Fix ALL the logging!
[Sone.git] / src / main / java / net / pterodactylus / sone / core / CoreListener.java
index d34ac36..2e7b337 100644 (file)
@@ -19,8 +19,9 @@ package net.pterodactylus.sone.core;
 
 import java.util.EventListener;
 
+import net.pterodactylus.sone.data.Image;
 import net.pterodactylus.sone.data.Post;
-import net.pterodactylus.sone.data.Reply;
+import net.pterodactylus.sone.data.PostReply;
 import net.pterodactylus.sone.data.Sone;
 import net.pterodactylus.util.version.Version;
 
@@ -33,22 +34,6 @@ import net.pterodactylus.util.version.Version;
 public interface CoreListener extends EventListener {
 
        /**
-        * Notifies a listener that a Sone is now being rescued.
-        *
-        * @param sone
-        *            The Sone that is rescued
-        */
-       public void rescuingSone(Sone sone);
-
-       /**
-        * Notifies a listener that the Sone was rescued and can now be unlocked.
-        *
-        * @param sone
-        *            The Sone that was rescued
-        */
-       public void rescuedSone(Sone sone);
-
-       /**
         * Notifies a listener that a new Sone has been discovered.
         *
         * @param sone
@@ -70,7 +55,7 @@ public interface CoreListener extends EventListener {
         * @param reply
         *            The new reply
         */
-       public void newReplyFound(Reply reply);
+       public void newReplyFound(PostReply reply);
 
        /**
         * Notifies a listener that the given Sone is now marked as known.
@@ -94,7 +79,7 @@ public interface CoreListener extends EventListener {
         * @param reply
         *            The known reply
         */
-       public void markReplyKnown(Reply reply);
+       public void markReplyKnown(PostReply reply);
 
        /**
         * Notifies a listener that the given Sone was removed.
@@ -118,7 +103,7 @@ public interface CoreListener extends EventListener {
         * @param reply
         *            The removed reply
         */
-       public void replyRemoved(Reply reply);
+       public void replyRemoved(PostReply reply);
 
        /**
         * Notifies a listener when a Sone was locked.
@@ -137,6 +122,38 @@ public interface CoreListener extends EventListener {
        public void soneUnlocked(Sone sone);
 
        /**
+        * Notifies a listener that the insert of the given Sone has started.
+        *
+        * @see SoneInsertListener#insertStarted(Sone)
+        * @param sone
+        *            The Sone that is being inserted
+        */
+       public void soneInserting(Sone sone);
+
+       /**
+        * Notifies a listener that the insert of the given Sone has finished
+        * successfully.
+        *
+        * @see SoneInsertListener#insertFinished(Sone, long)
+        * @param sone
+        *            The Sone that has been inserted
+        * @param insertDuration
+        *            The insert duration (in milliseconds)
+        */
+       public void soneInserted(Sone sone, long insertDuration);
+
+       /**
+        * Notifies a listener that the insert of the given Sone was aborted.
+        *
+        * @see SoneInsertListener#insertAborted(Sone, Throwable)
+        * @param sone
+        *            The Sone that was inserted
+        * @param cause
+        *            The cause for the abortion (may be {@code null})
+        */
+       public void soneInsertAborted(Sone sone, Throwable cause);
+
+       /**
         * Notifies a listener that a new version has been found.
         *
         * @param version
@@ -148,4 +165,38 @@ public interface CoreListener extends EventListener {
         */
        public void updateFound(Version version, long releaseTime, long latestEdition);
 
+       /**
+        * Notifies a listener that an image has started being inserted.
+        *
+        * @param image
+        *            The image that is now inserted
+        */
+       public void imageInsertStarted(Image image);
+
+       /**
+        * Notifies a listener that an image insert was aborted by the user.
+        *
+        * @param image
+        *            The image that is not inserted anymore
+        */
+       public void imageInsertAborted(Image image);
+
+       /**
+        * Notifies a listener that an image was successfully inserted.
+        *
+        * @param image
+        *            The image that was inserted
+        */
+       public void imageInsertFinished(Image image);
+
+       /**
+        * Notifies a listener that an image failed to be inserted.
+        *
+        * @param image
+        *            The image that could not be inserted
+        * @param cause
+        *            The reason for the failed insert
+        */
+       public void imageInsertFailed(Image image, Throwable cause);
+
 }