projects
/
Sone.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Convert “post reply marked as known” into EventBus-based event.
[Sone.git]
/
src
/
main
/
java
/
net
/
pterodactylus
/
sone
/
core
/
CoreListener.java
diff --git
a/src/main/java/net/pterodactylus/sone/core/CoreListener.java
b/src/main/java/net/pterodactylus/sone/core/CoreListener.java
index
5d5e715
..
f2ec67a
100644
(file)
--- a/
src/main/java/net/pterodactylus/sone/core/CoreListener.java
+++ b/
src/main/java/net/pterodactylus/sone/core/CoreListener.java
@@
-1,5
+1,5
@@
/*
/*
- * Sone - CoreListener.java - Copyright © 2010 David Roden
+ * Sone - CoreListener.java - Copyright © 2010
–2012
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
*
* 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
@@
-19,9
+19,11
@@
package net.pterodactylus.sone.core;
import java.util.EventListener;
import java.util.EventListener;
+import net.pterodactylus.sone.data.Image;
import net.pterodactylus.sone.data.Post;
import net.pterodactylus.sone.data.Post;
-import net.pterodactylus.sone.data.Reply;
+import net.pterodactylus.sone.data.
Post
Reply;
import net.pterodactylus.sone.data.Sone;
import net.pterodactylus.sone.data.Sone;
+import net.pterodactylus.util.version.Version;
/**
* Listener interface for objects that want to be notified on certain
/**
* Listener interface for objects that want to be notified on certain
@@
-32,99
+34,121
@@
import net.pterodactylus.sone.data.Sone;
public interface CoreListener extends EventListener {
/**
public interface CoreListener extends EventListener {
/**
- * Notifies a listener that
a Sone is now being rescu
ed.
+ * Notifies a listener that
the given Sone was remov
ed.
*
* @param sone
*
* @param sone
- * The
Sone that is rescued
+ * The
removed Sone
*/
*/
- public void
rescuingSone
(Sone sone);
+ public void
soneRemoved
(Sone sone);
/**
/**
- * Notifies a listener that the
Sone was rescued and can now be unlock
ed.
+ * Notifies a listener that the
given post was remov
ed.
*
*
- * @param sone
- * The Sone that was rescued
+ * @param post
+ * The removed post
+ */
+ public void postRemoved(Post post);
+
+ /**
+ * Notifies a listener that the given reply was removed.
+ *
+ * @param reply
+ * The removed reply
*/
*/
- public void re
scuedSone(Sone sone
);
+ public void re
plyRemoved(PostReply reply
);
/**
/**
- * Notifies a listener
that a new Sone has been discover
ed.
+ * Notifies a listener
when a Sone was lock
ed.
*
* @param sone
*
* @param sone
- * The
new Sone
+ * The
Sone that was locked
*/
*/
- public void
newSoneFoun
d(Sone sone);
+ public void
soneLocke
d(Sone sone);
/**
/**
- * Notifies a listener that a
new post has been foun
d.
+ * Notifies a listener that a
Sone was unlocke
d.
*
*
- * @param
post
- * The
new post
+ * @param
sone
+ * The
Sone that was unlocked
*/
*/
- public void
newPostFound(Post post
);
+ public void
soneUnlocked(Sone sone
);
/**
/**
- * Notifies a listener that
a new reply has been foun
d.
+ * Notifies a listener that
the insert of the given Sone has starte
d.
*
*
- * @param reply
- * The new reply
+ * @see SoneInsertListener#insertStarted(Sone)
+ * @param sone
+ * The Sone that is being inserted
*/
*/
- public void
newReplyFound(Reply reply
);
+ public void
soneInserting(Sone sone
);
/**
/**
- * Notifies a listener that the given Sone is now marked as known.
+ * Notifies a listener that the insert of the given Sone has finished
+ * successfully.
*
*
+ * @see SoneInsertListener#insertFinished(Sone, long)
* @param sone
* @param sone
- * The known Sone
+ * The Sone that has been inserted
+ * @param insertDuration
+ * The insert duration (in milliseconds)
*/
*/
- public void
markSoneKnown(Sone sone
);
+ public void
soneInserted(Sone sone, long insertDuration
);
/**
/**
- * Notifies a listener that the
given post is now marked as known
.
+ * Notifies a listener that the
insert of the given Sone was aborted
.
*
*
- * @param post
- * The known post
+ * @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
markPostKnown(Post post
);
+ public void
soneInsertAborted(Sone sone, Throwable cause
);
/**
/**
- * Notifies a listener that
the given reply is now marked as known
.
+ * Notifies a listener that
a new version has been found
.
*
*
- * @param reply
- * The known reply
+ * @param version
+ * The version that was found
+ * @param releaseTime
+ * The release time of the new version
+ * @param latestEdition
+ * The latest edition of the Sone homepage
*/
*/
- public void
markReplyKnown(Reply reply
);
+ public void
updateFound(Version version, long releaseTime, long latestEdition
);
/**
/**
- * Notifies a listener that
the given post was remov
ed.
+ * Notifies a listener that
an image has started being insert
ed.
*
*
- * @param
post
- * The
removed post
+ * @param
image
+ * The
image that is now inserted
*/
*/
- public void
postRemoved(Post post
);
+ public void
imageInsertStarted(Image image
);
/**
/**
- * Notifies a listener that
the given reply was removed
.
+ * Notifies a listener that
an image insert was aborted by the user
.
*
*
- * @param
reply
- * The
removed reply
+ * @param
image
+ * The
image that is not inserted anymore
*/
*/
- public void
replyRemoved(Reply reply
);
+ public void
imageInsertAborted(Image image
);
/**
/**
- * Notifies a listener
when a Sone was lock
ed.
+ * Notifies a listener
that an image was successfully insert
ed.
*
*
- * @param
son
e
- * The
Sone that was lock
ed
+ * @param
imag
e
+ * The
image that was insert
ed
*/
*/
- public void
soneLocked(Sone son
e);
+ public void
imageInsertFinished(Image imag
e);
/**
/**
- * Notifies a listener that a
Sone was unlock
ed.
+ * Notifies a listener that a
n image failed to be insert
ed.
*
*
- * @param sone
- * The Sone that was unlocked
+ * @param image
+ * The image that could not be inserted
+ * @param cause
+ * The reason for the failed insert
*/
*/
- public void
soneUnlocked(Sone son
e);
+ public void
imageInsertFailed(Image image, Throwable caus
e);
}
}