X-Git-Url: https://git.pterodactylus.net/?a=blobdiff_plain;f=src%2Fnet%2Fpterodactylus%2Ffcp%2Fhighlevel%2FHighLevelClient.java;h=231d383339fb939ebe8224f7c94ad25aed4568f3;hb=33eef3fb07a6d4b97ba0ff77216ae56606a491bb;hp=11a4c98c12cb416c13074141aa369e857229e34a;hpb=c6d398abde5664ea2c8c01532e53d634a67bcc09;p=jFCPlib.git diff --git a/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java b/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java index 11a4c98..231d383 100644 --- a/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java +++ b/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java @@ -90,9 +90,8 @@ import net.pterodactylus.fcp.WatchGlobal; /** * 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 { @@ -141,7 +140,7 @@ public class HighLevelClient { /** * Creates a new high-level client that connects to a node on * localhost. - * + * * @param clientName * The name of the client */ @@ -155,7 +154,7 @@ public class HighLevelClient { /** * Adds the given high-level client listener to list of listeners. - * + * * @param highLevelClientListener * The listener to add */ @@ -165,7 +164,7 @@ public class HighLevelClient { /** * Removes the given high-level client listener from the list of listeners. - * + * * @param highLevelClientListener * The listener to remove */ @@ -184,7 +183,7 @@ public class HighLevelClient { /** * Notifies all listeners that a client has disconnected. - * + * * @param throwable * The exception that caused the disconnect, or null * if there was no exception @@ -197,7 +196,7 @@ public class HighLevelClient { /** * Adds a high-level progress listener. - * + * * @param highLevelProgressListener * The high-level progress listener to add */ @@ -207,7 +206,7 @@ public class HighLevelClient { /** * Removes a high-level progress listener. - * + * * @param highLevelProgressListener * The high-level progress listener to remove */ @@ -218,7 +217,7 @@ public class HighLevelClient { /** * Notifies all listeners that the request with the given identifier made * some progress. - * + * * @param identifier * The identifier of the request * @param highLevelProgress @@ -238,7 +237,7 @@ public class HighLevelClient { * 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() { @@ -247,7 +246,7 @@ public class HighLevelClient { /** * Returns whether the node is connected. - * + * * @return true if the node is currently connected, * false otherwise */ @@ -261,7 +260,7 @@ public class HighLevelClient { /** * Connects the client. - * + * * @param hostname * The hostname of the node * @return A callback with a connection result @@ -276,7 +275,7 @@ public class HighLevelClient { /** * Connects the client. - * + * * @param hostname * The hostname of the node * @param port @@ -293,7 +292,7 @@ public class HighLevelClient { /** * Connects the client. - * + * * @param address * The address of the node * @param port @@ -328,7 +327,7 @@ public class HighLevelClient { /** * Generates a new SSK keypair. - * + * * @return A callback with the keypair * @throws IOException * if an I/O error occurs communicating with the node @@ -347,10 +346,10 @@ public class HighLevelClient { /** * Sets whether to watch the global queue. - * + * * @param enabled - * true to watch the global queue in addition to - * the client-local queue, false to only watch the + * true to watch the global queue in addition to the + * client-local queue, false to only watch the * client-local queue * @throws IOException * if an I/O error occurs communicating with the node @@ -365,7 +364,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 @@ -384,7 +383,7 @@ public class HighLevelClient { /** * 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 @@ -405,7 +404,7 @@ public class HighLevelClient { /** * 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 @@ -426,7 +425,7 @@ public class HighLevelClient { /** * Adds the peer whose noderef is stored in the given file. - * + * * @param nodeRef * The peer’s noderef * @return A peer callback @@ -449,7 +448,7 @@ public class HighLevelClient { * 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 @@ -475,7 +474,7 @@ public class HighLevelClient { * 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 @@ -504,7 +503,7 @@ public class HighLevelClient { /** * Requests a list of all running requests from the node. - * + * * @return The request list result * @throws IOException * if an I/O errors communicating with the node @@ -532,7 +531,7 @@ public class HighLevelClient { /** * Checks whether the client is already connected and throws an exception if * it is not. - * + * * @throws NotConnectedException * if the client is not connected */ @@ -546,7 +545,7 @@ public class HighLevelClient { /** * Generates an identifier for the given function. - * + * * @param function * The name of the function * @return An identifier @@ -558,7 +557,7 @@ public class HighLevelClient { /** * Disconnects the client from the node, handing the given Throwable to * {@link #fireClientDisconnected(Throwable)}. - * + * * @param throwable * The exception that caused the disconnect, or null * if there was no exception @@ -572,9 +571,8 @@ public class HighLevelClient { /** * FCP listener for {@link HighLevelClient}. - * + * * @author David ‘Bombe’ Roden <bombe@freenetproject.org> - * @version $Id$ */ private class HighLevelClientFcpListener implements FcpListener { @@ -595,7 +593,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 null to * cancel all pending requests @@ -681,7 +679,7 @@ public class HighLevelClient { /** * 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 @@ -705,7 +703,7 @@ public class HighLevelClient { /** * Writes the given content to the given file. - * + * * @param directDiskAccessResult * The DDA result * @param writeFilename @@ -731,7 +729,7 @@ public class HighLevelClient { /** * Cleans up any files that written for the given result. - * + * * @param directDiskAccessResult * The direct disk access result */ @@ -791,6 +789,7 @@ public class HighLevelClient { * @see net.pterodactylus.fcp.FcpListener#receivedDataFound(net.pterodactylus.fcp.FcpConnection, * net.pterodactylus.fcp.DataFound) */ + @SuppressWarnings("synthetic-access") public void receivedDataFound(FcpConnection fcpConnection, DataFound dataFound) { if (fcpConnection != HighLevelClient.this.fcpConnection) { return; @@ -805,7 +804,7 @@ public class HighLevelClient { downloadCallback.setDone(); } HighLevelProgress highLevelProgress = new HighLevelProgress(identifier, true); - fireProgressReceived(identifier , highLevelProgress); + fireProgressReceived(identifier, highLevelProgress); } /** @@ -1069,6 +1068,7 @@ public class HighLevelClient { * @see net.pterodactylus.fcp.FcpListener#receivedPutFailed(net.pterodactylus.fcp.FcpConnection, * net.pterodactylus.fcp.PutFailed) */ + @SuppressWarnings("synthetic-access") public void receivedPutFailed(FcpConnection fcpConnection, PutFailed putFailed) { if (fcpConnection != HighLevelClient.this.fcpConnection) { return; @@ -1091,6 +1091,7 @@ public class HighLevelClient { * @see net.pterodactylus.fcp.FcpListener#receivedPutFetchable(net.pterodactylus.fcp.FcpConnection, * net.pterodactylus.fcp.PutFetchable) */ + @SuppressWarnings("synthetic-access") public void receivedPutFetchable(FcpConnection fcpConnection, PutFetchable putFetchable) { if (fcpConnection != HighLevelClient.this.fcpConnection) { return; @@ -1106,6 +1107,7 @@ public class HighLevelClient { * @see net.pterodactylus.fcp.FcpListener#receivedPutSuccessful(net.pterodactylus.fcp.FcpConnection, * net.pterodactylus.fcp.PutSuccessful) */ + @SuppressWarnings("synthetic-access") public void receivedPutSuccessful(FcpConnection fcpConnection, PutSuccessful putSuccessful) { if (fcpConnection != HighLevelClient.this.fcpConnection) { return; @@ -1236,6 +1238,7 @@ public class HighLevelClient { * @see net.pterodactylus.fcp.FcpListener#receivedURIGenerated(net.pterodactylus.fcp.FcpConnection, * net.pterodactylus.fcp.URIGenerated) */ + @SuppressWarnings("synthetic-access") public void receivedURIGenerated(FcpConnection fcpConnection, URIGenerated uriGenerated) { if (fcpConnection != HighLevelClient.this.fcpConnection) { return;