doc: more doc cleanup

Author: jknack

docs/asciidoc/context.adoc

@@ -20,28 +20,6 @@ In most of the cases you can access the context object as a parameter of your ro
 }
 ----
 
-If you need to access the context via the service registry or dependency injection, you need to
-explicitly request the registration of it as a service with the following invocation:
-
-.Java
-[source, java, role="primary"]
-----
-{
-  setContextAsService(true);
-}
-----
-
-.Kotlin
-[source, kotlin, role="secondary"]
-----
-{
-  setContextAsService(true)
-}
-----
-
-Important to note that the context is a *request scoped* object, it's only available through the service
-registry while the request it belongs to is being processed.
-
 javadoc:Context[Context] also provides derived information about the current request such as a
 matching locale (or locales) based on the `Accept-Language` header (if presents). You may use
 the result of javadoc:Context[locale] or javadoc:Context[locales] to present content matching to
@@ -133,7 +111,7 @@ response.
 ----
 
 <1> Header variable `token`
-<2> All headers as javadoc:Value[]
+<2> All headers as javadoc:value.Value[]
 <3> All headers as map
 
 ==== Cookie
@@ -256,7 +234,7 @@ Path parameter are part of the `URI`. To define a path variable you need to use
 - `/a b`    => `/a%20b`  (not decoded)
 - `/%2F%2B` => `/%2F%2B` (not decoded)
 
-<2> Path as javadoc:Value[] object:
+<2> Path as javadoc:value.Value[] object:
 
 - `/a+b`    => `{name=a+b}`
 - `/a b`    => `{name=a b}` (decoded)

docs/asciidoc/handlers/ssl.adoc

@@ -2,6 +2,8 @@
 
 The javadoc:handler.SSLHandler[] forces client to use HTTPS by redirecting non-HTTPS calls to the HTTPS version.
 
+Refer to <<server-https-support, configure ssl>> to see how to setup SSL in your project.
+
 .Force SSL
 [source, java, role = "primary"]
 ----
