Go to file
James Baldassari 3e3a748eb6 SocksAuthRequest constructor occasionally throws IllegalStateException (#9558)
Motivation:

There appears to be a thread-safety issue in the way that `SocksAuthRequest` is using its `CharsetEncoder` instance.  `CharsetUtil#encoder` returns a cached thread-local encoder instance, so it is not correct to store this instance in a static member variable and reuse it across multiple threads.  The result is an occasional `IllegalStateException` as in the following example:

```
java.lang.IllegalStateException: Current state = RESET, new state = FLUSHED
	at java.base/java.nio.charset.CharsetEncoder.throwIllegalStateException(CharsetEncoder.java:989)
	at java.base/java.nio.charset.CharsetEncoder.flush(CharsetEncoder.java:672)
	at java.base/java.nio.charset.CharsetEncoder.encode(CharsetEncoder.java:801)
	at java.base/java.nio.charset.CharsetEncoder.canEncode(CharsetEncoder.java:907)
	at java.base/java.nio.charset.CharsetEncoder.canEncode(CharsetEncoder.java:982)
	at io.netty.handler.codec.socks.SocksAuthRequest.<init>(SocksAuthRequest.java:43)
```

Modification:

Instead of retrieving the thread-local encoder instance once and storing it as a static member instance, the encoder should be retrieved each time the constructor is invoked.  This change prevents any potential concurrency issues where multiple threads may end up using the same encoder instance.

Result:

Fixes #9556.
2019-09-09 21:08:21 +02:00
.github Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:09:42 +02:00
.mvn support publishing snapshots from docker based ci (#8634) 2018-12-07 05:43:06 +01:00
all Include native-image properties in the netty-all jar (#9518) 2019-08-28 08:09:03 +02:00
bom [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
buffer Fix for incorrect values from CompositeByteBuf#component(int) (#9525) 2019-09-02 13:52:17 +02:00
codec [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-dns Detect truncated responses caused by EDNS0 and MTU miss-match (#9468) 2019-08-17 09:58:22 +02:00
codec-haproxy [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-http HttpPostStandardRequestDecoder leaks memory when constructor throws ErrorDataDecoderException. (#9517) 2019-08-28 10:27:38 +02:00
codec-http2 Support cancellation in the Http2StreamChannelBootstrap (#9519) 2019-08-27 20:42:05 +02:00
codec-memcache [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-mqtt [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-redis [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-smtp [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-socks SocksAuthRequest constructor occasionally throws IllegalStateException (#9558) 2019-09-09 21:08:21 +02:00
codec-stomp [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
codec-xml [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
common Avoid redundant volatile read in DefaultPromise#get() (#9547) 2019-09-09 09:54:38 +02:00
dev-tools [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
docker Cleanup docker / docker-compose configs (#9473) 2019-08-16 13:59:36 +02:00
example [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
handler Fix WriteTimeoutException java doc description (#9554) 2019-09-09 13:58:07 +02:00
handler-proxy [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
license Use Table lookup for HPACK decoder (#9307) 2019-07-02 20:09:44 +02:00
microbench [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
resolver [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
resolver-dns Do not try to retrieve domain search list via reflection hack on windows when using Java9 and later (#9511) 2019-08-28 08:08:01 +02:00
tarball [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
testsuite Also support sendmmsg(...) on connected UDP channels when using native epoll transport (#9536) 2019-09-06 20:57:04 +02:00
testsuite-autobahn [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
testsuite-http2 [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
testsuite-native-image [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
testsuite-osgi [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
testsuite-shading [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
transport SimpleChannelPool POOL_KEY attribute name is easy to get conflict from user code (#9542) (#9548) 2019-09-09 09:47:23 +02:00
transport-native-epoll Add support for recvmmsg(...) even with connected datagram channels w… (#9539) 2019-09-06 20:58:38 +02:00
transport-native-kqueue Add support for recvmmsg when using epoll transport (#9509) 2019-09-03 08:40:17 +02:00
transport-native-unix-common Correctly handle ipv6 mapped ipv4 addresses when using recvmmsg (#9541) 2019-09-06 13:54:29 +02:00
transport-native-unix-common-tests [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
transport-rxtx [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
transport-sctp [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
transport-udt Remove extra checks to fix #9456 (#9523) 2019-08-30 10:37:30 +02:00
.fbprefs Updated Find Bugs configuration 2009-03-04 10:33:09 +00:00
.gitattributes Include mvn wrapper to make setup of development env easier 2018-01-26 08:13:17 +01:00
.gitignore Add .gitignore for docker-sync stuff 2019-03-19 14:03:15 +01:00
CONTRIBUTING.md Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:09:42 +02:00
LICENSE.txt Relicensed to Apache License v2 2009-08-28 07:15:49 +00:00
mvnw Include mvn wrapper to make setup of development env easier 2018-01-26 08:13:17 +01:00
mvnw.cmd Include mvn wrapper to make setup of development env easier 2018-01-26 08:13:17 +01:00
NOTICE.txt Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:09:42 +02:00
pom.xml [maven-release-plugin] prepare for next development iteration 2019-08-13 17:16:42 +00:00
README.md Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:09:42 +02:00
run-example.sh Add UptimeServer and adjust UptimeClient's code style. 2017-04-28 07:41:07 +02:00

Netty Project

Netty is an asynchronous event-driven network application framework for rapid development of maintainable high performance protocol servers & clients.

How to build

For the detailed information about building and developing Netty, please visit the developer guide. This page only gives very basic information.

You require the following to build Netty:

Note that this is build-time requirement. JDK 5 (for 3.x) or 6 (for 4.0+) is enough to run your Netty-based application.

Branches to look

Development of all versions takes place in each branch whose name is identical to <majorVersion>.<minorVersion>. For example, the development of 3.9 and 4.0 resides in the branch '3.9' and the branch '4.0' respectively.

Usage with JDK 9

Netty can be used in modular JDK9 applications as a collection of automatic modules. The module names follow the reverse-DNS style, and are derived from subproject names rather than root packages due to historical reasons. They are listed below:

  • io.netty.all
  • io.netty.buffer
  • io.netty.codec
  • io.netty.codec.dns
  • io.netty.codec.haproxy
  • io.netty.codec.http
  • io.netty.codec.http2
  • io.netty.codec.memcache
  • io.netty.codec.mqtt
  • io.netty.codec.redis
  • io.netty.codec.smtp
  • io.netty.codec.socks
  • io.netty.codec.stomp
  • io.netty.codec.xml
  • io.netty.common
  • io.netty.handler
  • io.netty.handler.proxy
  • io.netty.resolver
  • io.netty.resolver.dns
  • io.netty.transport
  • io.netty.transport.epoll (native omitted - reserved keyword in Java)
  • io.netty.transport.kqueue (native omitted - reserved keyword in Java)
  • io.netty.transport.unix.common (native omitted - reserved keyword in Java)
  • io.netty.transport.rxtx
  • io.netty.transport.sctp
  • io.netty.transport.udt

Automatic modules do not provide any means to declare dependencies, so you need to list each used module separately in your module-info file.