From 7020af8093e423c6a990a6db20da3514ac56236a Mon Sep 17 00:00:00 2001 From: =?utf8?q?David=20=E2=80=98Bombe=E2=80=99=20Roden?= Date: Mon, 14 Apr 2008 20:42:35 +0000 Subject: [PATCH] add first draft of high-level client git-svn-id: http://trooper/svn/projects/jFCPlib/branch/high-level-client@813 c3eda9e8-030b-0410-8277-bc7414b0a119 --- .../pterodactylus/fcp/highlevel/ConnectResult.java | 60 +++ .../fcp/highlevel/HighLevelCallback.java | 146 +++++++ .../fcp/highlevel/HighLevelCallbackListener.java | 44 ++ .../fcp/highlevel/HighLevelClient.java | 471 +++++++++++++++++++++ .../fcp/highlevel/HighLevelResult.java | 32 ++ 5 files changed, 753 insertions(+) create mode 100644 src/net/pterodactylus/fcp/highlevel/ConnectResult.java create mode 100644 src/net/pterodactylus/fcp/highlevel/HighLevelCallback.java create mode 100644 src/net/pterodactylus/fcp/highlevel/HighLevelCallbackListener.java create mode 100644 src/net/pterodactylus/fcp/highlevel/HighLevelClient.java create mode 100644 src/net/pterodactylus/fcp/highlevel/HighLevelResult.java diff --git a/src/net/pterodactylus/fcp/highlevel/ConnectResult.java b/src/net/pterodactylus/fcp/highlevel/ConnectResult.java new file mode 100644 index 0000000..c0f3b68 --- /dev/null +++ b/src/net/pterodactylus/fcp/highlevel/ConnectResult.java @@ -0,0 +1,60 @@ +/* + * fcplib - ConnectResult.java - + * Copyright © 2008 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 + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + +package net.pterodactylus.fcp.highlevel; + +/** + * A result of the {@link HighLevelClient#connect()} operation. + * + * @author David ‘Bombe’ Roden <bombe@freenetproject.org> + * @version $Id$ + */ +public class ConnectResult implements HighLevelResult { + + /** Whether the node is now connected. */ + private boolean connected; + + /** + * Package-private constructor. + */ + ConnectResult() { + } + + /** + * Returns whether the node is now connected. + * + * @return true if the node is now connected, + * false otherwise + */ + public boolean isConnected() { + return connected; + } + + /** + * Sets whether the node is now connected. + * + * @param connected + * true if the node is now connected, + * false otherwise + */ + void setConnected(boolean connected) { + this.connected = connected; + } + +} diff --git a/src/net/pterodactylus/fcp/highlevel/HighLevelCallback.java b/src/net/pterodactylus/fcp/highlevel/HighLevelCallback.java new file mode 100644 index 0000000..304d24e --- /dev/null +++ b/src/net/pterodactylus/fcp/highlevel/HighLevelCallback.java @@ -0,0 +1,146 @@ +/* + * fcplib - HighLevelCallback.java - + * Copyright © 2008 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 + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + +package net.pterodactylus.fcp.highlevel; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +/** + * A callback is used to notify users of the {@link HighLevelClient} that an + * operation was completed. + * + * @param + * The type of the high-level operation result + * @author David ‘Bombe’ Roden <bombe@freenetproject.org> + * @version $Id$ + */ +public class HighLevelCallback { + + /** Object used for synchronization. */ + public final Object syncObject = new Object(); + + /** The list of callback listeners. */ + public final List> highLevelCallbackListeners = Collections.synchronizedList(new ArrayList>()); + + /** The result of the operation. */ + public R result = null; + + /** + * Adds a callback listener to this callback. The callback listener will be + * called as soon as the result of the operation is known. If the result is + * already known, the listener will be called immediately. Also, as soon as + * a listener was notified the listener is automatically removed from this + * callback. + * + * @param highLevelCallbackListener + * The listener to add + */ + public void addHighLevelCallbackListener(HighLevelCallbackListener highLevelCallbackListener) { + highLevelCallbackListeners.add(highLevelCallbackListener); + if (isDone()) { + fireGotResult(); + } + } + + /** + * Removes a callback listener from this callback. + * + * @param highLevelCallbackListener + * The listener to remove + */ + public void removeHighLevelCallbackListener(HighLevelCallbackListener highLevelCallbackListener) { + highLevelCallbackListeners.remove(highLevelCallbackListener); + } + + /** + * Notifies all listeners that the result of the operation is now known. + * + * @see HighLevelCallbackListener#gotResult(HighLevelCallback) + */ + private synchronized void fireGotResult() { + for (HighLevelCallbackListener highLevelCallbackListener: highLevelCallbackListeners) { + highLevelCallbackListeners.remove(highLevelCallbackListener); + highLevelCallbackListener.gotResult(this); + } + } + + /** + * Returns whether the result of the operation is already known. If the + * result is already known a call to {@link #getResult()} will not block. + * + * @return true if the result is already known, + * false otherwise + */ + public boolean isDone() { + synchronized (syncObject) { + return result != null; + } + } + + /** + * Returns the result of the operation, blocking until it is known. + * + * @return The result of the operation + * @throws InterruptedException + * if {@link Object#wait()} was interrupted + */ + public R getResult() throws InterruptedException { + return getResult(0); + } + + /** + * Returns the result of the operation, blocking until it is known or the + * given time (in milliseconds) has passed. + * + * @param waitTime + * The time to wait for a result + * @return The result of the operation, or null if the result + * is still not known after waitTime milliseconds + * have passed + * @throws InterruptedException + * if {@link Object#wait()} is interrupted + */ + public R getResult(long waitTime) throws InterruptedException { + synchronized (syncObject) { + if (result == null) { + syncObject.wait(waitTime); + } + return result; + } + } + + /** + * Sets the result of the operation. Calling this method will result in all + * listeners being notified. + * + * @see #fireGotResult() + * @param result + * The result of the operation + */ + void setResult(R result) { + synchronized (syncObject) { + this.result = result; + syncObject.notifyAll(); + } + fireGotResult(); + } + +} diff --git a/src/net/pterodactylus/fcp/highlevel/HighLevelCallbackListener.java b/src/net/pterodactylus/fcp/highlevel/HighLevelCallbackListener.java new file mode 100644 index 0000000..36a2cc4 --- /dev/null +++ b/src/net/pterodactylus/fcp/highlevel/HighLevelCallbackListener.java @@ -0,0 +1,44 @@ +/* + * fcplib - HighLevelCallbackListener.java - + * Copyright © 2008 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 + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + +package net.pterodactylus.fcp.highlevel; + +import java.util.EventListener; + +/** + * Interface for objects that want to be notified as soon as a + * {@link HighLevelCallback} received a result. + * + * @param + * The type of the high-level operation result + * @author David ‘Bombe’ Roden <bombe@freenetproject.org> + * @version $Id$ + */ +public interface HighLevelCallbackListener extends EventListener { + + /** + * Notifies a listener that the given callback received a result. Use + * {@link HighLevelCallback#getResult()} to retrieve the result. + * + * @param highLevelCallback + * The callback that received a result + */ + public void gotResult(HighLevelCallback highLevelCallback); + +} diff --git a/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java b/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java new file mode 100644 index 0000000..6ab962b --- /dev/null +++ b/src/net/pterodactylus/fcp/highlevel/HighLevelClient.java @@ -0,0 +1,471 @@ +/* + * fcplib - HighLevelClient.java - + * Copyright © 2008 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 + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + +package net.pterodactylus.fcp.highlevel; + +import java.io.IOException; +import java.net.InetAddress; +import java.net.UnknownHostException; + +import net.pterodactylus.fcp.AllData; +import net.pterodactylus.fcp.ClientHello; +import net.pterodactylus.fcp.CloseConnectionDuplicateClientName; +import net.pterodactylus.fcp.ConfigData; +import net.pterodactylus.fcp.DataFound; +import net.pterodactylus.fcp.EndListPeerNotes; +import net.pterodactylus.fcp.EndListPeers; +import net.pterodactylus.fcp.EndListPersistentRequests; +import net.pterodactylus.fcp.FCPPluginReply; +import net.pterodactylus.fcp.FcpConnection; +import net.pterodactylus.fcp.FcpListener; +import net.pterodactylus.fcp.FcpMessage; +import net.pterodactylus.fcp.FinishedCompression; +import net.pterodactylus.fcp.GetFailed; +import net.pterodactylus.fcp.IdentifierCollision; +import net.pterodactylus.fcp.NodeData; +import net.pterodactylus.fcp.NodeHello; +import net.pterodactylus.fcp.Peer; +import net.pterodactylus.fcp.PeerNote; +import net.pterodactylus.fcp.PeerRemoved; +import net.pterodactylus.fcp.PersistentGet; +import net.pterodactylus.fcp.PersistentPut; +import net.pterodactylus.fcp.PersistentPutDir; +import net.pterodactylus.fcp.PersistentRequestModified; +import net.pterodactylus.fcp.PersistentRequestRemoved; +import net.pterodactylus.fcp.PluginInfo; +import net.pterodactylus.fcp.ProtocolError; +import net.pterodactylus.fcp.PutFailed; +import net.pterodactylus.fcp.PutFetchable; +import net.pterodactylus.fcp.PutSuccessful; +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.URIGenerated; +import net.pterodactylus.fcp.UnknownNodeIdentifier; +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 { + + /** Object for internal synchronization. */ + private final Object syncObject = new Object(); + + /** The name of the client. */ + private final String clientName; + + /** The address of the node. */ + private InetAddress address; + + /** The port number of the node. */ + private int port; + + /** The FCP connection to the node. */ + private FcpConnection fcpConnection; + + /** The listener for the connection. */ + private HighLevelClientFcpListener highLevelClientFcpListener = new HighLevelClientFcpListener(); + + /** The callback for {@link #connect()}. */ + private HighLevelCallback connectCallback; + + /** + * Creates a new high-level client that connects to a node on + * localhost. + * + * @param clientName + * The name of the client + * @throws UnknownHostException + * if the hostname of the node can not be resolved. + */ + public HighLevelClient(String clientName) throws UnknownHostException { + this(clientName, "localhost"); + } + + /** + * Creates a new high-level client that connects to a node on the given + * host. + * + * @param clientName + * The name of the client + * @param host + * The hostname of the node + * @throws UnknownHostException + * if the hostname of the node can not be resolved. + */ + public HighLevelClient(String clientName, String host) throws UnknownHostException { + this(clientName, host, FcpConnection.DEFAULT_PORT); + } + + /** + * Creates a new high-level client that connects to a node on the given + * host. + * + * @param clientName + * The name of the client + * @param host + * The hostname of the node + * @param port + * The port number of the node + * @throws UnknownHostException + * if the hostname of the node can not be resolved. + */ + public HighLevelClient(String clientName, String host, int port) throws UnknownHostException { + this(clientName, InetAddress.getByName(host), port); + } + + /** + * Creates a new high-level client that connects to a node at the given + * address. + * + * @param clientName + * The name of the client + * @param address + * The address of the node + * @param port + * The port number of the node + */ + public HighLevelClient(String clientName, InetAddress address, int port) { + this.clientName = clientName; + this.address = address; + this.port = port; + } + + // + // ACCESSORS + // + + // + // ACTIONS + // + + /** + * Connects the client. + * + * @return A callback with a connection result + * @throws IOException + * if an I/O error occurs communicating with the node + */ + public HighLevelCallback connect() throws IOException { + fcpConnection = new FcpConnection(address, port); + fcpConnection.addFcpListener(highLevelClientFcpListener); + ClientHello clientHello = new ClientHello(clientName); + connectCallback = new HighLevelCallback(); + fcpConnection.sendMessage(clientHello); + return connectCallback; + } + + /** + * Disconnects the client from the node. + */ + public void disconnect() { + } + + /** + * FCP listener for {@link HighLevelClient}. + * + * @author David ‘Bombe’ Roden <bombe@freenetproject.org> + * @version $Id$ + */ + private class HighLevelClientFcpListener implements FcpListener { + + /** + * Creates a new FCP listener for {@link HighLevelClient}. + */ + HighLevelClientFcpListener() { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#connectionClosed(net.pterodactylus.fcp.FcpConnection) + */ + public void connectionClosed(FcpConnection fcpConnection) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedAllData(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.AllData) + */ + public void receivedAllData(FcpConnection fcpConnection, AllData allData) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedCloseConnectionDuplicateClientName(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.CloseConnectionDuplicateClientName) + */ + public void receivedCloseConnectionDuplicateClientName(FcpConnection fcpConnection, CloseConnectionDuplicateClientName closeConnectionDuplicateClientName) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedConfigData(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.ConfigData) + */ + public void receivedConfigData(FcpConnection fcpConnection, ConfigData configData) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedDataFound(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.DataFound) + */ + public void receivedDataFound(FcpConnection fcpConnection, DataFound dataFound) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedEndListPeerNotes(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.EndListPeerNotes) + */ + public void receivedEndListPeerNotes(FcpConnection fcpConnection, EndListPeerNotes endListPeerNotes) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedEndListPeers(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.EndListPeers) + */ + public void receivedEndListPeers(FcpConnection fcpConnection, EndListPeers endListPeers) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedEndListPersistentRequests(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.EndListPersistentRequests) + */ + public void receivedEndListPersistentRequests(FcpConnection fcpConnection, EndListPersistentRequests endListPersistentRequests) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedFCPPluginReply(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.FCPPluginReply) + */ + public void receivedFCPPluginReply(FcpConnection fcpConnection, FCPPluginReply fcpPluginReply) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedGetFailed(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.GetFailed) + */ + public void receivedGetFailed(FcpConnection fcpConnection, GetFailed getFailed) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedIdentifierCollision(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.IdentifierCollision) + */ + public void receivedIdentifierCollision(FcpConnection fcpConnection, IdentifierCollision identifierCollision) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedMessage(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.FcpMessage) + */ + public void receivedMessage(FcpConnection fcpConnection, FcpMessage fcpMessage) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedNodeData(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.NodeData) + */ + public void receivedNodeData(FcpConnection fcpConnection, NodeData nodeData) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedNodeHello(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.NodeHello) + */ + @SuppressWarnings("synthetic-access") + public void receivedNodeHello(FcpConnection fcpConnection, NodeHello nodeHello) { + if (fcpConnection != HighLevelClient.this.fcpConnection) { + return; + } + ConnectResult connectResult = new ConnectResult(); + + synchronized (syncObject) { + connectCallback.setResult(connectResult); + } + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPeer(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.Peer) + */ + public void receivedPeer(FcpConnection fcpConnection, Peer peer) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPeerNote(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PeerNote) + */ + public void receivedPeerNote(FcpConnection fcpConnection, PeerNote peerNote) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPeerRemoved(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PeerRemoved) + */ + public void receivedPeerRemoved(FcpConnection fcpConnection, PeerRemoved peerRemoved) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPersistentGet(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PersistentGet) + */ + public void receivedPersistentGet(FcpConnection fcpConnection, PersistentGet persistentGet) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPersistentPut(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PersistentPut) + */ + public void receivedPersistentPut(FcpConnection fcpConnection, PersistentPut persistentPut) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPersistentPutDir(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PersistentPutDir) + */ + public void receivedPersistentPutDir(FcpConnection fcpConnection, PersistentPutDir persistentPutDir) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPersistentRequestModified(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PersistentRequestModified) + */ + public void receivedPersistentRequestModified(FcpConnection fcpConnection, PersistentRequestModified persistentRequestModified) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPersistentRequestRemoved(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PersistentRequestRemoved) + */ + public void receivedPersistentRequestRemoved(FcpConnection fcpConnection, PersistentRequestRemoved persistentRequestRemoved) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPluginInfo(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PluginInfo) + */ + public void receivedPluginInfo(FcpConnection fcpConnection, PluginInfo pluginInfo) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedProtocolError(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.ProtocolError) + */ + public void receivedProtocolError(FcpConnection fcpConnection, ProtocolError protocolError) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPutFailed(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PutFailed) + */ + public void receivedPutFailed(FcpConnection fcpConnection, PutFailed putFailed) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPutFetchable(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PutFetchable) + */ + public void receivedPutFetchable(FcpConnection fcpConnection, PutFetchable putFetchable) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedPutSuccessful(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.PutSuccessful) + */ + public void receivedPutSuccessful(FcpConnection fcpConnection, PutSuccessful putSuccessful) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedSSKKeypair(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.SSKKeypair) + */ + public void receivedSSKKeypair(FcpConnection fcpConnection, SSKKeypair sskKeypair) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedSimpleProgress(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.SimpleProgress) + */ + public void receivedSimpleProgress(FcpConnection fcpConnection, SimpleProgress simpleProgress) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedStartedCompression(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.StartedCompression) + */ + public void receivedStartedCompression(FcpConnection fcpConnection, StartedCompression startedCompression) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedSubscribedUSKUpdate(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.SubscribedUSKUpdate) + */ + public void receivedSubscribedUSKUpdate(FcpConnection fcpConnection, SubscribedUSKUpdate subscribedUSKUpdate) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedTestDDAComplete(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.TestDDAComplete) + */ + public void receivedTestDDAComplete(FcpConnection fcpConnection, TestDDAComplete testDDAComplete) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedTestDDAReply(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.TestDDAReply) + */ + public void receivedTestDDAReply(FcpConnection fcpConnection, TestDDAReply testDDAReply) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedURIGenerated(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.URIGenerated) + */ + public void receivedURIGenerated(FcpConnection fcpConnection, URIGenerated uriGenerated) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedUnknownNodeIdentifier(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.UnknownNodeIdentifier) + */ + public void receivedUnknownNodeIdentifier(FcpConnection fcpConnection, UnknownNodeIdentifier unknownNodeIdentifier) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receivedUnknownPeerNoteType(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.UnknownPeerNoteType) + */ + public void receivedUnknownPeerNoteType(FcpConnection fcpConnection, UnknownPeerNoteType unknownPeerNoteType) { + } + + /** + * @see net.pterodactylus.fcp.FcpListener#receviedFinishedCompression(net.pterodactylus.fcp.FcpConnection, + * net.pterodactylus.fcp.FinishedCompression) + */ + public void receviedFinishedCompression(FcpConnection fcpConnection, FinishedCompression finishedCompression) { + } + + } + +} diff --git a/src/net/pterodactylus/fcp/highlevel/HighLevelResult.java b/src/net/pterodactylus/fcp/highlevel/HighLevelResult.java new file mode 100644 index 0000000..b61036e --- /dev/null +++ b/src/net/pterodactylus/fcp/highlevel/HighLevelResult.java @@ -0,0 +1,32 @@ +/* + * fcplib - HighLevelResult.java - + * Copyright © 2008 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 + * the Free Software Foundation; either version 2 of the License, or + * (at your option) any later version. + * + * This program is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with this program; if not, write to the Free Software + * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + */ + +package net.pterodactylus.fcp.highlevel; + +/** + * Marker interface for results of {@link HighLevelClient} operations. + * + * @author David ‘Bombe’ Roden <bombe@freenetproject.org> + * @version $Id$ + */ +public interface HighLevelResult { + + /* intentionally left blank. */ + +} -- 2.7.4