@@ -10,8 +12,6 @@ import io.jooby.handler.SSLHandler;
 ...
 {
   
-  setServerOptions(new ServerOptions().setSecurePort(8443));
-
   before(new SSLHandler()); <1>
   
   get("/", ctx -> {
@@ -27,10 +27,6 @@ import io.jooby.Jooby
 import io.jooby.handler.SSHandler
 ...
 {
-  serverOptions {
-    securePort = 8443
-  }
-
   before(SSLHandler())      <1>
   
   get("/") {
@@ -54,8 +50,6 @@ import io.jooby.handler.SSLHandler;
 ...
 {
   
-  setServerOptions(new ServerOptions().setSecurePort(8443));
-
   before(new SSLHandler("myhost.org")); <1>
   
   get("/", ctx -> {
@@ -71,9 +65,6 @@ import io.jooby.Jooby
 import io.jooby.handler.SSHandler
 ...
 {
-  serverOptions {
-    securePort = 8443
-  }
 
   before(SSLHandler("myhost.org"))      <1>
   
@@ -88,5 +79,5 @@ For more information about SSL, please check the <<server-https-support, configu
 [TIP]
 ====
 If you run behind a reverse proxy that has been configured to send the X-Forwarded-* header,
-please consider to add the <<router-options-trust-proxy, trust proxy>> to your pipeline.
+please consider adding the <<router-options-trust-proxy, trust proxy>> to your pipeline.
 ====

docs/asciidoc/migration/4.x.adoc

@@ -61,7 +61,7 @@ runApp(args, new NettyServer(new ServerOptions()), App::new);
 
 ==== Method
 |===
-|2.x|3.x|Description
+|3.x|4.x|Description
 |io.jooby.Jooby.setServerOptions()|Server.setOptions()| removed in favor of `Server.setOptions()`
 |io.jooby.Router.mvc|-| it was deprecated and now removed
 |io.jooby.Router.decorator|-| it was deprecated and now removed

docs/asciidoc/mvc-api.adoc

@@ -868,6 +868,27 @@ JAX-RS specification and there is no immediate plan to do it.
 The main reason to support JAX-RS annotations is to let you plug-in third-party tools that rely
 on them (mostly annotations processors).
 
+=== Generated router
+
+For each MVC/controller class a new class is generated. The new class ends with `_`, this class
+mimics the constructors from the source class. If the constructor is annotated with `@Inject` a
+default constructor will exists.
+
+Any annotation found on the controller method will be persisted as route attributes, unless
+`jooby.skipAttributeAnnotations` excludes it.
+
+Access to generated routes is allowed:
+
+[source, java]
+----
+{
+  var routes = mvc(new MyController_());
+  routes.forEach(route -> {
+    // do something with route
+  });
+}
+----
+
 === Annotation Processor Options
 
 [cols="1,1,1,1"]
@@ -884,21 +905,11 @@ on them (mostly annotations processors).
 |true
 |Hints maven/gradle to do incremental compilation. Useful for development.
 
-|jooby.services
-|boolean
-|true
-|Generates META-INF/services metadata
-
 |jooby.skipAttributeAnnotations
 |array
 |[]
 |Skip annotation during byte code generation (i.e. don't generate them as route attributes)
 
-|jooby.handler
-|string
-|[]
-|Add custom handler mapping.
-
 |jooby.mvcMethod
 |boolean
 |false

docs/asciidoc/routing.adoc

@@ -70,7 +70,7 @@ Attributes let you annotate a route at application bootstrap time. It functions
 ----
 {
   get("/foo", ctx -> "Foo")
-    .attribute("foo", "bar");
+    .setAttribute("foo", "bar");
 }
 ----
 
@@ -80,7 +80,7 @@ Attributes let you annotate a route at application bootstrap time. It functions
 {
   get("/foo") {
     "Foo"
-  }.attribute("foo", "bar")
+  }.setAttribute("foo", "bar")
 }
 ----
 
@@ -93,7 +93,7 @@ Attributes can be accessed at runtime in a request/response cycle. For example,
 {
   use(next -> ctx -> {
     User user = ...;
-    String role = ctx.getRoute().attribute("Role"); 
+    String role = ctx.getRoute().getAttribute("Role"); 
     
     if (user.hasRole(role)) {
         return next.apply(ctx);
@@ -110,7 +110,7 @@ Attributes can be accessed at runtime in a request/response cycle. For example,
 {
 use(
   val user = ...
-  val role = ctx.route.attribute("Role")
+  val role = ctx.route.getAttribute("Role")
 
   if (user.hasRole(role)) {
     return next.apply(ctx)
@@ -144,7 +144,7 @@ public class AdminResource {
 
 {
   use(next -> ctx -> {
-    System.out.println(ctx.getRoute().attribute("Role"));
+    System.out.println(ctx.getRoute().getAttribute("Role"));
   });
 }
 ----
@@ -168,7 +168,7 @@ class AdminResource {
 
 {
   use {
-    println(ctx.route.attribute("Role"))
+    println(ctx.route.getAttribute("Role"))
   }
 }
 ----

docs/asciidoc/value-api.adoc

@@ -1,13 +1,13 @@
 === Value API
 
-The javadoc:Value[Value] is an unified and type-safe API across all parameter types:
+The javadoc:value.Value[Value] is an unified and type-safe API across all parameter types:
 
 - Header
 - Path
 - Query
 - Formdata/Multipart
 
-For learning purpose we are going to show all the javadoc:Value[Value] features using query
+For learning purpose we are going to show all the javadoc:value.Value[Value] features using query
 parameters, but keep in mind these features apply to all the parameter types.
 
 ==== Single value
@@ -127,8 +127,8 @@ Default and optional value are available in two different ways:
 
 Multiple values are available via functions:
 
-- javadoc:Value[toList]: Returns a `java.util.List` of values
-- javadoc:Value[toSet]: Returns a `java.util.Set` of values
+- javadoc:value.Value[toList]: Returns a `java.util.List` of values
+- javadoc:value.Value[toSet]: Returns a `java.util.Set` of values
 
 .Java
 [source, java,role="primary"]
@@ -182,7 +182,7 @@ Multiple values are available via functions:
 
 ==== Structured data
 
-The javadoc:Value[Value API] provides a way to traverse and parse structured data:
+The javadoc:value.Value[Value API] provides a way to traverse and parse structured data:
 
 ----
 /?user.name=root&user.pass=pass
@@ -221,7 +221,7 @@ The javadoc:Value[Value API] provides a way to traverse and parse structured dat
 <3> Get the `pass` value from `user` node
 <4> Get the `mail` value from `user` node. This is an optional value.
 
-The javadoc:Value[get, java.lang.String] takes a `path` and returns another value. The returning
+The javadoc:value.Value[get, java.lang.String] takes a `path` and returns another value. The returning
 value may or may not exists.
 
 ===== Syntax

jooby/src/main/java/io/jooby/Environment.java

@@ -8,7 +8,6 @@
 import java.nio.file.Files;
 import java.nio.file.Path;
 import java.nio.file.Paths;
-import java.util.Arrays;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.List;
@@ -54,7 +53,7 @@ public class Environment {
    */
   public Environment(
       @NonNull ClassLoader classLoader, @NonNull Config config, @NonNull String... actives) {
-    this(classLoader, config, Arrays.asList(actives));
+    this(classLoader, config, List.of(actives));
   }
 
   /**