Merge branch 'subtree'
[fanfix.git] / serial / server / ConnectActionServerObject.java
1 package be.nikiroo.utils.serial.server;
2
3 import java.io.IOException;
4 import java.net.Socket;
5
6 /**
7 * Class used for the server basic handling.
8 * <p>
9 * It represents a single action: a server is expected to execute one action for
10 * each client action.
11 *
12 * @author niki
13 */
14 public class ConnectActionServerObject extends ConnectActionServer {
15 /**
16 * Create a new {@link ConnectActionServerObject} as the server version.
17 *
18 * @param s
19 * the socket to bind to
20 * @param key
21 * an optional key to encrypt all the communications (if NULL,
22 * everything will be sent in clear text)
23 */
24 public ConnectActionServerObject(Socket s, String key) {
25 super(s, key);
26 }
27
28 /**
29 * Serialise and send the given object to the client.
30 *
31 * @param data
32 * the data to send
33 *
34 * @throws IOException
35 * in case of I/O error
36 * @throws NoSuchFieldException
37 * if the serialised data contains information about a field
38 * which does actually not exist in the class we know of
39 * @throws NoSuchMethodException
40 * if a class described in the serialised data cannot be created
41 * because it is not compatible with this code
42 * @throws ClassNotFoundException
43 * if a class described in the serialised data cannot be found
44 */
45 public void send(Object data) throws IOException, NoSuchFieldException,
46 NoSuchMethodException, ClassNotFoundException {
47 action.sendObject(data);
48 }
49
50 /**
51 * (Flush the data to the client if needed and) retrieve its answer.
52 *
53 * @return the deserialised answer (which can actually be NULL)
54 *
55 * @throws IOException
56 * in case of I/O error
57 * @throws NoSuchFieldException
58 * if the serialised data contains information about a field
59 * which does actually not exist in the class we know of
60 * @throws NoSuchMethodException
61 * if a class described in the serialised data cannot be created
62 * because it is not compatible with this code
63 * @throws ClassNotFoundException
64 * if a class described in the serialised data cannot be found
65 * @throws java.lang.NullPointerException
66 * if the counter part has no data to send
67 */
68 public Object rec() throws NoSuchFieldException, NoSuchMethodException,
69 ClassNotFoundException, IOException, java.lang.NullPointerException {
70 return action.recObject();
71 }
72 }