Go to file
Nick Travers d0d30f1fbe 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:42:23 +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 [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
bom [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
buffer Loosen bounds check on CompositeByteBuf's maxNumComponents (#8621) 2018-12-05 08:42:23 +01:00
codec [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-dns [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-haproxy [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-http Set-Cookie headers should not be combined (#8611) 2018-12-01 10:47:18 +01:00
codec-http2 Reduce http2 buffer slicing (#8598) 2018-11-29 19:45:52 +01:00
codec-memcache [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-mqtt [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-redis [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-smtp [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-socks [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-stomp [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
codec-xml [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
common [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
dev-tools [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
docker Update to OpenJDK 12 ea22 (#8618) 2018-12-04 11:59:10 +01:00
example [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
handler [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
handler-proxy [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00: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:25 +01:00
resolver [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
resolver-dns [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
tarball [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
testsuite [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
testsuite-autobahn [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
testsuite-http2 [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
testsuite-osgi Update to OpenJDK 12 ea22 (#8618) 2018-12-04 11:59:10 +01:00
testsuite-shading [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-native-epoll [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-native-kqueue [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-native-unix-common [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-native-unix-common-tests [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-rxtx [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-sctp [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +00:00
transport-udt [maven-release-plugin] prepare for next development iteration 2018-11-29 11:15:09 +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 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:10 +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.