hand reason for disconnects to listeners
[jFCPlib.git] / src / net / pterodactylus / fcp / FcpListener.java
index 90860e5..09a5f2a 100644 (file)
@@ -23,7 +23,7 @@ import java.util.EventListener;
 
 /**
  * Interface for objects that want to be notified on certain FCP events.
- * 
+ *
  * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
  * @version $Id$
  */
@@ -31,7 +31,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “NodeHello” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param nodeHello
@@ -42,7 +42,7 @@ public interface FcpListener extends EventListener {
        /**
         * Notifies a listener that a “CloseConnectionDuplicateClientName” message
         * was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param closeConnectionDuplicateClientName
@@ -52,7 +52,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “SSKKeypair” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received themessage
         * @param sskKeypair
@@ -62,7 +62,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “Peer” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param peer
@@ -72,7 +72,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “EndListPeers” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that recevied the message
         * @param endListPeers
@@ -82,7 +82,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PeerNote” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param peerNote
@@ -92,7 +92,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “EndListPeerNotes” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param endListPeerNotes
@@ -102,7 +102,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PeerRemoved” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param peerRemoved
@@ -112,7 +112,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “NodeData” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param nodeData
@@ -122,7 +122,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “TestDDAReply” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param testDDAReply
@@ -132,7 +132,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “TestDDAComplete” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param testDDAComplete
@@ -142,7 +142,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PersistentGet” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param persistentGet
@@ -152,7 +152,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PersistentPut” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param persistentPut
@@ -162,7 +162,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “EndListPersistentRequests” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param endListPersistentRequests
@@ -172,7 +172,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “URIGenerated” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param uriGenerated
@@ -182,7 +182,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “DataFound” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param dataFound
@@ -192,7 +192,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “AllData” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param allData
@@ -202,7 +202,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “SimpleProgress” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param simpleProgress
@@ -212,7 +212,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “StartedCompression” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param startedCompression
@@ -222,7 +222,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “FinishedCompression” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param finishedCompression
@@ -232,7 +232,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “UnknownPeerNoteType” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param unknownPeerNoteType
@@ -242,7 +242,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “UnknownNodeIdentifier” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param unknownNodeIdentifier
@@ -252,7 +252,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “ConfigData” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param configData
@@ -262,7 +262,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “GetFailed” message was recevied.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param getFailed
@@ -272,7 +272,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PutFailed” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param putFailed
@@ -282,7 +282,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “IdentifierCollision” message was receied.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param identifierCollision
@@ -292,7 +292,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PersistentPutDir” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param persistentPutDir
@@ -303,7 +303,7 @@ public interface FcpListener extends EventListener {
        /**
         * Notifies a listener that a “PersistentRequestRemoved” message was
         * received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param persistentRequestRemoved
@@ -313,7 +313,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “SubscribedUSKUpdate” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that recevied the message
         * @param subscribedUSKUpdate
@@ -323,7 +323,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PluginInfo” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param pluginInfo
@@ -333,7 +333,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that an “FCPPluginReply“ message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param fcpPluginReply
@@ -344,7 +344,7 @@ public interface FcpListener extends EventListener {
        /**
         * Notifies a listener that a “PersistentRequestModified” message was
         * received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param persistentRequestModified
@@ -354,7 +354,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PutSuccessful” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param putSuccessful
@@ -364,7 +364,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “PutFetchable” message was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param putFetchable
@@ -374,7 +374,7 @@ public interface FcpListener extends EventListener {
 
        /**
         * Notifies a listener that a “ProtocolError” was received.
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param protocolError
@@ -386,7 +386,7 @@ public interface FcpListener extends EventListener {
         * Notifies a listener that a message has been received. This method is only
         * called if {@link FcpConnection#handleMessage(FcpMessage)} does not
         * recognize the message. Should that ever happen, please file a bug report!
-        * 
+        *
         * @param fcpConnection
         *            The connection that received the message
         * @param fcpMessage
@@ -398,10 +398,13 @@ public interface FcpListener extends EventListener {
         * Notifies a listener that a connection was closed. A closed connection can
         * be reestablished by calling {@link FcpConnection#connect()} on the same
         * object again.
-        * 
+        *
         * @param fcpConnection
         *            The connection that was closed.
+        * @param throwable
+        *            The exception that caused the disconnect, or <code>null</code>
+        *            if there was no exception
         */
-       public void connectionClosed(FcpConnection fcpConnection);
+       public void connectionClosed(FcpConnection fcpConnection, Throwable throwable);
 
 }