Rename Parser -> MessageDecoder

Author: jknack

docs/asciidoc/body.adoc

@@ -50,19 +50,19 @@ Raw `request body` is available via javadoc:Context[body] method:
 
 This give us the `raw body`.
 
-==== Parser
+==== Message Decoder
 
-Request body parsing is achieved using the javadoc:Parser[] functional interface.
+Request body parsing is achieved using the javadoc:MessageDecoder[] functional interface.
 
 [source, java]
 ----
-public interface Parser {
+public interface MessageDecoder {
 
   <T> T parse(Context ctx, Type type) throws Exception;
 }
 ----
 
-javadoc:Parser[] has a single `parse` method that takes two input arguments: `(context, type)`
+javadoc:MessageDecoder[] has a single `parse` method that takes two input arguments: `(context, type)`
 and returns a single result of the given type.
 
 .JSON example:
@@ -71,7 +71,7 @@ and returns a single result of the given type.
 {
   FavoriteJson lib = new FavoriteJson();           // <1>
 
-  parser(MediaType.json, (ctx, type) -> {          // <2>
+  decoder(MediaType.json, (ctx, type) -> {          // <2>
 
     byte[] body = ctx.body().bytes();              // <3>
 
@@ -90,7 +90,7 @@ and returns a single result of the given type.
 {
   val lib = FavoriteJson()                 // <1>
 
-  parser(MediaType.json, { ctx, type ->    // <2>
+  decoder(MediaType.json, { ctx, type ->    // <2>
 
     val body = ctx.body().bytes()          // <3>
 
@@ -107,12 +107,12 @@ and returns a single result of the given type.
 <2> Check if the `Content-Type` header matches `application/json`
 <3> Ready 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 parser function
+<5> Route handler now call the `body(Type)` function to trigger the decoder function
 
 [TIP]
 ====
 
-Jooby comes with a `json` parser built on top of https://github.com/FasterXML/jackson-databind[Jackson]:
+Jooby comes with a `json` decoder built on top of https://github.com/FasterXML/jackson-databind[Jackson]:
 
 [dependency, artifactId="jooby-jackson"]
 .

docs/asciidoc/value-api.adoc

@@ -227,7 +227,7 @@ value may or may not exists.
 
 ===== Syntax
 
-Structured data parser supports `dot` and `bracket` notation:
+Structured data decoder supports `dot` and `bracket` notation:
 
 .Dot notation
 ----
@@ -246,13 +246,13 @@ Structured data parser supports `dot` and `bracket` notation:
 
 ===== POJO
 
-Structured data parser is able to reconstruct a POJO (Plain Old Java Object) from:
+Structured data decoder is able to reconstruct a POJO (Plain Old Java Object) from:
 
 - <<query, Query>> encoded as https://tools.ietf.org/html/rfc3986#section-2[RFC 3986]
 - <<formdata, Formdata>> encoded as `application/x-www-form-urlencoded`
 - <<multipart, Multipart>> encoded as `multipart/form-data`
 
-We are going to use a `Group` and `Member` objects to demonstrate how the parser works:
+We are going to use a `Group` and `Member` objects to demonstrate how the decoder works:
 
 .Example
 [source, java, role="primary"]
@@ -403,7 +403,7 @@ The target `POJO` must follow one of these rules:
 - Has multiple constructors, but only one is annotated with 
 https://static.javadoc.io/javax.inject/javax.inject/1/javax/inject/Inject.html[Inject]
 
-The parser matches HTTP parameters in the following order:
+The decoder matches HTTP parameters in the following order:
 
 - As constructor arguments
 - As setter method

jooby/src/main/java/io/jooby/Context.java

@@ -824,17 +824,17 @@ default long getRequestLength() {
   }
 
   /* **********************************************************************************************
-   * Body Parser
+   * Body MessageDecoder
    * **********************************************************************************************
    */
 
   /**
    * Get a parser for the given content type or get an {@link StatusCode#UNSUPPORTED_MEDIA_TYPE}.
    *
    * @param contentType Content type.
-   * @return Parser.
+   * @return MessageDecoder.
    */
-  default @Nonnull Parser parser(@Nonnull MediaType contentType) {
+  default @Nonnull MessageDecoder parser(@Nonnull MediaType contentType) {
     return getRoute().parser(contentType);
   }
 

jooby/src/main/java/io/jooby/Jooby.java

@@ -293,8 +293,9 @@ public <T> Jooby mvc(@Nonnull Class<T> router, @Nonnull Provider<T> provider) {
     return this;
   }
 
-  @Nonnull @Override public Jooby parser(@Nonnull MediaType contentType, @Nonnull Parser parser) {
-    router.parser(contentType, parser);
+  @Nonnull @Override public Jooby parser(@Nonnull MediaType contentType, @Nonnull
+      MessageDecoder decoder) {
+    router.parser(contentType, decoder);
     return this;
   }
 

jooby/src/main/java/io/jooby/Parser.java …c/main/java/io/jooby/MessageDecoder.javajooby/src/main/java/io/jooby/Parser.java renamed to jooby/src/main/java/io/jooby/MessageDecoder.java jooby/src/main/java/io/jooby/Parser.java renamed to jooby/src/main/java/io/jooby/MessageDecoder.java

@@ -14,20 +14,20 @@
  * @since 2.0.0
  * @author edgar
  */
-public interface Parser {
+public interface MessageDecoder {
 
   /**
    * Resolve parsing as {@link StatusCode#UNSUPPORTED_MEDIA_TYPE}.
    */
-  Parser UNSUPPORTED_MEDIA_TYPE = new Parser() {
+  MessageDecoder UNSUPPORTED_MEDIA_TYPE = new MessageDecoder() {
     @Override public <T> T parse(Context ctx, Type type) {
       throw new StatusCodeException(StatusCode.UNSUPPORTED_MEDIA_TYPE);
     }
   };
   /**
    * Parse body to one of the <code>raw</code> types: String, byte[], etc.
    */
-  Parser RAW = new Parser() {
+  MessageDecoder RAW = new MessageDecoder() {
     @Override public <T> T parse(Context ctx, Type type) {
       return ctx.body().to(type);
     }

jooby/src/main/java/io/jooby/Route.java

@@ -238,7 +238,7 @@ public interface Handler extends Serializable {
 
   private static final Map EMPTY_MAP = Collections.emptyMap();
 
-  private Map<String, Parser> parsers = EMPTY_MAP;
+  private Map<String, MessageDecoder> parsers = EMPTY_MAP;
 
   private final String pattern;
 
@@ -549,21 +549,21 @@ public Route(@Nonnull String method, @Nonnull String pattern, @Nonnull Handler h
   }
 
   /**
-   * Parser for given media type.
+   * MessageDecoder for given media type.
    *
    * @param contentType Media type.
-   * @return Parser.
+   * @return MessageDecoder.
    */
-  public @Nonnull Parser parser(@Nonnull MediaType contentType) {
-    return parsers.getOrDefault(contentType.getValue(), Parser.UNSUPPORTED_MEDIA_TYPE);
+  public @Nonnull MessageDecoder parser(@Nonnull MediaType contentType) {
+    return parsers.getOrDefault(contentType.getValue(), MessageDecoder.UNSUPPORTED_MEDIA_TYPE);
   }
 
   /**
    * Route message decoder.
    *
    * @return Message decoders.
    */
-  public @Nonnull Map<String, Parser> getParsers() {
+  public @Nonnull Map<String, MessageDecoder> getParsers() {
     return parsers;
   }
 
@@ -573,7 +573,7 @@ public Route(@Nonnull String method, @Nonnull String pattern, @Nonnull Handler h
    * @param decoders message decoder.
    * @return This route.
    */
-  public @Nonnull Route setParsers(@Nonnull Map<String, Parser> decoders) {
+  public @Nonnull Route setParsers(@Nonnull Map<String, MessageDecoder> decoders) {
     this.parsers = decoders;
     return this;
   }

jooby/src/main/java/io/jooby/Router.java

@@ -247,13 +247,13 @@ interface Match {
   @Nonnull Path getTmpdir();
 
   /**
-   * Register a parser for the given content type.
+   * Register a decoder for the given content type.
    *
    * @param contentType Content type to match.
-   * @param parser Parser.
+   * @param decoder MessageDecoder.
    * @return This router.
    */
-  @Nonnull Router parser(@Nonnull MediaType contentType, @Nonnull Parser parser);
+  @Nonnull Router parser(@Nonnull MediaType contentType, @Nonnull MessageDecoder decoder);
 
   /**
    * Returns the worker thread pool. This thread pool is used to run application blocking code.

jooby/src/main/java/io/jooby/internal/RouterImpl.java

@@ -13,7 +13,7 @@
 import io.jooby.ExecutionMode;
 import io.jooby.Jooby;
 import io.jooby.MediaType;
-import io.jooby.Parser;
+import io.jooby.MessageDecoder;
 import io.jooby.Renderer;
 import io.jooby.ResponseHandler;
 import io.jooby.Route;
@@ -130,7 +130,7 @@ public Stack executor(Executor executor) {
 
   private Map<Route, Executor> routeExecutor = new HashMap<>();
 
-  private Map<String, Parser> parsers = new HashMap<>();
+  private Map<String, MessageDecoder> parsers = new HashMap<>();
 
   private Map<String, Object> attributes = new ConcurrentHashMap<>();
 
@@ -155,7 +155,7 @@ public RouterImpl(ClassLoader loader) {
   }
 
   private void defaultParser() {
-    parsers.put(MediaType.text.getValue(), Parser.RAW);
+    parsers.put(MediaType.text.getValue(), MessageDecoder.RAW);
   }
 
   @Nonnull @Override public Map<String, Object> getAttributes() {
@@ -248,8 +248,9 @@ public Router renderer(@Nonnull MediaType contentType, @Nonnull Renderer rendere
     return renderer(renderer.accept(contentType));
   }
 
-  @Nonnull @Override public Router parser(@Nonnull MediaType contentType, @Nonnull Parser parser) {
-    parsers.put(contentType.getValue(), parser);
+  @Nonnull @Override public Router parser(@Nonnull MediaType contentType, @Nonnull
+      MessageDecoder decoder) {
+    parsers.put(contentType.getValue(), decoder);
     return this;
   }
 

modules/jooby-jackson/src/main/java/io/jooby/json/JacksonModule.java

@@ -17,7 +17,7 @@
 import io.jooby.Extension;
 import io.jooby.Jooby;
 import io.jooby.MediaType;
-import io.jooby.Parser;
+import io.jooby.MessageDecoder;
 import io.jooby.Renderer;
 import io.jooby.ServiceRegistry;
 
@@ -27,7 +27,7 @@
 import java.util.HashSet;
 import java.util.Set;
 
-public class JacksonModule implements Extension, Parser, Renderer {
+public class JacksonModule implements Extension, MessageDecoder, Renderer {
   private final ObjectMapper mapper;
 
   private final Set<Class<?extends Module>> modules = new HashSet<>();

modules/jooby-test/src/main/java/io/jooby/MockContext.java

@@ -51,7 +51,7 @@ public class MockContext implements Context {
 
   private Body body;
 
-  private Map<String, Parser> parsers = new HashMap<>();
+  private Map<String, MessageDecoder> parsers = new HashMap<>();
 
   private Map<String, Object> responseHeaders = new HashMap<>();
 
@@ -217,8 +217,8 @@ MockContext setPathString(@Nonnull String pathString) {
     return this;
   }
 
-  @Nonnull @Override public Parser parser(@Nonnull MediaType contentType) {
-    return parsers.getOrDefault(contentType, Parser.UNSUPPORTED_MEDIA_TYPE);
+  @Nonnull @Override public MessageDecoder parser(@Nonnull MediaType contentType) {
+    return parsers.getOrDefault(contentType, MessageDecoder.UNSUPPORTED_MEDIA_TYPE);
   }
 
   @Override public boolean isInIoThread() {