Add package-info.javas (#97)

* javadocs

* Update Jex.java

* Update JdkJexServer.java

* package info

avaje-jex/src/main/java/io/avaje/jex/Routing.java

@@ -8,10 +8,11 @@
 
 import io.avaje.jex.security.Role;
 
+/** Routing abstraction. */
 public sealed interface Routing permits DefaultRouting {
 
-  /** Add the routes provided by the Routing HttpService. */
-  Routing add(Routing.HttpService routes);
+  /** Add the routes provided by the given HttpService. */
+  Routing add(Routing.HttpService service);
 
   /** Add all the routes provided by the Routing Services. */
   Routing addAll(Collection<Routing.HttpService> routes);
@@ -47,12 +48,12 @@ public sealed interface Routing permits DefaultRouting {
   Routing withRoles(Role... permittedRoles);
 
   /**
-   * Registers an error handler that handles the given type of exceptions.
-   * This will replace an existing error handler for the same exception class.
+   * Registers an error handler that handles the given type of exceptions. This will replace an
+   * existing error handler for the same exception class.
    *
    * @param exceptionClass the type of exception to handle by this handler
-   * @param handler        the error handler
-   * @param <T>            exception type
+   * @param handler the error handler
+   * @param <T> exception type
    * @return updated routing
    */
   <T extends Exception> Routing error(Class<T> exceptionClass, ExceptionHandler<T> handler);
@@ -87,7 +88,7 @@ public sealed interface Routing permits DefaultRouting {
   /** Add a filter for all requests. */
   Routing filter(HttpFilter handler);
 
-  /** Add a preprocessing filter for all requests. */
+  /** Add a pre-processing filter for all requests. */
   default Routing before(Consumer<Context> handler) {
 
     return filter(
@@ -154,21 +155,13 @@ interface Entry {
 
   /** The type of route entry. */
   enum Type {
-    /** Http GET. */
     GET,
-    /** Http POST. */
     POST,
-    /** HTTP PUT. */
     PUT,
-    /** HTTP PATCH. */
     PATCH,
-    /** HTTP DELETE. */
     DELETE,
-    /** HTTP HEAD. */
     HEAD,
-    /** HTTP TRACE. */
     TRACE,
-    /** HTTP OPTIONS. */
     OPTIONS;
   }
 }

avaje-jex/src/main/java/io/avaje/jex/StaticContentConfig.java

@@ -31,7 +31,7 @@ static StaticContentConfig create() {
   /**
    * Sets the file to serve, or the folder your files are located in. (default: "/public/")
    *
-   * @param root the root directory
+   * @param resource the root directory
    * @return the updated configuration
    */
   StaticContentConfig resource(String resource);
@@ -91,7 +91,7 @@ static StaticContentConfig create() {
    */
   StaticContentConfig location(ResourceLocation location);
 
-  /** the resource location */
+  /** Resource location */
   public enum ResourceLocation {
     CLASS_PATH,
     FILE

avaje-jex/src/main/java/io/avaje/jex/core/json/package-info.java

@@ -0,0 +1,2 @@
+/** Optional JsonServices */
+package io.avaje.jex.core.json;

avaje-jex/src/main/java/io/avaje/jex/http/package-info.java

@@ -0,0 +1,2 @@
+/** Http Exceptions */
+package io.avaje.jex.http;

avaje-jex/src/main/java/io/avaje/jex/security/package-info.java

@@ -0,0 +1,2 @@
+/** Security Classes */
+package io.avaje.jex.security;

avaje-jex/src/main/java/io/avaje/jex/spi/package-info.java

@@ -1,2 +1,6 @@
-/** SPI extension interfaces */
+/**
+ * SPI extension interfaces
+ *
+ * @see {@link io.avaje.jex.spi.JexExtension}
+ */
 package io.avaje.jex.spi;

avaje-jex/src/main/java/module-info.java

@@ -1,5 +1,23 @@
 import io.avaje.jex.spi.JexExtension;
 
+/**
+ * Defines the Jex HTTP server API, for running a minimal HTTP server.
+ *
+ * <pre>{@code
+ * final Jex.Server app = Jex.create()
+ *   .routing(routing -> routing
+ *     .get("/", ctx -> ctx.text("hello world"))
+ *     .get("/one", ctx -> ctx.text("one"))
+ *   .port(8080)
+ *   .start();
+ *
+ * app.shutdown();
+ *
+ * }</pre>
+ *
+ * @uses JexExtension
+ *
+ */
 module io.avaje.jex {
 
   exports io.avaje.jex;