net.sergeych.farcall

Interface Connector

All Known Implementing Classes:

BossConnector, Interconnection.QueueConnector, JsonConnector

public interface Connector

Connectors abstract the data transfer between Farcall instances. Connectors must support at least these types which are supported in JSON, e.g. integers, floats, strings, null, arrays and string-object dictionaries. It is very good idea to support somehow the datetime objects, say, as a dictionary with unix time and type information.

Method Summary

Modifier and Type	Method and Description
void	close() Called by protocol when it is closing, and will not send and receive data anymore.
java.util.Map<java.lang.String,java.lang.Object>	receive() Block until the connection is closed or a valid package is received.
void	send(java.util.Map<java.lang.String,java.lang.Object> data) Pack and send farcall data

Method Detail

send

void send(java.util.Map<java.lang.String,java.lang.Object> data)
   throws java.io.IOException

Pack and send farcall data

Parameters:

data, - can not be null.

Throws:

java.io.IOException

receive

java.util.Map<java.lang.String,java.lang.Object> receive()
                                                  throws java.io.IOException

Block until the connection is closed or a valid package is received. Connector unpacks the package and returns it.

Returns:

unpacked data or null to signal eof state.

Throws:

java.io.IOException

close

void close()

Called by protocol when it is closing, and will not send and receive data anymore. Connector can expilcitly close streams and free resources at this point.