Merge branch '3.x' into 4.x

Author: jknack

docs/asciidoc/body.adoc

@@ -103,22 +103,12 @@ and returns a single result of the given type.
 }
 ----
 
-<1> Choose your favorite `jackson` library
+<1> Choose your favorite `json` library
 <2> Check if the `Content-Type` header matches `application/json`
 <3> Read the body as `byte[]`
 <4> Parse the `body` and use the requested type
 <5> Route handler now call the `body(Type)` function to trigger the decoder function
 
-[TIP]
-====
-
-Jooby comes with a `jackson` decoder built on top of https://github.com/FasterXML/jackson-databind[Jackson]:
-
-[dependency, artifactId="jooby-jackson"]
-.
-
-====
-
 === Response Body
 
 Response body is generated from `handler` function:
@@ -162,19 +152,22 @@ Response body is generated from `handler` function:
 
 ==== Message Encoder
 
-Response enconding is achieved using the javadoc:MessageEncoder[] functional interface.
+Response encoding is achieved using the javadoc:MessageEncoder[] functional interface.
 
 [source, java]
 ----
 public interface MessageEncoder {
 
-  byte[] encode(@NonNull Context ctx, @NonNull Object value) throws Exception;
+  DataBuffer encode(@NonNull Context ctx, @NonNull Object value) throws Exception;
 }
 ----
 
-MessageEncoder has a single `encode` method that accepts two input arguments: `(context, result)` and 
+MessageEncoder has a single `encode` method that accepts two input arguments: `(context, value)` and 
 produces a result.
 
+The javadoc:buffer.DataBuffer[buffer] works like `java.nio.ByteBuffer` and it is used internally
+for performance reason.
+
 .JSON example:
 [source, java, role="primary"]
 ----
@@ -219,19 +212,9 @@ produces a result.
 }
 ----
 
-<1> Choose your favorite `jackson` library
+<1> Choose your favorite `json` library
 <2> Check if the `Accept` header matches `application/json`
 <3> Convert `result` to `JSON`
 <4> Set default `Content-Type` to `application/json`
 <5> Produces JSON response
 <6> Route handler returns a user defined type
-
-[TIP]
-====
-
-Jooby comes with a `jackson` encoder built on top of https://github.com/FasterXML/jackson-databind[Jackson]:
-
-[dependency, artifactId="jooby-jackson"]
-.
-
-====

jooby/src/main/java/io/jooby/MessageEncoder.java

@@ -28,12 +28,11 @@ public interface MessageEncoder {
       };
 
   /**
-   * MessageEncoder a value into a byte array or <code>null</code> if given object isn't supported
-   * it.
+   * Encodes a value into a buffer or <code>null</code> if a given object isn't supported it.
    *
    * @param ctx Web context.
    * @param value Value to render.
-   * @return Value as a byte array or <code>null</code> if given object isn't supported it.
+   * @return Encoded value or <code>null</code> if given object isn't supported it.
    * @throws Exception If something goes wrong.
    */
   @Nullable BufferedOutput encode(@NonNull Context ctx, @NonNull Object value) throws Exception;