Go to file
Scott Mitchell 53b2dea3f4
HTTP/2 child channel read cycle doesn't respect RecvByteBufAllocator and (#8147)
Motivation:
Http2MultiplexCodec queues data internally if data is delivered from the
parent channel but the child channel did not request data. If the parent
channel notifies of a stream closure it is possible data in the queue
will be discarded before closing the channel.
Http2MultiplexCodec interacts with RecvByteBufAllocator to control the
child channel's demand for read. However it currently only ever reads a
maximum of one time per loop. This can thrash the read loop and bloat
the call stack if auto read is on, because channelReadComplete will
re-enter the read loop synchronously, and also neglect to deliver data
during the parent's read loop (if it is active). This also meant the
readPendingQueue was not utilized as originally intended (to extend the
child channel's read loop during the parent channel's read loop if
demand for data still existed).

Modifications:
- Modify the child channel's read loop to respect the
RecvByteBufAllocator, and append to the parents readPendingQueue if
appropriate.
- Stream closure notification behaves like EPOLL and KQUEUE transports
and reads all queued data, because the data is already queued in memory
and it is known there will be no more data. This will also replenish the
connection flow control window which may otherwise be constrained by a
closed stream.

Result:
More correct read loop and less risk of dropping data.
2018-07-26 19:44:21 -04:00
.github Use GitHub Issue/PR Template Feature 2016-12-07 11:40:26 -08:00
.mvn/wrapper Include mvn wrapper to make setup of development env easier 2018-01-26 08:13:17 +01:00
all [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
bom [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
buffer Leak detection combined with composite buffers results in incorrectly handled writerIndex when calling ByteBufUtil.writeAscii/writeUtf8 (#8153) 2018-07-27 01:56:09 +08:00
codec [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-dns [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-haproxy [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-http [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-http2 HTTP/2 child channel read cycle doesn't respect RecvByteBufAllocator and (#8147) 2018-07-26 19:44:21 -04:00
codec-memcache [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-mqtt [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-redis [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-smtp [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-socks [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-stomp [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
codec-xml [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
common DefaultPromise.getNow() does not correctly handle DefaultPromise.setUncancellable() (#8154) 2018-07-27 01:55:21 +08:00
dev-tools [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
docker Update to java 11+ea19 2018-06-25 16:47:01 +02:00
example [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
handler Allow to validate sni hostname with underscore (#8150) 2018-07-27 01:56:32 +08:00
handler-proxy [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
license Add the NOTICE of the forked portion of Apache Harmony 2018-01-30 11:22:51 +01:00
microbench [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
resolver [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
resolver-dns [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
tarball [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
testsuite [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
testsuite-autobahn [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
testsuite-http2 [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
testsuite-osgi [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
testsuite-shading Fix parent version number used by d67d639f5f 2018-07-11 22:13:48 +02:00
transport Support the usage of SocketOption when nio is used and the java versi… (#8085) 2018-07-25 12:32:28 +08:00
transport-native-epoll [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-native-kqueue [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-native-unix-common [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-native-unix-common-tests [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-rxtx [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-sctp [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00:00
transport-udt [maven-release-plugin] prepare for next development iteration 2018-07-11 15:37:40 +00: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 docker-sync files to .gitignore 2018-05-15 10:39:14 +02:00
CONTRIBUTING.md Move the pull request guide to the developer guide 2014-03-12 13:13:58 +09: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 Add the NOTICE of the forked portion of Apache Harmony 2018-01-30 11:22:51 +01:00
pom.xml Support the usage of SocketOption when nio is used and the java versi… (#8085) 2018-07-25 12:32:28 +08:00
README.md Provide an Automatic-Module-Name for the netty-all artifact fixes #7644 2018-01-27 20:31:16 +01: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.