disconnect when the connection was closed to notify listeners
[jFCPlib.git] / src / net / pterodactylus / fcp / highlevel / HighLevelClient.java
index 5e13487..6149adf 100644 (file)
 
 package net.pterodactylus.fcp.highlevel;
 
+import java.io.BufferedReader;
+import java.io.File;
+import java.io.FileReader;
+import java.io.FileWriter;
 import java.io.IOException;
 import java.net.InetAddress;
+import java.net.URL;
 import java.net.UnknownHostException;
+import java.util.ArrayList;
 import java.util.Collections;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.Map.Entry;
+import java.util.logging.Logger;
 
+import net.pterodactylus.fcp.AddPeer;
 import net.pterodactylus.fcp.AllData;
+import net.pterodactylus.fcp.ClientGet;
 import net.pterodactylus.fcp.ClientHello;
 import net.pterodactylus.fcp.CloseConnectionDuplicateClientName;
 import net.pterodactylus.fcp.ConfigData;
@@ -39,6 +49,7 @@ import net.pterodactylus.fcp.FCPPluginReply;
 import net.pterodactylus.fcp.FcpConnection;
 import net.pterodactylus.fcp.FcpListener;
 import net.pterodactylus.fcp.FcpMessage;
+import net.pterodactylus.fcp.FcpUtils;
 import net.pterodactylus.fcp.FinishedCompression;
 import net.pterodactylus.fcp.GenerateSSK;
 import net.pterodactylus.fcp.GetFailed;
@@ -46,6 +57,7 @@ import net.pterodactylus.fcp.IdentifierCollision;
 import net.pterodactylus.fcp.ListPeers;
 import net.pterodactylus.fcp.NodeData;
 import net.pterodactylus.fcp.NodeHello;
+import net.pterodactylus.fcp.NodeRef;
 import net.pterodactylus.fcp.Peer;
 import net.pterodactylus.fcp.PeerNote;
 import net.pterodactylus.fcp.PeerRemoved;
@@ -59,12 +71,15 @@ import net.pterodactylus.fcp.ProtocolError;
 import net.pterodactylus.fcp.PutFailed;
 import net.pterodactylus.fcp.PutFetchable;
 import net.pterodactylus.fcp.PutSuccessful;
+import net.pterodactylus.fcp.ReturnType;
 import net.pterodactylus.fcp.SSKKeypair;
 import net.pterodactylus.fcp.SimpleProgress;
 import net.pterodactylus.fcp.StartedCompression;
 import net.pterodactylus.fcp.SubscribedUSKUpdate;
 import net.pterodactylus.fcp.TestDDAComplete;
 import net.pterodactylus.fcp.TestDDAReply;
+import net.pterodactylus.fcp.TestDDARequest;
+import net.pterodactylus.fcp.TestDDAResponse;
 import net.pterodactylus.fcp.URIGenerated;
 import net.pterodactylus.fcp.UnknownNodeIdentifier;
 import net.pterodactylus.fcp.UnknownPeerNoteType;
