Added a word about benchmarks and rename HttpServerBenchmark to HttpS…

…erverHandlerBenchmark to be more accurate

benchmarks.md

@@ -0,0 +1,47 @@
+## Microbenchmarks
+
+A few JMH benchmarks are available to measure performance of some Vert.x sensistive parts.
+
+The benchmarks are executed with biased locking enabled.
+
+The benchmarks configures a JMH executor that uses `VertxThread`.
+
+Benchmarks are located in the `src/test/benchmarks` folder.
+
+### How-to
+
+Package the JMH microbenchmarks
+
+```
+> mvn package -DskipTests -Pbenchmarks
+```
+
+Run them all
+
+```
+> java -jar target/vertx-core-$VERSION-benchmarks.jar
+```
+
+### HttpHeaders benchmarks
+
+- `HeadersEncodeBenchmark`: encode HttpHeaders
+- `HeadersContainsBenchmarkv: HttpHeaders contains method
+- `HeadersSetBenchmark`: HttpHeaders set method
+
+```
+> java -jar target/vertx-core-$VERSION-benchmarks.jar HeadersEncodeBenchmark
+```
+
+### HttpServer handler benchmarks
+
+The `HttpServerHandlerBenchmark` benchmarks the `HttpServer` that deals with `HttpRequest` and `HttpResponse`
+ objects. It mainly compares a simple  _hello world_ application written with Vert.x and Netty.
+
+```
+> java -jar target/vertx-core-$VERSION-benchmarks.jar HttpServerHandlerBenchmark
+```
+
+### Context benchmarks
+
+The `RunOnContextBenchmark` measures the impact of the disabling thread checks, context timing that are done
+when running Vert.x context tasks.

src/test/benchmarks/io/vertx/benchmarks/HttpServerBenchmark.java → src/test/benchmarks/io/vertx/benchmarks/HttpServerHandlerBenchmark.java

@@ -63,7 +63,7 @@
  */
 @State(Scope.Thread)
 @Threads(16)
-public class HttpServerBenchmark extends BenchmarkBase {
+public class HttpServerHandlerBenchmark extends BenchmarkBase {
 
   private static final ByteBuf GET = Unpooled.unreleasableBuffer(Unpooled.copiedBuffer((
     "GET / HTTP/1.1\r\n" +