You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
|
|
Netty-socketio Overview===This project is an open-source Java implementation of [Socket.IO](http://socket.io/) server. Based on [Netty](http://netty.io/) server framework.
Checkout [Demo project](https://github.com/mrniko/netty-socketio-demo)
Licensed under the Apache License 2.0.
Features================================* Supports __0.7__...__0.9.16__ (netty-socketio 1.6.6) and __1.0+__ (netty-socketio latest version) version of [Socket.IO-client](https://github.com/LearnBoost/socket.io-client) * Supports xhr-polling transport * Supports websocket transport * Supports namespaces and rooms * Supports ack (acknowledgment of received data) * Supports SSL * Supports client store (Memory, [Redisson](http://redisson.org), [Hazelcast](http://www.hazelcast.com/)) * Supports distributed broadcast across netty-socketio nodes ([Redisson](http://redisson.org), [Hazelcast](http://www.hazelcast.com/)) * Supports OSGi * Supports Spring * Lock-free and thread-safe implementation * Declarative handler configuration via annotations
Performance================================
Customer feedback in __2012__: CentOS, 1 CPU, 4GB RAM runned on VM: CPU 10%, Memory 15% 6000 xhr-long polling sessions or 15000 websockets sessions 4000 messages per second
Customer feedback in __2014__: "To stress test the solution we run 30 000 simultaneous websocket clients and managed to peak at total of about 140 000 messages per second with less than 1 second average delay." (c) Viktor Endersz - Kambi Sports Solutions
Projects using netty-socketio================================AVOS Cloud: [avoscloud.com](https://avoscloud.com/) Bingo Crack: [bingocrack.com](http://bingocrack.com/) Kambi Sports Solutions: [kambi.com](http://kambi.com/) ARSnova: [arsnova.eu](https://arsnova.eu) Zipwhip: [zipwhip.com](https://zipwhip.com/)
Recent Releases================================#### Please Note: trunk is current development branch.
#### 11-Jan-2019 - version 1.7.17 released
Feature - randomSession setting added to Config object (thanks to yuanxiangz) Fixed - NPE in WebSocketTransport Fixed - NPE & memory leak (thanks to zhaolianwang) Fixed - namespace parsing (thanks to Redliver) Fixed - Redisson 3.9+ compatibility
#### 06-Jul-2018 - version 1.7.16 released
Fixed - non thread-safe ACK handling (thanks to dawnbreaks) Fixed - inactive long-polling channels cause memory leak (thanks to dawnbreaks) Fixed - websocket CloseFrame processing (thanks to hangsu.cho) Fixed - WebSocketTransport NPE
#### 15-May-2018 - version 1.7.15 released
Fixed - Session ID is not unique anymore Fixed - fixed underlying connection not closing on ping timeout Fixed - the "fin_close" problem
#### 26-Feb-2018 - version 1.7.14 released
Feature - added local socket address for the connection (thanks to @SergeyGrigorev) Feature - `addPingListener` method added (thanks to @lovebing) Feature - add ThreadFactory for HashedWheelTimer (thanks to @hand515) Fixed - changed SO_LINGER to be handled as child channel (not server channel) option (thanks to @robymus) Fixed - ByteBuf leak if binary attachments are used Fixed - restore session from Cookie (thanks to @wuxudong) Fixed - NumberFormatException when b64 is bool value (thanks to @vonway) Fixed - data encoding for polling transport
#### 20-Sep-2017 - version 1.7.13 released
Feature - Added option to change the SSL KeyFactoryAlgorithm using Configuration (thanks to @robymus) Improvement - Binary ack handling improvements (thanks to Sergey Bushik) Fixed - Failed to mark a promise as success because it has succeeded already (thanks to @robymus)
#### 27-Aug-2016 - version 1.7.12 released
Feature - `SocketIOServer.removeAllListeners` method added Feature - `BroadcastOperations.sendEvent` method with `excludedClient` param added Improvement - Redisson updated to 2.4.0 Fixed - memory leak in Namespace object (thanks to @CrazyIvan007)
#### 13-Jul-2016 - version 1.7.11 released
Fixed - Throw error if transport not supported Fixed - Client disconnecting when using Polling - IndexOutOfBoundsException
#### 4-Mar-2016 - version 1.7.10 released
Fixed - netty updated to 4.1.0.CR3 version Fixed - binary packet parsing (thanks to Winston Li)
#### 6-Feb-2016 - version 1.7.9 released
Feature - Compression support Fixed - DotNET client request handling Fixed - Packet length format parsing Fixed - skipping 'd=' in packet Fixed - Polling clients sporatically get prematurely disconnected (thanks to lpage30) Fixed - connections stay open forever if server sent `close` packet Fixed - compatibility with Redisson latest version
#### 30-Nov-2015 - version 1.7.8 released
Improvement - `WebSocketServerHandshaker.allowExtensions` is `true` now Improvement - SessionID cookie implementation (thanks to @ryandietrich) Fixed - clientRooms leak (thanks to @andreaspalm) Fixed - ExceptionListener not used for errors in JSON parsing Fixed - "silent channel" attack
#### 26-Mar-2015 - version 1.6.7 released
Improvement - `useStrictOrdering` param added for websocket packets strict ordering Improvement - `FAIL_ON_EMPTY_BEANS = false` option setted in json decoder
#### 18-Feb-2015 - version 1.7.7 released
Improvement - no need to add jackson lib if you use own JsonSupport impl Fixed - SocketIO client 1.3.x support Fixed - Charset encoding handling (thanks to alim-akbashev)
#### 17-Jan-2015 - version 1.7.6 released
Improvement - `SocketIONamespace.getName()` added Fixed - WebSocket frames aggregation Fixed - WebSocket buffer release Fixed - `Unexpected end-of-input in VALUE_STRING` error Fixed - Access-Control-Allow-Credentials is TRUE for requests with origin header
#### 05-Dec-2014 - version 1.7.5 released
Feature - `Configuration.sslProtocol` param added Fixed - BinaryEvent ack handling Fixed - BinaryEvent non b64 encoding/decoding Fixed - buffer leak during packet encoding
#### 15-Nov-2014 - version 1.7.4 released
Fixed - packet encoding Fixed - BinaryEvent encoding/decoding Fixed - unchallenged connections handling
#### 29-Sep-2014 - version 1.6.6 released
Feature - `origin` setting added Feature - `crossDomainPolicy` setting added Feature - `SocketIOServer.startAsync` method added
#### 24-Sep-2014 - version 1.7.3 released
Feature - Epoll support Improvement - BinaryEvent support Fixed - SocketIOClient disconnect handling Fixed - broadcast callback Fixed - NPE then no transport defined during auth Fixed - ping timeout for polling transport Fixed - buffer leak in PacketEncoder
#### 22-Aug-2014 - version 1.7.2 released
Fixed - wrong outgoing message encoding using websocket transport Fixed - NPE in websocket transport Fixed - multiple packet decoding in polling transport Fixed - buffer leak
#### 07-Jul-2014 - version 1.7.1 released
Feature - ability to set custom `Access-Control-Allow-Origin` via Configuration.origin Fixed - connection via CLI socket.io-client
#### 28-Jun-2014 - version 1.7.0 released
Feature - Socket.IO 1.0 protocol support. Thanks to the new protocol decoding/encoding has speedup __Dropped__ - `SocketIOClient.sendMessage`, `SocketIOClient.sendJsonObject` methods and corresponding listeners __Dropped__ - Flashsocket transport support __Dropped__ - protocol version 0.7 ... 0.9.16
#### 13-May-2014 - version 1.6.5 released
Improvement - single packet encoding optimized, used mostly in WebSocket transport. Encoding time reduced up to 40% (thanks to Viktor Endersz) Improvement - rooms handling optimized Improvement - ExceptionListener.exceptionCaught method added __Breaking api change__ - Configuration.autoAck replaced with ackMode Feature - trustStore setting added Feature - maxFramePayloadLength setting added Feature - getAllClients and getClient methods added to SocketIONamespace Fixed - SocketIOServer.getAllClients returns wrong clients amount
#### 25-Mar-2014 - version 1.6.4 released
Fixed - message release problem Fixed - problem with exception listener configuration redefinition __Breaking api change__ - DataListener.onData now throws Exception Improvement - data parameter added to exception listener Improvement - ability to setup socket configuration Improvement - Configuration.autoAck parameter added
#### 06-Mar-2014 - version 1.6.3 released
Fixed - AckCallback handling during client disconnect Fixed - unauthorized handshake HTTP code changed to 401 __Breaking api change__ - Configuration.heartbeatThreadPoolSize setting removed Feature - annotated Spring beans support via _SpringAnnotationScanner_ Feature - common exception listener Improvement - _ScheduledExecutorService_ replaced with _HashedWheelTimer_
#### 08-Feb-2014 - version 1.6.2 released
Fixed - wrong namespace client disconnect handling Fixed - exception in onConnect/onDisconnect/isAuthorized methods leads to server hang __Breaking api change__ - SocketIOClient.sendEvent methods signature changed Improvement - multi type events support via _MultiTypeEventListener_ and _OnEvent_ annotation Improvement - multi type events ack support via _MultiTypeAckCallback_ Improvement - SocketIOClient.getHandshakeData method added Improvement - Jedis replaced with [Redisson](https://github.com/mrniko/redisson)
#### 14-Jan-2014 - version 1.6.1 released
Fixed - JDK 1.6+ compatibility Feature - authorization support
#### 19-Dec-2013 - version 1.6.0 released
Fixed - XHR-pooling transport regression Fixed - Websocket transport regression Fixed - namespace NPE in PacketHandler Fixed - executors shutdown during server stop Feature - client store (Memory, [Redis](http://redis.io/), [Hazelcast](http://www.hazelcast.com/)) support Feature - distributed broadcast across netty-socketio nodes ([Redis](http://redis.io/), [Hazelcast](http://www.hazelcast.com/)) support Feature - OSGi support (thanks to rdevera) Improvement - XHR-pooling optimization Improvement - SocketIOClient.getAllRooms method added
#### 07-Dec-2013 - version 1.5.4 released
Fixed - flash policy "request leak" after page reload (thanks to ntrp) Fixed - websocket swf loading (thanks to ntrp) Fixed - wrong urls causes a potential DDoS Fixed - Event.class package visibility changed to avoid direct usage Improvement - Simplified Jackson modules registration
#### 24-Oct-2013 - version 1.5.2 released
Fixed - NPE during shutdown Improvement - isEmpty method added to Namespace
#### 13-Oct-2013 - version 1.5.1 released
Fixed - wrong ack timeout callback invocation Fixed - bigdecimal serialization for JSON Fixed - infinity loop during packet handling exception Fixed - 'client not found' handling
#### 27-Aug-2013 - version 1.5.0 released
Improvement - encoding buffers allocation optimization. Improvement - encoding buffers now pooled in memory to reduce GC pressure (netty 4.x feature).
#### 03-Aug-2013 - version 1.0.1 released
Fixed - error on unknown property during deserialization. Fixed - memory leak in long polling transport. Improvement - logging error info with inbound data. #### 07-Jun-2013 - version 1.0.0 released
First stable release.
### Maven
Include the following to your dependency list:
<dependency> <groupId>com.corundumstudio.socketio</groupId> <artifactId>netty-socketio</artifactId> <version>1.7.12</version> </dependency> ### Supported by
YourKit is kindly supporting this open source project with its full-featured Java Profiler.YourKit, LLC is the creator of innovative and intelligent tools for profilingJava and .NET applications. Take a look at YourKit's leading software products:<a href="http://www.yourkit.com/java/profiler/index.jsp">YourKit Java Profiler</a> and<a href="http://www.yourkit.com/.net/profiler/index.jsp">YourKit .NET Profiler</a>.
|
