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
5fbb333
..
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,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,109
+34,121
@@
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 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
rescuedSone(Sone sone
);
+ public void
postRemoved(Post post
);
/**
/**
- * Notifies a listener that
a new Sone has been discover
ed.
+ * Notifies a listener that
the given reply was remov
ed.
*
*
- * @param
sone
- * The
new Sone
+ * @param
reply
+ * The
removed reply
*/
*/
- public void
newSoneFound(Sone sone
);
+ public void
replyRemoved(PostReply reply
);
/**
/**
- * Notifies a listener
that a new post has been foun
d.
+ * Notifies a listener
when a Sone was locke
d.
*
*
- * @param
post
- * The
new post
+ * @param
sone
+ * The
Sone that was locked
*/
*/
- public void
newPostFound(Post post
);
+ public void
soneLocked(Sone sone
);
/**
/**
- * Notifies a listener that a
new reply has been foun
d.
+ * Notifies a listener that a
Sone was unlocke
d.
*
*
- * @param
reply
- * The
new reply
+ * @param
sone
+ * The
Sone that was unlocked
*/
*/
- public void
newReplyFound(Reply reply
);
+ public void
soneUnlocked(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 started
.
*
*
+ * @see SoneInsertListener#insertStarted(Sone)
* @param sone
* @param sone
- * The
known Sone
+ * The
Sone that is being inserted
*/
*/
- public void
markSoneKnown
(Sone sone);
+ public void
soneInserting
(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 finished
+ * successfully.
*
*
- * @param post
- * The known post
+ * @see SoneInsertListener#insertFinished(Sone, long)
+ * @param sone
+ * The Sone that has been inserted
+ * @param insertDuration
+ * The insert duration (in milliseconds)
*/
*/
- public void
markPostKnown(Post post
);
+ public void
soneInserted(Sone sone, long insertDuration
);
/**
/**
- * Notifies a listener that the
given reply is now marked as known
.
+ * Notifies a listener that the
insert of the given Sone was aborted
.
*
*
- * @param reply
- * The known reply
+ * @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
markReplyKnown(Reply reply
);
+ public void
soneInsertAborted(Sone sone, Throwable cause
);
/**
/**
- * 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 foun
d
- * @param
releaseTim
e
- * The re
lease time of the new version
+ * @param
image
+ * The
image that could not be inserte
d
+ * @param
caus
e
+ * The re
ason for the failed insert
*/
*/
- public void
updateFound(Version version, long releaseTim
e);
+ public void
imageInsertFailed(Image image, Throwable caus
e);
}
}