@@ -72,12 +87,15 @@ import net.pterodactylus.fcp.UnknownPeerNoteType;
 /**
  * A high-level client that allows simple yet full-featured access to a Freenet
  * node.
- * 
+ *
  * @author David ‘Bombe’ Roden <bombe@freenetproject.org>
  * @version $Id$
  */
 public class HighLevelClient {
 
+       /** Logger. */
+       private static final Logger logger = Logger.getLogger(HighLevelClient.class.getName());
+
        /** Object for internal synchronization. */
        private final Object syncObject = new Object();
 
@@ -93,6 +111,9 @@ public class HighLevelClient {
        /** The FCP connection to the node. */
        private FcpConnection fcpConnection;
 
+       /** Listeners for high-level client events. */
+       private List<HighLevelClientListener> highLevelClientListeners = Collections.synchronizedList(new ArrayList<HighLevelClientListener>());
+
        /** The listener for the connection. */
        private HighLevelClientFcpListener highLevelClientFcpListener = new HighLevelClientFcpListener();
 
@@ -105,10 +126,19 @@ public class HighLevelClient {
        /** Mapping from request identifier to peer list callbacks. */
        private Map<String, HighLevelCallback<PeerListResult>> peerListCallbacks = Collections.synchronizedMap(new HashMap<String, HighLevelCallback<PeerListResult>>());
 
+       /** Mapping from request identifier to peer callbacks. */
+       private Map<String, HighLevelCallback<PeerResult>> peerCallbacks = Collections.synchronizedMap(new HashMap<String, HighLevelCallback<PeerResult>>());
+
+       /** Mapping from directories to DDA callbacks. */
+       private Map<String, HighLevelCallback<DirectDiskAccessResult>> directDiskAccessCallbacks = Collections.synchronizedMap(new HashMap<String, HighLevelCallback<DirectDiskAccessResult>>());
+
+       /** Mapping from request identifiers to download callbacks. */
+       private Map<String, HighLevelProgressCallback<DownloadResult>> downloadCallbacks = Collections.synchronizedMap(new HashMap<String, HighLevelProgressCallback<DownloadResult>>());
+
        /**
         * Creates a new high-level client that connects to a node on
         * <code>localhost</code>.
-        * 
+        *
         * @param clientName
         *            The name of the client
         * @throws UnknownHostException
@@ -121,7 +151,7 @@ public class HighLevelClient {
        /**
         * Creates a new high-level client that connects to a node on the given
         * host.
-        * 
+        *
         * @param clientName
         *            The name of the client
         * @param host
@@ -136,7 +166,7 @@ public class HighLevelClient {
        /**
         * Creates a new high-level client that connects to a node on the given
         * host.
-        * 
+        *
         * @param clientName
         *            The name of the client
         * @param host
@@ -153,7 +183,7 @@ public class HighLevelClient {
        /**
         * Creates a new high-level client that connects to a node at the given
         * address.
-        * 
+        *
         * @param clientName
         *            The name of the client
         * @param address
@@ -168,16 +198,69 @@ public class HighLevelClient {
        }
 
        //
+       // EVENT MANAGEMENT
+       //
+
+       /**
+        * Adds the given high-level client listener to list of listeners.
+        *
+        * @param highLevelClientListener
+        *            The listener to add
+        */
+       public void addHighLevelClientListener(HighLevelClientListener highLevelClientListener) {
+               highLevelClientListeners.add(highLevelClientListener);
+       }
+
+       /**
+        * Removes the given high-level client listener from the list of listeners.
+        *
+        * @param highLevelClientListener
+        *            The listener to remove
+        */
+       public void removeHighLevelClientListener(HighLevelClientListener highLevelClientListener) {
+               highLevelClientListeners.remove(highLevelClientListener);
+       }
+
+       /**
+        * Notifies all listeners that a client has connected.
+        */
+       private void fireClientConnected() {
+               for (HighLevelClientListener highLevelClientListener: highLevelClientListeners) {
+                       highLevelClientListener.clientConnected(this);
+               }
+       }
+
+       /**
+        * Notifies all listeners that a client has disconnected.
+        */
+       private void fireClientDisconnected() {
+               for (HighLevelClientListener highLevelClientListener: highLevelClientListeners) {
+                       highLevelClientListener.clientDisconnected(this);
+               }
+       }
+
+       //
        // ACCESSORS
        //
 
+       /**
+        * Returns the FCP connection that backs this high-level client. This method
+        * should be used with care as fiddling around with the FCP connection can
+        * easily break the high-level client if you don’t know what you’re doing!
+        *
+        * @return The FCP connection of this client
+        */
+       public FcpConnection getFcpConnection() {
+               return fcpConnection;
+       }
+
        //
        // ACTIONS
        //
 
        /**
         * Connects the client.
-        * 
+        *
         * @return A callback with a connection result
         * @throws IOException
         *             if an I/O error occurs communicating with the node
@@ -195,11 +278,13 @@ public class HighLevelClient {
         * Disconnects the client from the node.
         */
        public void disconnect() {
+               fcpConnection.close();
+               fireClientDisconnected();
        }
 
        /**
         * Generates a new SSK keypair.
-        * 
+        *
         * @return A callback with the keypair
         * @throws IOException
         *             if an I/O error occurs communicating with the node
@@ -207,7 +292,7 @@ public class HighLevelClient {
        public HighLevelCallback<KeyGenerationResult> generateKey() throws IOException {
                String identifier = generateIdentifier("generateSSK");
                GenerateSSK generateSSK = new GenerateSSK(identifier);
-               HighLevelCallback<KeyGenerationResult> keyGenerationCallback = new HighLevelCallback<KeyGenerationResult>(new KeyGenerationResult());
+               HighLevelCallback<KeyGenerationResult> keyGenerationCallback = new HighLevelCallback<KeyGenerationResult>(new KeyGenerationResult(identifier));
                keyGenerationCallbacks.put(identifier, keyGenerationCallback);
                fcpConnection.sendMessage(generateSSK);
                return keyGenerationCallback;
@@ -215,7 +300,7 @@ public class HighLevelClient {
 
        /**
         * Gets a list of all peers from the node.
-        * 
+        *
         * @return A callback with the peer list
         * @throws IOException
         *             if an I/O error occurs with the node
@@ -223,15 +308,123 @@ public class HighLevelClient {
        public HighLevelCallback<PeerListResult> getPeers() throws IOException {
                String identifier = generateIdentifier("listPeers");
                ListPeers listPeers = new ListPeers(identifier, true, true);
-               HighLevelCallback<PeerListResult> peerListCallback = new HighLevelCallback<PeerListResult>(new PeerListResult());
+               HighLevelCallback<PeerListResult> peerListCallback = new HighLevelCallback<PeerListResult>(new PeerListResult(identifier));
                peerListCallbacks.put(identifier, peerListCallback);
                fcpConnection.sendMessage(listPeers);
                return peerListCallback;
        }
 
        /**
+        * Adds the peer whose noderef is stored in the given file.
+        *
+        * @param nodeRefFile
+        *            The name of the file the peer’s noderef is stored in
+        * @return A peer callback
+        * @throws IOException
+        *             if an I/O error occurs communicating with the node
+        */
+       public HighLevelCallback<PeerResult> addPeer(String nodeRefFile) throws IOException {
+               String identifier = generateIdentifier("addPeer");
+               AddPeer addPeer = new AddPeer(nodeRefFile);
+               HighLevelCallback<PeerResult> peerCallback = new HighLevelCallback<PeerResult>(new PeerResult(identifier));
+               peerCallbacks.put(identifier, peerCallback);
+               fcpConnection.sendMessage(addPeer);
+               return peerCallback;
+       }
+
+       /**
+        * Adds the peer whose noderef is stored in the given file.
+        *
+        * @param nodeRefURL
+        *            The URL where the peer’s noderef is stored
+        * @return A peer callback
+        * @throws IOException
+        *             if an I/O error occurs communicating with the node
+        */
+       public HighLevelCallback<PeerResult> addPeer(URL nodeRefURL) throws IOException {
+               String identifier = generateIdentifier("addPeer");
+               AddPeer addPeer = new AddPeer(nodeRefURL);
+               HighLevelCallback<PeerResult> peerCallback = new HighLevelCallback<PeerResult>(new PeerResult(identifier));
+               peerCallbacks.put(identifier, peerCallback);
+               fcpConnection.sendMessage(addPeer);
+               return peerCallback;
+       }
+
+       /**
+        * Adds the peer whose noderef is stored in the given file.
+        *
+        * @param nodeRef
+        *            The peer’s noderef
+        * @return A peer callback
+        * @throws IOException
+        *             if an I/O error occurs communicating with the node
+        */
+       public HighLevelCallback<PeerResult> addPeer(NodeRef nodeRef) throws IOException {
+               String identifier = generateIdentifier("addPeer");
+               AddPeer addPeer = new AddPeer(nodeRef);
+               HighLevelCallback<PeerResult> peerCallback = new HighLevelCallback<PeerResult>(new PeerResult(identifier));
+               peerCallbacks.put(identifier, peerCallback);
+               fcpConnection.sendMessage(addPeer);
+               return peerCallback;
+       }
+
+       /**
+        * Checks whether direct disk access for the given directory is possible.
+        * You have to perform this check before you can upload or download anything
+        * from or the disk directly!
+        *
+        * @param directory
+        *            The directory to check
+        * @param wantRead
+        *            Whether you want to read the given directory
+        * @param wantWrite
+        *            Whether you want to write to the given directory
+        * @return A direct disk access callback
+        * @throws IOException
+        */
+       public HighLevelCallback<DirectDiskAccessResult> checkDirectDiskAccess(String directory, boolean wantRead, boolean wantWrite) throws IOException {
+               TestDDARequest testDDARequest = new TestDDARequest(directory, wantRead, wantWrite);
+               HighLevelCallback<DirectDiskAccessResult> directDiskAccessCallback = new HighLevelCallback<DirectDiskAccessResult>(new DirectDiskAccessResult(directory));
+               directDiskAccessCallbacks.put(directory, directDiskAccessCallback);
+               fcpConnection.sendMessage(testDDARequest);
+               return directDiskAccessCallback;
+       }
+
+       /**
+        * Starts a download. Files can either be download to disk or streamed from
+        * the node. When downloading to disk you have to perform a direct disk
+        * access check for the directory you want to put the downloaded file in!
+        *
+        * @see #checkDirectDiskAccess(String, boolean, boolean)
+        * @param uri
+        *            The URI to get
+        * @param filename
+        *            The filename to save the data to, or <code>null</code> to
+        *            retrieve the data as InputStream from the
+        *            {@link DownloadResult}
+        * @param global
+        *            Whether to put the download on the global queue
+        * @return A download result
+        * @throws IOException
+        *             if an I/O error occurs communicating with the node
+        */
+       public HighLevelProgressCallback<DownloadResult> download(String uri, String filename, boolean global) throws IOException {
+               String identifier = generateIdentifier("download");
+               ClientGet clientGet = new ClientGet(uri, identifier, (filename == null) ? ReturnType.direct : ReturnType.disk);
+               clientGet.setGlobal(global);
+               HighLevelProgressCallback<DownloadResult> downloadCallback = new HighLevelProgressCallback<DownloadResult>(new DownloadResult(identifier));
+               downloadCallbacks.put(identifier, downloadCallback);
+               fcpConnection.sendMessage(clientGet);
+               return downloadCallback;
+       }
+
+       //
+       // PRIVATE METHODS
+       //
+
+       /**
         * Generates an identifier for the given function.
-        * 
+        *
         * @param function
         *            The name of the function
         * @return An identifier
@@ -242,16 +435,20 @@ public class HighLevelClient {
 
        /**
         * FCP listener for {@link HighLevelClient}.
-        * 
+        *
         * @author David ‘Bombe’ Roden &lt;bombe@freenetproject.org&gt;
         * @version $Id$
         */
        private class HighLevelClientFcpListener implements FcpListener {
 
+               /** Mapping from directory to written file (for cleanup). */
+               private final Map<DirectDiskAccessResult, String> writtenFiles = new HashMap<DirectDiskAccessResult, String>();
+
                /**
                 * Creates a new FCP listener for {@link HighLevelClient}.
                 */
                HighLevelClientFcpListener() {
+                       /* do nothing. */
                }
 
                //
@@ -261,7 +458,7 @@ public class HighLevelClient {
                /**
                 * Searches all callback collections for a callback with the given
                 * identifier and cancels it.
-                * 
+                *
                 * @param identifier
                 *            The identifier to search for, or <code>null</code> to
                 *            cancel all pending requests
@@ -288,6 +485,24 @@ public class HighLevelClient {
                                        peerListEntry.getValue().setDone();
                                }
                                peerListCallbacks.clear();
+                               /* peer callbacks. */
+                               for (Entry<String, HighLevelCallback<PeerResult>> peerEntry: peerCallbacks.entrySet()) {
+                                       peerEntry.getValue().getIntermediaryResult().setFailed(true);
+                                       peerEntry.getValue().setDone();
+                               }
+                               peerCallbacks.clear();
+                               /* direct disk access callbacks. */
+                               for (Entry<String, HighLevelCallback<DirectDiskAccessResult>> directDiskAccessEntry: directDiskAccessCallbacks.entrySet()) {
+                                       directDiskAccessEntry.getValue().getIntermediaryResult().setFailed(true);
+                                       directDiskAccessEntry.getValue().setDone();
+                               }
+                               directDiskAccessCallbacks.clear();
+                               /* download callbacks. */
+                               for (Entry<String, HighLevelProgressCallback<DownloadResult>> downloadEntry: downloadCallbacks.entrySet()) {
+                                       downloadEntry.getValue().getIntermediaryResult().setFailed(true);
+                                       downloadEntry.getValue().setDone();
+                               }
+                               downloadCallbacks.clear();
                        } else {
                                HighLevelCallback<KeyGenerationResult> keyGenerationCallback = keyGenerationCallbacks.remove(identifier);
                                if (keyGenerationCallback != null) {
@@ -301,6 +516,90 @@ public class HighLevelClient {
                                        peerListCallback.setDone();
                                        return;
                                }
+                               HighLevelCallback<PeerResult> peerCallback = peerCallbacks.remove(identifier);
+                               if (peerCallback != null) {
+                                       peerCallback.getIntermediaryResult().setFailed(true);
+                                       peerCallback.setDone();
+                                       return;
+                               }
+                               HighLevelCallback<DirectDiskAccessResult> directDiskAccessCallback = directDiskAccessCallbacks.remove(identifier);
+                               if (directDiskAccessCallback != null) {
+                                       directDiskAccessCallback.getIntermediaryResult().setFailed(true);
+                                       directDiskAccessCallback.setDone();
+                                       return;
+                               }
+                               HighLevelProgressCallback<DownloadResult> downloadCallback = downloadCallbacks.remove(identifier);
+                               if (downloadCallback != null) {
+                                       downloadCallback.getIntermediaryResult().setFailed(true);
+                                       downloadCallback.setDone();
+                                       return;
+                               }
+                       }
+               }
+
+               /**
+                * Reads the given file and returns the first line of the file.
+                *
+                * @param readFilename
+                *            The name of the file to read
+                * @return The content of the file
+                */
+               private String readContent(String readFilename) {
+                       FileReader fileReader = null;
+                       BufferedReader bufferedFileReader = null;
+                       try {
+                               fileReader = new FileReader(readFilename);
+                               bufferedFileReader = new BufferedReader(fileReader);
+                               String content = bufferedFileReader.readLine();
+                               return content;
+                       } catch (IOException ioe1) {
+                               /* swallow. */
+                       } finally {
+                               FcpUtils.close(bufferedFileReader);
+                               FcpUtils.close(fileReader);
+                       }
+                       return null;
+               }
+
+               /**
+                * Writes the given content to the given file.
+                *
+                * @param directDiskAccessResult
+                *            The DDA result
+                * @param writeFilename
+                *            The name of the file to write to
+                * @param writeContent
+                *            The content to write to the file
+                */
+               private void writeContent(DirectDiskAccessResult directDiskAccessResult, String writeFilename, String writeContent) {
+                       if ((writeFilename == null) || (writeContent == null)) {
+                               return;
+                       }
+                       writtenFiles.put(directDiskAccessResult, writeFilename);
+                       FileWriter fileWriter = null;
+                       try {
+                               fileWriter = new FileWriter(writeFilename);
+                               fileWriter.write(writeContent);
+                       } catch (IOException ioe1) {
+                               /* swallow. */
+                       } finally {
+                               FcpUtils.close(fileWriter);
+                       }
+               }
+
+               /**
+                * Cleans up any files that written for the given result.
+                *
+                * @param directDiskAccessResult
+                *            The direct disk access result
+                */
+               @SuppressWarnings("synthetic-access")
+               private void cleanFiles(DirectDiskAccessResult directDiskAccessResult) {
+                       String writeFilename = writtenFiles.remove(directDiskAccessResult);
+                       if (writeFilename != null) {
+                               if (!new File(writeFilename).delete()) {
+                                       logger.warning("could not delete " + writeFilename);
+                               }
                        }
                }
 
@@ -317,6 +616,7 @@ public class HighLevelClient {
                                return;
                        }
                        cancelIdentifier(null);
+                       disconnect();
                }
 
                /**
@@ -324,6 +624,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.AllData)
                 */
                public void receivedAllData(FcpConnection fcpConnection, AllData allData) {
+                       /* TODO */
                }
 
                /**
@@ -331,6 +632,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.CloseConnectionDuplicateClientName)
                 */
                public void receivedCloseConnectionDuplicateClientName(FcpConnection fcpConnection, CloseConnectionDuplicateClientName closeConnectionDuplicateClientName) {
+                       /* TODO */
                }
 
                /**
@@ -338,6 +640,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.ConfigData)
                 */
                public void receivedConfigData(FcpConnection fcpConnection, ConfigData configData) {
+                       /* TODO */
                }
 
                /**
@@ -345,6 +648,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.DataFound)
                 */
                public void receivedDataFound(FcpConnection fcpConnection, DataFound dataFound) {
+                       /* TODO */
                }
 
                /**
@@ -352,6 +656,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.EndListPeerNotes)
                 */
                public void receivedEndListPeerNotes(FcpConnection fcpConnection, EndListPeerNotes endListPeerNotes) {
+                       /* TODO */
                }
 
                /**
@@ -376,6 +681,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.EndListPersistentRequests)
                 */
                public void receivedEndListPersistentRequests(FcpConnection fcpConnection, EndListPersistentRequests endListPersistentRequests) {
+                       /* TODO */
                }
 
                /**
@@ -383,13 +689,27 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.FCPPluginReply)
                 */
                public void receivedFCPPluginReply(FcpConnection fcpConnection, FCPPluginReply fcpPluginReply) {
+                       /* TODO */
                }
 
                /**
                 * @see net.pterodactylus.fcp.FcpListener#receivedGetFailed(net.pterodactylus.fcp.FcpConnection,
                 *      net.pterodactylus.fcp.GetFailed)
                 */
+               @SuppressWarnings("synthetic-access")
                public void receivedGetFailed(FcpConnection fcpConnection, GetFailed getFailed) {
+                       if (fcpConnection != HighLevelClient.this.fcpConnection) {
+                               return;
+                       }
+                       String identifier = getFailed.getIdentifier();
+                       HighLevelProgressCallback<DownloadResult> downloadCallback = downloadCallbacks.remove(identifier);
+                       if (downloadCallback != null) {
+                               downloadCallback.getIntermediaryResult().setFailed(true);
+                               downloadCallback.setDone();
+                               return;
+                       }
+                       /* unknown identifier? */
+                       logger.warning("unknown identifier for GetFailed: " + identifier);
                }
 
                /**
@@ -397,6 +717,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.IdentifierCollision)
                 */
                public void receivedIdentifierCollision(FcpConnection fcpConnection, IdentifierCollision identifierCollision) {
+                       /* TODO */
                }
 
                /**
@@ -404,6 +725,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.FcpMessage)
                 */
                public void receivedMessage(FcpConnection fcpConnection, FcpMessage fcpMessage) {
+                       /* TODO */
                }
 
                /**
@@ -411,6 +733,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.NodeData)
                 */
                public void receivedNodeData(FcpConnection fcpConnection, NodeData nodeData) {
+                       /* TODO */
                }
 
                /**
@@ -427,6 +750,7 @@ public class HighLevelClient {
                                connectCallback.setDone();
                                connectCallback = null;
                        }
+                       fireClientConnected();
                }
 
                /**
@@ -439,11 +763,21 @@ public class HighLevelClient {
                                return;
                        }
                        String identifier = peer.getIdentifier();
+                       if (identifier == null) {
+                               return;
+                       }
                        HighLevelCallback<PeerListResult> peerListCallback = peerListCallbacks.get(identifier);
-                       if (peerListCallback == null) {
+                       if (peerListCallback != null) {
+                               peerListCallback.getIntermediaryResult().addPeer(peer);
+                               return;
+                       }
+                       HighLevelCallback<PeerResult> peerResult = peerCallbacks.remove(identifier);
+                       if (peerResult != null) {
+                               peerResult.getIntermediaryResult().setPeer(peer);
+                               peerResult.setDone();
                                return;
                        }
-                       peerListCallback.getIntermediaryResult().addPeer(peer);
+                       logger.warning("got Peer message with unknown identifier: " + identifier);
                }
 
                /**
@@ -451,6 +785,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PeerNote)
                 */
                public void receivedPeerNote(FcpConnection fcpConnection, PeerNote peerNote) {
+                       /* TODO */
                }
 
                /**
@@ -458,13 +793,23 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PeerRemoved)
                 */
                public void receivedPeerRemoved(FcpConnection fcpConnection, PeerRemoved peerRemoved) {
+                       /* TODO */
                }
 
                /**
                 * @see net.pterodactylus.fcp.FcpListener#receivedPersistentGet(net.pterodactylus.fcp.FcpConnection,
                 *      net.pterodactylus.fcp.PersistentGet)
                 */
+               @SuppressWarnings("synthetic-access")
                public void receivedPersistentGet(FcpConnection fcpConnection, PersistentGet persistentGet) {
+                       if (fcpConnection != HighLevelClient.this.fcpConnection) {
+                               return;
+                       }
+                       String identifier = persistentGet.getIdentifier();
+                       if (downloadCallbacks.containsKey(identifier)) {
+                               /* ignore, because a download does not care about this. */
+                               return;
+                       }
                }
 
                /**
@@ -472,6 +817,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PersistentPut)
                 */
                public void receivedPersistentPut(FcpConnection fcpConnection, PersistentPut persistentPut) {
+                       /* TODO */
                }
 
                /**
@@ -479,6 +825,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PersistentPutDir)
                 */
                public void receivedPersistentPutDir(FcpConnection fcpConnection, PersistentPutDir persistentPutDir) {
+                       /* TODO */
                }
 
                /**
@@ -486,6 +833,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PersistentRequestModified)
                 */
                public void receivedPersistentRequestModified(FcpConnection fcpConnection, PersistentRequestModified persistentRequestModified) {
+                       /* TODO */
                }
 
                /**
@@ -493,6 +841,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PersistentRequestRemoved)
                 */
                public void receivedPersistentRequestRemoved(FcpConnection fcpConnection, PersistentRequestRemoved persistentRequestRemoved) {
+                       /* TODO */
                }
 
                /**
@@ -500,6 +849,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PluginInfo)
                 */
                public void receivedPluginInfo(FcpConnection fcpConnection, PluginInfo pluginInfo) {
+                       /* TODO */
                }
 
                /**
@@ -523,6 +873,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PutFailed)
                 */
                public void receivedPutFailed(FcpConnection fcpConnection, PutFailed putFailed) {
+                       /* TODO */
                }
 
                /**
@@ -530,6 +881,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PutFetchable)
                 */
                public void receivedPutFetchable(FcpConnection fcpConnection, PutFetchable putFetchable) {
+                       /* TODO */
                }
 
                /**
@@ -537,6 +889,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.PutSuccessful)
                 */
                public void receivedPutSuccessful(FcpConnection fcpConnection, PutSuccessful putSuccessful) {
+                       /* TODO */
                }
 
                /**
@@ -562,7 +915,26 @@ public class HighLevelClient {
                 * @see net.pterodactylus.fcp.FcpListener#receivedSimpleProgress(net.pterodactylus.fcp.FcpConnection,
                 *      net.pterodactylus.fcp.SimpleProgress)
                 */
+               @SuppressWarnings("synthetic-access")
                public void receivedSimpleProgress(FcpConnection fcpConnection, SimpleProgress simpleProgress) {
+                       if (fcpConnection != HighLevelClient.this.fcpConnection) {
+                               return;
+                       }
+                       String identifier = simpleProgress.getIdentifier();
+                       HighLevelProgressCallback<DownloadResult> downloadCallback = downloadCallbacks.get(identifier);
+                       if (downloadCallback != null) {
+                               DownloadResult downloadResult = downloadCallback.getIntermediaryResult();
+                               downloadResult.setTotalBlocks(simpleProgress.getTotal());
+                               downloadResult.setRequiredBlocks(simpleProgress.getRequired());
+                               downloadResult.setSuccessfulBlocks(simpleProgress.getSucceeded());
+                               downloadResult.setFailedBlocks(simpleProgress.getFailed());
+                               downloadResult.setFatallyFailedBlocks(simpleProgress.getFatallyFailed());
+                               downloadResult.setTotalFinalized(simpleProgress.isFinalizedTotal());
+                               downloadCallback.progressUpdated();
+                               return;
+                       }
+                       /* unknown identifier? */
+                       logger.warning("unknown identifier for SimpleProgress: " + identifier);
                }
 
                /**
@@ -570,6 +942,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.StartedCompression)
                 */
                public void receivedStartedCompression(FcpConnection fcpConnection, StartedCompression startedCompression) {
+                       /* TODO */
                }
 
                /**
@@ -577,20 +950,55 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.SubscribedUSKUpdate)
                 */
                public void receivedSubscribedUSKUpdate(FcpConnection fcpConnection, SubscribedUSKUpdate subscribedUSKUpdate) {
+                       /* TODO */
                }
 
                /**
                 * @see net.pterodactylus.fcp.FcpListener#receivedTestDDAComplete(net.pterodactylus.fcp.FcpConnection,
                 *      net.pterodactylus.fcp.TestDDAComplete)
                 */
+               @SuppressWarnings("synthetic-access")
                public void receivedTestDDAComplete(FcpConnection fcpConnection, TestDDAComplete testDDAComplete) {
+                       if (fcpConnection != HighLevelClient.this.fcpConnection) {
+                               return;
+                       }
+                       String directory = testDDAComplete.getDirectory();
+                       if (directory == null) {
+                               return;
+                       }
+                       HighLevelCallback<DirectDiskAccessResult> directDiskAccessCallback = directDiskAccessCallbacks.remove(directory);
+                       DirectDiskAccessResult directDiskAccessResult = directDiskAccessCallback.getIntermediaryResult();
+                       cleanFiles(directDiskAccessResult);
+                       directDiskAccessResult.setReadAllowed(testDDAComplete.isReadDirectoryAllowed());
+                       directDiskAccessResult.setWriteAllowed(testDDAComplete.isWriteDirectoryAllowed());
+                       directDiskAccessCallback.setDone();
                }
 
                /**
                 * @see net.pterodactylus.fcp.FcpListener#receivedTestDDAReply(net.pterodactylus.fcp.FcpConnection,
                 *      net.pterodactylus.fcp.TestDDAReply)
                 */
+               @SuppressWarnings("synthetic-access")
                public void receivedTestDDAReply(FcpConnection fcpConnection, TestDDAReply testDDAReply) {
+                       if (fcpConnection != HighLevelClient.this.fcpConnection) {
+                               return;
+                       }
+                       String directory = testDDAReply.getDirectory();
+                       if (directory == null) {
+                               return;
+                       }
+                       DirectDiskAccessResult directDiskAccessResult = directDiskAccessCallbacks.get(directory).getIntermediaryResult();
+                       String readFilename = testDDAReply.getReadFilename();
+                       String readContent = readContent(readFilename);
+                       String writeFilename = testDDAReply.getWriteFilename();
+                       String writeContent = testDDAReply.getContentToWrite();
+                       writeContent(directDiskAccessResult, writeFilename, writeContent);
+                       TestDDAResponse testDDAResponse = new TestDDAResponse(directory, readContent);
+                       try {
+                               fcpConnection.sendMessage(testDDAResponse);
+                       } catch (IOException e) {
+                               /* swallow. I’m verry unhappy about this. */
+                       }
                }
 
                /**
@@ -598,6 +1006,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.URIGenerated)
                 */
                public void receivedURIGenerated(FcpConnection fcpConnection, URIGenerated uriGenerated) {
+                       /* TODO */
                }
 
                /**
@@ -605,6 +1014,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.UnknownNodeIdentifier)
                 */
                public void receivedUnknownNodeIdentifier(FcpConnection fcpConnection, UnknownNodeIdentifier unknownNodeIdentifier) {
+                       /* TODO */
                }
 
                /**
@@ -612,6 +1022,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.UnknownPeerNoteType)
                 */
                public void receivedUnknownPeerNoteType(FcpConnection fcpConnection, UnknownPeerNoteType unknownPeerNoteType) {
+                       /* TODO */
                }
 
                /**
@@ -619,6 +1030,7 @@ public class HighLevelClient {
                 *      net.pterodactylus.fcp.FinishedCompression)
                 */
                public void receviedFinishedCompression(FcpConnection fcpConnection, FinishedCompression finishedCompression) {
+                       /* TODO */
                }
 
        }