+ /**
+ * Adds the given Sone.
+ *
+ * @param sone
+ * The Sone to add
+ */
+ public void addSone(Sone sone) {
+ if (localSones.add(sone)) {
+ SoneInserter soneInserter = new SoneInserter(freenetInterface, sone);
+ soneInserter.start();
+ soneInserters.put(sone, soneInserter);
+ }
+ }
+
+ /**
+ * Creates a new Sone at a random location.
+ *
+ * @param name
+ * The name of the Sone
+ * @return The created Sone
+ * @throws SoneException
+ * if a Sone error occurs
+ */
+ public Sone createSone(String name) throws SoneException {
+ return createSone(name, null, null);
+ }
+
+ /**
+ * Creates a new Sone at the given location. If one of {@code requestUri} or
+ * {@code insertUrI} is {@code null}, the Sone is created at a random
+ * location.
+ *
+ * @param name
+ * The name of the Sone
+ * @param requestUri
+ * The request URI of the Sone, or {@link NullPointerException}
+ * to create a Sone at a random location
+ * @param insertUri
+ * The insert URI of the Sone, or {@code null} to create a Sone
+ * at a random location
+ * @return The created Sone
+ * @throws SoneException
+ * if a Sone error occurs
+ */
+ public Sone createSone(String name, String requestUri, String insertUri) throws SoneException {
+ if ((name == null) || (name.trim().length() == 0)) {
+ throw new SoneException(Type.INVALID_SONE_NAME);
+ }
+ String finalRequestUri;
+ String finalInsertUri;
+ if ((requestUri == null) || (insertUri == null)) {
+ String[] keyPair = freenetInterface.generateKeyPair();
+ finalRequestUri = keyPair[0];
+ finalInsertUri = keyPair[1];
+ } else {
+ finalRequestUri = requestUri;
+ finalInsertUri = insertUri;
+ }
+ Sone sone;
+ try {
+ logger.log(Level.FINEST, "Creating new Sone “%s” at %s (%s)…", new Object[] { name, finalRequestUri, finalInsertUri });
+ sone = new Sone(UUID.randomUUID(), name, new FreenetURI(finalRequestUri), new FreenetURI(finalInsertUri));
+ sone.setProfile(new Profile());
+ /* set modification counter to 1 so it is inserted immediately. */
+ sone.setModificationCounter(1);
+ addSone(sone);
+ } catch (MalformedURLException mue1) {
+ throw new SoneException(Type.INVALID_URI);
+ }
+ localSones.add(sone);
+ return sone;
+ }
+
+ /**
+ * Deletes the given Sone from this plugin instance.
+ *
+ * @param sone
+ * The sone to delete
+ */
+ public void deleteSone(Sone sone) {
+ SoneInserter soneInserter = soneInserters.remove(sone);
+ soneInserter.stop();
+ localSones.remove(sone);
+ }
+