Go to file
Chris Vest c982d45493 Fix a bug where SslHandler clients would not process Server Hello messages in a timely manner (#11472)
Motivation:
The TLS handshake must be able to finish on its own, without being driven by outside read calls.
This is currently not the case when TCP FastOpen is enabled.
Reads must be permitted and marked as pending, even when a channel is not active.

This is important because, with TCP FastOpen, the handshake processing of a TLS connection will start
before the connection has been established -- before the process of connecting has even been started.

The SslHandler on the client side will add the Client Hello message to the ChannelOutboundBuffer, then
issue a `ctx.read` call for the anticipated Server Hello response, and then flush the Client Hello
message which, in the case of TCP FastOpen, will cause the TCP connection to be established.

In this transaction, it is important that the `ctx.read` call is not ignored since, if auto-read is
turned off, this could delay or even prevent the Server Hello message from being processed, causing
the server-side handshake to time out.

Modification:
Attach a listener to the SslHandler.handshakeFuture in the EchoClient, that will call ctx.read.

Result:
The SocketSslEchoTest now tests that the SslHandler can finish handshakes on its own, without being driven by 3rd party ctx.read calls.
The various channel implementations have been updated to comply with this behaviour.
2021-07-15 12:01:16 +02:00
.github Add script which can be used to build affected modules only (#11461) 2021-07-08 10:18:28 +02:00
.mvn/wrapper Use MAVEN_OPTS to setup timeouts for dependency downloads (#11250) 2021-05-12 18:04:33 +02:00
all Fix netty-all artifact (#11274) 2021-05-19 11:18:43 +02:00
bom Fix classifier usage in bom 2020-12-08 14:56:38 +01:00
buffer Introduce alternative Buffer API (#11347) 2021-06-28 12:06:44 +02:00
codec Fix JavaDoc and Run Brotli tests on Windows (#11468) 2021-07-13 16:25:13 +02:00
codec-dns Remove unUsed import statement (#11338) 2021-05-31 08:39:11 +02:00
codec-haproxy HAProxyMessage.sourceAddress() can be null (#11475) 2021-07-12 11:56:08 +02:00
codec-http Use Static Constants as Sample Data (#11485) 2021-07-14 07:45:48 +02:00
codec-http2 SelfSignedCertificate should work in http2 tests (#11486) 2021-07-14 07:46:31 +02:00
codec-memcache Remove Progressive*Promise / Progressive*Future (#11374) 2021-06-09 08:32:38 +02:00
codec-mqtt Remove rest of junit4 usage (#11484) 2021-07-13 21:00:53 +02:00
codec-redis Migrate codec-redis to junit5 (#11426) 2021-06-30 14:00:13 +02:00
codec-smtp Migrate codec-smtp tests to JUnit 5 (#11309) 2021-05-26 09:44:06 +02:00
codec-socks Migrate codec-socks tests to JUnit 5 (#11314) 2021-05-26 10:39:13 +02:00
codec-stomp Migrate codec-stomp tests to JUnit 5 (#11312) 2021-05-26 10:17:27 +02:00
codec-xml Migrate codec-xml tests to JUnit 5 (#11311) 2021-05-26 10:06:05 +02:00
common Introduce BrotliEncoder (#11256) 2021-07-08 12:01:28 +02:00
dev-tools Use http in xmlns URIs to make maven release plugin happy again (#10788) 2020-11-10 10:51:05 +01:00
docker Introduce alternative Buffer API (#11347) 2021-06-28 12:06:44 +02:00
example Remove throws Exception from ChannelHandler methods that handle o… (#11417) 2021-07-08 10:16:00 +02:00
handler Migrate the rest of the ssl package to junit5 (#11483) 2021-07-15 08:58:50 +02:00
handler-proxy Remove throws Exception from ChannelHandler methods that handle o… (#11417) 2021-07-08 10:16:00 +02:00
license Introduce BrotliEncoder (#11256) 2021-07-08 12:01:28 +02:00
microbench Remove rest of junit4 usage (#11484) 2021-07-13 21:00:53 +02:00
resolver Migrate resolver to junit5 (#11425) 2021-06-30 12:20:27 +02:00
resolver-dns Improve name matching in DNS answers (#11474) 2021-07-14 14:20:20 +02:00
resolver-dns-native-macos Ensure we fail if native lib can not be loaded on macos (#11261) 2021-05-18 08:14:01 +02:00
scripts Remove tarball module (#11377) 2021-06-10 10:20:32 +02:00
testsuite Fix a bug where SslHandler clients would not process Server Hello messages in a timely manner (#11472) 2021-07-15 12:01:16 +02:00
testsuite-autobahn Add WebSocketClientHandshaker / WebSocketServerHandshaker close methods that take ChannelHandlerContext as parameter (#11171) 2021-04-21 15:22:34 +02:00
testsuite-http2 Skip deployment of testsuite jars (#11127) 2021-03-30 19:06:34 +02:00
testsuite-native Skip deployment of testsuite jars (#11127) 2021-03-30 19:06:34 +02:00
testsuite-native-image Update graal annotations dependencies GAV to allow license GPL2+CE (#11404) 2021-06-21 16:11:57 +02:00
testsuite-native-image-client Change reflection config to match constructor (#11453) 2021-07-05 21:05:06 +02:00
testsuite-native-image-client-runtime-init Update graal annotations dependencies GAV to allow license GPL2+CE (#11404) 2021-06-21 16:11:57 +02:00
testsuite-osgi Skip deployment of testsuite jars (#11127) 2021-03-30 19:06:34 +02:00
testsuite-shading Migrate testsuite-shading tests to JUnit 5 (#11323) 2021-05-27 15:59:36 +02:00
transport Fix a bug where SslHandler clients would not process Server Hello messages in a timely manner (#11472) 2021-07-15 12:01:16 +02:00
transport-blockhound-tests Migrate transport-blockhound-tests tests to JUnit 5 (#11322) 2021-05-27 16:00:30 +02:00
transport-native-epoll Add support for Unix domain datagram sockets when using native epoll/kqueue transport (#11476) 2021-07-12 08:45:10 +02:00
transport-native-kqueue Add support for Unix domain datagram sockets when using native epoll/kqueue transport (#11476) 2021-07-12 08:45:10 +02:00
transport-native-unix-common Add support for Unix domain datagram sockets when using native epoll/kqueue transport (#11476) 2021-07-12 08:45:10 +02:00
transport-native-unix-common-tests Migrate testsuite, transport-native-epoll, transport-native-kqueue, and transport-native-unix-common-tests tests to JUnit 5 (#11320) 2021-05-27 14:07:41 +02:00
transport-sctp Fix compile errors introduced by f805c50f9f 2021-05-28 15:14:55 +02:00
transport-udt/lib/bin/lib/x86_64-MacOSX-gpp/jni Replace reflection usage with MethodHandles when performance matters (#10097) 2020-03-11 21:04:40 +01: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 Ignore .shelf/ folder generated by IntelliJ IDEA (#10445) 2020-08-03 07:52:18 +02:00
.lgtm.yml Enables lgtm.com to process this project and create a CodeQL database 2020-01-20 19:22:49 +01:00
CONTRIBUTING.md Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:10:14 +02:00
LICENSE.txt Enable nohttp check during the build (#10708) 2020-10-23 15:26:25 +02:00
mvnw Enable nohttp check during the build (#10708) 2020-10-23 15:26:25 +02:00
mvnw.cmd Enable nohttp check during the build (#10708) 2020-10-23 15:26:25 +02:00
nohttp-checkstyle-suppressions.xml Ensure Checkstyle suppression for dependency-reduced-pom.xml on Windows (#10899) 2021-01-01 19:31:01 +01:00
nohttp-checkstyle.xml Enable nohttp check during the build (#10708) 2020-10-23 15:26:25 +02:00
NOTICE.txt Introduce BrotliEncoder (#11256) 2021-07-08 12:01:28 +02:00
pom.xml SelfSignedCertificate should work in http2 tests (#11486) 2021-07-14 07:46:31 +02:00
README.md Fix url in README.md (#10915) 2021-01-11 07:50:43 +01:00
run-example.sh Add license header to our scripts and workflows (#11282) 2021-05-19 14:07:00 +02:00
SECURITY.md Added a security policy (#10692) 2020-10-15 20:40:05 +02:00

Build project

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+ / 4.1+) 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.1 resides in the branch '3.9' and the branch '4.1' 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.