Ring netty adapter
An netty adapter impl on top of netty for used with Ring. Rssminer uses it to build the web server.
Quick Start
[me.shenfeng/async-ring-adapter "1.0.0"]
(use 'ring.adapter.netty)
(defn app [req]
{:status 200
:headers {"Content-Type" "text/html"}
:body (str "hello word")})
(run-netty app {:port 8080
:worker 4 ;; worker thread count
:netty {"reuseAddress" true}})netty options
- connectTimeoutMillis
- keepAlive
- reuseAddress
- tcpNoDelay
- receiveBufferSize
- sendBufferSize
more options, refer netty doc
why
-
Netty is well designed and documented. It’s fun reading it’s code. It’s high performance.
-
Netty’s HTTP support is very different from the existing HTTP libraries. It gives you complete control over how HTTP messages are exchanged in a low level. Because it is basically the combination of HTTP codec and HTTP message classes, there is no restriction such as enforced thread model. That is, you can write your own HTTP client or server that works exactly the way you want. You have full control over thread model, connection life cycle, chunked encoding, and as much as what HTTP specification allows you to do.
Limitation
- Serving file is not optimized due to it’s better be done by Nginx, so as compression.
Benchmark
There is a script ./scripts/start_server will start netty at port 3333, jetty at port 4444, here is a result on my machine
(def resp {:status 200
:headers {"Content-Type" "text/plain"}
:body "Hello World"})ab -n 300000 -c 50 http://localhost:4444/ #11264.90 [#/sec] (mean) jetty
ab -n 300000 -c 50 http://localhost:3333/ #12638.37 [#/sec] (mean) nettyContributors
This repo was fork from datskos
Source code
The source code is in github