Read this if you want to investigate in socket.io-java-client.


SocketIO is the API frontend. You can use this to connect to multiple hosts. If an

*IOConnection* object exists for a certian host, it will be reused as the

socket.io specs state.

[Javadoc](http://s01.de/~tox/hgexport/socket.io-java-client/io/socket/SocketIO.html)

This class is used to hold a connection to a socket.io server. It handles calling

callback functions of the corresponding *SocketIO* and reconnecting if the connection

is shut down ungracefully.

[Javadoc](http://s01.de/~tox/hgexport/socket.io-java-client/io/socket/IOConnection.html)

This interface describes a connection to a host. The implementation can be fairly minimal,

as *IOConnection* does most of the work for you. Reconnecting, errorhandling, etc... is

handled by *IOConnection*.

[Javadoc](http://s01.de/~tox/hgexport/socket.io-java-client/io/socket/IOTransport.html)

An example can be found in [WebsocketTransport.java](http://github.com/Gottox/socket.io-java-client/blob/master/src/io/socket/XhrTransport.java)

or [XhrTransport.java](http://github.com/Gottox/socket.io-java-client/blob/master/src/io/socket/XhrTransport.java)

Create a class implementing the IOTransport interface.

This constant should contain the name of the transport.

Called by IOConnector to create a new Instance of the transport. The URL is the one you should connect to. Here you can rewrite the

url if needed, i.e. WebsocketTransport rewrites the incoming "http://" address to "ws://"

Called by IOConnection. Here you should set up the connection.

Called by IOConnection. This should shut down the connection. I'm currently not sure if this function is called multiple times.

So make sure, it doesn't crash if it's called more than once.

Called by IOConnection. This call request you to send data to the server.

If you can send more than one message at a time, return true. If not return false.

Basicly the same as send() but for multiple messages at a time. This is only called when canSendBulk returns true.

After this call, the transport should not call any methods of IOConnection. It must not disconnect from the server.

This is the case when we're forcing a reconnect. If we disconnect gracefully from the server, it will terminate our

session.

Ok, now we know when our functions are called. But how do we tell socket.io-java-client to process messages we get?

The provided IOConnection does the trick.

Call this method when the connection is established an the socket is ready to send and receive data.

Call this method when the connection is shot down. IOConnection will care about reconnecting, if it's feasibility.

Call this method when the connection is experiencing an error. IOConnection will take care about reconnecting or throwing an

error to the callbacks. Whatever makes more sense ;)

This should be called as soon as the transport has received data. IOConnection will take care about parsing the information and

calling the callbacks of the sockets.

Now IOConnection needs to instantiate the transpost look at the sourcecode of IOConnection and search for the connectTransport() method.

It's part of the ConnectThread inner class.

add a new else if branch to the section. I.e.:

``` java

...

else if (protocols.contains(MyTransport.TRANSPORT_NAME))

transport = MyTransport.create(url, IOConnection.this);

...