+ /**
+ * Returns the Sone with the given ID, or an empty Sone that has been
+ * initialized with the given ID.
+ *
+ * @param soneId
+ * The ID of the Sone
+ * @return The Sone
+ */
+ public Sone getSone(String soneId) {
+ if (!soneCache.containsKey(soneId)) {
+ Sone sone = new Sone(soneId);
+ soneCache.put(soneId, sone);
+ setSoneStatus(sone, SoneStatus.unknown);
+ }
+ return soneCache.get(soneId);
+ }
+
+ /**
+ * Returns all known sones.
+ *
+ * @return All known sones
+ */
+ public Collection<Sone> getKnownSones() {
+ return soneCache.values();
+ }
+
+ /**
+ * Gets all known Sones that are not local Sones.
+ *
+ * @return All remote Sones
+ */
+ public Collection<Sone> getRemoteSones() {
+ return Filters.filteredCollection(getKnownSones(), new Filter<Sone>() {
+
+ @Override
+ @SuppressWarnings("synthetic-access")
+ public boolean filterObject(Sone object) {
+ return !localSones.contains(object);
+ }
+ });
+ }
+
+ /**
+ * Returns the status of the given Sone.
+ *
+ * @param sone
+ * The Sone to get the status for
+ * @return The status of the Sone
+ */
+ public SoneStatus getSoneStatus(Sone sone) {
+ return soneStatuses.get(sone);
+ }
+
+ /**
+ * Sets the status of the Sone.
+ *
+ * @param sone
+ * The Sone to set the status for
+ * @param soneStatus
+ * The status of the Sone
+ */
+ public void setSoneStatus(Sone sone, SoneStatus soneStatus) {
+ soneStatuses.put(sone, soneStatus);
+ }
+
+ /**
+ * Creates a new post and adds it to the given Sone.
+ *
+ * @param sone
+ * The sone that creates the post
+ * @param text
+ * The text of the post
+ * @return The created post
+ */
+ public Post createPost(Sone sone, String text) {
+ return createPost(sone, System.currentTimeMillis(), text);
+ }
+
+ /**
+ * Creates a new post and adds it to the given Sone.
+ *
+ * @param sone
+ * The Sone that creates the post
+ * @param time
+ * The time of the post
+ * @param text
+ * The text of the post
+ * @return The created post
+ */
+ public Post createPost(Sone sone, long time, String text) {
+ Post post = getPost(UUID.randomUUID().toString()).setSone(sone).setTime(time).setText(text);
+ sone.addPost(post);
+ return post;
+ }
+
+ /**
+ * Creates a reply.
+ *
+ * @param sone
+ * The Sone that posts the reply
+ * @param post
+ * The post the reply refers to
+ * @param text
+ * The text of the reply
+ * @return The created reply
+ */
+ public Reply createReply(Sone sone, Post post, String text) {
+ return createReply(sone, post, System.currentTimeMillis(), text);
+ }
+
+ /**
+ * Creates a reply.
+ *
+ * @param sone
+ * The Sone that posts the reply
+ * @param post
+ * The post the reply refers to
+ * @param time
+ * The time of the post
+ * @param text
+ * The text of the reply
+ * @return The created reply
+ */
+ public Reply createReply(Sone sone, Post post, long time, String text) {
+ Reply reply = getReply(UUID.randomUUID().toString()).setSone(sone).setPost(post).setTime(time).setText(text);
+ sone.addReply(reply);
+ return reply;
+ }
+