Save Sone after rescuing.
[Sone.git] / 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.Client;
35 import net.pterodactylus.sone.data.Post;
36 import net.pterodactylus.sone.data.Profile;
37 import net.pterodactylus.sone.data.Reply;
38 import net.pterodactylus.sone.data.Sone;
39 import net.pterodactylus.sone.freenet.wot.Identity;
40 import net.pterodactylus.sone.freenet.wot.IdentityListener;
41 import net.pterodactylus.sone.freenet.wot.IdentityManager;
42 import net.pterodactylus.sone.freenet.wot.OwnIdentity;
43 import net.pterodactylus.sone.main.SonePlugin;
44 import net.pterodactylus.util.config.Configuration;
45 import net.pterodactylus.util.config.ConfigurationException;
46 import net.pterodactylus.util.logging.Logging;
47 import net.pterodactylus.util.number.Numbers;
48 import freenet.keys.FreenetURI;
49
50 /**
51  * The Sone core.
52  *
53  * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
54  */
55 public class Core implements IdentityListener {
56
57         /**
58          * Enumeration for the possible states of a {@link Sone}.
59          *
60          * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
61          */
62         public enum SoneStatus {
63
64                 /** The Sone is unknown, i.e. not yet downloaded. */
65                 unknown,
66
67                 /** The Sone is idle, i.e. not being downloaded or inserted. */
68                 idle,
69
70                 /** The Sone is currently being inserted. */
71                 inserting,
72
73                 /** The Sone is currently being downloaded. */
74                 downloading,
75         }
76
77         /** The logger. */
78         private static final Logger logger = Logging.getLogger(Core.class);
79
80         /** The options. */
81         private final Options options = new Options();
82
83         /** The core listener manager. */
84         private final CoreListenerManager coreListenerManager = new CoreListenerManager(this);
85
86         /** The configuration. */
87         private final Configuration configuration;
88
89         /** The identity manager. */
90         private final IdentityManager identityManager;
91
92         /** Interface to freenet. */
93         private final FreenetInterface freenetInterface;
94
95         /** The Sone downloader. */
96         private final SoneDownloader soneDownloader;
97
98         /** Whether the core has been stopped. */
99         private volatile boolean stopped;
100
101         /** The Sones’ statuses. */
102         /* synchronize access on itself. */
103         private final Map<Sone, SoneStatus> soneStatuses = new HashMap<Sone, SoneStatus>();
104
105         /** Locked local Sones. */
106         /* synchronize on itself. */
107         private final Set<Sone> lockedSones = new HashSet<Sone>();
108
109         /** Sone inserters. */
110         /* synchronize access on this on localSones. */
111         private final Map<Sone, SoneInserter> soneInserters = new HashMap<Sone, SoneInserter>();
112
113         /** All local Sones. */
114         /* synchronize access on this on itself. */
115         private Map<String, Sone> localSones = new HashMap<String, Sone>();
116
117         /** All remote Sones. */
118         /* synchronize access on this on itself. */
119         private Map<String, Sone> remoteSones = new HashMap<String, Sone>();
120
121         /** All new Sones. */
122         private Set<String> newSones = new HashSet<String>();
123
124         /** All known Sones. */
125         /* synchronize access on {@link #newSones}. */
126         private Set<String> knownSones = new HashSet<String>();
127
128         /** All posts. */
129         private Map<String, Post> posts = new HashMap<String, Post>();
130
131         /** All new posts. */
132         private Set<String> newPosts = new HashSet<String>();
133
134         /** All known posts. */
135         /* synchronize access on {@link #newPosts}. */
136         private Set<String> knownPosts = new HashSet<String>();
137
138         /** All replies. */
139         private Map<String, Reply> replies = new HashMap<String, Reply>();
140
141         /** All new replies. */
142         private Set<String> newReplies = new HashSet<String>();
143
144         /** All known replies. */
145         private Set<String> knownReplies = new HashSet<String>();
146
147         /**
148          * Creates a new core.
149          *
150          * @param configuration
151          *            The configuration of the core
152          * @param freenetInterface
153          *            The freenet interface
154          * @param identityManager
155          *            The identity manager
156          */
157         public Core(Configuration configuration, FreenetInterface freenetInterface, IdentityManager identityManager) {
158                 this.configuration = configuration;
159                 this.freenetInterface = freenetInterface;
160                 this.identityManager = identityManager;
161                 this.soneDownloader = new SoneDownloader(this, freenetInterface);
162         }
163
164         //
165         // LISTENER MANAGEMENT
166         //
167
168         /**
169          * Adds a new core listener.
170          *
171          * @param coreListener
172          *            The listener to add
173          */
174         public void addCoreListener(CoreListener coreListener) {
175                 coreListenerManager.addListener(coreListener);
176         }
177
178         /**
179          * Removes a core listener.
180          *
181          * @param coreListener
182          *            The listener to remove
183          */
184         public void removeCoreListener(CoreListener coreListener) {
185                 coreListenerManager.removeListener(coreListener);
186         }
187
188         //
189         // ACCESSORS
190         //
191
192         /**
193          * Returns the options used by the core.
194          *
195          * @return The options of the core
196          */
197         public Options getOptions() {
198                 return options;
199         }
200
201         /**
202          * Returns whether the “Sone rescue mode” is currently activated.
203          *
204          * @return {@code true} if the “Sone rescue mode” is currently activated,
205          *         {@code false} if it is not
206          */
207         public boolean isSoneRescueMode() {
208                 return options.getBooleanOption("SoneRescueMode").get();
209         }
210
211         /**
212          * Returns the identity manager used by the core.
213          *
214          * @return The identity manager
215          */
216         public IdentityManager getIdentityManager() {
217                 return identityManager;
218         }
219
220         /**
221          * Returns the status of the given Sone.
222          *
223          * @param sone
224          *            The Sone to get the status for
225          * @return The status of the Sone
226          */
227         public SoneStatus getSoneStatus(Sone sone) {
228                 synchronized (soneStatuses) {
229                         return soneStatuses.get(sone);
230                 }
231         }
232
233         /**
234          * Sets the status of the given Sone.
235          *
236          * @param sone
237          *            The Sone to set the status of
238          * @param soneStatus
239          *            The status to set
240          */
241         public void setSoneStatus(Sone sone, SoneStatus soneStatus) {
242                 synchronized (soneStatuses) {
243                         soneStatuses.put(sone, soneStatus);
244                 }
245         }
246
247         /**
248          * Returns whether the given Sone is currently locked.
249          *
250          * @param sone
251          *            The sone to check
252          * @return {@code true} if the Sone is locked, {@code false} if it is not
253          */
254         public boolean isLocked(Sone sone) {
255                 synchronized (lockedSones) {
256                         return lockedSones.contains(sone);
257                 }
258         }
259
260         /**
261          * Returns all Sones, remote and local.
262          *
263          * @return All Sones
264          */
265         public Set<Sone> getSones() {
266                 Set<Sone> allSones = new HashSet<Sone>();
267                 allSones.addAll(getLocalSones());
268                 allSones.addAll(getRemoteSones());
269                 return allSones;
270         }
271
272         /**
273          * Returns the Sone with the given ID, regardless whether it’s local or
274          * remote.
275          *
276          * @param id
277          *            The ID of the Sone to get
278          * @return The Sone with the given ID, or {@code null} if there is no such
279          *         Sone
280          */
281         public Sone getSone(String id) {
282                 return getSone(id, true);
283         }
284
285         /**
286          * Returns the Sone with the given ID, regardless whether it’s local or
287          * remote.
288          *
289          * @param id
290          *            The ID of the Sone to get
291          * @param create
292          *            {@code true} to create a new Sone if none exists,
293          *            {@code false} to return {@code null} if a Sone with the given
294          *            ID does not exist
295          * @return The Sone with the given ID, or {@code null} if there is no such
296          *         Sone
297          */
298         public Sone getSone(String id, boolean create) {
299                 if (isLocalSone(id)) {
300                         return getLocalSone(id);
301                 }
302                 return getRemoteSone(id, create);
303         }
304
305         /**
306          * Checks whether the core knows a Sone with the given ID.
307          *
308          * @param id
309          *            The ID of the Sone
310          * @return {@code true} if there is a Sone with the given ID, {@code false}
311          *         otherwise
312          */
313         public boolean hasSone(String id) {
314                 return isLocalSone(id) || isRemoteSone(id);
315         }
316
317         /**
318          * Returns whether the given Sone is a local Sone.
319          *
320          * @param sone
321          *            The Sone to check for its locality
322          * @return {@code true} if the given Sone is local, {@code false} otherwise
323          */
324         public boolean isLocalSone(Sone sone) {
325                 synchronized (localSones) {
326                         return localSones.containsKey(sone.getId());
327                 }
328         }
329
330         /**
331          * Returns whether the given ID is the ID of a local Sone.
332          *
333          * @param id
334          *            The Sone ID to check for its locality
335          * @return {@code true} if the given ID is a local Sone, {@code false}
336          *         otherwise
337          */
338         public boolean isLocalSone(String id) {
339                 synchronized (localSones) {
340                         return localSones.containsKey(id);
341                 }
342         }
343
344         /**
345          * Returns all local Sones.
346          *
347          * @return All local Sones
348          */
349         public Set<Sone> getLocalSones() {
350                 synchronized (localSones) {
351                         return new HashSet<Sone>(localSones.values());
352                 }
353         }
354
355         /**
356          * Returns the local Sone with the given ID.
357          *
358          * @param id
359          *            The ID of the Sone to get
360          * @return The Sone with the given ID
361          */
362         public Sone getLocalSone(String id) {
363                 return getLocalSone(id, true);
364         }
365
366         /**
367          * Returns the local Sone with the given ID, optionally creating a new Sone.
368          *
369          * @param id
370          *            The ID of the Sone
371          * @param create
372          *            {@code true} to create a new Sone if none exists,
373          *            {@code false} to return null if none exists
374          * @return The Sone with the given ID, or {@code null}
375          */
376         public Sone getLocalSone(String id, boolean create) {
377                 synchronized (localSones) {
378                         Sone sone = localSones.get(id);
379                         if ((sone == null) && create) {
380                                 sone = new Sone(id);
381                                 localSones.put(id, sone);
382                         }
383                         return sone;
384                 }
385         }
386
387         /**
388          * Returns all remote Sones.
389          *
390          * @return All remote Sones
391          */
392         public Set<Sone> getRemoteSones() {
393                 synchronized (remoteSones) {
394                         return new HashSet<Sone>(remoteSones.values());
395                 }
396         }
397
398         /**
399          * Returns the remote Sone with the given ID.
400          *
401          * @param id
402          *            The ID of the remote Sone to get
403          * @return The Sone with the given ID
404          */
405         public Sone getRemoteSone(String id) {
406                 return getRemoteSone(id, true);
407         }
408
409         /**
410          * Returns the remote Sone with the given ID.
411          *
412          * @param id
413          *            The ID of the remote Sone to get
414          * @param create
415          *            {@code true} to always create a Sone, {@code false} to return
416          *            {@code null} if no Sone with the given ID exists
417          * @return The Sone with the given ID
418          */
419         public Sone getRemoteSone(String id, boolean create) {
420                 synchronized (remoteSones) {
421                         Sone sone = remoteSones.get(id);
422                         if ((sone == null) && create) {
423                                 sone = new Sone(id);
424                                 remoteSones.put(id, sone);
425                         }
426                         return sone;
427                 }
428         }
429
430         /**
431          * Returns whether the given Sone is a remote Sone.
432          *
433          * @param sone
434          *            The Sone to check
435          * @return {@code true} if the given Sone is a remote Sone, {@code false}
436          *         otherwise
437          */
438         public boolean isRemoteSone(Sone sone) {
439                 synchronized (remoteSones) {
440                         return remoteSones.containsKey(sone.getId());
441                 }
442         }
443
444         /**
445          * Returns whether the Sone with the given ID is a remote Sone.
446          *
447          * @param id
448          *            The ID of the Sone to check
449          * @return {@code true} if the Sone with the given ID is a remote Sone,
450          *         {@code false} otherwise
451          */
452         public boolean isRemoteSone(String id) {
453                 synchronized (remoteSones) {
454                         return remoteSones.containsKey(id);
455                 }
456         }
457
458         /**
459          * Returns whether the given Sone is a new Sone. After this check, the Sone
460          * is marked as known, i.e. a second call with the same parameters will
461          * always yield {@code false}.
462          *
463          * @param sone
464          *            The sone to check for
465          * @return {@code true} if the given Sone is new, false otherwise
466          */
467         public boolean isNewSone(Sone sone) {
468                 synchronized (newSones) {
469                         boolean isNew = !knownSones.contains(sone.getId()) && newSones.remove(sone.getId());
470                         knownSones.add(sone.getId());
471                         if (isNew) {
472                                 coreListenerManager.fireMarkSoneKnown(sone);
473                         }
474                         return isNew;
475                 }
476         }
477
478         /**
479          * Returns whether the given Sone has been modified.
480          *
481          * @param sone
482          *            The Sone to check for modifications
483          * @return {@code true} if a modification has been detected in the Sone,
484          *         {@code false} otherwise
485          */
486         public boolean isModifiedSone(Sone sone) {
487                 return (soneInserters.containsKey(sone)) ? soneInserters.get(sone).isModified() : false;
488         }
489
490         /**
491          * Returns the post with the given ID.
492          *
493          * @param postId
494          *            The ID of the post to get
495          * @return The post, or {@code null} if there is no such post
496          */
497         public Post getPost(String postId) {
498                 return getPost(postId, true);
499         }
500
501         /**
502          * Returns the post with the given ID, optionally creating a new post.
503          *
504          * @param postId
505          *            The ID of the post to get
506          * @param create
507          *            {@code true} it create a new post if no post with the given ID
508          *            exists, {@code false} to return {@code null}
509          * @return The post, or {@code null} if there is no such post
510          */
511         public Post getPost(String postId, boolean create) {
512                 synchronized (posts) {
513                         Post post = posts.get(postId);
514                         if ((post == null) && create) {
515                                 post = new Post(postId);
516                                 posts.put(postId, post);
517                         }
518                         return post;
519                 }
520         }
521
522         /**
523          * Returns whether the given post ID is new. After this method returns it is
524          * marked a known post ID.
525          *
526          * @param postId
527          *            The post ID
528          * @return {@code true} if the post is considered to be new, {@code false}
529          *         otherwise
530          */
531         public boolean isNewPost(String postId) {
532                 synchronized (newPosts) {
533                         boolean isNew = !knownPosts.contains(postId) && newPosts.remove(postId);
534                         knownPosts.add(postId);
535                         if (isNew) {
536                                 coreListenerManager.fireMarkPostKnown(getPost(postId));
537                         }
538                         return isNew;
539                 }
540         }
541
542         /**
543          * Returns the reply with the given ID.
544          *
545          * @param replyId
546          *            The ID of the reply to get
547          * @return The reply, or {@code null} if there is no such reply
548          */
549         public Reply getReply(String replyId) {
550                 synchronized (replies) {
551                         Reply reply = replies.get(replyId);
552                         if (reply == null) {
553                                 reply = new Reply(replyId);
554                                 replies.put(replyId, reply);
555                         }
556                         return reply;
557                 }
558         }
559
560         /**
561          * Returns all replies for the given post, order ascending by time.
562          *
563          * @param post
564          *            The post to get all replies for
565          * @return All replies for the given post
566          */
567         public List<Reply> getReplies(Post post) {
568                 Set<Sone> sones = getSones();
569                 List<Reply> replies = new ArrayList<Reply>();
570                 for (Sone sone : sones) {
571                         for (Reply reply : sone.getReplies()) {
572                                 if (reply.getPost().equals(post)) {
573                                         replies.add(reply);
574                                 }
575                         }
576                 }
577                 Collections.sort(replies, Reply.TIME_COMPARATOR);
578                 return replies;
579         }
580
581         /**
582          * Returns whether the reply with the given ID is new.
583          *
584          * @param replyId
585          *            The ID of the reply to check
586          * @return {@code true} if the reply is considered to be new, {@code false}
587          *         otherwise
588          */
589         public boolean isNewReply(String replyId) {
590                 synchronized (newReplies) {
591                         boolean isNew = !knownReplies.contains(replyId) && newReplies.remove(replyId);
592                         knownReplies.add(replyId);
593                         if (isNew) {
594                                 coreListenerManager.fireMarkReplyKnown(getReply(replyId));
595                         }
596                         return isNew;
597                 }
598         }
599
600         /**
601          * Returns all Sones that have liked the given post.
602          *
603          * @param post
604          *            The post to get the liking Sones for
605          * @return The Sones that like the given post
606          */
607         public Set<Sone> getLikes(Post post) {
608                 Set<Sone> sones = new HashSet<Sone>();
609                 for (Sone sone : getSones()) {
610                         if (sone.getLikedPostIds().contains(post.getId())) {
611                                 sones.add(sone);
612                         }
613                 }
614                 return sones;
615         }
616
617         /**
618          * Returns all Sones that have liked the given reply.
619          *
620          * @param reply
621          *            The reply to get the liking Sones for
622          * @return The Sones that like the given reply
623          */
624         public Set<Sone> getLikes(Reply reply) {
625                 Set<Sone> sones = new HashSet<Sone>();
626                 for (Sone sone : getSones()) {
627                         if (sone.getLikedReplyIds().contains(reply.getId())) {
628                                 sones.add(sone);
629                         }
630                 }
631                 return sones;
632         }
633
634         //
635         // ACTIONS
636         //
637
638         /**
639          * Locks the given Sone. A locked Sone will not be inserted by
640          * {@link SoneInserter} until it is {@link #unlockSone(Sone) unlocked}
641          * again.
642          *
643          * @param sone
644          *            The sone to lock
645          */
646         public void lockSone(Sone sone) {
647                 synchronized (lockedSones) {
648                         lockedSones.add(sone);
649                 }
650         }
651
652         /**
653          * Unlocks the given Sone.
654          *
655          * @see #lockSone(Sone)
656          * @param sone
657          *            The sone to unlock
658          */
659         public void unlockSone(Sone sone) {
660                 synchronized (lockedSones) {
661                         lockedSones.remove(sone);
662                 }
663         }
664
665         /**
666          * Adds a local Sone from the given ID which has to be the ID of an own
667          * identity.
668          *
669          * @param id
670          *            The ID of an own identity to add a Sone for
671          * @return The added (or already existing) Sone
672          */
673         public Sone addLocalSone(String id) {
674                 synchronized (localSones) {
675                         if (localSones.containsKey(id)) {
676                                 logger.log(Level.FINE, "Tried to add known local Sone: %s", id);
677                                 return localSones.get(id);
678                         }
679                         OwnIdentity ownIdentity = identityManager.getOwnIdentity(id);
680                         if (ownIdentity == null) {
681                                 logger.log(Level.INFO, "Invalid Sone ID: %s", id);
682                                 return null;
683                         }
684                         return addLocalSone(ownIdentity);
685                 }
686         }
687
688         /**
689          * Adds a local Sone from the given own identity.
690          *
691          * @param ownIdentity
692          *            The own identity to create a Sone from
693          * @return The added (or already existing) Sone
694          */
695         public Sone addLocalSone(OwnIdentity ownIdentity) {
696                 if (ownIdentity == null) {
697                         logger.log(Level.WARNING, "Given OwnIdentity is null!");
698                         return null;
699                 }
700                 synchronized (localSones) {
701                         final Sone sone;
702                         try {
703                                 sone = getLocalSone(ownIdentity.getId()).setIdentity(ownIdentity).setInsertUri(new FreenetURI(ownIdentity.getInsertUri())).setRequestUri(new FreenetURI(ownIdentity.getRequestUri()));
704                         } catch (MalformedURLException mue1) {
705                                 logger.log(Level.SEVERE, "Could not convert the Identity’s URIs to Freenet URIs: " + ownIdentity.getInsertUri() + ", " + ownIdentity.getRequestUri(), mue1);
706                                 return null;
707                         }
708                         sone.setLatestEdition(Numbers.safeParseLong(ownIdentity.getProperty("Sone.LatestEdition"), (long) 0));
709                         sone.setClient(new Client("Sone", SonePlugin.VERSION.toString()));
710                         /* TODO - load posts ’n stuff */
711                         localSones.put(ownIdentity.getId(), sone);
712                         final SoneInserter soneInserter = new SoneInserter(this, freenetInterface, sone);
713                         soneInserters.put(sone, soneInserter);
714                         setSoneStatus(sone, SoneStatus.idle);
715                         loadSone(sone);
716                         if (!isSoneRescueMode()) {
717                                 soneInserter.start();
718                         }
719                         new Thread(new Runnable() {
720
721                                 @Override
722                                 @SuppressWarnings("synthetic-access")
723                                 public void run() {
724                                         if (!isSoneRescueMode()) {
725                                                 soneDownloader.fetchSone(sone);
726                                                 return;
727                                         }
728                                         logger.log(Level.INFO, "Trying to restore Sone from Freenet…");
729                                         coreListenerManager.fireRescuingSone(sone);
730                                         lockSone(sone);
731                                         long edition = sone.getLatestEdition();
732                                         while (!stopped && (edition >= 0) && isSoneRescueMode()) {
733                                                 logger.log(Level.FINE, "Downloading edition " + edition + "…");
734                                                 soneDownloader.fetchSone(sone, sone.getRequestUri().setKeyType("SSK").setDocName("Sone-" + edition));
735                                                 --edition;
736                                         }
737                                         logger.log(Level.INFO, "Finished restoring Sone from Freenet, starting Inserter…");
738                                         saveSone(sone);
739                                         coreListenerManager.fireRescuedSone(sone);
740                                         soneInserter.start();
741                                 }
742
743                         }, "Sone Downloader").start();
744                         return sone;
745                 }
746         }
747
748         /**
749          * Creates a new Sone for the given own identity.
750          *
751          * @param ownIdentity
752          *            The own identity to create a Sone for
753          * @return The created Sone
754          */
755         public Sone createSone(OwnIdentity ownIdentity) {
756                 identityManager.addContext(ownIdentity, "Sone");
757                 Sone sone = addLocalSone(ownIdentity);
758                 return sone;
759         }
760
761         /**
762          * Adds the Sone of the given identity.
763          *
764          * @param identity
765          *            The identity whose Sone to add
766          * @return The added or already existing Sone
767          */
768         public Sone addRemoteSone(Identity identity) {
769                 if (identity == null) {
770                         logger.log(Level.WARNING, "Given Identity is null!");
771                         return null;
772                 }
773                 synchronized (remoteSones) {
774                         final Sone sone = getRemoteSone(identity.getId()).setIdentity(identity);
775                         boolean newSone = sone.getRequestUri() == null;
776                         sone.setRequestUri(getSoneUri(identity.getRequestUri()));
777                         sone.setLatestEdition(Numbers.safeParseLong(identity.getProperty("Sone.LatestEdition"), (long) 0));
778                         if (newSone) {
779                                 synchronized (newSones) {
780                                         newSone = !knownSones.contains(sone.getId());
781                                         if (newSone) {
782                                                 newSones.add(sone.getId());
783                                         }
784                                 }
785                                 if (newSone) {
786                                         coreListenerManager.fireNewSoneFound(sone);
787                                 }
788                         }
789                         remoteSones.put(identity.getId(), sone);
790                         soneDownloader.addSone(sone);
791                         setSoneStatus(sone, SoneStatus.unknown);
792                         new Thread(new Runnable() {
793
794                                 @Override
795                                 @SuppressWarnings("synthetic-access")
796                                 public void run() {
797                                         soneDownloader.fetchSone(sone);
798                                 }
799
800                         }, "Sone Downloader").start();
801                         return sone;
802                 }
803         }
804
805         /**
806          * Updates the stores Sone with the given Sone.
807          *
808          * @param sone
809          *            The updated Sone
810          */
811         public void updateSone(Sone sone) {
812                 if (hasSone(sone.getId())) {
813                         boolean soneRescueMode = isLocalSone(sone) && isSoneRescueMode();
814                         Sone storedSone = getSone(sone.getId());
815                         if (!soneRescueMode && !(sone.getTime() > storedSone.getTime())) {
816                                 logger.log(Level.FINE, "Downloaded Sone %s is not newer than stored Sone %s.", new Object[] { sone, storedSone });
817                                 return;
818                         }
819                         synchronized (posts) {
820                                 if (!soneRescueMode) {
821                                         for (Post post : storedSone.getPosts()) {
822                                                 posts.remove(post.getId());
823                                         }
824                                 }
825                                 synchronized (newPosts) {
826                                         for (Post post : sone.getPosts()) {
827                                                 post.setSone(getSone(post.getSone().getId()));
828                                                 if (!storedSone.getPosts().contains(post) && !knownPosts.contains(post.getId())) {
829                                                         newPosts.add(post.getId());
830                                                         coreListenerManager.fireNewPostFound(post);
831                                                 }
832                                                 posts.put(post.getId(), post);
833                                         }
834                                 }
835                         }
836                         synchronized (replies) {
837                                 if (!soneRescueMode) {
838                                         for (Reply reply : storedSone.getReplies()) {
839                                                 replies.remove(reply.getId());
840                                         }
841                                 }
842                                 synchronized (newReplies) {
843                                         for (Reply reply : sone.getReplies()) {
844                                                 reply.setSone(getSone(reply.getSone().getId()));
845                                                 if (!storedSone.getReplies().contains(reply) && !knownReplies.contains(reply.getId())) {
846                                                         newReplies.add(reply.getId());
847                                                         coreListenerManager.fireNewReplyFound(reply);
848                                                 }
849                                                 replies.put(reply.getId(), reply);
850                                         }
851                                 }
852                         }
853                         synchronized (storedSone) {
854                                 storedSone.setTime(sone.getTime());
855                                 storedSone.setClient(sone.getClient());
856                                 storedSone.setProfile(sone.getProfile());
857                                 if (soneRescueMode) {
858                                         for (Post post : sone.getPosts()) {
859                                                 storedSone.addPost(post);
860                                         }
861                                         for (Reply reply : sone.getReplies()) {
862                                                 storedSone.addReply(reply);
863                                         }
864                                         for (String likedPostId : sone.getLikedPostIds()) {
865                                                 storedSone.addLikedPostId(likedPostId);
866                                         }
867                                         for (String likedReplyId : sone.getLikedReplyIds()) {
868                                                 storedSone.addLikedReplyId(likedReplyId);
869                                         }
870                                 } else {
871                                         storedSone.setPosts(sone.getPosts());
872                                         storedSone.setReplies(sone.getReplies());
873                                         storedSone.setLikePostIds(sone.getLikedPostIds());
874                                         storedSone.setLikeReplyIds(sone.getLikedReplyIds());
875                                 }
876                                 storedSone.setLatestEdition(sone.getRequestUri().getEdition());
877                         }
878                 }
879         }
880
881         /**
882          * Deletes the given Sone. This will remove the Sone from the
883          * {@link #getLocalSone(String) local Sones}, stops its {@link SoneInserter}
884          * and remove the context from its identity.
885          *
886          * @param sone
887          *            The Sone to delete
888          */
889         public void deleteSone(Sone sone) {
890                 if (!(sone.getIdentity() instanceof OwnIdentity)) {
891                         logger.log(Level.WARNING, "Tried to delete Sone of non-own identity: %s", sone);
892                         return;
893                 }
894                 synchronized (localSones) {
895                         if (!localSones.containsKey(sone.getId())) {
896                                 logger.log(Level.WARNING, "Tried to delete non-local Sone: %s", sone);
897                                 return;
898                         }
899                         localSones.remove(sone.getId());
900                         soneInserters.remove(sone).stop();
901                 }
902                 identityManager.removeContext((OwnIdentity) sone.getIdentity(), "Sone");
903                 identityManager.removeProperty((OwnIdentity) sone.getIdentity(), "Sone.LatestEdition");
904                 try {
905                         configuration.getLongValue("Sone/" + sone.getId() + "/Time").setValue(null);
906                 } catch (ConfigurationException ce1) {
907                         logger.log(Level.WARNING, "Could not remove Sone from configuration!", ce1);
908                 }
909         }
910
911         /**
912          * Loads and updates the given Sone from the configuration. If any error is
913          * encountered, loading is aborted and the given Sone is not changed.
914          *
915          * @param sone
916          *            The Sone to load and update
917          */
918         public void loadSone(Sone sone) {
919                 if (!isLocalSone(sone)) {
920                         logger.log(Level.FINE, "Tried to load non-local Sone: %s", sone);
921                         return;
922                 }
923
924                 /* load Sone. */
925                 String sonePrefix = "Sone/" + sone.getId();
926                 Long soneTime = configuration.getLongValue(sonePrefix + "/Time").getValue(null);
927                 if (soneTime == null) {
928                         logger.log(Level.INFO, "Could not load Sone because no Sone has been saved.");
929                         return;
930                 }
931                 String lastInsertFingerprint = configuration.getStringValue(sonePrefix + "/LastInsertFingerprint").getValue("");
932
933                 /* load profile. */
934                 Profile profile = new Profile();
935                 profile.setFirstName(configuration.getStringValue(sonePrefix + "/Profile/FirstName").getValue(null));
936                 profile.setMiddleName(configuration.getStringValue(sonePrefix + "/Profile/MiddleName").getValue(null));
937                 profile.setLastName(configuration.getStringValue(sonePrefix + "/Profile/LastName").getValue(null));
938                 profile.setBirthDay(configuration.getIntValue(sonePrefix + "/Profile/BirthDay").getValue(null));
939                 profile.setBirthMonth(configuration.getIntValue(sonePrefix + "/Profile/BirthMonth").getValue(null));
940                 profile.setBirthYear(configuration.getIntValue(sonePrefix + "/Profile/BirthYear").getValue(null));
941
942                 /* load posts. */
943                 Set<Post> posts = new HashSet<Post>();
944                 while (true) {
945                         String postPrefix = sonePrefix + "/Posts/" + posts.size();
946                         String postId = configuration.getStringValue(postPrefix + "/ID").getValue(null);
947                         if (postId == null) {
948                                 break;
949                         }
950                         long postTime = configuration.getLongValue(postPrefix + "/Time").getValue((long) 0);
951                         String postText = configuration.getStringValue(postPrefix + "/Text").getValue(null);
952                         if ((postTime == 0) || (postText == null)) {
953                                 logger.log(Level.WARNING, "Invalid post found, aborting load!");
954                                 return;
955                         }
956                         posts.add(getPost(postId).setSone(sone).setTime(postTime).setText(postText));
957                 }
958
959                 /* load replies. */
960                 Set<Reply> replies = new HashSet<Reply>();
961                 while (true) {
962                         String replyPrefix = sonePrefix + "/Replies/" + replies.size();
963                         String replyId = configuration.getStringValue(replyPrefix + "/ID").getValue(null);
964                         if (replyId == null) {
965                                 break;
966                         }
967                         String postId = configuration.getStringValue(replyPrefix + "/Post/ID").getValue(null);
968                         long replyTime = configuration.getLongValue(replyPrefix + "/Time").getValue((long) 0);
969                         String replyText = configuration.getStringValue(replyPrefix + "/Text").getValue(null);
970                         if ((postId == null) || (replyTime == 0) || (replyText == null)) {
971                                 logger.log(Level.WARNING, "Invalid reply found, aborting load!");
972                                 return;
973                         }
974                         replies.add(getReply(replyId).setSone(sone).setPost(getPost(postId)).setTime(replyTime).setText(replyText));
975                 }
976
977                 /* load post likes. */
978                 Set<String> likedPostIds = new HashSet<String>();
979                 while (true) {
980                         String likedPostId = configuration.getStringValue(sonePrefix + "/Likes/Post/" + likedPostIds.size() + "/ID").getValue(null);
981                         if (likedPostId == null) {
982                                 break;
983                         }
984                         likedPostIds.add(likedPostId);
985                 }
986
987                 /* load reply likes. */
988                 Set<String> likedReplyIds = new HashSet<String>();
989                 while (true) {
990                         String likedReplyId = configuration.getStringValue(sonePrefix + "/Likes/Reply/" + likedReplyIds.size() + "/ID").getValue(null);
991                         if (likedReplyId == null) {
992                                 break;
993                         }
994                         likedReplyIds.add(likedReplyId);
995                 }
996
997                 /* load friends. */
998                 Set<String> friends = new HashSet<String>();
999                 while (true) {
1000                         String friendId = configuration.getStringValue(sonePrefix + "/Friends/" + friends.size() + "/ID").getValue(null);
1001                         if (friendId == null) {
1002                                 break;
1003                         }
1004                         friends.add(friendId);
1005                 }
1006
1007                 /* if we’re still here, Sone was loaded successfully. */
1008                 synchronized (sone) {
1009                         sone.setTime(soneTime);
1010                         sone.setProfile(profile);
1011                         sone.setPosts(posts);
1012                         sone.setReplies(replies);
1013                         sone.setLikePostIds(likedPostIds);
1014                         sone.setLikeReplyIds(likedReplyIds);
1015                         sone.setFriends(friends);
1016                         soneInserters.get(sone).setLastInsertFingerprint(lastInsertFingerprint);
1017                 }
1018                 synchronized (newSones) {
1019                         for (String friend : friends) {
1020                                 knownSones.add(friend);
1021                         }
1022                 }
1023                 synchronized (newPosts) {
1024                         for (Post post : posts) {
1025                                 knownPosts.add(post.getId());
1026                         }
1027                 }
1028                 synchronized (newReplies) {
1029                         for (Reply reply : replies) {
1030                                 knownReplies.add(reply.getId());
1031                         }
1032                 }
1033         }
1034
1035         /**
1036          * Saves the given Sone. This will persist all local settings for the given
1037          * Sone, such as the friends list and similar, private options.
1038          *
1039          * @param sone
1040          *            The Sone to save
1041          */
1042         public void saveSone(Sone sone) {
1043                 if (!isLocalSone(sone)) {
1044                         logger.log(Level.FINE, "Tried to save non-local Sone: %s", sone);
1045                         return;
1046                 }
1047                 if (!(sone.getIdentity() instanceof OwnIdentity)) {
1048                         logger.log(Level.WARNING, "Local Sone without OwnIdentity found, refusing to save: %s", sone);
1049                         return;
1050                 }
1051
1052                 logger.log(Level.INFO, "Saving Sone: %s", sone);
1053                 identityManager.setProperty((OwnIdentity) sone.getIdentity(), "Sone.LatestEdition", String.valueOf(sone.getLatestEdition()));
1054                 try {
1055                         /* save Sone into configuration. */
1056                         String sonePrefix = "Sone/" + sone.getId();
1057                         configuration.getLongValue(sonePrefix + "/Time").setValue(sone.getTime());
1058                         configuration.getStringValue(sonePrefix + "/LastInsertFingerprint").setValue(soneInserters.get(sone).getLastInsertFingerprint());
1059
1060                         /* save profile. */
1061                         Profile profile = sone.getProfile();
1062                         configuration.getStringValue(sonePrefix + "/Profile/FirstName").setValue(profile.getFirstName());
1063                         configuration.getStringValue(sonePrefix + "/Profile/MiddleName").setValue(profile.getMiddleName());
1064                         configuration.getStringValue(sonePrefix + "/Profile/LastName").setValue(profile.getLastName());
1065                         configuration.getIntValue(sonePrefix + "/Profile/BirthDay").setValue(profile.getBirthDay());
1066                         configuration.getIntValue(sonePrefix + "/Profile/BirthMonth").setValue(profile.getBirthMonth());
1067                         configuration.getIntValue(sonePrefix + "/Profile/BirthYear").setValue(profile.getBirthYear());
1068
1069                         /* save posts. */
1070                         int postCounter = 0;
1071                         for (Post post : sone.getPosts()) {
1072                                 String postPrefix = sonePrefix + "/Posts/" + postCounter++;
1073                                 configuration.getStringValue(postPrefix + "/ID").setValue(post.getId());
1074                                 configuration.getLongValue(postPrefix + "/Time").setValue(post.getTime());
1075                                 configuration.getStringValue(postPrefix + "/Text").setValue(post.getText());
1076                         }
1077                         configuration.getStringValue(sonePrefix + "/Posts/" + postCounter + "/ID").setValue(null);
1078
1079                         /* save replies. */
1080                         int replyCounter = 0;
1081                         for (Reply reply : sone.getReplies()) {
1082                                 String replyPrefix = sonePrefix + "/Replies/" + replyCounter++;
1083                                 configuration.getStringValue(replyPrefix + "/ID").setValue(reply.getId());
1084                                 configuration.getStringValue(replyPrefix + "/Post/ID").setValue(reply.getPost().getId());
1085                                 configuration.getLongValue(replyPrefix + "/Time").setValue(reply.getTime());
1086                                 configuration.getStringValue(replyPrefix + "/Text").setValue(reply.getText());
1087                         }
1088                         configuration.getStringValue(sonePrefix + "/Replies/" + replyCounter + "/ID").setValue(null);
1089
1090                         /* save post likes. */
1091                         int postLikeCounter = 0;
1092                         for (String postId : sone.getLikedPostIds()) {
1093                                 configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter++ + "/ID").setValue(postId);
1094                         }
1095                         configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter + "/ID").setValue(null);
1096
1097                         /* save reply likes. */
1098                         int replyLikeCounter = 0;
1099                         for (String replyId : sone.getLikedReplyIds()) {
1100                                 configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter++ + "/ID").setValue(replyId);
1101                         }
1102                         configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter + "/ID").setValue(null);
1103
1104                         /* save friends. */
1105                         int friendCounter = 0;
1106                         for (String friendId : sone.getFriends()) {
1107                                 configuration.getStringValue(sonePrefix + "/Friends/" + friendCounter++ + "/ID").setValue(friendId);
1108                         }
1109                         configuration.getStringValue(sonePrefix + "/Friends/" + friendCounter + "/ID").setValue(null);
1110
1111                         logger.log(Level.INFO, "Sone %s saved.", sone);
1112                 } catch (ConfigurationException ce1) {
1113                         logger.log(Level.WARNING, "Could not save Sone: " + sone, ce1);
1114                 }
1115         }
1116
1117         /**
1118          * Creates a new post.
1119          *
1120          * @param sone
1121          *            The Sone that creates the post
1122          * @param text
1123          *            The text of the post
1124          */
1125         public void createPost(Sone sone, String text) {
1126                 createPost(sone, System.currentTimeMillis(), text);
1127         }
1128
1129         /**
1130          * Creates a new post.
1131          *
1132          * @param sone
1133          *            The Sone that creates the post
1134          * @param time
1135          *            The time of the post
1136          * @param text
1137          *            The text of the post
1138          */
1139         public void createPost(Sone sone, long time, String text) {
1140                 if (!isLocalSone(sone)) {
1141                         logger.log(Level.FINE, "Tried to create post for non-local Sone: %s", sone);
1142                         return;
1143                 }
1144                 Post post = new Post(sone, time, text);
1145                 synchronized (posts) {
1146                         posts.put(post.getId(), post);
1147                 }
1148                 synchronized (newPosts) {
1149                         knownPosts.add(post.getId());
1150                 }
1151                 sone.addPost(post);
1152                 saveSone(sone);
1153         }
1154
1155         /**
1156          * Deletes the given post.
1157          *
1158          * @param post
1159          *            The post to delete
1160          */
1161         public void deletePost(Post post) {
1162                 if (!isLocalSone(post.getSone())) {
1163                         logger.log(Level.WARNING, "Tried to delete post of non-local Sone: %s", post.getSone());
1164                         return;
1165                 }
1166                 post.getSone().removePost(post);
1167                 synchronized (posts) {
1168                         posts.remove(post.getId());
1169                 }
1170                 saveSone(post.getSone());
1171         }
1172
1173         /**
1174          * Creates a new reply.
1175          *
1176          * @param sone
1177          *            The Sone that creates the reply
1178          * @param post
1179          *            The post that this reply refers to
1180          * @param text
1181          *            The text of the reply
1182          * @return The created reply
1183          */
1184         public Reply createReply(Sone sone, Post post, String text) {
1185                 return createReply(sone, post, System.currentTimeMillis(), text);
1186         }
1187
1188         /**
1189          * Creates a new reply.
1190          *
1191          * @param sone
1192          *            The Sone that creates the reply
1193          * @param post
1194          *            The post that this reply refers to
1195          * @param time
1196          *            The time of the reply
1197          * @param text
1198          *            The text of the reply
1199          * @return The created reply
1200          */
1201         public Reply createReply(Sone sone, Post post, long time, String text) {
1202                 if (!isLocalSone(sone)) {
1203                         logger.log(Level.FINE, "Tried to create reply for non-local Sone: %s", sone);
1204                         return null;
1205                 }
1206                 Reply reply = new Reply(sone, post, System.currentTimeMillis(), text);
1207                 synchronized (replies) {
1208                         replies.put(reply.getId(), reply);
1209                 }
1210                 synchronized (newReplies) {
1211                         knownReplies.add(reply.getId());
1212                 }
1213                 sone.addReply(reply);
1214                 saveSone(sone);
1215                 return reply;
1216         }
1217
1218         /**
1219          * Deletes the given reply.
1220          *
1221          * @param reply
1222          *            The reply to delete
1223          */
1224         public void deleteReply(Reply reply) {
1225                 Sone sone = reply.getSone();
1226                 if (!isLocalSone(sone)) {
1227                         logger.log(Level.FINE, "Tried to delete non-local reply: %s", reply);
1228                         return;
1229                 }
1230                 synchronized (replies) {
1231                         replies.remove(reply.getId());
1232                 }
1233                 sone.removeReply(reply);
1234                 saveSone(sone);
1235         }
1236
1237         /**
1238          * Starts the core.
1239          */
1240         public void start() {
1241                 loadConfiguration();
1242         }
1243
1244         /**
1245          * Stops the core.
1246          */
1247         public void stop() {
1248                 synchronized (localSones) {
1249                         for (SoneInserter soneInserter : soneInserters.values()) {
1250                                 soneInserter.stop();
1251                         }
1252                 }
1253                 saveConfiguration();
1254                 stopped = true;
1255         }
1256
1257         //
1258         // PRIVATE METHODS
1259         //
1260
1261         /**
1262          * Loads the configuration.
1263          */
1264         @SuppressWarnings("unchecked")
1265         private void loadConfiguration() {
1266                 /* create options. */
1267                 options.addIntegerOption("InsertionDelay", new DefaultOption<Integer>(60, new OptionWatcher<Integer>() {
1268
1269                         @Override
1270                         public void optionChanged(Option<Integer> option, Integer oldValue, Integer newValue) {
1271                                 SoneInserter.setInsertionDelay(newValue);
1272                         }
1273
1274                 }));
1275                 options.addBooleanOption("SoneRescueMode", new DefaultOption<Boolean>(false));
1276                 options.addBooleanOption("ClearOnNextRestart", new DefaultOption<Boolean>(false));
1277                 options.addBooleanOption("ReallyClearOnNextRestart", new DefaultOption<Boolean>(false));
1278
1279                 /* read options from configuration. */
1280                 options.getBooleanOption("ClearOnNextRestart").set(configuration.getBooleanValue("Option/ClearOnNextRestart").getValue(null));
1281                 options.getBooleanOption("ReallyClearOnNextRestart").set(configuration.getBooleanValue("Option/ReallyClearOnNextRestart").getValue(null));
1282                 boolean clearConfiguration = options.getBooleanOption("ClearOnNextRestart").get() && options.getBooleanOption("ReallyClearOnNextRestart").get();
1283                 options.getBooleanOption("ClearOnNextRestart").set(null);
1284                 options.getBooleanOption("ReallyClearOnNextRestart").set(null);
1285                 if (clearConfiguration) {
1286                         /* stop loading the configuration. */
1287                         return;
1288                 }
1289
1290                 options.getIntegerOption("InsertionDelay").set(configuration.getIntValue("Option/InsertionDelay").getValue(null));
1291                 options.getBooleanOption("SoneRescueMode").set(configuration.getBooleanValue("Option/SoneRescueMode").getValue(null));
1292
1293                 /* load known Sones. */
1294                 int soneCounter = 0;
1295                 while (true) {
1296                         String knownSoneId = configuration.getStringValue("KnownSone/" + soneCounter++ + "/ID").getValue(null);
1297                         if (knownSoneId == null) {
1298                                 break;
1299                         }
1300                         synchronized (newSones) {
1301                                 knownSones.add(knownSoneId);
1302                         }
1303                 }
1304
1305                 /* load known posts. */
1306                 int postCounter = 0;
1307                 while (true) {
1308                         String knownPostId = configuration.getStringValue("KnownPosts/" + postCounter++ + "/ID").getValue(null);
1309                         if (knownPostId == null) {
1310                                 break;
1311                         }
1312                         synchronized (newPosts) {
1313                                 knownPosts.add(knownPostId);
1314                         }
1315                 }
1316
1317                 /* load known replies. */
1318                 int replyCounter = 0;
1319                 while (true) {
1320                         String knownReplyId = configuration.getStringValue("KnownReplies/" + replyCounter++ + "/ID").getValue(null);
1321                         if (knownReplyId == null) {
1322                                 break;
1323                         }
1324                         synchronized (newReplies) {
1325                                 knownReplies.add(knownReplyId);
1326                         }
1327                 }
1328
1329         }
1330
1331         /**
1332          * Saves the current options.
1333          */
1334         private void saveConfiguration() {
1335                 /* store the options first. */
1336                 try {
1337                         configuration.getIntValue("Option/InsertionDelay").setValue(options.getIntegerOption("InsertionDelay").getReal());
1338                         configuration.getBooleanValue("Option/SoneRescueMode").setValue(options.getBooleanOption("SoneRescueMode").getReal());
1339                         configuration.getBooleanValue("Option/ClearOnNextRestart").setValue(options.getBooleanOption("ClearOnNextRestart").getReal());
1340                         configuration.getBooleanValue("Option/ReallyClearOnNextRestart").setValue(options.getBooleanOption("ReallyClearOnNextRestart").getReal());
1341
1342                         /* save known Sones. */
1343                         int soneCounter = 0;
1344                         synchronized (newSones) {
1345                                 for (String knownSoneId : knownSones) {
1346                                         configuration.getStringValue("KnownSone/" + soneCounter++ + "/ID").setValue(knownSoneId);
1347                                 }
1348                                 configuration.getStringValue("KnownSone/" + soneCounter + "/ID").setValue(null);
1349                         }
1350
1351                         /* save known posts. */
1352                         int postCounter = 0;
1353                         synchronized (newPosts) {
1354                                 for (String knownPostId : knownPosts) {
1355                                         configuration.getStringValue("KnownPosts/" + postCounter++ + "/ID").setValue(knownPostId);
1356                                 }
1357                                 configuration.getStringValue("KnownPosts/" + postCounter + "/ID").setValue(null);
1358                         }
1359
1360                         /* save known replies. */
1361                         int replyCounter = 0;
1362                         synchronized (newReplies) {
1363                                 for (String knownReplyId : knownReplies) {
1364                                         configuration.getStringValue("KnownReplies/" + replyCounter++ + "/ID").setValue(knownReplyId);
1365                                 }
1366                                 configuration.getStringValue("KnownReplies/" + replyCounter + "/ID").setValue(null);
1367                         }
1368
1369                 } catch (ConfigurationException ce1) {
1370                         logger.log(Level.SEVERE, "Could not store configuration!", ce1);
1371                 }
1372         }
1373
1374         /**
1375          * Generate a Sone URI from the given URI and latest edition.
1376          *
1377          * @param uriString
1378          *            The URI to derive the Sone URI from
1379          * @return The derived URI
1380          */
1381         private FreenetURI getSoneUri(String uriString) {
1382                 try {
1383                         FreenetURI uri = new FreenetURI(uriString).setDocName("Sone").setMetaString(new String[0]);
1384                         return uri;
1385                 } catch (MalformedURLException mue1) {
1386                         logger.log(Level.WARNING, "Could not create Sone URI from URI: " + uriString, mue1);
1387                         return null;
1388                 }
1389         }
1390
1391         //
1392         // INTERFACE IdentityListener
1393         //
1394
1395         /**
1396          * {@inheritDoc}
1397          */
1398         @Override
1399         public void ownIdentityAdded(OwnIdentity ownIdentity) {
1400                 logger.log(Level.FINEST, "Adding OwnIdentity: " + ownIdentity);
1401                 if (ownIdentity.hasContext("Sone")) {
1402                         addLocalSone(ownIdentity);
1403                 }
1404         }
1405
1406         /**
1407          * {@inheritDoc}
1408          */
1409         @Override
1410         public void ownIdentityRemoved(OwnIdentity ownIdentity) {
1411                 logger.log(Level.FINEST, "Removing OwnIdentity: " + ownIdentity);
1412         }
1413
1414         /**
1415          * {@inheritDoc}
1416          */
1417         @Override
1418         public void identityAdded(Identity identity) {
1419                 logger.log(Level.FINEST, "Adding Identity: " + identity);
1420                 addRemoteSone(identity);
1421         }
1422
1423         /**
1424          * {@inheritDoc}
1425          */
1426         @Override
1427         public void identityUpdated(final Identity identity) {
1428                 new Thread(new Runnable() {
1429
1430                         @Override
1431                         @SuppressWarnings("synthetic-access")
1432                         public void run() {
1433                                 Sone sone = getRemoteSone(identity.getId());
1434                                 soneDownloader.fetchSone(sone);
1435                         }
1436                 }).start();
1437         }
1438
1439         /**
1440          * {@inheritDoc}
1441          */
1442         @Override
1443         public void identityRemoved(Identity identity) {
1444                 /* TODO */
1445         }
1446
1447 }