projects
/
Sone.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Convert “Sone locked” 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
595d11a
..
a826e64
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,9
@@
package net.pterodactylus.sone.core;
import java.util.EventListener;
import java.util.EventListener;
-import net.pterodactylus.sone.data.Post;
-import net.pterodactylus.sone.data.Reply;
+import net.pterodactylus.sone.data.Image;
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,67
+32,89
@@
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 a Sone
was unlock
ed.
*
* @param sone
*
* @param sone
- * The Sone that
is rescu
ed
+ * The Sone that
was unlock
ed
*/
*/
- public void
rescuingSone
(Sone sone);
+ public void
soneUnlocked
(Sone sone);
/**
/**
- * Notifies a listener that the
Sone was rescued and can now be unlock
ed.
+ * Notifies a listener that the
insert of the given Sone has start
ed.
*
*
+ * @see SoneInsertListener#insertStarted(Sone)
* @param sone
* @param sone
- * The Sone that
was rescu
ed
+ * The Sone that
is being insert
ed
*/
*/
- public void
rescuedSone
(Sone sone);
+ public void
soneInserting
(Sone sone);
/**
/**
- * Notifies a listener that a new Sone has been discovered.
+ * Notifies a listener that the insert of the given Sone has finished
+ * successfully.
*
*
+ * @see SoneInsertListener#insertFinished(Sone, long)
* @param sone
* @param sone
- * The new Sone
+ * The Sone that has been inserted
+ * @param insertDuration
+ * The insert duration (in milliseconds)
*/
*/
- public void
newSoneFound(Sone sone
);
+ public void
soneInserted(Sone sone, long insertDuration
);
/**
/**
- * Notifies a listener that
a new post has been foun
d.
+ * Notifies a listener that
the insert of the given Sone was aborte
d.
*
*
- * @param post
- * The new 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
newPostFound(Post post
);
+ public void
soneInsertAborted(Sone sone, Throwable cause
);
/**
/**
- * Notifies a listener that a new
reply
has been found.
+ * Notifies a listener that a new
version
has been found.
*
*
- * @param reply
- * The new 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
newReplyFound(Reply reply
);
+ public void
updateFound(Version version, long releaseTime, long latestEdition
);
/**
/**
- * Notifies a listener that
the given Sone is now marked as known
.
+ * Notifies a listener that
an image has started being inserted
.
*
*
- * @param sone
- * The known Sone
+ * @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
markSoneKnown(Sone son
e);
+ public void
imageInsertAborted(Image imag
e);
/**
/**
- * Notifies a listener that
the given post is now marked as known
.
+ * Notifies a listener that
an image was successfully inserted
.
*
*
- * @param
post
- * The
known post
+ * @param
image
+ * The
image that was inserted
*/
*/
- public void
markPostKnown(Post post
);
+ public void
imageInsertFinished(Image image
);
/**
/**
- * Notifies a listener that
the given reply is now marked as known
.
+ * Notifies a listener that
an image failed to be inserted
.
*
*
- * @param reply
- * The known reply
+ * @param image
+ * The image that could not be inserted
+ * @param cause
+ * The reason for the failed insert
*/
*/
- public void
markReplyKnown(Reply reply
);
+ public void
imageInsertFailed(Image image, Throwable cause
);
}
}