Go to file
Nick Travers 0a8c93a6fa Loosen bounds check on CompositeByteBuf's maxNumComponents (#8621)
Motivation:

In versions of Netty prior to 4.1.31.Final, a CompositeByteBuf could be
created with any size (including potentially nonsensical negative
values). This behavior changed in e7737b993, which introduced a bounds
check to only allow for a component size greater than one. This broke
some existing use cases that attempted to create a byte buf with a
single component.

Modifications:

Lower the bounds check on numComponents to include the single component
case, but still throw an exception for anything less than one.

Add unit tests for the case of numComponents being less than, equal to,
and greater than this lower bound.

Result:

Return to the behavior of 4.1.30.Final, allowing one component, but
still include an explicit check against a lower bound.

Note that while creating a CompositeByteBuf with a single component is
in some ways a contradiction of the term "composite", this patch caters
for existing uses while excluding the clearly nonsensical case of asking
for a CompositeByteBuf with zero or fewer components.

Fixes #8613.
2018-12-05 08:43:53 +01: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 Remove OIO transport (and transports that depend on it). (#8580) 2018-11-21 15:23:18 +01:00
bom Remove OIO transport (and transports that depend on it). (#8580) 2018-11-21 15:23:18 +01:00
buffer Loosen bounds check on CompositeByteBuf's maxNumComponents (#8621) 2018-12-05 08:43:53 +01:00
codec Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-dns Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-haproxy Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-http Set-Cookie headers should not be combined (#8611) 2018-12-01 10:47:37 +01:00
codec-http2 Reduce http2 buffer slicing (#8598) 2018-11-29 19:46:19 +01:00
codec-memcache Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-mqtt Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-redis Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-smtp Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-socks Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-stomp Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
codec-xml Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
common Harden ref-counting concurrency semantics (#8583) 2018-11-29 08:32:50 +01:00
dev-tools Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
docker Update to OpenJDK 12 ea22 (#8618) 2018-12-04 11:59:23 +01:00
example Remove OIO transport (and transports that depend on it). (#8580) 2018-11-21 15:23:18 +01:00
handler Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
handler-proxy Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
license Add the NOTICE of the forked portion of Apache Harmony 2018-01-30 11:22:51 +01:00
microbench Adding an execute burst cost benchmark for Netty executors (#8594) 2018-12-04 15:46:48 +01:00
resolver Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
resolver-dns Combine flushes in DnsNameResolver to allow usage of sendmmsg to reduce syscall costs (#8470) 2018-11-21 06:42:50 +01:00
tarball Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
testsuite Remove OIO transport (and transports that depend on it). (#8580) 2018-11-21 15:23:18 +01:00
testsuite-autobahn Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
testsuite-http2 Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
testsuite-osgi Update to OpenJDK 12 ea22 (#8618) 2018-12-04 11:59:23 +01:00
testsuite-shading Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
transport Factor out less common code-path into own method to allow inlining. (#8590) 2018-11-25 21:46:33 +01:00
transport-native-epoll Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
transport-native-kqueue Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
transport-native-unix-common Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
transport-native-unix-common-tests Update version number to start working on Netty 5 2018-11-20 15:49:57 +01:00
transport-sctp Remove OIO transport (and transports that depend on it). (#8580) 2018-11-21 15:23:18 +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 Exclude mainframer related files from git 2018-10-14 13:20:18 +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 Update to OpenJDK 12 ea22 (#8618) 2018-12-04 11:59:23 +01: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.