2 * Sone - Core.java - Copyright © 2010 David Roden
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.
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.
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/>.
18 package net.pterodactylus.sone.core;
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;
28 import java.util.logging.Level;
29 import java.util.logging.Logger;
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.Album;
35 import net.pterodactylus.sone.data.Client;
36 import net.pterodactylus.sone.data.Image;
37 import net.pterodactylus.sone.data.Post;
38 import net.pterodactylus.sone.data.Profile;
39 import net.pterodactylus.sone.data.Profile.Field;
40 import net.pterodactylus.sone.data.Reply;
41 import net.pterodactylus.sone.data.Sone;
42 import net.pterodactylus.sone.data.TemporaryImage;
43 import net.pterodactylus.sone.freenet.wot.Identity;
44 import net.pterodactylus.sone.freenet.wot.IdentityListener;
45 import net.pterodactylus.sone.freenet.wot.IdentityManager;
46 import net.pterodactylus.sone.freenet.wot.OwnIdentity;
47 import net.pterodactylus.sone.freenet.wot.Trust;
48 import net.pterodactylus.sone.freenet.wot.WebOfTrustException;
49 import net.pterodactylus.sone.main.SonePlugin;
50 import net.pterodactylus.util.config.Configuration;
51 import net.pterodactylus.util.config.ConfigurationException;
52 import net.pterodactylus.util.logging.Logging;
53 import net.pterodactylus.util.number.Numbers;
54 import net.pterodactylus.util.validation.Validation;
55 import net.pterodactylus.util.version.Version;
56 import freenet.keys.FreenetURI;
61 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
63 public class Core implements IdentityListener, UpdateListener, ImageInsertListener {
66 * Enumeration for the possible states of a {@link Sone}.
68 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
70 public enum SoneStatus {
72 /** The Sone is unknown, i.e. not yet downloaded. */
75 /** The Sone is idle, i.e. not being downloaded or inserted. */
78 /** The Sone is currently being inserted. */
81 /** The Sone is currently being downloaded. */
86 private static final Logger logger = Logging.getLogger(Core.class);
89 private final Options options = new Options();
91 /** The preferences. */
92 private final Preferences preferences = new Preferences(options);
94 /** The core listener manager. */
95 private final CoreListenerManager coreListenerManager = new CoreListenerManager(this);
97 /** The configuration. */
98 private Configuration configuration;
100 /** Whether we’re currently saving the configuration. */
101 private boolean storingConfiguration = false;
103 /** The identity manager. */
104 private final IdentityManager identityManager;
106 /** Interface to freenet. */
107 private final FreenetInterface freenetInterface;
109 /** The Sone downloader. */
110 private final SoneDownloader soneDownloader;
112 /** The image inserter. */
113 private final ImageInserter imageInserter;
115 /** The update checker. */
116 private final UpdateChecker updateChecker;
118 /** Whether the core has been stopped. */
119 private volatile boolean stopped;
121 /** The Sones’ statuses. */
122 /* synchronize access on itself. */
123 private final Map<Sone, SoneStatus> soneStatuses = new HashMap<Sone, SoneStatus>();
125 /** Locked local Sones. */
126 /* synchronize on itself. */
127 private final Set<Sone> lockedSones = new HashSet<Sone>();
129 /** Sone inserters. */
130 /* synchronize access on this on localSones. */
131 private final Map<Sone, SoneInserter> soneInserters = new HashMap<Sone, SoneInserter>();
133 /** All local Sones. */
134 /* synchronize access on this on itself. */
135 private Map<String, Sone> localSones = new HashMap<String, Sone>();
137 /** All remote Sones. */
138 /* synchronize access on this on itself. */
139 private Map<String, Sone> remoteSones = new HashMap<String, Sone>();
141 /** All new Sones. */
142 private Set<String> newSones = new HashSet<String>();
144 /** All known Sones. */
145 /* synchronize access on {@link #newSones}. */
146 private Set<String> knownSones = new HashSet<String>();
149 private Map<String, Post> posts = new HashMap<String, Post>();
151 /** All new posts. */
152 private Set<String> newPosts = new HashSet<String>();
154 /** All known posts. */
155 /* synchronize access on {@link #newPosts}. */
156 private Set<String> knownPosts = new HashSet<String>();
159 private Map<String, Reply> replies = new HashMap<String, Reply>();
161 /** All new replies. */
162 private Set<String> newReplies = new HashSet<String>();
164 /** All known replies. */
165 private Set<String> knownReplies = new HashSet<String>();
167 /** All bookmarked posts. */
168 /* synchronize access on itself. */
169 private Set<String> bookmarkedPosts = new HashSet<String>();
171 /** Trusted identities, sorted by own identities. */
172 private Map<OwnIdentity, Set<Identity>> trustedIdentities = Collections.synchronizedMap(new HashMap<OwnIdentity, Set<Identity>>());
174 /** All known albums. */
175 private Map<String, Album> albums = new HashMap<String, Album>();
177 /** All known images. */
178 private Map<String, Image> images = new HashMap<String, Image>();
180 /** All temporary images. */
181 private Map<String, TemporaryImage> temporaryImages = new HashMap<String, TemporaryImage>();
184 * Creates a new core.
186 * @param configuration
187 * The configuration of the core
188 * @param freenetInterface
189 * The freenet interface
190 * @param identityManager
191 * The identity manager
193 public Core(Configuration configuration, FreenetInterface freenetInterface, IdentityManager identityManager) {
194 this.configuration = configuration;
195 this.freenetInterface = freenetInterface;
196 this.identityManager = identityManager;
197 this.soneDownloader = new SoneDownloader(this, freenetInterface);
198 this.imageInserter = new ImageInserter(this, freenetInterface);
199 this.updateChecker = new UpdateChecker(freenetInterface);
203 // LISTENER MANAGEMENT
207 * Adds a new core listener.
209 * @param coreListener
210 * The listener to add
212 public void addCoreListener(CoreListener coreListener) {
213 coreListenerManager.addListener(coreListener);
217 * Removes a core listener.
219 * @param coreListener
220 * The listener to remove
222 public void removeCoreListener(CoreListener coreListener) {
223 coreListenerManager.removeListener(coreListener);
231 * Sets the configuration to use. This will automatically save the current
232 * configuration to the given configuration.
234 * @param configuration
235 * The new configuration to use
237 public void setConfiguration(Configuration configuration) {
238 this.configuration = configuration;
243 * Returns the options used by the core.
245 * @return The options of the core
247 public Preferences getPreferences() {
252 * Returns the identity manager used by the core.
254 * @return The identity manager
256 public IdentityManager getIdentityManager() {
257 return identityManager;
261 * Returns the update checker.
263 * @return The update checker
265 public UpdateChecker getUpdateChecker() {
266 return updateChecker;
270 * Returns the status of the given Sone.
273 * The Sone to get the status for
274 * @return The status of the Sone
276 public SoneStatus getSoneStatus(Sone sone) {
277 synchronized (soneStatuses) {
278 return soneStatuses.get(sone);
283 * Sets the status of the given Sone.
286 * The Sone to set the status of
290 public void setSoneStatus(Sone sone, SoneStatus soneStatus) {
291 synchronized (soneStatuses) {
292 soneStatuses.put(sone, soneStatus);
297 * Returns whether the given Sone is currently locked.
301 * @return {@code true} if the Sone is locked, {@code false} if it is not
303 public boolean isLocked(Sone sone) {
304 synchronized (lockedSones) {
305 return lockedSones.contains(sone);
310 * Returns all Sones, remote and local.
314 public Set<Sone> getSones() {
315 Set<Sone> allSones = new HashSet<Sone>();
316 allSones.addAll(getLocalSones());
317 allSones.addAll(getRemoteSones());
322 * Returns the Sone with the given ID, regardless whether it’s local or
326 * The ID of the Sone to get
327 * @return The Sone with the given ID, or {@code null} if there is no such
330 public Sone getSone(String id) {
331 return getSone(id, true);
335 * Returns the Sone with the given ID, regardless whether it’s local or
339 * The ID of the Sone to get
341 * {@code true} to create a new Sone if none exists,
342 * {@code false} to return {@code null} if a Sone with the given
344 * @return The Sone with the given ID, or {@code null} if there is no such
347 public Sone getSone(String id, boolean create) {
348 if (isLocalSone(id)) {
349 return getLocalSone(id);
351 return getRemoteSone(id, create);
355 * Checks whether the core knows a Sone with the given ID.
359 * @return {@code true} if there is a Sone with the given ID, {@code false}
362 public boolean hasSone(String id) {
363 return isLocalSone(id) || isRemoteSone(id);
367 * Returns whether the given Sone is a local Sone.
370 * The Sone to check for its locality
371 * @return {@code true} if the given Sone is local, {@code false} otherwise
373 public boolean isLocalSone(Sone sone) {
374 synchronized (localSones) {
375 return localSones.containsKey(sone.getId());
380 * Returns whether the given ID is the ID of a local Sone.
383 * The Sone ID to check for its locality
384 * @return {@code true} if the given ID is a local Sone, {@code false}
387 public boolean isLocalSone(String id) {
388 synchronized (localSones) {
389 return localSones.containsKey(id);
394 * Returns all local Sones.
396 * @return All local Sones
398 public Set<Sone> getLocalSones() {
399 synchronized (localSones) {
400 return new HashSet<Sone>(localSones.values());
405 * Returns the local Sone with the given ID.
408 * The ID of the Sone to get
409 * @return The Sone with the given ID
411 public Sone getLocalSone(String id) {
412 return getLocalSone(id, true);
416 * Returns the local Sone with the given ID, optionally creating a new Sone.
421 * {@code true} to create a new Sone if none exists,
422 * {@code false} to return null if none exists
423 * @return The Sone with the given ID, or {@code null}
425 public Sone getLocalSone(String id, boolean create) {
426 synchronized (localSones) {
427 Sone sone = localSones.get(id);
428 if ((sone == null) && create) {
430 localSones.put(id, sone);
431 setSoneStatus(sone, SoneStatus.unknown);
438 * Returns all remote Sones.
440 * @return All remote Sones
442 public Set<Sone> getRemoteSones() {
443 synchronized (remoteSones) {
444 return new HashSet<Sone>(remoteSones.values());
449 * Returns the remote Sone with the given ID.
452 * The ID of the remote Sone to get
453 * @return The Sone with the given ID
455 public Sone getRemoteSone(String id) {
456 return getRemoteSone(id, true);
460 * Returns the remote Sone with the given ID.
463 * The ID of the remote Sone to get
465 * {@code true} to always create a Sone, {@code false} to return
466 * {@code null} if no Sone with the given ID exists
467 * @return The Sone with the given ID
469 public Sone getRemoteSone(String id, boolean create) {
470 synchronized (remoteSones) {
471 Sone sone = remoteSones.get(id);
472 if ((sone == null) && create) {
474 remoteSones.put(id, sone);
475 setSoneStatus(sone, SoneStatus.unknown);
482 * Returns whether the given Sone is a remote Sone.
486 * @return {@code true} if the given Sone is a remote Sone, {@code false}
489 public boolean isRemoteSone(Sone sone) {
490 synchronized (remoteSones) {
491 return remoteSones.containsKey(sone.getId());
496 * Returns whether the Sone with the given ID is a remote Sone.
499 * The ID of the Sone to check
500 * @return {@code true} if the Sone with the given ID is a remote Sone,
501 * {@code false} otherwise
503 public boolean isRemoteSone(String id) {
504 synchronized (remoteSones) {
505 return remoteSones.containsKey(id);
510 * Returns whether the Sone with the given ID is a new Sone.
513 * The ID of the sone to check for
514 * @return {@code true} if the given Sone is new, false otherwise
516 public boolean isNewSone(String soneId) {
517 synchronized (newSones) {
518 return !knownSones.contains(soneId) && newSones.contains(soneId);
523 * Returns whether the given Sone has been modified.
526 * The Sone to check for modifications
527 * @return {@code true} if a modification has been detected in the Sone,
528 * {@code false} otherwise
530 public boolean isModifiedSone(Sone sone) {
531 return (soneInserters.containsKey(sone)) ? soneInserters.get(sone).isModified() : false;
535 * Returns whether the target Sone is trusted by the origin Sone.
541 * @return {@code true} if the target Sone is trusted by the origin Sone
543 public boolean isSoneTrusted(Sone origin, Sone target) {
544 Validation.begin().isNotNull("Origin", origin).isNotNull("Target", target).check().isInstanceOf("Origin’s OwnIdentity", origin.getIdentity(), OwnIdentity.class).check();
545 return trustedIdentities.containsKey(origin.getIdentity()) && trustedIdentities.get(origin.getIdentity()).contains(target.getIdentity());
549 * Returns the post with the given ID.
552 * The ID of the post to get
553 * @return The post with the given ID, or a new post with the given ID
555 public Post getPost(String postId) {
556 return getPost(postId, true);
560 * Returns the post with the given ID, optionally creating a new post.
563 * The ID of the post to get
565 * {@code true} it create a new post if no post with the given ID
566 * exists, {@code false} to return {@code null}
567 * @return The post, or {@code null} if there is no such post
569 public Post getPost(String postId, boolean create) {
570 synchronized (posts) {
571 Post post = posts.get(postId);
572 if ((post == null) && create) {
573 post = new Post(postId);
574 posts.put(postId, post);
581 * Returns whether the given post ID is new.
585 * @return {@code true} if the post is considered to be new, {@code false}
588 public boolean isNewPost(String postId) {
589 synchronized (newPosts) {
590 return !knownPosts.contains(postId) && newPosts.contains(postId);
595 * Returns all posts that have the given Sone as recipient.
597 * @see Post#getRecipient()
599 * The recipient of the posts
600 * @return All posts that have the given Sone as recipient
602 public Set<Post> getDirectedPosts(Sone recipient) {
603 Validation.begin().isNotNull("Recipient", recipient).check();
604 Set<Post> directedPosts = new HashSet<Post>();
605 synchronized (posts) {
606 for (Post post : posts.values()) {
607 if (recipient.equals(post.getRecipient())) {
608 directedPosts.add(post);
612 return directedPosts;
616 * Returns the reply with the given ID. If there is no reply with the given
617 * ID yet, a new one is created.
620 * The ID of the reply to get
623 public Reply getReply(String replyId) {
624 return getReply(replyId, true);
628 * Returns the reply with the given ID. If there is no reply with the given
629 * ID yet, a new one is created, unless {@code create} is false in which
630 * case {@code null} is returned.
633 * The ID of the reply to get
635 * {@code true} to always return a {@link Reply}, {@code false}
636 * to return {@code null} if no reply can be found
637 * @return The reply, or {@code null} if there is no such reply
639 public Reply getReply(String replyId, boolean create) {
640 synchronized (replies) {
641 Reply reply = replies.get(replyId);
642 if (create && (reply == null)) {
643 reply = new Reply(replyId);
644 replies.put(replyId, reply);
651 * Returns all replies for the given post, order ascending by time.
654 * The post to get all replies for
655 * @return All replies for the given post
657 public List<Reply> getReplies(Post post) {
658 Set<Sone> sones = getSones();
659 List<Reply> replies = new ArrayList<Reply>();
660 for (Sone sone : sones) {
661 for (Reply reply : sone.getReplies()) {
662 if (reply.getPost().equals(post)) {
667 Collections.sort(replies, Reply.TIME_COMPARATOR);
672 * Returns whether the reply with the given ID is new.
675 * The ID of the reply to check
676 * @return {@code true} if the reply is considered to be new, {@code false}
679 public boolean isNewReply(String replyId) {
680 synchronized (newReplies) {
681 return !knownReplies.contains(replyId) && newReplies.contains(replyId);
686 * Returns all Sones that have liked the given post.
689 * The post to get the liking Sones for
690 * @return The Sones that like the given post
692 public Set<Sone> getLikes(Post post) {
693 Set<Sone> sones = new HashSet<Sone>();
694 for (Sone sone : getSones()) {
695 if (sone.getLikedPostIds().contains(post.getId())) {
703 * Returns all Sones that have liked the given reply.
706 * The reply to get the liking Sones for
707 * @return The Sones that like the given reply
709 public Set<Sone> getLikes(Reply reply) {
710 Set<Sone> sones = new HashSet<Sone>();
711 for (Sone sone : getSones()) {
712 if (sone.getLikedReplyIds().contains(reply.getId())) {
720 * Returns whether the given post is bookmarked.
724 * @return {@code true} if the given post is bookmarked, {@code false}
727 public boolean isBookmarked(Post post) {
728 return isPostBookmarked(post.getId());
732 * Returns whether the post with the given ID is bookmarked.
735 * The ID of the post to check
736 * @return {@code true} if the post with the given ID is bookmarked,
737 * {@code false} otherwise
739 public boolean isPostBookmarked(String id) {
740 synchronized (bookmarkedPosts) {
741 return bookmarkedPosts.contains(id);
746 * Returns all currently known bookmarked posts.
748 * @return All bookmarked posts
750 public Set<Post> getBookmarkedPosts() {
751 Set<Post> posts = new HashSet<Post>();
752 synchronized (bookmarkedPosts) {
753 for (String bookmarkedPostId : bookmarkedPosts) {
754 Post post = getPost(bookmarkedPostId, false);
764 * Returns the album with the given ID, creating a new album if no album
765 * with the given ID can be found.
768 * The ID of the album
769 * @return The album with the given ID
771 public Album getAlbum(String albumId) {
772 return getAlbum(albumId, true);
776 * Returns the album with the given ID, optionally creating a new album if
777 * an album with the given ID can not be found.
780 * The ID of the album
782 * {@code true} to create a new album if none exists for the
784 * @return The album with the given ID, or {@code null} if no album with the
785 * given ID exists and {@code create} is {@code false}
787 public Album getAlbum(String albumId, boolean create) {
788 synchronized (albums) {
789 Album album = albums.get(albumId);
790 if (create && (album == null)) {
791 album = new Album(albumId);
792 albums.put(albumId, album);
799 * Returns the image with the given ID, creating it if necessary.
802 * The ID of the image
803 * @return The image with the given ID
805 public Image getImage(String imageId) {
806 return getImage(imageId, true);
810 * Returns the image with the given ID, optionally creating it if it does
814 * The ID of the image
816 * {@code true} to create an image if none exists with the given
818 * @return The image with the given ID, or {@code null} if none exists and
821 public Image getImage(String imageId, boolean create) {
822 synchronized (images) {
823 Image image = images.get(imageId);
824 if (create && (image == null)) {
825 image = new Image(imageId);
826 images.put(imageId, image);
833 * Returns the temporary image with the given ID.
836 * The ID of the temporary image
837 * @return The temporary image, or {@code null} if there is no temporary
838 * image with the given ID
840 public TemporaryImage getTemporaryImage(String imageId) {
841 synchronized (temporaryImages) {
842 return temporaryImages.get(imageId);
851 * Locks the given Sone. A locked Sone will not be inserted by
852 * {@link SoneInserter} until it is {@link #unlockSone(Sone) unlocked}
858 public void lockSone(Sone sone) {
859 synchronized (lockedSones) {
860 if (lockedSones.add(sone)) {
861 coreListenerManager.fireSoneLocked(sone);
867 * Unlocks the given Sone.
869 * @see #lockSone(Sone)
873 public void unlockSone(Sone sone) {
874 synchronized (lockedSones) {
875 if (lockedSones.remove(sone)) {
876 coreListenerManager.fireSoneUnlocked(sone);
882 * Adds a local Sone from the given ID which has to be the ID of an own
886 * The ID of an own identity to add a Sone for
887 * @return The added (or already existing) Sone
889 public Sone addLocalSone(String id) {
890 synchronized (localSones) {
891 if (localSones.containsKey(id)) {
892 logger.log(Level.FINE, "Tried to add known local Sone: %s", id);
893 return localSones.get(id);
895 OwnIdentity ownIdentity = identityManager.getOwnIdentity(id);
896 if (ownIdentity == null) {
897 logger.log(Level.INFO, "Invalid Sone ID: %s", id);
900 return addLocalSone(ownIdentity);
905 * Adds a local Sone from the given own identity.
908 * The own identity to create a Sone from
909 * @return The added (or already existing) Sone
911 public Sone addLocalSone(OwnIdentity ownIdentity) {
912 if (ownIdentity == null) {
913 logger.log(Level.WARNING, "Given OwnIdentity is null!");
916 synchronized (localSones) {
919 sone = getLocalSone(ownIdentity.getId()).setIdentity(ownIdentity).setInsertUri(new FreenetURI(ownIdentity.getInsertUri())).setRequestUri(new FreenetURI(ownIdentity.getRequestUri()));
920 } catch (MalformedURLException mue1) {
921 logger.log(Level.SEVERE, "Could not convert the Identity’s URIs to Freenet URIs: " + ownIdentity.getInsertUri() + ", " + ownIdentity.getRequestUri(), mue1);
924 sone.setLatestEdition(Numbers.safeParseLong(ownIdentity.getProperty("Sone.LatestEdition"), (long) 0));
925 sone.setClient(new Client("Sone", SonePlugin.VERSION.toString()));
926 /* TODO - load posts ’n stuff */
927 localSones.put(ownIdentity.getId(), sone);
928 final SoneInserter soneInserter = new SoneInserter(this, freenetInterface, sone);
929 soneInserters.put(sone, soneInserter);
930 setSoneStatus(sone, SoneStatus.idle);
932 if (!preferences.isSoneRescueMode()) {
933 soneInserter.start();
935 new Thread(new Runnable() {
938 @SuppressWarnings("synthetic-access")
940 if (!preferences.isSoneRescueMode()) {
943 logger.log(Level.INFO, "Trying to restore Sone from Freenet…");
944 coreListenerManager.fireRescuingSone(sone);
946 long edition = sone.getLatestEdition();
947 while (!stopped && (edition >= 0) && preferences.isSoneRescueMode()) {
948 logger.log(Level.FINE, "Downloading edition " + edition + "…");
949 soneDownloader.fetchSone(sone, sone.getRequestUri().setKeyType("SSK").setDocName("Sone-" + edition));
952 logger.log(Level.INFO, "Finished restoring Sone from Freenet, starting Inserter…");
954 coreListenerManager.fireRescuedSone(sone);
955 soneInserter.start();
958 }, "Sone Downloader").start();
964 * Creates a new Sone for the given own identity.
967 * The own identity to create a Sone for
968 * @return The created Sone
970 public Sone createSone(OwnIdentity ownIdentity) {
972 ownIdentity.addContext("Sone");
973 } catch (WebOfTrustException wote1) {
974 logger.log(Level.SEVERE, "Could not add “Sone” context to own identity: " + ownIdentity, wote1);
977 Sone sone = addLocalSone(ownIdentity);
978 sone.getOptions().addBooleanOption("AutoFollow", new DefaultOption<Boolean>(false));
984 * Adds the Sone of the given identity.
987 * The identity whose Sone to add
988 * @return The added or already existing Sone
990 public Sone addRemoteSone(Identity identity) {
991 if (identity == null) {
992 logger.log(Level.WARNING, "Given Identity is null!");
995 synchronized (remoteSones) {
996 final Sone sone = getRemoteSone(identity.getId()).setIdentity(identity);
997 boolean newSone = sone.getRequestUri() == null;
998 sone.setRequestUri(getSoneUri(identity.getRequestUri()));
999 sone.setLatestEdition(Numbers.safeParseLong(identity.getProperty("Sone.LatestEdition"), (long) 0));
1001 synchronized (newSones) {
1002 newSone = !knownSones.contains(sone.getId());
1004 newSones.add(sone.getId());
1008 coreListenerManager.fireNewSoneFound(sone);
1009 for (Sone localSone : getLocalSones()) {
1010 if (localSone.getOptions().getBooleanOption("AutoFollow").get()) {
1011 localSone.addFriend(sone.getId());
1016 remoteSones.put(identity.getId(), sone);
1017 soneDownloader.addSone(sone);
1018 setSoneStatus(sone, SoneStatus.unknown);
1019 new Thread(new Runnable() {
1022 @SuppressWarnings("synthetic-access")
1024 soneDownloader.fetchSone(sone);
1027 }, "Sone Downloader").start();
1033 * Retrieves the trust relationship from the origin to the target. If the
1034 * trust relationship can not be retrieved, {@code null} is returned.
1036 * @see Identity#getTrust(OwnIdentity)
1038 * The origin of the trust tree
1040 * The target of the trust
1041 * @return The trust relationship
1043 public Trust getTrust(Sone origin, Sone target) {
1044 if (!isLocalSone(origin)) {
1045 logger.log(Level.WARNING, "Tried to get trust from remote Sone: %s", origin);
1048 return target.getIdentity().getTrust((OwnIdentity) origin.getIdentity());
1052 * Sets the trust value of the given origin Sone for the target Sone.
1059 * The trust value (from {@code -100} to {@code 100})
1061 public void setTrust(Sone origin, Sone target, int trustValue) {
1062 Validation.begin().isNotNull("Trust Origin", origin).check().isInstanceOf("Trust Origin", origin.getIdentity(), OwnIdentity.class).isNotNull("Trust Target", target).isLessOrEqual("Trust Value", trustValue, 100).isGreaterOrEqual("Trust Value", trustValue, -100).check();
1064 ((OwnIdentity) origin.getIdentity()).setTrust(target.getIdentity(), trustValue, preferences.getTrustComment());
1065 } catch (WebOfTrustException wote1) {
1066 logger.log(Level.WARNING, "Could not set trust for Sone: " + target, wote1);
1071 * Removes any trust assignment for the given target Sone.
1078 public void removeTrust(Sone origin, Sone target) {
1079 Validation.begin().isNotNull("Trust Origin", origin).isNotNull("Trust Target", target).check().isInstanceOf("Trust Origin Identity", origin.getIdentity(), OwnIdentity.class).check();
1081 ((OwnIdentity) origin.getIdentity()).removeTrust(target.getIdentity());
1082 } catch (WebOfTrustException wote1) {
1083 logger.log(Level.WARNING, "Could not remove trust for Sone: " + target, wote1);
1088 * Assigns the configured positive trust value for the given target.
1095 public void trustSone(Sone origin, Sone target) {
1096 setTrust(origin, target, preferences.getPositiveTrust());
1100 * Assigns the configured negative trust value for the given target.
1107 public void distrustSone(Sone origin, Sone target) {
1108 setTrust(origin, target, preferences.getNegativeTrust());
1112 * Removes the trust assignment for the given target.
1119 public void untrustSone(Sone origin, Sone target) {
1120 removeTrust(origin, target);
1124 * Updates the stores Sone with the given Sone.
1129 public void updateSone(Sone sone) {
1130 if (hasSone(sone.getId())) {
1131 boolean soneRescueMode = isLocalSone(sone) && preferences.isSoneRescueMode();
1132 Sone storedSone = getSone(sone.getId());
1133 if (!soneRescueMode && !(sone.getTime() > storedSone.getTime())) {
1134 logger.log(Level.FINE, "Downloaded Sone %s is not newer than stored Sone %s.", new Object[] { sone, storedSone });
1137 synchronized (posts) {
1138 if (!soneRescueMode) {
1139 for (Post post : storedSone.getPosts()) {
1140 posts.remove(post.getId());
1141 if (!sone.getPosts().contains(post)) {
1142 coreListenerManager.firePostRemoved(post);
1146 List<Post> storedPosts = storedSone.getPosts();
1147 synchronized (newPosts) {
1148 for (Post post : sone.getPosts()) {
1149 post.setSone(storedSone);
1150 if (!storedPosts.contains(post) && !knownPosts.contains(post.getId())) {
1151 newPosts.add(post.getId());
1152 coreListenerManager.fireNewPostFound(post);
1154 posts.put(post.getId(), post);
1158 synchronized (replies) {
1159 if (!soneRescueMode) {
1160 for (Reply reply : storedSone.getReplies()) {
1161 replies.remove(reply.getId());
1162 if (!sone.getReplies().contains(reply)) {
1163 coreListenerManager.fireReplyRemoved(reply);
1167 Set<Reply> storedReplies = storedSone.getReplies();
1168 synchronized (newReplies) {
1169 for (Reply reply : sone.getReplies()) {
1170 reply.setSone(storedSone);
1171 if (!storedReplies.contains(reply) && !knownReplies.contains(reply.getId())) {
1172 newReplies.add(reply.getId());
1173 coreListenerManager.fireNewReplyFound(reply);
1175 replies.put(reply.getId(), reply);
1179 synchronized (storedSone) {
1180 if (!soneRescueMode || (sone.getTime() > storedSone.getTime())) {
1181 storedSone.setTime(sone.getTime());
1183 storedSone.setClient(sone.getClient());
1184 storedSone.setProfile(sone.getProfile());
1185 if (soneRescueMode) {
1186 for (Post post : sone.getPosts()) {
1187 storedSone.addPost(post);
1189 for (Reply reply : sone.getReplies()) {
1190 storedSone.addReply(reply);
1192 for (String likedPostId : sone.getLikedPostIds()) {
1193 storedSone.addLikedPostId(likedPostId);
1195 for (String likedReplyId : sone.getLikedReplyIds()) {
1196 storedSone.addLikedReplyId(likedReplyId);
1199 storedSone.setPosts(sone.getPosts());
1200 storedSone.setReplies(sone.getReplies());
1201 storedSone.setLikePostIds(sone.getLikedPostIds());
1202 storedSone.setLikeReplyIds(sone.getLikedReplyIds());
1204 storedSone.setLatestEdition(sone.getLatestEdition());
1210 * Deletes the given Sone. This will remove the Sone from the
1211 * {@link #getLocalSone(String) local Sones}, stops its {@link SoneInserter}
1212 * and remove the context from its identity.
1215 * The Sone to delete
1217 public void deleteSone(Sone sone) {
1218 if (!(sone.getIdentity() instanceof OwnIdentity)) {
1219 logger.log(Level.WARNING, "Tried to delete Sone of non-own identity: %s", sone);
1222 synchronized (localSones) {
1223 if (!localSones.containsKey(sone.getId())) {
1224 logger.log(Level.WARNING, "Tried to delete non-local Sone: %s", sone);
1227 localSones.remove(sone.getId());
1228 soneInserters.remove(sone).stop();
1231 ((OwnIdentity) sone.getIdentity()).removeContext("Sone");
1232 ((OwnIdentity) sone.getIdentity()).removeProperty("Sone.LatestEdition");
1233 } catch (WebOfTrustException wote1) {
1234 logger.log(Level.WARNING, "Could not remove context and properties from Sone: " + sone, wote1);
1237 configuration.getLongValue("Sone/" + sone.getId() + "/Time").setValue(null);
1238 } catch (ConfigurationException ce1) {
1239 logger.log(Level.WARNING, "Could not remove Sone from configuration!", ce1);
1244 * Marks the given Sone as known. If the Sone was {@link #isNewPost(String)
1245 * new} before, a {@link CoreListener#markSoneKnown(Sone)} event is fired.
1248 * The Sone to mark as known
1250 public void markSoneKnown(Sone sone) {
1251 synchronized (newSones) {
1252 if (newSones.remove(sone.getId())) {
1253 knownSones.add(sone.getId());
1254 coreListenerManager.fireMarkSoneKnown(sone);
1255 saveConfiguration();
1261 * Loads and updates the given Sone from the configuration. If any error is
1262 * encountered, loading is aborted and the given Sone is not changed.
1265 * The Sone to load and update
1267 public void loadSone(Sone sone) {
1268 if (!isLocalSone(sone)) {
1269 logger.log(Level.FINE, "Tried to load non-local Sone: %s", sone);
1274 String sonePrefix = "Sone/" + sone.getId();
1275 Long soneTime = configuration.getLongValue(sonePrefix + "/Time").getValue(null);
1276 if (soneTime == null) {
1277 logger.log(Level.INFO, "Could not load Sone because no Sone has been saved.");
1280 String lastInsertFingerprint = configuration.getStringValue(sonePrefix + "/LastInsertFingerprint").getValue("");
1283 Profile profile = new Profile();
1284 profile.setFirstName(configuration.getStringValue(sonePrefix + "/Profile/FirstName").getValue(null));
1285 profile.setMiddleName(configuration.getStringValue(sonePrefix + "/Profile/MiddleName").getValue(null));
1286 profile.setLastName(configuration.getStringValue(sonePrefix + "/Profile/LastName").getValue(null));
1287 profile.setBirthDay(configuration.getIntValue(sonePrefix + "/Profile/BirthDay").getValue(null));
1288 profile.setBirthMonth(configuration.getIntValue(sonePrefix + "/Profile/BirthMonth").getValue(null));
1289 profile.setBirthYear(configuration.getIntValue(sonePrefix + "/Profile/BirthYear").getValue(null));
1291 /* load profile fields. */
1293 String fieldPrefix = sonePrefix + "/Profile/Fields/" + profile.getFields().size();
1294 String fieldName = configuration.getStringValue(fieldPrefix + "/Name").getValue(null);
1295 if (fieldName == null) {
1298 String fieldValue = configuration.getStringValue(fieldPrefix + "/Value").getValue("");
1299 profile.addField(fieldName).setValue(fieldValue);
1303 Set<Post> posts = new HashSet<Post>();
1305 String postPrefix = sonePrefix + "/Posts/" + posts.size();
1306 String postId = configuration.getStringValue(postPrefix + "/ID").getValue(null);
1307 if (postId == null) {
1310 String postRecipientId = configuration.getStringValue(postPrefix + "/Recipient").getValue(null);
1311 long postTime = configuration.getLongValue(postPrefix + "/Time").getValue((long) 0);
1312 String postText = configuration.getStringValue(postPrefix + "/Text").getValue(null);
1313 if ((postTime == 0) || (postText == null)) {
1314 logger.log(Level.WARNING, "Invalid post found, aborting load!");
1317 Post post = getPost(postId).setSone(sone).setTime(postTime).setText(postText);
1318 if ((postRecipientId != null) && (postRecipientId.length() == 43)) {
1319 post.setRecipient(getSone(postRecipientId));
1325 Set<Reply> replies = new HashSet<Reply>();
1327 String replyPrefix = sonePrefix + "/Replies/" + replies.size();
1328 String replyId = configuration.getStringValue(replyPrefix + "/ID").getValue(null);
1329 if (replyId == null) {
1332 String postId = configuration.getStringValue(replyPrefix + "/Post/ID").getValue(null);
1333 long replyTime = configuration.getLongValue(replyPrefix + "/Time").getValue((long) 0);
1334 String replyText = configuration.getStringValue(replyPrefix + "/Text").getValue(null);
1335 if ((postId == null) || (replyTime == 0) || (replyText == null)) {
1336 logger.log(Level.WARNING, "Invalid reply found, aborting load!");
1339 replies.add(getReply(replyId).setSone(sone).setPost(getPost(postId)).setTime(replyTime).setText(replyText));
1342 /* load post likes. */
1343 Set<String> likedPostIds = new HashSet<String>();
1345 String likedPostId = configuration.getStringValue(sonePrefix + "/Likes/Post/" + likedPostIds.size() + "/ID").getValue(null);
1346 if (likedPostId == null) {
1349 likedPostIds.add(likedPostId);
1352 /* load reply likes. */
1353 Set<String> likedReplyIds = new HashSet<String>();
1355 String likedReplyId = configuration.getStringValue(sonePrefix + "/Likes/Reply/" + likedReplyIds.size() + "/ID").getValue(null);
1356 if (likedReplyId == null) {
1359 likedReplyIds.add(likedReplyId);
1363 Set<String> friends = new HashSet<String>();
1365 String friendId = configuration.getStringValue(sonePrefix + "/Friends/" + friends.size() + "/ID").getValue(null);
1366 if (friendId == null) {
1369 friends.add(friendId);
1373 List<Album> topLevelAlbums = new ArrayList<Album>();
1374 int albumCounter = 0;
1376 String albumPrefix = sonePrefix + "/Albums/" + albumCounter++;
1377 String albumId = configuration.getStringValue(albumPrefix + "/ID").getValue(null);
1378 if (albumId == null) {
1381 String albumTitle = configuration.getStringValue(albumPrefix + "/Title").getValue(null);
1382 String albumDescription = configuration.getStringValue(albumPrefix + "/Description").getValue(null);
1383 String albumParentId = configuration.getStringValue(albumPrefix + "/Parent").getValue(null);
1384 if ((albumTitle == null) || (albumDescription == null)) {
1385 logger.log(Level.WARNING, "Invalid album found, aborting load!");
1388 Album album = getAlbum(albumId).setSone(sone).setTitle(albumTitle).setDescription(albumDescription);
1389 if (albumParentId != null) {
1390 Album parentAlbum = getAlbum(albumParentId, false);
1391 if (parentAlbum == null) {
1392 logger.log(Level.WARNING, "Invalid parent album ID: " + albumParentId);
1395 parentAlbum.addAlbum(album);
1397 topLevelAlbums.add(album);
1402 int imageCounter = 0;
1404 String imagePrefix = sonePrefix + "/Images/" + imageCounter++;
1405 String imageId = configuration.getStringValue(imagePrefix + "/ID").getValue(null);
1406 if (imageId == null) {
1409 String albumId = configuration.getStringValue(imagePrefix + "/Album").getValue(null);
1410 String key = configuration.getStringValue(imagePrefix + "/Key").getValue(null);
1411 String title = configuration.getStringValue(imagePrefix + "/Title").getValue(null);
1412 String description = configuration.getStringValue(imagePrefix + "/Description").getValue(null);
1413 Long creationTime = configuration.getLongValue(imagePrefix + "/CreationTime").getValue(null);
1414 Integer width = configuration.getIntValue(imagePrefix + "/Width").getValue(null);
1415 Integer height = configuration.getIntValue(imagePrefix + "/Height").getValue(null);
1416 if ((albumId == null) || (key == null) || (title == null) || (description == null) || (creationTime == null) || (width == null) || (height == null)) {
1417 logger.log(Level.WARNING, "Invalid image found, aborting load!");
1420 Album album = getAlbum(albumId, false);
1421 if (album == null) {
1422 logger.log(Level.WARNING, "Invalid album image encountered, aborting load!");
1425 Image image = getImage(imageId).setSone(sone).setCreationTime(creationTime).setKey(key);
1426 image.setTitle(title).setDescription(description).setWidth(width).setHeight(height);
1427 album.addImage(image);
1431 sone.getOptions().addBooleanOption("AutoFollow", new DefaultOption<Boolean>(false));
1432 sone.getOptions().getBooleanOption("AutoFollow").set(configuration.getBooleanValue(sonePrefix + "/Options/AutoFollow").getValue(null));
1434 /* if we’re still here, Sone was loaded successfully. */
1435 synchronized (sone) {
1436 sone.setTime(soneTime);
1437 sone.setProfile(profile);
1438 sone.setPosts(posts);
1439 sone.setReplies(replies);
1440 sone.setLikePostIds(likedPostIds);
1441 sone.setLikeReplyIds(likedReplyIds);
1442 sone.setFriends(friends);
1443 sone.setAlbums(topLevelAlbums);
1444 soneInserters.get(sone).setLastInsertFingerprint(lastInsertFingerprint);
1446 synchronized (newSones) {
1447 for (String friend : friends) {
1448 knownSones.add(friend);
1451 synchronized (newPosts) {
1452 for (Post post : posts) {
1453 knownPosts.add(post.getId());
1456 synchronized (newReplies) {
1457 for (Reply reply : replies) {
1458 knownReplies.add(reply.getId());
1464 * Saves the given Sone. This will persist all local settings for the given
1465 * Sone, such as the friends list and similar, private options.
1470 public synchronized void saveSone(Sone sone) {
1471 if (!isLocalSone(sone)) {
1472 logger.log(Level.FINE, "Tried to save non-local Sone: %s", sone);
1475 if (!(sone.getIdentity() instanceof OwnIdentity)) {
1476 logger.log(Level.WARNING, "Local Sone without OwnIdentity found, refusing to save: %s", sone);
1480 logger.log(Level.INFO, "Saving Sone: %s", sone);
1482 ((OwnIdentity) sone.getIdentity()).setProperty("Sone.LatestEdition", String.valueOf(sone.getLatestEdition()));
1484 /* save Sone into configuration. */
1485 String sonePrefix = "Sone/" + sone.getId();
1486 configuration.getLongValue(sonePrefix + "/Time").setValue(sone.getTime());
1487 configuration.getStringValue(sonePrefix + "/LastInsertFingerprint").setValue(soneInserters.get(sone).getLastInsertFingerprint());
1490 Profile profile = sone.getProfile();
1491 configuration.getStringValue(sonePrefix + "/Profile/FirstName").setValue(profile.getFirstName());
1492 configuration.getStringValue(sonePrefix + "/Profile/MiddleName").setValue(profile.getMiddleName());
1493 configuration.getStringValue(sonePrefix + "/Profile/LastName").setValue(profile.getLastName());
1494 configuration.getIntValue(sonePrefix + "/Profile/BirthDay").setValue(profile.getBirthDay());
1495 configuration.getIntValue(sonePrefix + "/Profile/BirthMonth").setValue(profile.getBirthMonth());
1496 configuration.getIntValue(sonePrefix + "/Profile/BirthYear").setValue(profile.getBirthYear());
1498 /* save profile fields. */
1499 int fieldCounter = 0;
1500 for (Field profileField : profile.getFields()) {
1501 String fieldPrefix = sonePrefix + "/Profile/Fields/" + fieldCounter++;
1502 configuration.getStringValue(fieldPrefix + "/Name").setValue(profileField.getName());
1503 configuration.getStringValue(fieldPrefix + "/Value").setValue(profileField.getValue());
1505 configuration.getStringValue(sonePrefix + "/Profile/Fields/" + fieldCounter + "/Name").setValue(null);
1508 int postCounter = 0;
1509 for (Post post : sone.getPosts()) {
1510 String postPrefix = sonePrefix + "/Posts/" + postCounter++;
1511 configuration.getStringValue(postPrefix + "/ID").setValue(post.getId());
1512 configuration.getStringValue(postPrefix + "/Recipient").setValue((post.getRecipient() != null) ? post.getRecipient().getId() : null);
1513 configuration.getLongValue(postPrefix + "/Time").setValue(post.getTime());
1514 configuration.getStringValue(postPrefix + "/Text").setValue(post.getText());
1516 configuration.getStringValue(sonePrefix + "/Posts/" + postCounter + "/ID").setValue(null);
1519 int replyCounter = 0;
1520 for (Reply reply : sone.getReplies()) {
1521 String replyPrefix = sonePrefix + "/Replies/" + replyCounter++;
1522 configuration.getStringValue(replyPrefix + "/ID").setValue(reply.getId());
1523 configuration.getStringValue(replyPrefix + "/Post/ID").setValue(reply.getPost().getId());
1524 configuration.getLongValue(replyPrefix + "/Time").setValue(reply.getTime());
1525 configuration.getStringValue(replyPrefix + "/Text").setValue(reply.getText());
1527 configuration.getStringValue(sonePrefix + "/Replies/" + replyCounter + "/ID").setValue(null);
1529 /* save post likes. */
1530 int postLikeCounter = 0;
1531 for (String postId : sone.getLikedPostIds()) {
1532 configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter++ + "/ID").setValue(postId);
1534 configuration.getStringValue(sonePrefix + "/Likes/Post/" + postLikeCounter + "/ID").setValue(null);
1536 /* save reply likes. */
1537 int replyLikeCounter = 0;
1538 for (String replyId : sone.getLikedReplyIds()) {
1539 configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter++ + "/ID").setValue(replyId);
1541 configuration.getStringValue(sonePrefix + "/Likes/Reply/" + replyLikeCounter + "/ID").setValue(null);
1544 int friendCounter = 0;
1545 for (String friendId : sone.getFriends()) {
1546 configuration.getStringValue(sonePrefix + "/Friends/" + friendCounter++ + "/ID").setValue(friendId);
1548 configuration.getStringValue(sonePrefix + "/Friends/" + friendCounter + "/ID").setValue(null);
1550 /* save albums. first, collect in a flat structure, top-level first. */
1551 List<Album> albums = new ArrayList<Album>();
1552 albums.addAll(sone.getAlbums());
1553 int lastAlbumIndex = 0;
1554 while (lastAlbumIndex < albums.size()) {
1555 int previousAlbumCount = albums.size();
1556 for (Album album : new ArrayList<Album>(albums.subList(lastAlbumIndex, albums.size()))) {
1557 albums.addAll(album.getAlbums());
1559 lastAlbumIndex = previousAlbumCount;
1562 int albumCounter = 0;
1563 for (Album album : albums) {
1564 String albumPrefix = sonePrefix + "/Albums/" + albumCounter++;
1565 configuration.getStringValue(albumPrefix + "/ID").setValue(album.getId());
1566 configuration.getStringValue(albumPrefix + "/Title").setValue(album.getTitle());
1567 configuration.getStringValue(albumPrefix + "/Description").setValue(album.getDescription());
1568 configuration.getStringValue(albumPrefix + "/Parent").setValue(album.getParent() == null ? null : album.getParent().getId());
1570 configuration.getStringValue(sonePrefix + "/Albums/" + albumCounter + "/ID").setValue(null);
1573 int imageCounter = 0;
1574 for (Album album : albums) {
1575 for (Image image : album.getImages()) {
1576 if (!image.isInserted()) {
1579 String imagePrefix = sonePrefix + "/Images/" + imageCounter++;
1580 configuration.getStringValue(imagePrefix + "/ID").setValue(image.getId());
1581 configuration.getStringValue(imagePrefix + "/Album").setValue(album.getId());
1582 configuration.getStringValue(imagePrefix + "/Key").setValue(image.getKey());
1583 configuration.getStringValue(imagePrefix + "/Title").setValue(image.getTitle());
1584 configuration.getStringValue(imagePrefix + "/Description").setValue(image.getDescription());
1585 configuration.getLongValue(imagePrefix + "/CreationTime").setValue(image.getCreationTime());
1586 configuration.getIntValue(imagePrefix + "/Width").setValue(image.getWidth());
1587 configuration.getIntValue(imagePrefix + "/Height").setValue(image.getHeight());
1590 configuration.getStringValue(sonePrefix + "/Images/" + imageCounter + "/ID").setValue(null);
1593 configuration.getBooleanValue(sonePrefix + "/Options/AutoFollow").setValue(sone.getOptions().getBooleanOption("AutoFollow").getReal());
1595 configuration.save();
1596 logger.log(Level.INFO, "Sone %s saved.", sone);
1597 } catch (ConfigurationException ce1) {
1598 logger.log(Level.WARNING, "Could not save Sone: " + sone, ce1);
1599 } catch (WebOfTrustException wote1) {
1600 logger.log(Level.WARNING, "Could not set WoT property for Sone: " + sone, wote1);
1605 * Creates a new post.
1608 * The Sone that creates the post
1610 * The text of the post
1611 * @return The created post
1613 public Post createPost(Sone sone, String text) {
1614 return createPost(sone, System.currentTimeMillis(), text);
1618 * Creates a new post.
1621 * The Sone that creates the post
1623 * The time of the post
1625 * The text of the post
1626 * @return The created post
1628 public Post createPost(Sone sone, long time, String text) {
1629 return createPost(sone, null, time, text);
1633 * Creates a new post.
1636 * The Sone that creates the post
1638 * The recipient Sone, or {@code null} if this post does not have
1641 * The text of the post
1642 * @return The created post
1644 public Post createPost(Sone sone, Sone recipient, String text) {
1645 return createPost(sone, recipient, System.currentTimeMillis(), text);
1649 * Creates a new post.
1652 * The Sone that creates the post
1654 * The recipient Sone, or {@code null} if this post does not have
1657 * The time of the post
1659 * The text of the post
1660 * @return The created post
1662 public Post createPost(Sone sone, Sone recipient, long time, String text) {
1663 if (!isLocalSone(sone)) {
1664 logger.log(Level.FINE, "Tried to create post for non-local Sone: %s", sone);
1667 Post post = new Post(sone, time, text);
1668 if (recipient != null) {
1669 post.setRecipient(recipient);
1671 synchronized (posts) {
1672 posts.put(post.getId(), post);
1674 synchronized (newPosts) {
1675 newPosts.add(post.getId());
1676 coreListenerManager.fireNewPostFound(post);
1684 * Deletes the given post.
1687 * The post to delete
1689 public void deletePost(Post post) {
1690 if (!isLocalSone(post.getSone())) {
1691 logger.log(Level.WARNING, "Tried to delete post of non-local Sone: %s", post.getSone());
1694 post.getSone().removePost(post);
1695 synchronized (posts) {
1696 posts.remove(post.getId());
1698 synchronized (newPosts) {
1699 markPostKnown(post);
1700 knownPosts.remove(post.getId());
1702 saveSone(post.getSone());
1706 * Marks the given post as known, if it is currently a new post (according
1707 * to {@link #isNewPost(String)}).
1710 * The post to mark as known
1712 public void markPostKnown(Post post) {
1713 synchronized (newPosts) {
1714 if (newPosts.remove(post.getId())) {
1715 knownPosts.add(post.getId());
1716 coreListenerManager.fireMarkPostKnown(post);
1717 saveConfiguration();
1723 * Bookmarks the given post.
1726 * The post to bookmark
1728 public void bookmark(Post post) {
1729 bookmarkPost(post.getId());
1733 * Bookmarks the post with the given ID.
1736 * The ID of the post to bookmark
1738 public void bookmarkPost(String id) {
1739 synchronized (bookmarkedPosts) {
1740 bookmarkedPosts.add(id);
1745 * Removes the given post from the bookmarks.
1748 * The post to unbookmark
1750 public void unbookmark(Post post) {
1751 unbookmarkPost(post.getId());
1755 * Removes the post with the given ID from the bookmarks.
1758 * The ID of the post to unbookmark
1760 public void unbookmarkPost(String id) {
1761 synchronized (bookmarkedPosts) {
1762 bookmarkedPosts.remove(id);
1767 * Creates a new reply.
1770 * The Sone that creates the reply
1772 * The post that this reply refers to
1774 * The text of the reply
1775 * @return The created reply
1777 public Reply createReply(Sone sone, Post post, String text) {
1778 return createReply(sone, post, System.currentTimeMillis(), text);
1782 * Creates a new reply.
1785 * The Sone that creates the reply
1787 * The post that this reply refers to
1789 * The time of the reply
1791 * The text of the reply
1792 * @return The created reply
1794 public Reply createReply(Sone sone, Post post, long time, String text) {
1795 if (!isLocalSone(sone)) {
1796 logger.log(Level.FINE, "Tried to create reply for non-local Sone: %s", sone);
1799 Reply reply = new Reply(sone, post, System.currentTimeMillis(), text);
1800 synchronized (replies) {
1801 replies.put(reply.getId(), reply);
1803 synchronized (newReplies) {
1804 newReplies.add(reply.getId());
1805 coreListenerManager.fireNewReplyFound(reply);
1807 sone.addReply(reply);
1813 * Deletes the given reply.
1816 * The reply to delete
1818 public void deleteReply(Reply reply) {
1819 Sone sone = reply.getSone();
1820 if (!isLocalSone(sone)) {
1821 logger.log(Level.FINE, "Tried to delete non-local reply: %s", reply);
1824 synchronized (replies) {
1825 replies.remove(reply.getId());
1827 synchronized (newReplies) {
1828 markReplyKnown(reply);
1829 knownReplies.remove(reply.getId());
1831 sone.removeReply(reply);
1836 * Marks the given reply as known, if it is currently a new reply (according
1837 * to {@link #isNewReply(String)}).
1840 * The reply to mark as known
1842 public void markReplyKnown(Reply reply) {
1843 synchronized (newReplies) {
1844 if (newReplies.remove(reply.getId())) {
1845 knownReplies.add(reply.getId());
1846 coreListenerManager.fireMarkReplyKnown(reply);
1847 saveConfiguration();
1853 * Creates a new top-level album for the given Sone.
1856 * The Sone to create the album for
1857 * @return The new album
1859 public Album createAlbum(Sone sone) {
1860 return createAlbum(sone, null);
1864 * Creates a new album for the given Sone.
1867 * The Sone to create the album for
1869 * The parent of the album (may be {@code null} to create a
1871 * @return The new album
1873 public Album createAlbum(Sone sone, Album parent) {
1874 Album album = new Album();
1875 synchronized (albums) {
1876 albums.put(album.getId(), album);
1878 album.setSone(sone);
1879 if (parent != null) {
1880 parent.addAlbum(album);
1882 sone.addAlbum(album);
1888 * Deletes the given album. The owner of the album has to be a local Sone,
1889 * and the album has to be {@link Album#isEmpty() empty} to be deleted.
1892 * The album to remove
1894 public void deleteAlbum(Album album) {
1895 Validation.begin().isNotNull("Album", album).check().is("Local Sone", isLocalSone(album.getSone())).check();
1896 if (!album.isEmpty()) {
1899 if (album.getParent() == null) {
1900 album.getSone().removeAlbum(album);
1902 album.getParent().removeAlbum(album);
1904 synchronized (albums) {
1905 albums.remove(album.getId());
1907 saveSone(album.getSone());
1911 * Creates a new image.
1914 * The Sone creating the image
1916 * The album the image will be inserted into
1917 * @param temporaryImage
1918 * The temporary image to create the image from
1919 * @return The newly created image
1921 public Image createImage(Sone sone, Album album, TemporaryImage temporaryImage) {
1922 Validation.begin().isNotNull("Sone", sone).isNotNull("Album", album).isNotNull("Temporary Image", temporaryImage).check().is("Local Sone", isLocalSone(sone)).check().isEqual("Owner and Album Owner", sone, album.getSone()).check();
1923 Image image = new Image(temporaryImage.getId()).setSone(sone).setCreationTime(System.currentTimeMillis());
1924 album.addImage(image);
1925 synchronized (images) {
1926 images.put(image.getId(), image);
1928 imageInserter.insertImage(temporaryImage, image);
1933 * Deletes the given image. This method will also delete a matching
1936 * @see #deleteTemporaryImage(TemporaryImage)
1938 * The image to delete
1940 public void deleteImage(Image image) {
1941 Validation.begin().isNotNull("Image", image).check().is("Local Sone", isLocalSone(image.getSone())).check();
1942 deleteTemporaryImage(image.getId());
1943 image.getAlbum().removeImage(image);
1944 synchronized (images) {
1945 images.remove(image.getId());
1947 saveSone(image.getSone());
1951 * Creates a new temporary image.
1954 * The MIME type of the temporary image
1956 * The encoded data of the image
1957 * @return The temporary image
1959 public TemporaryImage createTemporaryImage(String mimeType, byte[] imageData) {
1960 TemporaryImage temporaryImage = new TemporaryImage();
1961 temporaryImage.setMimeType(mimeType).setImageData(imageData);
1962 synchronized (temporaryImages) {
1963 temporaryImages.put(temporaryImage.getId(), temporaryImage);
1965 return temporaryImage;
1969 * Deletes the given temporary image.
1971 * @param temporaryImage
1972 * The temporary image to delete
1974 public void deleteTemporaryImage(TemporaryImage temporaryImage) {
1975 Validation.begin().isNotNull("Temporary Image", temporaryImage).check();
1976 deleteTemporaryImage(temporaryImage.getId());
1980 * Deletes the temporary image with the given ID.
1983 * The ID of the temporary image to delete
1985 public void deleteTemporaryImage(String imageId) {
1986 Validation.begin().isNotNull("Temporary Image ID", imageId).check();
1987 synchronized (temporaryImages) {
1988 temporaryImages.remove(imageId);
1990 Image image = getImage(imageId, false);
1991 if (image != null) {
1992 imageInserter.cancelImageInsert(image);
1999 public void start() {
2000 loadConfiguration();
2001 updateChecker.addUpdateListener(this);
2002 updateChecker.start();
2008 public void stop() {
2009 synchronized (localSones) {
2010 for (SoneInserter soneInserter : soneInserters.values()) {
2011 soneInserter.stop();
2014 updateChecker.stop();
2015 updateChecker.removeUpdateListener(this);
2016 soneDownloader.stop();
2017 saveConfiguration();
2022 * Saves the current options.
2024 public void saveConfiguration() {
2025 synchronized (configuration) {
2026 if (storingConfiguration) {
2027 logger.log(Level.FINE, "Already storing configuration…");
2030 storingConfiguration = true;
2033 /* store the options first. */
2035 configuration.getIntValue("Option/ConfigurationVersion").setValue(0);
2036 configuration.getIntValue("Option/InsertionDelay").setValue(options.getIntegerOption("InsertionDelay").getReal());
2037 configuration.getIntValue("Option/PostsPerPage").setValue(options.getIntegerOption("PostsPerPage").getReal());
2038 configuration.getIntValue("Option/PositiveTrust").setValue(options.getIntegerOption("PositiveTrust").getReal());
2039 configuration.getIntValue("Option/NegativeTrust").setValue(options.getIntegerOption("NegativeTrust").getReal());
2040 configuration.getStringValue("Option/TrustComment").setValue(options.getStringOption("TrustComment").getReal());
2041 configuration.getBooleanValue("Option/SoneRescueMode").setValue(options.getBooleanOption("SoneRescueMode").getReal());
2042 configuration.getBooleanValue("Option/ClearOnNextRestart").setValue(options.getBooleanOption("ClearOnNextRestart").getReal());
2043 configuration.getBooleanValue("Option/ReallyClearOnNextRestart").setValue(options.getBooleanOption("ReallyClearOnNextRestart").getReal());
2045 /* save known Sones. */
2046 int soneCounter = 0;
2047 synchronized (newSones) {
2048 for (String knownSoneId : knownSones) {
2049 configuration.getStringValue("KnownSone/" + soneCounter++ + "/ID").setValue(knownSoneId);
2051 configuration.getStringValue("KnownSone/" + soneCounter + "/ID").setValue(null);
2054 /* save known posts. */
2055 int postCounter = 0;
2056 synchronized (newPosts) {
2057 for (String knownPostId : knownPosts) {
2058 configuration.getStringValue("KnownPosts/" + postCounter++ + "/ID").setValue(knownPostId);
2060 configuration.getStringValue("KnownPosts/" + postCounter + "/ID").setValue(null);
2063 /* save known replies. */
2064 int replyCounter = 0;
2065 synchronized (newReplies) {
2066 for (String knownReplyId : knownReplies) {
2067 configuration.getStringValue("KnownReplies/" + replyCounter++ + "/ID").setValue(knownReplyId);
2069 configuration.getStringValue("KnownReplies/" + replyCounter + "/ID").setValue(null);
2072 /* save bookmarked posts. */
2073 int bookmarkedPostCounter = 0;
2074 synchronized (bookmarkedPosts) {
2075 for (String bookmarkedPostId : bookmarkedPosts) {
2076 configuration.getStringValue("Bookmarks/Post/" + bookmarkedPostCounter++ + "/ID").setValue(bookmarkedPostId);
2079 configuration.getStringValue("Bookmarks/Post/" + bookmarkedPostCounter++ + "/ID").setValue(null);
2082 configuration.save();
2084 } catch (ConfigurationException ce1) {
2085 logger.log(Level.SEVERE, "Could not store configuration!", ce1);
2087 synchronized (configuration) {
2088 storingConfiguration = false;
2098 * Loads the configuration.
2100 @SuppressWarnings("unchecked")
2101 private void loadConfiguration() {
2102 /* create options. */
2103 options.addIntegerOption("InsertionDelay", new DefaultOption<Integer>(60, new OptionWatcher<Integer>() {
2106 public void optionChanged(Option<Integer> option, Integer oldValue, Integer newValue) {
2107 SoneInserter.setInsertionDelay(newValue);
2111 options.addIntegerOption("PostsPerPage", new DefaultOption<Integer>(10));
2112 options.addIntegerOption("PositiveTrust", new DefaultOption<Integer>(75));
2113 options.addIntegerOption("NegativeTrust", new DefaultOption<Integer>(-25));
2114 options.addStringOption("TrustComment", new DefaultOption<String>("Set from Sone Web Interface"));
2115 options.addBooleanOption("SoneRescueMode", new DefaultOption<Boolean>(false));
2116 options.addBooleanOption("ClearOnNextRestart", new DefaultOption<Boolean>(false));
2117 options.addBooleanOption("ReallyClearOnNextRestart", new DefaultOption<Boolean>(false));
2119 /* read options from configuration. */
2120 options.getBooleanOption("ClearOnNextRestart").set(configuration.getBooleanValue("Option/ClearOnNextRestart").getValue(null));
2121 options.getBooleanOption("ReallyClearOnNextRestart").set(configuration.getBooleanValue("Option/ReallyClearOnNextRestart").getValue(null));
2122 boolean clearConfiguration = options.getBooleanOption("ClearOnNextRestart").get() && options.getBooleanOption("ReallyClearOnNextRestart").get();
2123 options.getBooleanOption("ClearOnNextRestart").set(null);
2124 options.getBooleanOption("ReallyClearOnNextRestart").set(null);
2125 if (clearConfiguration) {
2126 /* stop loading the configuration. */
2130 options.getIntegerOption("InsertionDelay").set(configuration.getIntValue("Option/InsertionDelay").getValue(null));
2131 options.getIntegerOption("PostsPerPage").set(configuration.getIntValue("Option/PostsPerPage").getValue(null));
2132 options.getIntegerOption("PositiveTrust").set(configuration.getIntValue("Option/PositiveTrust").getValue(null));
2133 options.getIntegerOption("NegativeTrust").set(configuration.getIntValue("Option/NegativeTrust").getValue(null));
2134 options.getStringOption("TrustComment").set(configuration.getStringValue("Option/TrustComment").getValue(null));
2135 options.getBooleanOption("SoneRescueMode").set(configuration.getBooleanValue("Option/SoneRescueMode").getValue(null));
2137 /* load known Sones. */
2138 int soneCounter = 0;
2140 String knownSoneId = configuration.getStringValue("KnownSone/" + soneCounter++ + "/ID").getValue(null);
2141 if (knownSoneId == null) {
2144 synchronized (newSones) {
2145 knownSones.add(knownSoneId);
2149 /* load known posts. */
2150 int postCounter = 0;
2152 String knownPostId = configuration.getStringValue("KnownPosts/" + postCounter++ + "/ID").getValue(null);
2153 if (knownPostId == null) {
2156 synchronized (newPosts) {
2157 knownPosts.add(knownPostId);
2161 /* load known replies. */
2162 int replyCounter = 0;
2164 String knownReplyId = configuration.getStringValue("KnownReplies/" + replyCounter++ + "/ID").getValue(null);
2165 if (knownReplyId == null) {
2168 synchronized (newReplies) {
2169 knownReplies.add(knownReplyId);
2173 /* load bookmarked posts. */
2174 int bookmarkedPostCounter = 0;
2176 String bookmarkedPostId = configuration.getStringValue("Bookmarks/Post/" + bookmarkedPostCounter++ + "/ID").getValue(null);
2177 if (bookmarkedPostId == null) {
2180 synchronized (bookmarkedPosts) {
2181 bookmarkedPosts.add(bookmarkedPostId);
2188 * Generate a Sone URI from the given URI and latest edition.
2191 * The URI to derive the Sone URI from
2192 * @return The derived URI
2194 private FreenetURI getSoneUri(String uriString) {
2196 FreenetURI uri = new FreenetURI(uriString).setDocName("Sone").setMetaString(new String[0]);
2198 } catch (MalformedURLException mue1) {
2199 logger.log(Level.WARNING, "Could not create Sone URI from URI: " + uriString, mue1);
2205 // INTERFACE IdentityListener
2212 public void ownIdentityAdded(OwnIdentity ownIdentity) {
2213 logger.log(Level.FINEST, "Adding OwnIdentity: " + ownIdentity);
2214 if (ownIdentity.hasContext("Sone")) {
2215 trustedIdentities.put(ownIdentity, Collections.synchronizedSet(new HashSet<Identity>()));
2216 addLocalSone(ownIdentity);
2224 public void ownIdentityRemoved(OwnIdentity ownIdentity) {
2225 logger.log(Level.FINEST, "Removing OwnIdentity: " + ownIdentity);
2226 trustedIdentities.remove(ownIdentity);
2233 public void identityAdded(OwnIdentity ownIdentity, Identity identity) {
2234 logger.log(Level.FINEST, "Adding Identity: " + identity);
2235 trustedIdentities.get(ownIdentity).add(identity);
2236 addRemoteSone(identity);
2243 public void identityUpdated(OwnIdentity ownIdentity, final Identity identity) {
2244 new Thread(new Runnable() {
2247 @SuppressWarnings("synthetic-access")
2249 Sone sone = getRemoteSone(identity.getId());
2250 sone.setIdentity(identity);
2251 soneDownloader.addSone(sone);
2252 soneDownloader.fetchSone(sone);
2261 public void identityRemoved(OwnIdentity ownIdentity, Identity identity) {
2262 trustedIdentities.get(ownIdentity).remove(identity);
2266 // INTERFACE UpdateListener
2273 public void updateFound(Version version, long releaseTime, long latestEdition) {
2274 coreListenerManager.fireUpdateFound(version, releaseTime, latestEdition);
2278 // INTERFACE ImageInsertListener
2285 public void imageInsertStarted(Image image) {
2286 logger.log(Level.WARNING, "Image insert started for " + image);
2287 coreListenerManager.fireImageInsertStarted(image);
2294 public void imageInsertAborted(Image image) {
2295 logger.log(Level.WARNING, "Image insert aborted for " + image);
2296 coreListenerManager.fireImageInsertAborted(image);
2303 public void imageInsertFinished(Image image, FreenetURI key) {
2304 logger.log(Level.WARNING, "Image insert finished for " + image + ": " + key);
2305 image.setKey(key.toString());
2306 deleteTemporaryImage(image.getId());
2307 saveSone(image.getSone());
2308 coreListenerManager.fireImageInsertFinished(image);
2315 public void imageInsertFailed(Image image, Throwable cause) {
2316 logger.log(Level.WARNING, "Image insert failed for " + image, cause);
2317 coreListenerManager.fireImageInsertFailed(image, cause);
2321 * Convenience interface for external classes that want to access the core’s
2324 * @author <a href="mailto:bombe@pterodactylus.net">David ‘Bombe’ Roden</a>
2326 public static class Preferences {
2328 /** The wrapped options. */
2329 private final Options options;
2332 * Creates a new preferences object wrapped around the given options.
2335 * The options to wrap
2337 public Preferences(Options options) {
2338 this.options = options;
2342 * Returns the insertion delay.
2344 * @return The insertion delay
2346 public int getInsertionDelay() {
2347 return options.getIntegerOption("InsertionDelay").get();
2351 * Sets the insertion delay
2353 * @param insertionDelay
2354 * The new insertion delay, or {@code null} to restore it to
2356 * @return This preferences
2358 public Preferences setInsertionDelay(Integer insertionDelay) {
2359 options.getIntegerOption("InsertionDelay").set(insertionDelay);
2364 * Returns the number of posts to show per page.
2366 * @return The number of posts to show per page
2368 public int getPostsPerPage() {
2369 return options.getIntegerOption("PostsPerPage").get();
2373 * Sets the number of posts to show per page.
2375 * @param postsPerPage
2376 * The number of posts to show per page
2377 * @return This preferences object
2379 public Preferences setPostsPerPage(Integer postsPerPage) {
2380 options.getIntegerOption("PostsPerPage").set(postsPerPage);
2385 * Returns the positive trust.
2387 * @return The positive trust
2389 public int getPositiveTrust() {
2390 return options.getIntegerOption("PositiveTrust").get();
2394 * Sets the positive trust.
2396 * @param positiveTrust
2397 * The new positive trust, or {@code null} to restore it to
2399 * @return This preferences
2401 public Preferences setPositiveTrust(Integer positiveTrust) {
2402 options.getIntegerOption("PositiveTrust").set(positiveTrust);
2407 * Returns the negative trust.
2409 * @return The negative trust
2411 public int getNegativeTrust() {
2412 return options.getIntegerOption("NegativeTrust").get();
2416 * Sets the negative trust.
2418 * @param negativeTrust
2419 * The negative trust, or {@code null} to restore it to the
2421 * @return The preferences
2423 public Preferences setNegativeTrust(Integer negativeTrust) {
2424 options.getIntegerOption("NegativeTrust").set(negativeTrust);
2429 * Returns the trust comment. This is the comment that is set in the web
2430 * of trust when a trust value is assigned to an identity.
2432 * @return The trust comment
2434 public String getTrustComment() {
2435 return options.getStringOption("TrustComment").get();
2439 * Sets the trust comment.
2441 * @param trustComment
2442 * The trust comment, or {@code null} to restore it to the
2444 * @return This preferences
2446 public Preferences setTrustComment(String trustComment) {
2447 options.getStringOption("TrustComment").set(trustComment);
2452 * Returns whether the rescue mode is active.
2454 * @return {@code true} if the rescue mode is active, {@code false}
2457 public boolean isSoneRescueMode() {
2458 return options.getBooleanOption("SoneRescueMode").get();
2462 * Sets whether the rescue mode is active.
2464 * @param soneRescueMode
2465 * {@code true} if the rescue mode is active, {@code false}
2467 * @return This preferences
2469 public Preferences setSoneRescueMode(Boolean soneRescueMode) {
2470 options.getBooleanOption("SoneRescueMode").set(soneRescueMode);
2475 * Returns whether Sone should clear its settings on the next restart.
2476 * In order to be effective, {@link #isReallyClearOnNextRestart()} needs
2477 * to return {@code true} as well!
2479 * @return {@code true} if Sone should clear its settings on the next
2480 * restart, {@code false} otherwise
2482 public boolean isClearOnNextRestart() {
2483 return options.getBooleanOption("ClearOnNextRestart").get();
2487 * Sets whether Sone will clear its settings on the next restart.
2489 * @param clearOnNextRestart
2490 * {@code true} if Sone should clear its settings on the next
2491 * restart, {@code false} otherwise
2492 * @return This preferences
2494 public Preferences setClearOnNextRestart(Boolean clearOnNextRestart) {
2495 options.getBooleanOption("ClearOnNextRestart").set(clearOnNextRestart);
2500 * Returns whether Sone should really clear its settings on next
2501 * restart. This is a confirmation option that needs to be set in
2502 * addition to {@link #isClearOnNextRestart()} in order to clear Sone’s
2503 * settings on the next restart.
2505 * @return {@code true} if Sone should really clear its settings on the
2506 * next restart, {@code false} otherwise
2508 public boolean isReallyClearOnNextRestart() {
2509 return options.getBooleanOption("ReallyClearOnNextRestart").get();
2513 * Sets whether Sone should really clear its settings on the next
2516 * @param reallyClearOnNextRestart
2517 * {@code true} if Sone should really clear its settings on
2518 * the next restart, {@code false} otherwise
2519 * @return This preferences
2521 public Preferences setReallyClearOnNextRestart(Boolean reallyClearOnNextRestart) {
2522 options.getBooleanOption("ReallyClearOnNextRestart").set(reallyClearOnNextRestart);