🔀 Merge branch 'release/v82'
[Sone.git] / src / main / java / net / pterodactylus / sone / data / Reply.java
index 2dacfbe..0cf2a52 100644 (file)
@@ -1,5 +1,5 @@
 /*
- * Sone - Reply.java - Copyright Â© 2010 David Roden
+ * Sone - Reply.java - Copyright Â© 2010–2020 David Roden
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
 
 package net.pterodactylus.sone.data;
 
-import java.util.Comparator;
-import java.util.UUID;
-
-import net.pterodactylus.util.filter.Filter;
-
 /**
- * A reply is like a {@link Post} but can never be posted on its own, it always
- * refers to another {@link Post}.
+ * Defines methods common for all replies.
  *
- * @author <a href="mailto:bombe@pterodactylus.net">David â€˜Bombe’ Roden</a>
+ * @param <T>
+ *            The type of the reply
  */
-public class Reply {
-
-       /** Comparator that sorts replies ascending by time. */
-       public static final Comparator<Reply> TIME_COMPARATOR = new Comparator<Reply>() {
-
-               @Override
-               public int compare(Reply leftReply, Reply rightReply) {
-                       return (int) Math.max(Integer.MIN_VALUE, Math.min(Integer.MAX_VALUE, leftReply.getTime() - rightReply.getTime()));
-               }
-
-       };
-
-       /** Filter for replies with timestamps from the future. */
-       public static final Filter<Reply> FUTURE_REPLIES_FILTER = new Filter<Reply>() {
-
-               @Override
-               public boolean filterObject(Reply reply) {
-                       return reply.getTime() <= System.currentTimeMillis();
-               }
-
-       };
-
-       /** The ID of the reply. */
-       private final UUID id;
-
-       /** The Sone that posted this reply. */
-       private volatile Sone sone;
-
-       /** The Post this reply refers to. */
-       private volatile Post post;
-
-       /** The time of the reply. */
-       private volatile long time;
-
-       /** The text of the reply. */
-       private volatile String text;
-
-       /**
-        * Creates a new reply.
-        *
-        * @param id
-        *            The ID of the reply
-        */
-       public Reply(String id) {
-               this(id, null, null, 0, null);
-       }
-
-       /**
-        * Creates a new reply.
-        *
-        * @param sone
-        *            The sone that posted the reply
-        * @param post
-        *            The post to reply to
-        * @param text
-        *            The text of the reply
-        */
-       public Reply(Sone sone, Post post, String text) {
-               this(sone, post, System.currentTimeMillis(), text);
-       }
-
-       /**
-        * Creates a new reply-
-        *
-        * @param sone
-        *            The sone that posted the reply
-        * @param post
-        *            The post to reply to
-        * @param time
-        *            The time of the reply
-        * @param text
-        *            The text of the reply
-        */
-       public Reply(Sone sone, Post post, long time, String text) {
-               this(UUID.randomUUID().toString(), sone, post, time, text);
-       }
-
-       /**
-        * Creates a new reply-
-        *
-        * @param sone
-        *            The sone that posted the reply
-        * @param id
-        *            The ID of the reply
-        * @param post
-        *            The post to reply to
-        * @param time
-        *            The time of the reply
-        * @param text
-        *            The text of the reply
-        */
-       public Reply(String id, Sone sone, Post post, long time, String text) {
-               this.id = UUID.fromString(id);
-               this.sone = sone;
-               this.post = post;
-               this.time = time;
-               this.text = text;
-       }
-
-       //
-       // ACCESSORS
-       //
+public interface Reply<T extends Reply<T>> extends Identified {
 
        /**
         * Returns the ID of the reply.
         *
         * @return The ID of the reply
         */
-       public String getId() {
-               return id.toString();
-       }
+       public String getId();
 
        /**
         * Returns the Sone that posted this reply.
         *
         * @return The Sone that posted this reply
         */
-       public Sone getSone() {
-               return sone;
-       }
-
-       /**
-        * Sets the Sone that posted this reply.
-        *
-        * @param sone
-        *            The Sone that posted this reply
-        * @return This reply (for method chaining)
-        */
-       public Reply setSone(Sone sone) {
-               this.sone = sone;
-               return this;
-       }
-
-       /**
-        * Returns the post this reply refers to.
-        *
-        * @return The post this reply refers to
-        */
-       public Post getPost() {
-               return post;
-       }
-
-       /**
-        * Sets the post this reply refers to.
-        *
-        * @param post
-        *            The post this reply refers to
-        * @return This reply (for method chaining)
-        */
-       public Reply setPost(Post post) {
-               this.post = post;
-               return this;
-       }
+       public Sone getSone();
 
        /**
         * Returns the time of the reply.
         *
         * @return The time of the reply (in milliseconds since Jan 1, 1970 UTC)
         */
-       public long getTime() {
-               return time;
-       }
-
-       /**
-        * Sets the time of this reply.
-        *
-        * @param time
-        *            The time of this reply (in milliseconds since Jan 1, 1970 UTC)
-        * @return This reply (for method chaining)
-        */
-       public Reply setTime(long time) {
-               this.time = time;
-               return this;
-       }
+       public long getTime();
 
        /**
         * Returns the text of the reply.
         *
         * @return The text of the reply
         */
-       public String getText() {
-               return text;
-       }
+       public String getText();
 
        /**
-        * Sets the text of this reply.
+        * Returns whether this reply is known.
         *
-        * @param text
-        *            The text of this reply
-        * @return This reply (for method chaining)
-        */
-       public Reply setText(String text) {
-               this.text = text;
-               return this;
-       }
-
-       //
-       // OBJECT METHODS
-       //
-
-       /**
-        * {@inheritDoc}
-        */
-       @Override
-       public int hashCode() {
-               return id.hashCode();
-       }
-
-       /**
-        * {@inheritDoc}
-        */
-       @Override
-       public boolean equals(Object object) {
-               if (!(object instanceof Reply)) {
-                       return false;
-               }
-               Reply reply = (Reply) object;
-               return reply.id.equals(id);
-       }
-
-       /**
-        * {@inheritDoc}
+        * @return {@code true} if this reply is known, {@code false} otherwise
         */
-       @Override
-       public String toString() {
-               return getClass().getName() + "[id=" + id + ",sone=" + sone + ",post=" + post + ",time=" + time + ",text=" + text + "]";
-       }
+       public boolean isKnown();
 
 }