Go to file
Carl Mastrangelo 9abeaf16fd Properly debounce wakeups (#9191)
Motivation:
The wakeup logic in EpollEventLoop is overly complex

Modification:
* Simplify the race to wakeup the loop
* Dont let the event loop wake up itself (it's already awake!)
* Make event loop check if there are any more tasks after preparing to
sleep.  There is small window where the non-eventloop writers can issue
eventfd writes here, but that is okay.

Result:
Cleaner wakeup logic.

Benchmarks:

```
BEFORE
Benchmark                                   Mode  Cnt       Score      Error  Units
EpollSocketChannelBenchmark.executeMulti   thrpt   20  408381.411 ± 2857.498  ops/s
EpollSocketChannelBenchmark.executeSingle  thrpt   20  157022.360 ± 1240.573  ops/s
EpollSocketChannelBenchmark.pingPong       thrpt   20   60571.704 ±  331.125  ops/s

Benchmark                                   Mode  Cnt       Score      Error  Units
EpollSocketChannelBenchmark.executeMulti   thrpt   20  440546.953 ± 1652.823  ops/s
EpollSocketChannelBenchmark.executeSingle  thrpt   20  168114.751 ± 1176.609  ops/s
EpollSocketChannelBenchmark.pingPong       thrpt   20   61231.878 ±  520.108  ops/s
```
2019-06-04 05:17:23 -07:00
.github Use GitHub Issue/PR Template Feature 2016-12-07 11:40:26 -08:00
.mvn support publishing snapshots from docker based ci (#8634) 2018-12-07 05:43:06 +01:00
all Always include classes from all native transports no matter on which platfrom netty-all is build (#9111) 2019-04-30 23:23:48 +02:00
bom [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
buffer De-duplicate UnpooledDirectByteBuf/UnpooledUnsafeDirectByteBuf (#9085) 2019-06-03 13:04:10 +02:00
codec Allow null sender when using DatagramPacketEncoder (#9204) 2019-06-03 08:44:35 +02:00
codec-dns Add support for TCP fallback when we receive a truncated DnsResponse (#9139) 2019-05-17 14:37:11 +02:00
codec-haproxy [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
codec-http Do not use static exceptions for websocket handshake timeout (#9174) 2019-05-23 08:24:03 +02:00
codec-http2 Remove deprecated GraalVM native-image flags (#9118) 2019-05-22 19:20:54 +02:00
codec-memcache codec-memcache: copy metadata in binary full request response (#9160) 2019-05-22 11:05:52 +02:00
codec-mqtt Fixed toString() exception in MqttSubscribePayload and MqttUnsubscribePayload (#9202) 2019-05-31 06:46:50 +02:00
codec-redis [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
codec-smtp [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
codec-socks [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
codec-stomp [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
codec-xml [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
common Simplify SingleThreadEventExecutor.awaitTermination() implementation (#9081) 2019-05-27 16:05:40 +02:00
dev-tools [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
docker Remove deprecated GraalVM native-image flags (#9118) 2019-05-22 19:20:54 +02:00
example Set the HOST header in Http2ClientInitializer when trying to start an upgrade request (#9177) 2019-05-27 16:02:38 +02:00
handler OpenSsl.USE_KEYMANAGER_FACTORY incorrectly set to false with BoringSSL (#9175) 2019-05-23 07:09:55 +02:00
handler-proxy [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
license Updated jboss-marshalling dependency to current license (#9172) 2019-05-23 07:21:11 +02:00
microbench Properly debounce wakeups (#9191) 2019-06-04 05:17:23 -07:00
resolver Close delegate resolver from RoundRobinInetAddressResolver (#9214) 2019-06-04 05:13:44 -07:00
resolver-dns Only try to use reflection to access default nameservers when using Java8 and lower (#9157) 2019-05-18 08:21:33 +02:00
tarball [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
testsuite Added UDP multicast (with caveats: getInterface, getNetworkInterface, block or loopback-mode-disabled operations). 2019-05-25 08:00:16 +02:00
testsuite-autobahn [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
testsuite-http2 [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
testsuite-native-image [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
testsuite-osgi [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
testsuite-shading [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
transport Don't double record stacktrace in Annotated*Exception (#9117) 2019-05-22 12:06:30 +02:00
transport-native-epoll Properly debounce wakeups (#9191) 2019-06-04 05:17:23 -07:00
transport-native-kqueue Resolve the pid field in PeerCredentials of KQueueDomainSocketChannels. (#9219) 2019-06-04 05:15:42 -07:00
transport-native-unix-common Added UDP multicast (with caveats: getInterface, getNetworkInterface, block or loopback-mode-disabled operations). 2019-05-25 08:00:16 +02:00
transport-native-unix-common-tests [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
transport-rxtx [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
transport-sctp [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +00:00
transport-udt [maven-release-plugin] prepare for next development iteration 2019-04-30 16:42:29 +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 .gitignore for docker-sync stuff 2019-03-19 14:03:15 +01: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 Updated jboss-marshalling dependency to current license (#9172) 2019-05-23 07:21:11 +02:00
pom.xml Remove deprecated GraalVM native-image flags (#9118) 2019-05-22 19:20:54 +02: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.