This is the Engine.IO Client Library for Java, which is simply ported from the JavaScript client.
See also: Socket.IO-client Java
| Client version | Engine.IO server | Socket.IO server |
|---|---|---|
| 0.9.x | 1.x | 1.x |
| 1.x | 3.x | 2.x |
| 2.x | 4.x | 3.x |
The latest artifact is available on Maven Central.
Add the following dependency to your pom.xml.
<dependencies> <dependency> <groupId>io.socket</groupId> <artifactId>engine.io-client</artifactId> <version>2.1.0</version> </dependency> </dependencies>Add it as a gradle dependency for Android Studio, in build.gradle:
compile ('io.socket:engine.io-client:2.1.0'){// excluding org.json which is provided by Android exclude group: 'org.json', module: 'json' }Engine.IO-client Java has the similar api with the JS client. You can use Socket to connect:
socket = newSocket("ws://localhost"); socket.on(Socket.EVENT_OPEN, newEmitter.Listener(){@Overridepublicvoidcall(Object... args){socket.send("hi"); socket.close()} }); socket.open();You can listen events as follows:
socket.on(Socket.EVENT_MESSAGE, newEmitter.Listener(){@Overridepublicvoidcall(Object... args){Stringdata = (String)args[0]} }).on(Socket.EVENT_ERROR, newEmitter.Listener(){@Overridepublicvoidcall(Object... args){Exceptionerr = (Exception)args[0]} });How to set options:
opts = newSocket.Options(); opts.transports = newString[]{WebSocket.NAME}; socket = newSocket(opts);Sending and receiving binary data:
socket = newSocket(); socket.on(Socket.EVENT_OPEN, newEmitter.Listener(){@Overridepublicvoidcall(Object... args){// send binary databyte[] data = newbyte[42]; socket.send(data)} }).on(Socket.EVENT_MESSAGE, newEmitter.Listener(){@Overridepublicvoidcall(Object... args){// receive binary databyte[] data = (byte[])args[0]} });Use custom SSL settings:
OkHttpClientokHttpClient = newOkHttpClient.Builder() .hostnameVerifier(myHostnameVerifier) .sslSocketFactory(mySSLContext.getSocketFactory(), myX509TrustManager) .build(); // default SSLContext for all socketsSocket.setDefaultOkHttpWebSocketFactory(okHttpClient); Socket.setDefaultOkHttpCallFactory(okHttpClient); // set as an optionopts = newSocket.Options(); opts.callFactory = okHttpClient; opts.webSocketFactory = okHttpClient; socket = newSocket(opts);This library supports all of the features the JS client does, including events, options and upgrading transport. Android is fully supported.
MIT
