update javdoc

Author: jknack

coverage-report/src/test/java/org/jooby/ws/WebSocketPauseResumeFeature.java

@@ -27,14 +27,6 @@ public class WebSocketPauseResumeFeature extends ServerFeature {
   {
     ws("/ws", ws -> {
       CountDownLatch latch = new CountDownLatch(1);
-      ws.onMessage(message -> {
-
-        ws.send("=" + message.value(), () -> {
-          latch.await();
-          ws.close();
-        });
-
-      });
 
       ws.pause();
       // 2nd ignored
@@ -46,6 +38,16 @@ public class WebSocketPauseResumeFeature extends ServerFeature {
         ws.resume();
         latch.countDown();
       }, 1, TimeUnit.SECONDS);
+
+      ws.onMessage(message -> {
+
+        ws.send("=" + message.value(), () -> {
+          latch.await();
+          ws.close();
+        });
+
+      });
+
     });
 
   }

jooby/src/main/java/org/jooby/Mutant.java

@@ -31,22 +31,27 @@
 
 /**
  * <p>
- * A type safe {@link Mutant} useful for reading parameters and headers. It let you retrieve a
- * HTTP value: <code>param</code> or <code>header</code> in a type safe manner.
+ * A type safe {@link Mutant} useful for reading parameters and headers.
  * </p>
  *
  * <pre>
+ *   // str param
+ *   String value = request.param("str").value();
+ *
+ *   // optional str
+ *   String value = request.param("str").toOptional().orElse("defs");
+ *
  *   // int param
- *   int value = request.param("some").getInt();
+ *   int value = request.param("some").intValue();
  *
  *   // optional int param
- *   Optional{@literal <}Integer{@literal >} value = request.param("some").getOptional(Integer.class);
+ *   Optional{@literal <}Integer{@literal >} value = request.param("some").toOptional(Integer.class);
 
  *   // list param
- *   List{@literal <}String{@literal >} values = request.param("some").getList(String.class);
+ *   List{@literal <}String{@literal >} values = request.param("some").toList(String.class);
  *
  *   // file upload
- *   Upload upload = request.param("file").get(Upload.class);
+ *   Upload upload = request.param("file").to(Upload.class);
  * </pre>
  *
  * @author edgar
@@ -153,6 +158,13 @@ default <T extends Comparable<T>> SortedSet<T> toSortedSet(@Nonnull final Class<
         ));
   }
 
+  /**
+   * @return An optional string value.
+   */
+  default Optional<String> toOptional() {
+    return toOptional(String.class);
+  }
+
   /**
    * @param type The optional type.
    * @param <T> Optional type.

jooby/src/test/java/org/jooby/internal/MutantImplTest.java

@@ -461,7 +461,11 @@ public void asStringSortedSet() throws Exception {
   public void asOptionalString() throws Exception {
     assertEquals(Optional.empty(), newMutant((String) null).toOptional(String.class));
 
+    assertEquals(Optional.empty(), newMutant((String) null).toOptional());
+
     assertEquals(Optional.of("A"), newMutant("A").toOptional(String.class));
+
+    assertEquals(Optional.of("A"), newMutant("A").toOptional());
   }
 
   @Test