+++ /dev/null
-package be.nikiroo.utils.serial;
-
-import java.io.IOException;
-import java.net.Socket;
-
-import be.nikiroo.utils.Version;
-
-/**
- * Base class used for the client basic handling.
- * <p>
- * It represents a single action: a client is expected to only execute one
- * action.
- *
- * @author niki
- */
-public class ConnectActionClient {
- private ConnectAction action;
-
- /**
- * Create a new {@link ConnectActionClient} with the current application
- * version (see {@link Version#getCurrentVersion()}) as the client version.
- *
- * @param s
- * the socket to bind to
- */
- public ConnectActionClient(Socket s) {
- this(s, Version.getCurrentVersion());
- }
-
- /**
- * Create a new {@link ConnectActionClient} with the current application
- * version (see {@link Version#getCurrentVersion()}) as the client version.
- *
- * @param host
- * the host to bind to
- * @param port
- * the port to bind to
- * @param ssl
- * TRUE for an SSL connection, FALSE for plain text
- *
- * @throws IOException
- * in case of I/O error when creating the socket
- */
- public ConnectActionClient(String host, int port, boolean ssl)
- throws IOException {
- this(Server.createSocket(host, port, ssl), Version.getCurrentVersion());
- }
-
- /**
- * Create a new {@link ConnectActionClient}.
- *
- * @param host
- * the host to bind to
- * @param port
- * the port to bind to
- * @param ssl
- * TRUE for an SSL connection, FALSE for plain text
- * @param version
- * the client version
- *
- * @throws IOException
- * in case of I/O error when creating the socket
- */
- public ConnectActionClient(String host, int port, boolean ssl,
- Version version) throws IOException {
- this(Server.createSocket(host, port, ssl), version);
- }
-
- /**
- * Create a new {@link ConnectActionClient}.
- *
- * @param s
- * the socket to bind to
- * @param version
- * the client version
- */
- public ConnectActionClient(Socket s, Version version) {
- action = new ConnectAction(s, false, version) {
- @Override
- protected void action(Version serverVersion) throws Exception {
- ConnectActionClient.this.action(serverVersion);
- }
-
- @Override
- protected void onError(Exception e) {
- ConnectActionClient.this.onError(e);
- }
-
- @Override
- protected Version negotiateVersion(Version clientVersion) {
- new Exception("Should never be called on a client")
- .printStackTrace();
- return null;
- }
- };
- }
-
- /**
- * Actually start the process and call the action (synchronous).
- */
- public void connect() {
- action.connect();
- }
-
- /**
- * Actually start the process and call the action (asynchronous).
- */
- public void connectAsync() {
- new Thread(new Runnable() {
- @Override
- public void run() {
- connect();
- }
- }).start();
- }
-
- /**
- * Method that will be called when an action is performed on the client.
- *
- * @param serverVersion
- * the server version
- *
- * @throws Exception
- * in case of I/O error
- */
- @SuppressWarnings("unused")
- public void action(Version serverVersion) throws Exception {
- }
-
- /**
- * Serialise and send the given object to the server (and return the
- * deserialised answer).
- *
- * @param data
- * the data to send
- *
- * @return the answer, which can be NULL
- *
- * @throws IOException
- * in case of I/O error
- * @throws NoSuchFieldException
- * if the serialised data contains information about a field
- * which does actually not exist in the class we know of
- * @throws NoSuchMethodException
- * if a class described in the serialised data cannot be created
- * because it is not compatible with this code
- * @throws ClassNotFoundException
- * if a class described in the serialised data cannot be found
- */
- public Object send(Object data) throws IOException, NoSuchFieldException,
- NoSuchMethodException, ClassNotFoundException {
- return action.send(data);
- }
-
- /**
- * Handler called when an unexpected error occurs in the code.
- * <p>
- * Will just ignore the error by default.
- *
- * @param e
- * the exception that occurred
- */
- protected void onError(@SuppressWarnings("unused") Exception e) {
- }
-
- // old stuff:
-
- /**
- * Do not use. Will never be called.
- */
- @SuppressWarnings({ "unused", "javadoc" })
- @Deprecated
- protected void onClientVersionReceived(Version clientVersion) {
- }
-
- /**
- * Do not use, it is not supposed to be called from the outside.
- */
- @SuppressWarnings({ "unused", "javadoc" })
- @Deprecated
- public Object flush() throws NoSuchFieldException, NoSuchMethodException,
- ClassNotFoundException, IOException, java.lang.NullPointerException {
- return null;
- }
-}
\ No newline at end of file
git://git.nikiroo.be / nikiroo-utils.git / blobdiff