Blocking or unblocking sites inserts a new update of a Sone.
[Sone.git] / src / main / java / net / pterodactylus / sone / data / Sone.java
index 9df1a8f..3e808a8 100644 (file)
 package net.pterodactylus.sone.data;
 
 import java.util.ArrayList;
+import java.util.Collection;
 import java.util.Collections;
+import java.util.Comparator;
 import java.util.HashSet;
 import java.util.List;
 import java.util.Set;
 import java.util.UUID;
+import java.util.logging.Level;
+import java.util.logging.Logger;
 
+import net.pterodactylus.util.logging.Logging;
 import freenet.keys.FreenetURI;
 
 /**
@@ -36,18 +41,24 @@ import freenet.keys.FreenetURI;
  */
 public class Sone {
 
+       /** The logger. */
+       private static final Logger logger = Logging.getLogger(Sone.class);
+
        /** A GUID for this Sone. */
        private final UUID id;
 
        /** The name of this Sone. */
-       private final String name;
+       private String name;
 
        /** The URI under which the Sone is stored in Freenet. */
-       private final FreenetURI requestUri;
+       private FreenetURI requestUri;
 
        /** The URI used to insert a new version of this Sone. */
        /* This will be null for remote Sones! */
-       private final FreenetURI insertUri;
+       private FreenetURI insertUri;
+
+       /** The time of the last inserted update. */
+       private long time;
 
        /** The profile of this Sone. */
        private Profile profile;
@@ -56,11 +67,14 @@ public class Sone {
        private final Set<Sone> friendSones = new HashSet<Sone>();
 
        /** All posts. */
-       private final List<Post> posts = new ArrayList<Post>();
+       private final Set<Post> posts = new HashSet<Post>();
 
        /** All replies. */
        private final Set<Reply> replies = new HashSet<Reply>();
 
+       /** The IDs of all blocked Sones. */
+       private final Set<String> blockedSoneIds = new HashSet<String>();
+
        /** Modification count. */
        private volatile long modificationCounter = 0;
 
@@ -69,32 +83,9 @@ public class Sone {
         *
         * @param id
         *            The ID of this Sone
-        * @param name
-        *            The name of the Sone
-        * @param requestUri
-        *            The request URI of the Sone
-        */
-       public Sone(UUID id, String name, FreenetURI requestUri) {
-               this(id, name, requestUri, null);
-       }
-
-       /**
-        * Creates a new Sone.
-        *
-        * @param id
-        *            The ID of this Sone
-        * @param name
-        *            The name of the Sone
-        * @param requestUri
-        *            The request URI of the Sone
-        * @param insertUri
-        *            The insert URI of the Sone
         */
-       public Sone(UUID id, String name, FreenetURI requestUri, FreenetURI insertUri) {
-               this.id = id;
-               this.name = name;
-               this.requestUri = requestUri;
-               this.insertUri = insertUri;
+       public Sone(String id) {
+               this.id = UUID.fromString(id);
        }
 
        //
@@ -120,6 +111,18 @@ public class Sone {
        }
 
        /**
+        * Sets the name of this Sone.
+        *
+        * @param name
+        *            The name of this Sone
+        * @return This sone (for method chaining)
+        */
+       public Sone setName(String name) {
+               this.name = name;
+               return this;
+       }
+
+       /**
         * Returns the request URI of this Sone.
         *
         * @return The request URI of this Sone
@@ -129,6 +132,18 @@ public class Sone {
        }
 
        /**
+        * Sets the request URI of this Sone.
+        *
+        * @param requestUri
+        *            The request URI of this Sone
+        * @return This Sone (for method chaining)
+        */
+       public Sone setRequestUri(FreenetURI requestUri) {
+               this.requestUri = requestUri;
+               return this;
+       }
+
+       /**
         * Returns the insert URI of this Sone.
         *
         * @return The insert URI of this Sone
@@ -138,6 +153,39 @@ public class Sone {
        }
 
        /**
+        * Sets the insert URI of this Sone.
+        *
+        * @param insertUri
+        *            The insert URI of this Sone
+        * @return This Sone (for method chaining)
+        */
+       public Sone setInsertUri(FreenetURI insertUri) {
+               this.insertUri = insertUri;
+               return this;
+       }
+
+       /**
+        * Return the time of the last inserted update of this Sone.
+        *
+        * @return The time of the update (in milliseconds since Jan 1, 1970 UTC)
+        */
+       public long getTime() {
+               return time;
+       }
+
+       /**
+        * Sets the time of the last inserted update of this Sone.
+        *
+        * @param time
+        *            The time of the update (in milliseconds since Jan 1, 1970 UTC)
+        * @return This Sone (for method chaining)
+        */
+       public Sone setTime(long time) {
+               this.time = time;
+               return this;
+       }
+
+       /**
         * Returns a copy of the profile. If you want to update values in the
         * profile of this Sone, update the values in the returned {@link Profile}
         * and use {@link #setProfile(Profile)} to change the profile in this Sone.
@@ -166,11 +214,25 @@ public class Sone {
         *
         * @return The friend Sones of this Sone
         */
-       public Set<Sone> getFriendSones() {
+       public Set<Sone> getFriends() {
                return Collections.unmodifiableSet(friendSones);
        }
 
        /**
+        * Sets all friends of this Sone at once.
+        *
+        * @param friends
+        *            The new (and only) friends of this Sone
+        * @return This Sone (for method chaining)
+        */
+       public synchronized Sone setFriends(Collection<Sone> friends) {
+               friendSones.clear();
+               friendSones.addAll(friends);
+               modificationCounter++;
+               return this;
+       }
+
+       /**
         * Returns whether this Sone has the given Sone as a friend Sone.
         *
         * @param friendSone
@@ -178,7 +240,7 @@ public class Sone {
         * @return {@code true} if this Sone has the given Sone as a friend,
         *         {@code false} otherwise
         */
-       public boolean hasFriendSone(Sone friendSone) {
+       public boolean hasFriend(Sone friendSone) {
                return friendSones.contains(friendSone);
        }
 
@@ -189,8 +251,8 @@ public class Sone {
         *            The friend Sone to add
         * @return This Sone (for method chaining)
         */
-       public synchronized Sone addFriendSone(Sone friendSone) {
-               if (friendSones.add(friendSone)) {
+       public synchronized Sone addFriend(Sone friendSone) {
+               if (!friendSone.equals(this) && friendSones.add(friendSone)) {
                        modificationCounter++;
                }
                return this;
@@ -203,7 +265,7 @@ public class Sone {
         *            The friend Sone to remove
         * @return This Sone (for method chaining)
         */
-       public synchronized Sone removeFriendSone(Sone friendSone) {
+       public synchronized Sone removeFriend(Sone friendSone) {
                if (friendSones.remove(friendSone)) {
                        modificationCounter++;
                }
@@ -211,12 +273,35 @@ public class Sone {
        }
 
        /**
-        * Returns the list of posts of this Sone.
+        * Returns the list of posts of this Sone, sorted by time, newest first.
         *
         * @return All posts of this Sone
         */
        public List<Post> getPosts() {
-               return Collections.unmodifiableList(posts);
+               List<Post> sortedPosts = new ArrayList<Post>(posts);
+               Collections.sort(sortedPosts, new Comparator<Post>() {
+
+                       @Override
+                       public int compare(Post leftPost, Post rightPost) {
+                               return (int) Math.max(Integer.MIN_VALUE, Math.min(Integer.MAX_VALUE, rightPost.getTime() - leftPost.getTime()));
+                       }
+
+               });
+               return sortedPosts;
+       }
+
+       /**
+        * Sets all posts of this Sone at once.
+        *
+        * @param posts
+        *            The new (and only) posts of this Sone
+        * @return This Sone (for method chaining)
+        */
+       public synchronized Sone setPosts(Collection<Post> posts) {
+               this.posts.clear();
+               this.posts.addAll(posts);
+               modificationCounter++;
+               return this;
        }
 
        /**
@@ -228,6 +313,7 @@ public class Sone {
         */
        public synchronized void addPost(Post post) {
                if (post.getSone().equals(this) && posts.add(post)) {
+                       logger.log(Level.FINEST, "Adding %s to “%s”.", new Object[] { post, getName() });
                        modificationCounter++;
                }
        }
@@ -250,10 +336,25 @@ public class Sone {
         * @return All replies this Sone made
         */
        public Set<Reply> getReplies() {
+               logger.log(Level.FINEST, "Friends of %s: %s", new Object[] { this, friendSones });
                return Collections.unmodifiableSet(replies);
        }
 
        /**
+        * Sets all replies of this Sone at once.
+        *
+        * @param replies
+        *            The new (and only) replies of this Sone
+        * @return This Sone (for method chaining)
+        */
+       public synchronized Sone setReplies(Collection<Reply> replies) {
+               this.replies.clear();
+               this.replies.addAll(replies);
+               modificationCounter++;
+               return this;
+       }
+
+       /**
         * Adds a reply to this Sone. If the given reply was not made by this Sone,
         * nothing is added to this Sone.
         *
@@ -279,6 +380,52 @@ public class Sone {
        }
 
        /**
+        * Returns the IDs of all blocked Sones. These Sones will not propagated
+        * using the “known Sones” mechanism.
+        *
+        * @return The IDs of all blocked Sones
+        */
+       public Set<String> getBlockedSoneIds() {
+               return Collections.unmodifiableSet(blockedSoneIds);
+       }
+
+       /**
+        * Returns whether the given Sone ID is blocked.
+        *
+        * @param soneId
+        *            The Sone ID to check
+        * @return {@code true} if the given Sone ID is blocked, {@code false}
+        *         otherwise
+        */
+       public boolean isSoneBlocked(String soneId) {
+               return blockedSoneIds.contains(soneId);
+       }
+
+       /**
+        * Adds the given ID to the list of blocked IDs.
+        *
+        * @param soneId
+        *            The Sone ID to block
+        */
+       public synchronized void addBlockedSoneId(String soneId) {
+               if (blockedSoneIds.add(soneId)) {
+                       modificationCounter++;
+               }
+       }
+
+       /**
+        * Removes the given ID from the list of blocked IDs.
+        *
+        * @param soneId
+        *            The Sone ID to unblock
+        */
+       public synchronized void removeBlockedSoneId(String soneId) {
+               if (blockedSoneIds.remove(soneId)) {
+                       modificationCounter++;
+               }
+       }
+
+       /**
         * Returns the modification counter.
         *
         * @return The modification counter
@@ -297,6 +444,21 @@ public class Sone {
                this.modificationCounter = modificationCounter;
        }
 
+       /**
+        * Updates the suggested edition in both the request URI and the insert URI.
+        *
+        * @param requestUri
+        *            The request URI that resulted from an insert
+        */
+       public void updateUris(FreenetURI requestUri) {
+               /* TODO - check for the correct URI. */
+               long latestEdition = requestUri.getSuggestedEdition();
+               this.requestUri = this.requestUri.setSuggestedEdition(latestEdition);
+               if (this.insertUri != null) {
+                       this.insertUri = this.insertUri.setSuggestedEdition(latestEdition);
+               }
+       }
+
        //
        // OBJECT METHODS
        //
@@ -320,4 +482,12 @@ public class Sone {
                return ((Sone) object).id.equals(id);
        }
 
+       /**
+        * {@inheritDoc}
+        */
+       @Override
+       public String toString() {
+               return getClass().getName() + "[id=" + id + ",name=" + name + ",requestUri=" + requestUri + ",insertUri=" + insertUri + ",friends(" + friendSones.size() + "),posts(" + posts.size() + "),replies(" + replies.size() + ")]";
+       }
+
 }