src/main/java/net/pterodactylus/sone/core/Core.java

   1 /*
   2  * Sone - Core.java - Copyright © 2010 David Roden
   3  *
   4  * This program is free software: you can redistribute it and/or modify
   5  * it under the terms of the GNU General Public License as published by
   6  * the Free Software Foundation, either version 3 of the License, or
   7  * (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12  * GNU General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  16  */
  17
  18 package net.pterodactylus.sone.core;
  19
  20 import java.net.MalformedURLException;
  21 import java.util.ArrayList;
  22 import java.util.Collections;
  23 import java.util.HashMap;
  24 import java.util.HashSet;
  25 import java.util.List;
  26 import java.util.Map;
  27 import java.util.Set;
  28 import java.util.logging.Level;
  29 import java.util.logging.Logger;
  30
  31 import net.pterodactylus.sone.core.Options.DefaultOption;
  32 import net.pterodactylus.sone.core.Options.Option;
  33 import net.pterodactylus.sone.core.Options.OptionWatcher;
  34 import net.pterodactylus.sone.data.Post;
  35 import net.pterodactylus.sone.data.Profile;
  36 import net.pterodactylus.sone.data.Reply;
  37 import net.pterodactylus.sone.data.Sone;
  38 import net.pterodactylus.sone.freenet.wot.Identity;
  39 import net.pterodactylus.sone.freenet.wot.IdentityListener;
  40 import net.pterodactylus.sone.freenet.wot.IdentityManager;
  41 import net.pterodactylus.sone.freenet.wot.OwnIdentity;
  42 import net.pterodactylus.util.config.Configuration;
  43 import net.pterodactylus.util.config.ConfigurationException;
  44 import net.pterodactylus.util.logging.Logging;
  45 import net.pterodactylus.util.number.Numbers;
  46 import freenet.keys.FreenetURI;
  47
  48 /**
  49  * The Sone core.
  50  *
  51  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  52  */
  53 public class Core implements IdentityListener {
  54
  55         /**
  56          * Enumeration for the possible states of a {@link Sone}.
  57          *
  58          * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
  59          */
  60         public enum SoneStatus {
  61
  62                 /** The Sone is unknown, i.e. not yet downloaded. */
  63                 unknown,
  64
  65                 /** The Sone is idle, i.e. not being downloaded or inserted. */
  66                 idle,
  67
  68                 /** The Sone is currently being inserted. */
  69                 inserting,
  70
  71                 /** The Sone is currently being downloaded. */
  72                 downloading,
  73         }
  74
  75         /** The logger. */
  76         private static final Logger logger = Logging.getLogger(Core.class);
  77
  78         /** The options. */
  79         private final Options options = new Options();
  80
  81         /** The configuration. */
  82         private final Configuration configuration;
  83
  84         /** The identity manager. */
  85         private final IdentityManager identityManager;
  86
  87         /** Interface to freenet. */
  88         private final FreenetInterface freenetInterface;
  89
  90         /** The Sone downloader. */
  91         private final SoneDownloader soneDownloader;
  92
  93         /** The Sones’ statuses. */
  94         /* synchronize access on itself. */
  95         private final Map<Sone, SoneStatus> soneStatuses = new HashMap<Sone, SoneStatus>();
  96
  97         /** Sone inserters. */
  98         /* synchronize access on this on localSones. */
  99         private final Map<Sone, SoneInserter> soneInserters = new HashMap<Sone, SoneInserter>();
 100
 101         /** All local Sones. */
 102         /* synchronize access on this on itself. */
 103         private Map<String, Sone> localSones = new HashMap<String, Sone>();
 104
 105         /** All remote Sones. */
 106         /* synchronize access on this on itself. */
 107         private Map<String, Sone> remoteSones = new HashMap<String, Sone>();
 108
 109         /** All posts. */
 110         private Map<String, Post> posts = new HashMap<String, Post>();
 111
 112         /** All replies. */
 113         private Map<String, Reply> replies = new HashMap<String, Reply>();
 114
 115         /**
 116          * Creates a new core.
 117          *
 118          * @param configuration
 119          *            The configuration of the core
 120          * @param freenetInterface
 121          *            The freenet interface
 122          * @param identityManager
 123          *            The identity manager
 124          */
 125         public Core(Configuration configuration, FreenetInterface freenetInterface, IdentityManager identityManager) {
 126                 this.configuration = configuration;
 127                 this.freenetInterface = freenetInterface;
 128                 this.identityManager = identityManager;
 129                 this.soneDownloader = new SoneDownloader(this, freenetInterface);
 130         }
 131
 132         //
 133         // ACCESSORS
 134         //
 135
 136         /**
 137          * Returns the options used by the core.
 138          *
 139          * @return The options of the core
 140          */
 141         public Options getOptions() {
 142                 return options;
 143         }
 144
 145         /**
 146          * Returns the identity manager used by the core.
 147          *
 148          * @return The identity manager
 149          */
 150         public IdentityManager getIdentityManager() {
 151                 return identityManager;
 152         }
 153
 154         /**
 155          * Returns the status of the given Sone.
 156          *
 157          * @param sone
 158          *            The Sone to get the status for
 159          * @return The status of the Sone
 160          */
 161         public SoneStatus getSoneStatus(Sone sone) {
 162                 synchronized (soneStatuses) {
 163                         return soneStatuses.get(sone);
 164                 }
 165         }
 166
 167         /**
 168          * Sets the status of the given Sone.
 169          *
 170          * @param sone
 171          *            The Sone to set the status of
 172          * @param soneStatus
 173          *            The status to set
 174          */
 175         public void setSoneStatus(Sone sone, SoneStatus soneStatus) {
 176                 synchronized (soneStatuses) {
 177                         soneStatuses.put(sone, soneStatus);
 178                 }
 179         }
 180
 181         /**
 182          * Returns all Sones, remote and local.
 183          *
 184          * @return All Sones
 185          */
 186         public Set<Sone> getSones() {
 187                 Set<Sone> allSones = new HashSet<Sone>();
 188                 allSones.addAll(getLocalSones());
 189                 allSones.addAll(getRemoteSones());
 190                 return allSones;
 191         }
 192
 193         /**
 194          * Returns the Sone with the given ID, regardless whether it’s local or
 195          * remote.
 196          *
 197          * @param id
 198          *            The ID of the Sone to get
 199          * @return The Sone with the given ID, or {@code null} if there is no such
 200          *         Sone
 201          */
 202         public Sone getSone(String id) {
 203                 if (isLocalSone(id)) {
 204                         return getLocalSone(id);
 205                 }
 206                 return getRemoteSone(id);
 207         }
 208
 209         /**
 210          * Returns whether the given Sone is a local Sone.
 211          *
 212          * @param sone
 213          *            The Sone to check for its locality
 214          * @return {@code true} if the given Sone is local, {@code false} otherwise
 215          */
 216         public boolean isLocalSone(Sone sone) {
 217                 synchronized (localSones) {
 218                         return localSones.containsKey(sone.getId());
 219                 }
 220         }
 221
 222         /**
 223          * Returns whether the given ID is the ID of a local Sone.
 224          *
 225          * @param id
 226          *            The Sone ID to check for its locality
 227          * @return {@code true} if the given ID is a local Sone, {@code false}
 228          *         otherwise
 229          */
 230         public boolean isLocalSone(String id) {
 231                 synchronized (localSones) {
 232                         return localSones.containsKey(id);
 233                 }
 234         }
 235
 236         /**
 237          * Returns all local Sones.
 238          *
 239          * @return All local Sones
 240          */
 241         public Set<Sone> getLocalSones() {
 242                 synchronized (localSones) {
 243                         return new HashSet<Sone>(localSones.values());
 244                 }
 245         }
 246
 247         /**
 248          * Returns the local Sone with the given ID.
 249          *
 250          * @param id
 251          *            The ID of the Sone to get
 252          * @return The Sone with the given ID
 253          */
 254         public Sone getLocalSone(String id) {
 255                 synchronized (localSones) {
 256                         Sone sone = localSones.get(id);
 257                         if (sone == null) {
 258                                 sone = new Sone(id);
 259                                 localSones.put(id, sone);
 260                         }
 261                         return sone;
 262                 }
 263         }
 264
 265         /**
 266          * Returns all remote Sones.
 267          *
 268          * @return All remote Sones
 269          */
 270         public Set<Sone> getRemoteSones() {
 271                 synchronized (remoteSones) {
 272                         return new HashSet<Sone>(remoteSones.values());
 273                 }
 274         }
 275
 276         /**
 277          * Returns the remote Sone with the given ID.
 278          *
 279          * @param id
 280          *            The ID of the remote Sone to get
 281          * @return The Sone with the given ID
 282          */
 283         public Sone getRemoteSone(String id) {
 284                 synchronized (remoteSones) {
 285                         Sone sone = remoteSones.get(id);
 286                         if (sone == null) {
 287                                 sone = new Sone(id);
 288                                 remoteSones.put(id, sone);
 289                         }
 290                         return sone;
 291                 }
 292         }
 293
 294         /**
 295          * Returns whether the given Sone is a remote Sone.
 296          *
 297          * @param sone
 298          *            The Sone to check
 299          * @return {@code true} if the given Sone is a remote Sone, {@code false}
 300          *         otherwise
 301          */
 302         public boolean isRemoteSone(Sone sone) {
 303                 synchronized (remoteSones) {
 304                         return remoteSones.containsKey(sone.getId());
 305                 }
 306         }
 307
 308         /**
 309          * Returns the post with the given ID.
 310          *
 311          * @param postId
 312          *            The ID of the post to get
 313          * @return The post, or {@code null} if there is no such post
 314          */
 315         public Post getPost(String postId) {
 316                 synchronized (posts) {
 317                         Post post = posts.get(postId);
 318                         if (post == null) {
 319                                 post = new Post(postId);
 320                                 posts.put(postId, post);
 321                         }
 322                         return post;
 323                 }
 324         }
 325
 326         /**
 327          * Returns the reply with the given ID.
 328          *
 329          * @param replyId
 330          *            The ID of the reply to get
 331          * @return The reply, or {@code null} if there is no such reply
 332          */
 333         public Reply getReply(String replyId) {
 334                 synchronized (replies) {
 335                         Reply reply = replies.get(replyId);
 336                         if (reply == null) {
 337                                 reply = new Reply(replyId);
 338                                 replies.put(replyId, reply);
 339                         }
 340                         return reply;
 341                 }
 342         }
 343
 344         /**
 345          * Returns all replies for the given post, order ascending by time.
 346          *
 347          * @param post
 348          *            The post to get all replies for
 349          * @return All replies for the given post
 350          */
 351         public List<Reply> getReplies(Post post) {
 352                 Set<Sone> sones = getSones();
 353                 List<Reply> replies = new ArrayList<Reply>();
 354                 for (Sone sone : sones) {
 355                         for (Reply reply : sone.getReplies()) {
 356                                 if (reply.getPost().equals(post)) {
 357                                         replies.add(reply);
 358                                 }
 359                         }
 360                 }
 361                 Collections.sort(replies, Reply.TIME_COMPARATOR);
 362                 return replies;
 363         }
 364
 365         /**
 366          * Returns all Sones that have liked the given post.
 367          *
 368          * @param post
 369          *            The post to get the liking Sones for
 370          * @return The Sones that like the given post
 371          */
 372         public Set<Sone> getLikes(Post post) {
 373                 Set<Sone> sones = new HashSet<Sone>();
 374                 for (Sone sone : getSones()) {
 375                         if (sone.getLikedPostIds().contains(post.getId())) {
 376                                 sones.add(sone);
 377                         }
 378                 }
 379                 return sones;
 380         }
 381
 382         /**
 383          * Returns all Sones that have liked the given reply.
 384          *
 385          * @param reply
 386          *            The reply to get the liking Sones for
 387          * @return The Sones that like the given reply
 388          */
 389         public Set<Sone> getLikes(Reply reply) {
 390                 Set<Sone> sones = new HashSet<Sone>();
 391                 for (Sone sone : getSones()) {
 392                         if (sone.getLikedPostIds().contains(reply.getId())) {
 393                                 sones.add(sone);
 394                         }
 395                 }
 396                 return sones;
 397         }
 398
 399         //
 400         // ACTIONS
 401         //
 402
 403         /**
 404          * Adds a local Sone from the given ID which has to be the ID of an own
 405          * identity.
 406          *
 407          * @param id
 408          *            The ID of an own identity to add a Sone for
 409          * @return The added (or already existing) Sone
 410          */
 411         public Sone addLocalSone(String id) {
 412                 synchronized (localSones) {
 413                         if (localSones.containsKey(id)) {
 414                                 logger.log(Level.FINE, "Tried to add known local Sone: %s", id);
 415                                 return localSones.get(id);
 416                         }
 417                         OwnIdentity ownIdentity = identityManager.getOwnIdentity(id);
 418                         if (ownIdentity == null) {
 419                                 logger.log(Level.INFO, "Invalid Sone ID: %s", id);
 420                                 return null;
 421                         }
 422                         return addLocalSone(ownIdentity);
 423                 }
 424         }
 425
 426         /**
 427          * Adds a local Sone from the given own identity.
 428          *
 429          * @param ownIdentity
 430          *            The own identity to create a Sone from
 431          * @return The added (or already existing) Sone
 432          */
 433         public Sone addLocalSone(OwnIdentity ownIdentity) {
 434                 if (ownIdentity == null) {
 435                         logger.log(Level.WARNING, "Given OwnIdentity is null!");
 436                         return null;
 437                 }
 438                 synchronized (localSones) {
 439                         if (localSones.containsKey(ownIdentity.getId())) {
 440                                 logger.log(Level.FINE, "Tried to add known local Sone: %s", ownIdentity);
 441                                 return localSones.get(ownIdentity.getId());
 442                         }
 443                         final Sone sone;
 444                         try {
 445                                 sone = getLocalSone(ownIdentity.getId()).setIdentity(ownIdentity).setInsertUri(new FreenetURI(ownIdentity.getInsertUri())).setRequestUri(new FreenetURI(ownIdentity.getRequestUri()));
 446                                 sone.setLatestEdition(Numbers.safeParseLong(ownIdentity.getProperty("Sone.LatestEdition"), (long) 0));
 447                         } catch (MalformedURLException mue1) {
 448                                 logger.log(Level.SEVERE, "Could not convert the Identity’s URIs to Freenet URIs: " + ownIdentity.getInsertUri() + ", " + ownIdentity.getRequestUri(), mue1);
 449                                 return null;
 450                         }
 451                         /* TODO - load posts ’n stuff */
 452                         localSones.put(ownIdentity.getId(), sone);
 453                         SoneInserter soneInserter = new SoneInserter(this, freenetInterface, sone);
 454                         soneInserters.put(sone, soneInserter);
 455                         soneInserter.start();
 456                         setSoneStatus(sone, SoneStatus.idle);
 457                         new Thread(new Runnable() {
 458
 459                                 @Override
 460                                 @SuppressWarnings("synthetic-access")
 461                                 public void run() {
 462                                         soneDownloader.fetchSone(sone);
 463                                 }
 464
 465                         }, "Sone Downloader").start();
 466                         return sone;
 467                 }
 468         }
 469
 470         /**
 471          * Creates a new Sone for the given own identity.
 472          *
 473          * @param ownIdentity
 474          *            The own identity to create a Sone for
 475          * @return The created Sone
 476          */
 477         public Sone createSone(OwnIdentity ownIdentity) {
 478                 identityManager.addContext(ownIdentity, "Sone");
 479                 Sone sone = addLocalSone(ownIdentity);
 480                 synchronized (sone) {
 481                         /* mark as modified so that it gets inserted immediately. */
 482                         sone.setModificationCounter(sone.getModificationCounter() + 1);
 483                 }
 484                 return sone;
 485         }
 486
 487         /**
 488          * Adds the Sone of the given identity.
 489          *
 490          * @param identity
 491          *            The identity whose Sone to add
 492          * @return The added or already existing Sone
 493          */
 494         public Sone addRemoteSone(Identity identity) {
 495                 if (identity == null) {
 496                         logger.log(Level.WARNING, "Given Identity is null!");
 497                         return null;
 498                 }
 499                 synchronized (remoteSones) {
 500                         if (remoteSones.containsKey(identity.getId())) {
 501                                 logger.log(Level.FINE, "Identity already exists: %s", identity);
 502                                 return remoteSones.get(identity.getId());
 503                         }
 504                         Sone sone = new Sone(identity);
 505                         sone.setRequestUri(getSoneUri(identity.getRequestUri(), identity.getProperty("Sone.LatestEdition")));
 506                         remoteSones.put(identity.getId(), sone);
 507                         soneDownloader.addSone(sone);
 508                         setSoneStatus(sone, SoneStatus.idle);
 509                         return sone;
 510                 }
 511         }
 512
 513         /**
 514          * Updates the stores Sone with the given Sone.
 515          *
 516          * @param sone
 517          *            The updated Sone
 518          */
 519         public void updateSone(Sone sone) {
 520                 if (isRemoteSone(sone)) {
 521                         Sone storedSone = getRemoteSone(sone.getId());
 522                         if (!(sone.getTime() > storedSone.getTime())) {
 523                                 logger.log(Level.FINE, "Downloaded Sone %s is not newer than stored Sone %s.", new Object[] { sone, storedSone });
 524                                 return;
 525                         }
 526                         synchronized (posts) {
 527                                 for (Post post : storedSone.getPosts()) {
 528                                         posts.remove(post.getId());
 529                                 }
 530                                 for (Post post : sone.getPosts()) {
 531                                         posts.put(post.getId(), post);
 532                                 }
 533                         }
 534                         synchronized (replies) {
 535                                 for (Reply reply : storedSone.getReplies()) {
 536                                         replies.remove(reply.getId());
 537                                 }
 538                                 for (Reply reply : sone.getReplies()) {
 539                                         replies.put(reply.getId(), reply);
 540                                 }
 541                         }
 542                         synchronized (storedSone) {
 543                                 storedSone.setTime(sone.getTime());
 544                                 storedSone.setProfile(sone.getProfile());
 545                                 storedSone.setPosts(sone.getPosts());
 546                                 storedSone.setReplies(sone.getReplies());
 547                                 storedSone.setLikePostIds(sone.getLikedPostIds());
 548                                 storedSone.setLikeReplyIds(sone.getLikedReplyIds());
 549                                 storedSone.setLatestEdition(sone.getRequestUri().getEdition());
 550                         }
 551                         saveSone(storedSone);
 552                 }
 553         }
 554
 555         /**
 556          * Deletes the given Sone. This will remove the Sone from the
 557          * {@link #getLocalSone(String) local Sones}, stops its {@link SoneInserter}
 558          * and remove the context from its identity.
 559          *
 560          * @param sone
 561          *            The Sone to delete
 562          */
 563         public void deleteSone(Sone sone) {
 564                 if (!(sone.getIdentity() instanceof OwnIdentity)) {
 565                         logger.log(Level.WARNING, "Tried to delete Sone of non-own identity: %s", sone);
 566                         return;
 567                 }
 568                 synchronized (localSones) {
 569                         if (!localSones.containsKey(sone.getId())) {
 570                                 logger.log(Level.WARNING, "Tried to delete non-local Sone: %s", sone);
 571                                 return;
 572                         }
 573                         localSones.remove(sone.getId());
 574                         soneInserters.remove(sone.getId()).stop();
 575                 }
 576                 identityManager.removeContext((OwnIdentity) sone.getIdentity(), "Sone");
 577         }
 578
 579         /**
 580          * Saves the given Sone. This will persist all local settings for the given
 581          * Sone, such as the friends list and similar, private options.
 582          *
 583          * @param sone
 584          *            The Sone to save
 585          */
 586         public void saveSone(Sone sone) {
 587                 if (!isLocalSone(sone)) {
 588                         logger.log(Level.FINE, "Tried to save non-local Sone: %s", sone);
 589                         return;
 590                 }
 591                 if (!(sone.getIdentity() instanceof OwnIdentity)) {
 592                         logger.log(Level.WARNING, "Local Sone without OwnIdentity found, refusing to save: %s", sone);
 593                         return;
 594                 }
 595
 596                 logger.log(Level.INFO, "Saving Sone: %s", sone);
 597                 identityManager.setProperty((OwnIdentity) sone.getIdentity(), "Sone.LatestEdition", String.valueOf(sone.getLatestEdition()));
 598                 try {
 599                         /* save Sone into configuration. */
 600                         String sonePrefix = "Sone/" + sone.getId();
 601                         configuration.getLongValue(sonePrefix + "/Time").setValue(sone.getTime());
 602
 603                         /* save profile. */
 604                         Profile profile = sone.getProfile();
 605                         configuration.getStringValue(sonePrefix + "/Profile/FirstName").setValue(profile.getFirstName());
 606                         configuration.getStringValue(sonePrefix + "/Profile/MiddleName").setValue(profile.getMiddleName());
 607                         configuration.getStringValue(sonePrefix + "/Profile/LastName").setValue(profile.getLastName());
 608                         configuration.getIntValue(sonePrefix + "/Profile/BirthDay").setValue(profile.getBirthDay());
 609                         configuration.getIntValue(sonePrefix + "/Profile/BirthMonth").setValue(profile.getBirthMonth());
 610                         configuration.getIntValue(sonePrefix + "/Profile/BirthYear").setValue(profile.getBirthYear());
 611
 612                         /* save posts. */
 613                         int postCounter = 0;
 614                         for (Post post : sone.getPosts()) {
 615                                 String postPrefix = sonePrefix + "/Posts/" + postCounter++;
 616                                 configuration.getStringValue(postPrefix + "/ID").setValue(post.getId());
 617                                 configuration.getLongValue(postPrefix + "/Time").setValue(post.getTime());
 618                                 configuration.getStringValue(postPrefix + "/Text").setValue(post.getText());
 619                         }
 620                         configuration.getStringValue(sonePrefix + "/Posts/" + postCounter + "/ID").setValue(null);
 621
 622                         /* save replies. */
 623                         int replyCounter = 0;
 624                         for (Reply reply : sone.getReplies()) {
 625                                 String replyPrefix = sonePrefix + "/Replies/" + replyCounter++;
 626                                 configuration.getStringValue(replyPrefix + "/ID").setValue(reply.getId());
 627                                 configuration.getStringValue(replyPrefix + "/Post/ID").setValue(reply.getPost().getId());
 628                                 configuration.getLongValue(replyPrefix + "/Time").setValue(reply.getTime());
 629                                 configuration.getStringValue(replyPrefix + "/Text").setValue(reply.getText());
 630                         }
 631                         configuration.getStringValue(sonePrefix + "/Replies/" + replyCounter + "/ID").setValue(null);
 632
 633                         /* save post likes. */
 634                         int postLikeCounter = 0;
 635                         for (String postId : sone.getLikedPostIds()) {
 636                                 configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter++ + "/ID").setValue(postId);
 637                         }
 638                         configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter + "/ID").setValue(null);
 639
 640                         /* save reply likes. */
 641                         int replyLikeCounter = 0;
 642                         for (String replyId : sone.getLikedReplyIds()) {
 643                                 configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter++ + "/ID").setValue(replyId);
 644                         }
 645                         configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter + "/ID").setValue(null);
 646
 647                         logger.log(Level.INFO, "Sone %s saved.", sone);
 648                 } catch (ConfigurationException ce1) {
 649                         logger.log(Level.WARNING, "Could not save Sone: " + sone, ce1);
 650                 }
 651         }
 652
 653         /**
 654          * Creates a new post.
 655          *
 656          * @param sone
 657          *            The Sone that creates the post
 658          * @param text
 659          *            The text of the post
 660          */
 661         public void createPost(Sone sone, String text) {
 662                 createPost(sone, System.currentTimeMillis(), text);
 663         }
 664
 665         /**
 666          * Creates a new post.
 667          *
 668          * @param sone
 669          *            The Sone that creates the post
 670          * @param time
 671          *            The time of the post
 672          * @param text
 673          *            The text of the post
 674          */
 675         public void createPost(Sone sone, long time, String text) {
 676                 if (!isLocalSone(sone)) {
 677                         logger.log(Level.FINE, "Tried to create post for non-local Sone: %s", sone);
 678                         return;
 679                 }
 680                 Post post = new Post(sone, time, text);
 681                 synchronized (posts) {
 682                         posts.put(post.getId(), post);
 683                 }
 684                 sone.addPost(post);
 685                 saveSone(sone);
 686         }
 687
 688         /**
 689          * Deletes the given post.
 690          *
 691          * @param post
 692          *            The post to delete
 693          */
 694         public void deletePost(Post post) {
 695                 if (!isLocalSone(post.getSone())) {
 696                         logger.log(Level.WARNING, "Tried to delete post of non-local Sone: %s", post.getSone());
 697                         return;
 698                 }
 699                 post.getSone().removePost(post);
 700                 synchronized (posts) {
 701                         posts.remove(post.getId());
 702                 }
 703                 saveSone(post.getSone());
 704         }
 705
 706         /**
 707          * Creates a new reply.
 708          *
 709          * @param sone
 710          *            The Sone that creates the reply
 711          * @param post
 712          *            The post that this reply refers to
 713          * @param text
 714          *            The text of the reply
 715          */
 716         public void createReply(Sone sone, Post post, String text) {
 717                 createReply(sone, post, System.currentTimeMillis(), text);
 718         }
 719
 720         /**
 721          * Creates a new reply.
 722          *
 723          * @param sone
 724          *            The Sone that creates the reply
 725          * @param post
 726          *            The post that this reply refers to
 727          * @param time
 728          *            The time of the reply
 729          * @param text
 730          *            The text of the reply
 731          */
 732         public void createReply(Sone sone, Post post, long time, String text) {
 733                 if (!isLocalSone(sone)) {
 734                         logger.log(Level.FINE, "Tried to create reply for non-local Sone: %s", sone);
 735                         return;
 736                 }
 737                 Reply reply = new Reply(sone, post, System.currentTimeMillis(), text);
 738                 synchronized (replies) {
 739                         replies.put(reply.getId(), reply);
 740                 }
 741                 sone.addReply(reply);
 742                 saveSone(sone);
 743         }
 744
 745         /**
 746          * Deletes the given reply.
 747          *
 748          * @param reply
 749          *            The reply to delete
 750          */
 751         public void deleteReply(Reply reply) {
 752                 Sone sone = reply.getSone();
 753                 if (!isLocalSone(sone)) {
 754                         logger.log(Level.FINE, "Tried to delete non-local reply: %s", reply);
 755                         return;
 756                 }
 757                 synchronized (replies) {
 758                         replies.remove(reply.getId());
 759                 }
 760                 sone.removeReply(reply);
 761                 saveSone(sone);
 762         }
 763
 764         /**
 765          * Starts the core.
 766          */
 767         public void start() {
 768                 loadConfiguration();
 769         }
 770
 771         /**
 772          * Stops the core.
 773          */
 774         public void stop() {
 775                 synchronized (localSones) {
 776                         for (SoneInserter soneInserter : soneInserters.values()) {
 777                                 soneInserter.stop();
 778                         }
 779                 }
 780                 saveConfiguration();
 781         }
 782
 783         //
 784         // PRIVATE METHODS
 785         //
 786
 787         /**
 788          * Loads the configuration.
 789          */
 790         @SuppressWarnings("unchecked")
 791         private void loadConfiguration() {
 792                 /* create options. */
 793                 options.addIntegerOption("InsertionDelay", new DefaultOption<Integer>(60, new OptionWatcher<Integer>() {
 794
 795                         @Override
 796                         public void optionChanged(Option<Integer> option, Integer oldValue, Integer newValue) {
 797                                 SoneInserter.setInsertionDelay(newValue);
 798                         }
 799
 800                 }));
 801                 options.addBooleanOption("ClearOnNextRestart", new DefaultOption<Boolean>(false));
 802                 options.addBooleanOption("ReallyClearOnNextRestart", new DefaultOption<Boolean>(false));
 803
 804                 /* read options from configuration. */
 805                 options.getBooleanOption("ClearOnNextRestart").set(configuration.getBooleanValue("Option/ClearOnNextRestart").getValue(null));
 806                 options.getBooleanOption("ReallyClearOnNextRestart").set(configuration.getBooleanValue("Option/ReallyClearOnNextRestart").getValue(null));
 807                 boolean clearConfiguration = options.getBooleanOption("ClearOnNextRestart").get() && options.getBooleanOption("ReallyClearOnNextRestart").get();
 808                 options.getBooleanOption("ClearOnNextRestart").set(null);
 809                 options.getBooleanOption("ReallyClearOnNextRestart").set(null);
 810                 if (clearConfiguration) {
 811                         /* stop loading the configuration. */
 812                         return;
 813                 }
 814
 815                 options.getIntegerOption("InsertionDelay").set(configuration.getIntValue("Option/InsertionDelay").getValue(null));
 816
 817         }
 818
 819         /**
 820          * Saves the current options.
 821          */
 822         private void saveConfiguration() {
 823                 /* store the options first. */
 824                 try {
 825                         configuration.getIntValue("Option/InsertionDelay").setValue(options.getIntegerOption("InsertionDelay").getReal());
 826                         configuration.getBooleanValue("Option/ClearOnNextRestart").setValue(options.getBooleanOption("ClearOnNextRestart").getReal());
 827                         configuration.getBooleanValue("Option/ReallyClearOnNextRestart").setValue(options.getBooleanOption("ReallyClearOnNextRestart").getReal());
 828                 } catch (ConfigurationException ce1) {
 829                         logger.log(Level.SEVERE, "Could not store configuration!", ce1);
 830                 }
 831         }
 832
 833         /**
 834          * Generate a Sone URI from the given URI and latest edition.
 835          *
 836          * @param uriString
 837          *            The URI to derive the Sone URI from
 838          * @param latestEditionString
 839          *            The latest edition as a {@link String}, or {@code null}
 840          * @return The derived URI
 841          */
 842         private FreenetURI getSoneUri(String uriString, String latestEditionString) {
 843                 try {
 844                         FreenetURI uri = new FreenetURI(uriString).setDocName("Sone").setMetaString(new String[0]).setSuggestedEdition(Numbers.safeParseLong(latestEditionString, (long) 0));
 845                         return uri;
 846                 } catch (MalformedURLException mue1) {
 847                         logger.log(Level.WARNING, "Could not create Sone URI from URI: " + uriString, mue1);
 848                         return null;
 849                 }
 850         }
 851
 852         //
 853         // INTERFACE IdentityListener
 854         //
 855
 856         /**
 857          * {@inheritDoc}
 858          */
 859         @Override
 860         public void ownIdentityAdded(OwnIdentity ownIdentity) {
 861                 logger.log(Level.FINEST, "Adding OwnIdentity: " + ownIdentity);
 862                 if (ownIdentity.hasContext("Sone")) {
 863                         addLocalSone(ownIdentity);
 864                 }
 865         }
 866
 867         /**
 868          * {@inheritDoc}
 869          */
 870         @Override
 871         public void ownIdentityRemoved(OwnIdentity ownIdentity) {
 872                 /* TODO */
 873         }
 874
 875         /**
 876          * {@inheritDoc}
 877          */
 878         @Override
 879         public void identityAdded(Identity identity) {
 880                 logger.log(Level.FINEST, "Adding Identity: " + identity);
 881                 addRemoteSone(identity);
 882         }
 883
 884         /**
 885          * {@inheritDoc}
 886          */
 887         @Override
 888         public void identityUpdated(Identity identity) {
 889                 /* TODO */
 890         }
 891
 892         /**
 893          * {@inheritDoc}
 894          */
 895         @Override
 896         public void identityRemoved(Identity identity) {
 897                 /* TODO */
 898         }
 899
 900 }