projects
/
Sone.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
Convert “Sone removed” 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
d34ac36
..
970d9e9
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,8
+19,9
@@
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.util.version.Version;
import net.pterodactylus.sone.data.Sone;
import net.pterodactylus.util.version.Version;
@@
-33,119
+34,113
@@
import net.pterodactylus.util.version.Version;
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 post was remov
ed.
*
*
- * @param
sone
- * The
Sone that is rescued
+ * @param
post
+ * The
removed post
*/
*/
- public void
rescuingSone(Sone sone
);
+ public void
postRemoved(Post post
);
/**
/**
- * Notifies a listener that the
Sone was rescued and can now be unlock
ed.
+ * Notifies a listener that the
given reply was remov
ed.
*
*
- * @param
sone
- * The
Sone that was rescued
+ * @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
- */
- public void newSoneFound(Sone sone);
-
- /**
- * Notifies a listener that a new post has been found.
- *
- * @param post
- * The new post
- */
- public void newPostFound(Post post);
-
- /**
- * Notifies a listener that a new reply has been found.
- *
- * @param reply
- * The new reply
+ * The Sone that was locked
*/
*/
- public void
newReplyFound(Reply reply
);
+ public void
soneLocked(Sone sone
);
/**
/**
- * Notifies a listener that
the given Sone is now marked as known
.
+ * Notifies a listener that
a Sone was unlocked
.
*
* @param sone
*
* @param sone
- * The
known Sone
+ * The
Sone that was unlocked
*/
*/
- public void
markSoneKnown
(Sone sone);
+ public void
soneUnlocked
(Sone sone);
/**
/**
- * Notifies a listener that the
given post is now marked as known
.
+ * Notifies a listener that the
insert of the given Sone has started
.
*
*
- * @param post
- * The known post
+ * @see SoneInsertListener#insertStarted(Sone)
+ * @param sone
+ * The Sone that is being inserted
*/
*/
- public void
markPostKnown(Post post
);
+ public void
soneInserting(Sone sone
);
/**
/**
- * Notifies a listener that the given reply is now marked as known.
+ * Notifies a listener that the insert of the given Sone has finished
+ * successfully.
*
*
- * @param reply
- * The known reply
+ * @see SoneInsertListener#insertFinished(Sone, long)
+ * @param sone
+ * The Sone that has been inserted
+ * @param insertDuration
+ * The insert duration (in milliseconds)
*/
*/
- public void
markReplyKnown(Reply reply
);
+ public void
soneInserted(Sone sone, long insertDuration
);
/**
/**
- * Notifies a listener that the
given Sone was remov
ed.
+ * Notifies a listener that the
insert of the given Sone was abort
ed.
*
*
+ * @see SoneInsertListener#insertAborted(Sone, Throwable)
* @param sone
* @param sone
- * The removed Sone
+ * The Sone that was inserted
+ * @param cause
+ * The cause for the abortion (may be {@code null})
*/
*/
- public void sone
Removed(Sone son
e);
+ public void sone
InsertAborted(Sone sone, Throwable caus
e);
/**
/**
- * Notifies a listener that
the given post was remove
d.
+ * Notifies a listener that
a new version has been foun
d.
*
*
- * @param post
- * The removed post
+ * @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
postRemoved(Post post
);
+ public void
updateFound(Version version, long releaseTime, long latestEdition
);
/**
/**
- * Notifies a listener that
the given reply was remov
ed.
+ * Notifies a listener that
an image has started being insert
ed.
*
*
- * @param
reply
- * The
removed reply
+ * @param
image
+ * The
image that is now inserted
*/
*/
- public void
replyRemoved(Reply reply
);
+ public void
imageInsertStarted(Image image
);
/**
/**
- * Notifies a listener
when a Sone was locked
.
+ * Notifies a listener
that an image insert was aborted by the user
.
*
*
- * @param
son
e
- * The
Sone that was locked
+ * @param
imag
e
+ * The
image that is not inserted anymore
*/
*/
- public void
soneLocked(Sone son
e);
+ public void
imageInsertAborted(Image imag
e);
/**
/**
- * Notifies a listener that a
Sone was unlock
ed.
+ * Notifies a listener that a
n image was successfully insert
ed.
*
*
- * @param
son
e
- * The
Sone that was unlock
ed
+ * @param
imag
e
+ * The
image that was insert
ed
*/
*/
- public void
soneUnlocked(Sone son
e);
+ public void
imageInsertFinished(Image imag
e);
/**
/**
- * Notifies a listener that a
new version has been foun
d.
+ * Notifies a listener that a
n image failed to be inserte
d.
*
*
- * @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
+ * @param image
+ * The image that could not be inserted
+ * @param cause
+ * The reason for the failed insert
*/
*/
- public void
updateFound(Version version, long releaseTime, long latestEdition
);
+ public void
imageInsertFailed(Image image, Throwable cause
);
}
}