This very short introduction should get you going with Coconut AIO in about 2 minutes. The tutorial consists of a building a simple client and server that exchanges some data.
Download and install
Download the standalone jar file and include it in your classpath.
The server
First we create the server that accepts an incoming TCP connection. After having accepted the socket is reads some data and outputs it to the System.out stream. Finally, it closes both sockets.
We have used traditionally java.nio for the server. If any of this is new to you you should probably get up-to-date with the socket handling mechanisms in Java before proceeding with Coconut.
The client
We'll be using Coconut AIO to create the client.
Now startup the server first and when it is running startup the AIO client. Expected output from the server is "HelloWorld"
The code is very similar to what you would have been writing if you had used java.nio or the ordinary sockets in java.net. One of the features of Coconut AIO is that is can function in a blocking manner as these well known libraries. However, beside using a blocking mode the various AIO types are also able to take callbacks as arguments or specify a queue for notification of event completion.
You can read more about these mechanisms in the 5 minute introduction