engine.io-client-java/README.md

Engine.IO-client.java

This is the Engine.IO Client Library for Java, which is simply ported from the JavaScript client.

See also: Socket.IO-client.java

Installation

The latest artifact is available on Maven Central. Add the following dependency to your pom.xml.

<dependencies>
  <dependency>
    <groupId>com.github.nkzawa</groupId>
    <artifactId>engine.io-client</artifactId>
    <version>0.1.2</version>
  </dependency>
</dependencies>

Usage

Engine.IO-client.java has the similar api with the JS client. You can use Socket to connect:

socket = new Socket("ws://localhost") {
  @Override
  public void onopen() {
    socket.send("hi");
    socket.close();
  }

  @Override
  public void onmessage(String data) {}

  @Override
  public void onclose() {}

  @Override
  public void onerror(Exception err) {}
};
socket.open();

You can receive events as follows:

socket.on(Socket.EVENT_ERROR, new Emitter.Listener() {
  @Override
  public void call(Object... args) {
    Exception err = (Exception)args[0];
  }
});

How to set options:

opts = new Socket.Options();
opts.cookie = "foo=1;";

socket = new Socket("ws://localhost", opts) { ... };

See the Javadoc for more details.

http://nkzawa.github.io/engine.io-client.java/apidocs/

Features

This library supports all of the features the JS client does, including events, options and upgraging transport. Android is fully supported.

License

MIT