From c669d7b61db18fdbdaafa30e11c24b4c2a6056c9 Mon Sep 17 00:00:00 2001 From: Edgar Espina Date: Mon, 10 Jun 2024 14:48:50 -0300 Subject: [PATCH] '3.2.0' --- index.html | 2042 +++++++++++++------------- migration/3.x/index.html | 6 +- modules/avaje-inject/index.html | 32 +- modules/avaje-jsonb/index.html | 30 +- modules/aws/index.html | 24 +- modules/caffeine/index.html | 14 +- modules/camel/index.html | 36 +- modules/ebean/index.html | 86 +- modules/flyway/index.html | 34 +- modules/freemarker/index.html | 28 +- modules/graphql/index.html | 68 +- modules/gson/index.html | 30 +- modules/guice/index.html | 32 +- modules/handlebars/index.html | 24 +- modules/hibernate/index.html | 100 +- modules/hikari/index.html | 60 +- modules/jackson/index.html | 54 +- modules/jasypt/index.html | 38 +- modules/jdbi/index.html | 82 +- modules/jstachio/index.html | 48 +- modules/jte/index.html | 34 +- modules/jwt-session-store/index.html | 14 +- modules/kafka/index.html | 18 +- modules/metrics/index.html | 72 +- modules/node/index.html | 30 +- modules/openapi/index.html | 86 +- modules/pac4j/index.html | 94 +- modules/pebble/index.html | 24 +- modules/quartz/index.html | 82 +- modules/redis/index.html | 36 +- modules/rocker/index.html | 42 +- modules/thymeleaf/index.html | 26 +- modules/whoops/index.html | 14 +- modules/yasson/index.html | 30 +- packaging/index.html | 16 +- usage/index.html | 32 +- 36 files changed, 1721 insertions(+), 1797 deletions(-) diff --git a/index.html b/index.html index c7799db..08bb1d8 100644 --- a/index.html +++ b/index.html @@ -932,7 +932,7 @@

Welcome!!
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 
 public class App extends Jooby {
 
@@ -943,15 +943,15 @@ 

+}
@@ -1028,7 +1028,7 @@

Script with sub-class:

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 
 public class App extends Jooby {
 
@@ -1039,9 +1039,9 @@ 
Copy to clipboard

+}
@@ -1066,7 +1066,7 @@

Script without subclass:

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 
 public class App {
 
@@ -1077,9 +1077,9 @@ 
Copy to clipboard

+}
@@ -1105,7 +1105,7 @@

MVC API:

Java
Kotlin
-
import io.jooby.annotation.*;
+
import io.jooby.annotation.*;
 
 public class MyController {
 
@@ -1124,9 +1124,9 @@ 

+}
@@ -1231,7 +1231,7 @@

Setting workspace:
-
jooby set -w ~/Source
+
jooby set -w ~/Source

@@ -1249,7 +1249,7 @@

jooby
-
jooby> help create
+
jooby> help create
 Missing required parameter: <name>
 Usage: jooby create [-dgikms] [--server=<server>] <name>
 Creates a new application
@@ -1263,7 +1263,7 @@ 

+jooby>

@@ -1272,13 +1272,13 @@

Creates a Maven Java project:
-
jooby> create myapp
+
jooby> create myapp

Creates a Maven Kotlin project:
-
jooby> create myapp --kotlin
+
jooby> create myapp --kotlin
@@ -1296,13 +1296,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-kotlin</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -1312,13 +1312,13 @@

Creates a Gradle Java project:
-
jooby> create myapp --gradle
+
jooby> create myapp --gradle
Creates a Gradle Kotlin project:
-
jooby> create myapp --gradle --kotlin
+
jooby> create myapp --gradle --kotlin
@@ -1331,7 +1331,7 @@

Creates a Maven Java Mvc project:
-
jooby> create myapp --mvc
+
jooby> create myapp --mvc

@@ -1340,7 +1340,7 @@

Creates a Maven Java Project using Undertow:
-
jooby> create myapp --server undertow
+
jooby> create myapp --server undertow

@@ -1350,7 +1350,7 @@

Creates a Maven Java Project with stork launchers:
-
jooby> create myapp --stork
+
jooby> create myapp --stork

@@ -1359,7 +1359,7 @@

Creates a docker file:
-
jooby> create myapp --docker
+
jooby> create myapp --docker

@@ -1368,7 +1368,7 @@

Interactive mode:
-
jooby> create myapp -i
+
jooby> create myapp -i

@@ -1381,13 +1381,13 @@

Snippet

Java
Kotlin
-
{
+
{
   get("/", ctx -> "Snippet");
-}

+}
@@ -1424,7 +1424,7 @@

Routes:

Java
Kotlin
-
{
+
{
 
   (1) (2)
   get("/foo", ctx -> {
@@ -1440,9 +1440,9 @@ 

+}
@@ -1490,16 +1490,16 @@

Java
Kotlin

-
{
+
{
   get("/foo", ctx -> "Foo")
     .attribute("foo", "bar");
-}

+}
@@ -1510,7 +1510,7 @@

Java
Kotlin

-
{
+
{
   use(next -> ctx -> {
     User user = ...;
     String role = ctx.getRoute().attribute("Role");
@@ -1521,9 +1521,9 @@ 
Copy to clipboard

+}
@@ -1543,7 +1543,7 @@

Java
Kotlin

-
@Target({ElementType.METHOD, ElementType.TYPE, ElementType.ANNOTATION_TYPE })
+
@Target({ElementType.METHOD, ElementType.TYPE, ElementType.ANNOTATION_TYPE })
 @Retention(RetentionPolicy.RUNTIME)
 public @interface Role {
   String value();
@@ -1563,9 +1563,9 @@ 

+}
@@ -1605,13 +1605,13 @@

Java
Koltin

-
{
+
{
   get("/foo", ctx -> "Foo");
-}

+}
@@ -1621,21 +1621,21 @@

Single path variable:
Java
Kotlin
-
{
+
{
   (1)
   get("/user/{id}", ctx -> {
     int id = ctx.path("id").intValue(); (2)
     return id;
   });
-}

+}
@@ -1654,23 +1654,23 @@

Multiple path variables:

Java
Kotlin
-
{
+
{
   (1)
   get("/file/{file}.{ext}", ctx -> {
     String filename = ctx.path("file").value(); (2)
     String ext = ctx.path("ext").value();   (3)
     return filename + "." + ext;
   });
-}

+}
@@ -1693,21 +1693,21 @@

Optional path variable:

Java
Kotlin
-
{
+
{
   (1)
   get("/profile/{id}?", ctx -> {
     String id = ctx.path("id").value("self"); (2)
     return id;
   });
-}

+}
@@ -1742,21 +1742,21 @@

Regex path variable:

Java
Kotlin
-
{
+
{
   (1)
   get("/user/{id:[0-9]+}", ctx -> {
     int id = ctx.path("id").intValue(); (2)
     return id;
   });
-}

+}
@@ -1791,7 +1791,7 @@

catchall

Java
Kotlin
-
{
+
{
   (1)
   get("/articles/*", ctx -> {
     String catchall = ctx.path("*").value(); (2)
@@ -1802,9 +1802,9 @@ 
(3)
     return path;
   });
-}

+}
@@ -1881,7 +1881,7 @@

Java
Kotlin

-
{
+
{
   get("/user/{id}", ctx -> ctx.path("id").value());  (1)
 
   get("/user/me", ctx -> "my profile");              (2)
@@ -1889,9 +1889,9 @@ 
(3)
 
   get("/users", ctx -> "new users");                 (4)
-}

+}
@@ -1940,16 +1940,16 @@

<

-
interface Filter {
+
interface Filter {
   Handler apply(Handler next);
-}

+}
Timing filter example:
Java
Kotlin
-
{
+
{
   use(next -> ctx -> {
     long start = System.currentTimeMillis();       (1)
 
@@ -1966,9 +1966,9 @@ 
<
   get("/", ctx -> {
     return "filter";
   });
-}

+}
@@ -2035,16 +2035,16 @@

<

-
interface Before {
+
interface Before {
   void apply(Context ctx);
-}

+}
Example
Java
Kotlin
-
{
+
{
   before(ctx -> {
     ctx.setResponseHeader("Server", "Jooby");
   });
@@ -2052,9 +2052,9 @@ 
<
   get("/", ctx -> {
     return "...";
   });
-}

+}
@@ -2082,16 +2082,16 @@

-
interface After {
+
interface After {
   void apply(Context ctx, Object result, Throwable failure);
-}

+}
Functional Handler:
Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     System.out.println(result);          (1)
     ctx.setResponseHeader("foo", "bar"); (2)
@@ -2100,9 +2100,9 @@ 

+}
@@ -2136,7 +2136,7 @@

Side-Effect Handler:

Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     System.out.println(result);          (1)
     ctx.setResponseHeader("foo", "bar"); (2)
@@ -2145,9 +2145,9 @@ 

+}
@@ -2184,7 +2184,7 @@

Safe After:

Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     if (ctx.isResponseStarted()) {
       // Don't modify response
@@ -2192,9 +2192,9 @@ 

+}
@@ -2228,7 +2228,7 @@

Run code depending of success or failure responses:

Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     if (failure == null) {
       db.commit();                   (1)
@@ -2236,9 +2236,9 @@ 
(2)
     }
   });
-}

+}
@@ -2256,21 +2256,21 @@

Recover fom exception and produces an alternative output:

Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     if (failure instanceOf MyBusinessException) {
       ctx.send("Recovering from something");        (1)
     }
   });
-}

+}
@@ -2291,7 +2291,7 @@

Suppressed exceptions:

Java
Kotlin
-
{
+
{
   after((ctx, result, failure) -> {
     ...
     throw new AnotherException();
@@ -2306,9 +2306,9 @@ 
(1)
     Throwable anotherException  = failure.getSuppressed()[0];    (2)
   });
-}

+}
@@ -2353,7 +2353,7 @@

Example

Java
Kotlin
-
{
+
{
    use(next -> ctx -> {
      long start = System.currentTimeInMillis();
      ctx.onComplete(context -> {                      (1)
@@ -2361,9 +2361,9 @@ 

+}
@@ -2400,7 +2400,7 @@

Java
Kotlin

-
{
+
{
   // Increment +1
   use(next -> ctx -> {
     Number n = (Number) next.apply(ctx);
@@ -2416,9 +2416,9 @@ 
(1)
 
   get("/2", ctx -> 2); (2)
-}

+}
@@ -2457,7 +2457,7 @@

-
{
+
{
   // Increment +1
   var increment = use(next -> ctx -> {
     Number n = (Number) next.apply(ctx);
@@ -2474,7 +2474,7 @@ 

+}
@@ -2499,13 +2499,13 @@

Jooby 1.x
-
{
+
{
    use("/*", (req, rsp, chain) -> {
      // remote call, db call
    });
 
    // ...
-}

+}

@@ -2530,7 +2530,7 @@

<
Order example:
Java
Kotlin
-
{
+
{
   // Increment +1
   use(next -> ctx -> {
     Number n = (Number) next.apply(ctx);
@@ -2546,9 +2546,9 @@ 
<
   });
 
   get("/2", ctx -> 2);               (2)
-}

+}

@@ -2596,7 +2596,7 @@

Scoped filter:

Java
Kotlin
-
{
+
{
   // Increment +1
   use(next -> ctx -> {
     Number n = (Number) next.apply(ctx);
@@ -2614,9 +2614,9 @@ 
(3)
-}

+}

@@ -2671,15 +2671,15 @@

Route operator

Java
Kotlin
-
{
+
{
   routes(() -> {
 
     get("/", ctx -> "Hello");
 
   });
-}

+}
@@ -2701,7 +2701,7 @@

Routes with path prefix:

Java
Kotlin
-
{
+
{
    path("/api/user", () -> {    (1)
 
      get("/{id}", ctx -> ...);  (2)
@@ -2712,9 +2712,9 @@ 

+}
@@ -2764,7 +2764,7 @@

Composing

Java
Kotlin
-
public class Foo extends Jooby {
+
public class Foo extends Jooby {
   {
     get("/foo", Context::getRequestPath);
   }
@@ -2784,9 +2784,9 @@ 
(3)
   }
-}

+}
@@ -2827,7 +2827,7 @@

Composing with path prefix

Java
Kotlin
-
public class Foo extends Jooby {
+
public class Foo extends Jooby {
   {
     get("/foo", Context::getRequestPath);
   }
@@ -2837,9 +2837,9 @@ 
(1)
   }
-}

+}
@@ -2875,7 +2875,7 @@

Installing

Java
Kotlin
-
public class Foo extends Jooby {
+
public class Foo extends Jooby {
   {
     get("/foo", ctx -> ...);
   }
@@ -2893,9 +2893,9 @@ 
(2)
   }
-}

+}
@@ -2937,10 +2937,10 @@

Java
-
{
+
{
   Foo foo = new Foo();
   install(() -> foo);        // Won't work
-}

+}

@@ -2949,9 +2949,9 @@

Java
-
{
+
{
   install(() -> new Foo());  // Works!
-}

+}

@@ -2969,7 +2969,7 @@

Dynamic Routing
Java
Kotlin
-
public class V1 extends Jooby {
+
public class V1 extends Jooby {
   {
     get("/api", ctx -> "v1");
   }
@@ -2987,9 +2987,9 @@ 
(2)
   }
-}

+}
@@ -3040,16 +3040,16 @@

Client
-
<form method="post" action="/form">
+
<form method="post" action="/form">
   <input type="hidden" name="_method" value="put">
-</form>

+</form>

Server
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 ...
 {
 
@@ -3058,9 +3058,9 @@ 
(2)
 
   });
-}

+}
@@ -3091,18 +3091,18 @@

HTTP Header

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 ...
 {
 
   setHiddenMethod(ctx -> ctx.header("X-HTTP-Method-Override").toOptional());  (1)
-}

+}
@@ -3123,7 +3123,7 @@

Usage

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 ...
 {
 
@@ -3136,9 +3136,9 @@ 
(5)
     ...
   });
-}

+}
@@ -3210,13 +3210,13 @@

Java
Kotlin

-
{
+
{
   get("/", ctx -> { /* do important stuff with variable 'ctx'. */ });
-}

+}
@@ -3227,13 +3227,13 @@

Java
Kotlin

-
{
+
{
   setContextAsService(true);
-}

+}
@@ -3260,7 +3260,7 @@

application.conf
-
application.lang = en, en-GB, de
+
application.lang = en, en-GB, de

@@ -3271,13 +3271,13 @@

Java
Kotlin

-
{
+
{
   setLocales(Locale.GERMAN, new Locale("hu", "HU"));
-}

+}
@@ -3308,7 +3308,7 @@

Java
Kotlin

-
{
+
{
   get("/", ctx -> {
     String token = ctx.header("token").value();      (1)
 
@@ -3318,9 +3318,9 @@ 
Copy to clipboard

+}
@@ -3360,7 +3360,7 @@
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     String token = ctx.cookie("token").value();      (1)
 
@@ -3368,9 +3368,9 @@ 

+}
@@ -3403,7 +3403,7 @@

Syntax:

Java
Kotlin
-
{
+
{
   get("/{id}" ctx -> ctx.path("id").value());                                 (1)
 
   get("/@{id}" ctx -> ctx.path("id").value());                                (2)
@@ -3413,9 +3413,9 @@ 
(4)
 
   get("/{id:[0-9]+}", ctx -> ctx.path("id))                                   (5)
-}

+}
@@ -3456,7 +3456,7 @@

Java
Kotlin

-
{
+
{
   get("/{name}", ctx -> {
     String pathString = ctx.getRequestPath();     (1)
 
@@ -3468,9 +3468,9 @@ 
Copy to clipboard

+}
@@ -3567,7 +3567,7 @@

Java
Kotlin

-
{
+
{
   get("/search", ctx -> {
     String queryString = ctx.queryString();                    (1)
 
@@ -3590,9 +3590,9 @@ 
Copy to clipboard

+}
@@ -3713,7 +3713,7 @@

Java
Kotlin

-
{
+
{
   post("/user", ctx -> {
     Formdata form = ctx.form();                             (1)
 
@@ -3739,9 +3739,9 @@ 
Copy to clipboard

+}
@@ -3799,7 +3799,7 @@

Java
Kotlin

-
{
+
{
   post("/user", ctx -> {
     Multipart multipart = ctx.multipart();                            (1)
 
@@ -3830,9 +3830,9 @@ 
Copy to clipboard

+}
@@ -3901,17 +3901,17 @@

Java
Kotlin

-
  FileUpload pic = ctx.file("pic");         (1)
+
  FileUpload pic = ctx.file("pic");         (1)
 
   List<FileUpload> pic = ctx.files("pic");  (2)
 
-  List<FileUpload> files = ctx.files();     (3)

+  List<FileUpload> files = ctx.files();     (3)
@@ -3945,13 +3945,13 @@

Java
Kotlin

-
  Session session = ctx.session();                      (1)
+
  Session session = ctx.session();                      (1)
 
-  String attribute = ctx.session("attribute").value();  (2)

+  String attribute = ctx.session("attribute").value();  (2)
@@ -3977,23 +3977,23 @@

Java
Kotlin

-
  get("/", ctx -> {
+
  get("/", ctx -> {
     return ctx.flash("success").value("Welcome!"); (3)
   });
 
   post("/save", ctx -> {
     ctx.flash("success", "Item created");          (1)
     return ctx.sendRedirect("/");                  (2)
-  });

+  });
@@ -4020,19 +4020,19 @@

Java
Kotlin

-
{
+
{
   setFlashCookie(new Cookie("myflash").setHttpOnly(true));
 
   // or if you're fine with the default name
   getFlashCookie().setHttpOnly(true);
-}

+}
@@ -4046,7 +4046,7 @@

Java
Kotlin
-
get("/{foo}", ctx -> {
+
get("/{foo}", ctx -> {
   String foo = ctx.lookup("foo", ParamSource.QUERY, ParamSource.PATH).value();
   return "foo is: " + foo;
 });
@@ -4054,9 +4054,9 @@ 

+});
@@ -4083,15 +4083,15 @@

Java
Kotlin

-
get("/{foo}", ctx -> {
+
get("/{foo}", ctx -> {
   List<Certificate> certificates = ctx.getClientCertificates(); (1)
   Certificate peerCertificate = certificates.get(0);            (2)
-});

+});
@@ -4142,7 +4142,7 @@

Java
Kotlin

-
{
+
{
   get("/", ctx -> {
     String name = ctx.query("name").value();                          (1)
 
@@ -4153,9 +4153,9 @@ 
(4)
     ...
   });
-}

+}
@@ -4262,7 +4262,7 @@

Java
Kotlin

-
{
+
{
   get("/search", ctx -> {
     String q = ctx.query("q").value("*:*");             (1)
     return q;
@@ -4272,9 +4272,9 @@ 
(2)
     return q;
   });
-}

+}
@@ -4339,7 +4339,7 @@

Java
Kotlin

-
{
+
{
   get("/", ctx -> {
     List<String> q = ctx.query("q").toList();                            (1)
 
@@ -4349,9 +4349,9 @@ 
Copy to clipboard

+}
@@ -4434,7 +4434,7 @@

Traversal

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     Value user = ctx.query("user");                  (1)
     String name  = user.get("name").value();         (2)
@@ -4442,9 +4442,9 @@ 
(4)
     ...
   }}
-}

+}
@@ -4528,7 +4528,7 @@
PO
Example
Java
Kotlin
-
class Member {
+
class Member {
   public final String firstname;
   public final String lastName;
 
@@ -4546,11 +4546,11 @@ 
PO
     this.id = id;
     this.members = members;
   }
-}

+}
@@ -4563,19 +4563,19 @@
PO
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     Member member = ctx.query(Member.class);
     ...
   });
-}

+}
@@ -4588,19 +4588,19 @@
PO
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     Member member = ctx.query("member").to(Member.class);
     ...
   });
-}

+}
@@ -4616,19 +4616,19 @@
PO
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     List<Member> members = ctx.query().toList(Member.class);
     ...
   });
-}

+}
@@ -4641,19 +4641,19 @@
PO
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     Group group = ctx.query(Group.class);
     ...
   });
-}

+}
@@ -4692,7 +4692,7 @@
PO
Java
Kotlin
-
class Member {
+
class Member {
   public final String firstname;
 
   public final String lastname;
@@ -4700,9 +4700,9 @@ 
PO
   public Member(@Named("first-name") String firstname, @Named("last-name") String lastname) {
     ....
   }
-}

+}
@@ -4720,7 +4720,7 @@

Java
Kotlin

-
{
+
{
   post("/string", ctx -> {
     String body = ctx.body().value();        (1)
     ...
@@ -4735,9 +4735,9 @@ 
(3)
     ...
   });
-}

+}
@@ -4781,10 +4781,10 @@

-
public interface MessageDecoder {
+
public interface MessageDecoder {
 
   <T> T decode(Context ctx, Type type) throws Exception;
-}

+}

@@ -4795,7 +4795,7 @@

JSON example:

Java
Kotlin
-
{
+
{
   FavoriteJson lib = new FavoriteJson();           (1)
 
   decoder(MediaType.json, (ctx, type) -> {          (2)
@@ -4808,9 +4808,9 @@ 
(5)
   });
-}

+}
@@ -4864,13 +4864,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jackson</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -4888,7 +4888,7 @@

<
Response body
Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     ctx.setResponseCode(200);                  (1)
 
@@ -4898,9 +4898,9 @@ 
<
 
     return "Response";                          (4)
   });
-}

+}
@@ -4940,10 +4940,10 @@

-
public interface MessageEncoder {
+
public interface MessageEncoder {
 
   byte[] encode(@NonNull Context ctx, @NonNull Object value) throws Exception;
-}

+}

@@ -4954,7 +4954,7 @@

JSON example:

Java
Kotlin
-
{
+
{
   FavoriteJson lib = new FavoriteJson();           (1)
 
   encoder(MediaType.json, (ctx, result) -> {      (2)
@@ -4970,9 +4970,9 @@ 
(6)
   });
-}

+}
@@ -5033,13 +5033,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jackson</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -5054,8 +5054,7 @@

5. MVC API

-

MVC API is an alternative way to define routes in Jooby. It uses annotations and byte code generation -to define and execute routes.

+

MVC API is an alternative way to define routes in Jooby. It generates source code to define and execute routes.

If you use Gradle 6.0 or a later version, you can leverage incremental annotation processing support, @@ -5069,20 +5068,20 @@

build.gradle

Java
Kotlin
-
tasks.withType(JavaCompile) {
+
tasks.withType(JavaCompile) {
     options.compilerArgs += [
         '-parameters',
         '-Ajooby.incremental=true',
         '-Ajooby.services=true'
     ]
-}

+}
@@ -5110,7 +5109,7 @@

MVC API:

Java
Kotlin
-
import io.jooby.annotation.*;
+
import io.jooby.annotation.*;
 
 @Path("/mvc")                  (1)
 public class Controller {
@@ -5124,15 +5123,15 @@ 
(3)
+    mvc(new Controller_());   (3)
   }
 
   public static void main(String[] args) {
     runApp(args, App::new);
   }
-}

+}
@@ -5162,7 +5161,7 @@

3 -Register/install the controller in the main application +Register/install the generated controller in the main application

@@ -5191,103 +5190,28 @@

Simple MVC route registration
Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
-    mvc(new MyController());
-  }
-
-  public static void main(String[] args) {
-    runApp(args, App::new);
-  }
-}

-
- -
-

The mvc(Object) install the mvc route. As showed in the example there is -no dependency injection involved, you just instantiate a MVC route and register.

-
-
-
Class MVC route registration
- -
Java
Kotlin
-
public class App extends Jooby {
-  {
-    mvc(MyController.class);
-  }
-
-  public static void main(String[] args) {
-    runApp(args, App::new);
-  }
-}
-
- -
-

The mvc(Class) does the same job, but delegates route instantiation to a -dependency injection framework of your choice.

-
-
- - - - - -
- - -Jooby 1.x was built around Guice, this is not the case for 2.x. The entire project was built -without dependency injection. This make DI optional and at same time give you freedom to choose the -one you like most. -
-
-
-
Provider MVC route registration
- -
Java
Kotlin
-
import jakarta.inject.Provider;
-
-public class App extends Jooby {
-  {
-    Provider<MyController> provider = ...;
-
-    mvc(MyController.class, provider);
+    mvc(new MyController_());
   }
 
   public static void main(String[] args) {
     runApp(args, App::new);
   }
-}
+}
-

The mvc(Provider) does the same job, might or might not delegate -instantiation to a dependency injection framework but most important let you control lifecycle of -MVC routes (Singleton vs Non-Singleton routes).

+

The mvc(MvcExtension) install the mvc route. The generated controller instantiate the controller +or requires it when an jakarta.inject.Inject annotated controller is present.

@@ -5296,33 +5220,33 @@

HTTP parameter provision is available via *Param annotations.

-

There is also a Param annotation which allows to retrieve parameters from +

There is also a Param annotation which allows to retrieve parameters from multiple sources.

5.3.1. Header

-

Provisioning of headers is available via HeaderParam annotation:

+

Provisioning of headers is available via HeaderParam annotation:

Headers
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@HeaderParam String token) {  (1)
     ...
   }
-}

+}
@@ -5341,48 +5265,48 @@

Non valid Java name

Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@HeaderParam("Last-Modified-Since") long lastModifiedSince) {
     ...
   }
-}

+}
-

Provisioning of cookies is available via CookieParam annotation:

+

Provisioning of cookies is available via CookieParam annotation:

Cookies
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@CookieParam String token) {  (1)
     ...
   }
-}

+}
@@ -5401,104 +5325,104 @@
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@CookieParam("token-id") String tokenId) {
     ...
   }
-}

+}

5.3.3. Path

-

For path parameters the PathParam annotation is required:

+

For path parameters the PathParam annotation is required:

PathParam
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @Path("/{id}")
   public Object provisioning(@PathParam String id) {
     ...
   }
-}

+}

5.3.4. Query

-

For query parameters the QueryParam annotation is required:

+

For query parameters the QueryParam annotation is required:

QueryParam
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @Path("/")
   public Object provisioning(@QueryParam String q) {
     ...
   }
-}

+}

5.3.5. Formdata/Multipart

-

For formdata/multipart parameters the FormParam annotation is required:

+

For formdata/multipart parameters the FormParam annotation is required:

QueryParam
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @Path("/")
   @POST
   public Object provisioning(@FormParam String username) {
     ...
   }
-}

+}
@@ -5511,50 +5435,50 @@

HTTP Body
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @Path("/")
   @POST
   public Object provisioning(MyObject body) {
     ...
   }
-}

+}

5.3.7. Flash

-

Provisioning of flash attribute is available via FlashParam annotation:

+

Provisioning of flash attribute is available via FlashParam annotation:

Flash
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@FlashParam String success) {  (1)
     ...
   }
-}

+}
@@ -5569,27 +5493,27 @@

5.3.8. Session

-

Provisioning of session attribute is available via SessionParam annotation:

+

Provisioning of session attribute is available via SessionParam annotation:

Session Attribute
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@SessionParam String userId) {  (1)
     ...
   }
-}

+}
@@ -5607,21 +5531,21 @@

Session Attribute

Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(Session session) {  (1)
     ...
   }
-}

+}

@@ -5639,27 +5563,27 @@

5.3.9. Context

-

Provisioning of context attributes is available via ContextParam annotation:

+

Provisioning of context attributes is available via ContextParam annotation:

Context Attribute
Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@ContextParam String userId) {  (1)
     ...
   }
-}

+}
@@ -5677,21 +5601,21 @@

Context Attributes

Java
Kotlin
-
public class MyController {
+
public class MyController {
 
   @GET
   public Object provisioning(@ContextParam Map<String, Object> attributes) {  (1)
     ...
   }
-}

+}

@@ -5706,26 +5630,26 @@

5.3.10. Multiple Sources

-

You can use the Param annotation to search for a parameter in multiple sources. +

You can use the Param annotation to search for a parameter in multiple sources. The sources and their precedence can be specified as follows:

Multiple Sources
Java
Kotlin
-
public class FooController {
+
public class FooController {
 
   @GET("/{foo}")
   public String multipleSources(@Param({ QUERY, PATH }) String foo) {
     return "foo is: " + foo;
   }
-}

+}
@@ -5767,7 +5691,7 @@

Kotlin Coroutines
-
class SuspendMvc {
+
class SuspendMvc {
   @GET
   @Path("/delay")
   suspend fun delayed(ctx: Context): String {
@@ -5780,7 +5704,7 @@ 
Copy to clipboard

+}

@@ -5799,7 +5723,7 @@

EventLoop MVC route

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     mvc(new MyController());
   }
@@ -5807,15 +5731,15 @@ 
(1)
   }
-}

+}

@@ -5833,7 +5757,7 @@

Worker mode MVC route

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     dispatch(() -> {
       mvc(new MyBlockingController());  (1)
@@ -5843,9 +5767,9 @@ 
Copy to clipboard

+}
@@ -5866,13 +5790,13 @@

One drawback with this approach is that the entire controller is now going to be executed in the worker or custom executor. -For more fine grain control use the Dispatch annotation:

+For more fine grain control use the Dispatch annotation:

Dispatch annotation
Java
Kotlin
-
public class MyController {
+
public class MyController {
   @GET("/nonblocking")
   public String nonblocking() {  (1)
     return "I'm nonblocking";
@@ -5883,9 +5807,9 @@ 
(2)
     return "I'm blocking";
   }
-}

+}
@@ -5915,21 +5839,21 @@

-

The Dispatch annotation supports custom executor using an executor name.

+

The Dispatch annotation supports custom executor using an executor name.

Dispatch to custom executor
Java
Kotlin
-
public class MyController {
+
public class MyController {
   @GET("/blocking")
   @Dispatch("single")         (1)
   public String blocking() {
     return "I'm blocking";
   }
-}

+}
@@ -5956,17 +5880,17 @@

Custom executor registration

Java
Kotlin
-
{
+
{
   executor("single", Executors.newSingleThreadExecutor());
 
   mvc(new MyController());
-}

+}
@@ -5982,7 +5906,7 @@

Resource

Java
Kotlin
-
import javax.ws.rs.GET;
+
import javax.ws.rs.GET;
 import javax.ws.rs.Path;
 
 @Path("/jaxrs")
@@ -5992,9 +5916,9 @@ 

+}
@@ -6059,10 +5983,10 @@

Skip annotation during byte code generation (i.e. don’t generate them as route attributes)

-

jooby.extendedLookupOfSuperTypes

-

boolean

-

false

-

Extended lookup of super/base types. Useful when base route/controller isn’t part of current project (no sources code)

+

jooby.handler

+

string

+

[]

+

Add custom handler mapping.

@@ -6072,7 +5996,7 @@

Maven
Gradle

-
  <plugin>
+
  <plugin>
     <artifactId>maven-compiler-plugin</artifactId>
     <configuration>
       <annotationProcessorPaths>
@@ -6096,22 +6020,22 @@ 

+  </plugin>
@@ -6129,13 +6053,13 @@

Classpath resources:
Java
Kotlin
-
{
+
{
   assets("/static/*"); (1)
-}

+}
@@ -6163,13 +6087,13 @@

File system resources:

Java
Kotlin
-
{
+
{
   assets("/static/*", Paths.get("www")); (1)
-}

+}
@@ -6200,14 +6124,14 @@

Classpath:
File system

-
{
+
{
   assets("/myfile.js", "/static/myfile.js");
-}

+}
@@ -6219,15 +6143,15 @@

Classpath resources:

Java
Kotlin
-
{
+
{
   Path docs = Paths.get("docs"); (1)
   assets("/docs/?*", docs);      (2)
-}

+}
@@ -6271,15 +6195,15 @@

Classpath resources:

Java
Kotlin
-
{
+
{
   AssetSource docs = AssetSource.create(Paths.get("docs")); (1)
   assets("/docs/?*", new AssetHandler("index.html", docs)); (2)
-}

+}
@@ -6308,21 +6232,21 @@

Asset handler options:

Java
Kotlin
-
{
+
{
   AssetSource www = AssetSource.create(Paths.get("www"));
   assets("/static/*", new AssetHandler(www)
     .setLastModified(false)
     .setEtag(false)
   );
-}

+}
@@ -6332,19 +6256,19 @@

Cache control:

Java
Kotlin
-
{
+
{
   AssetSource www = AssetSource.create(Paths.get("www"));
   assets("/static/*", new AssetHandler(www)
     .setMaxAge(Duration.ofDays(365))
   );
-}

+}
@@ -6359,7 +6283,7 @@

Per-asset cache control:

Java
Kotlin
-
{
+
{
   AssetSource www = AssetSource.create(Paths.get("www"));
   assets("/static/*", new AssetHandler(www)
       .cacheControl(path -> {
@@ -6373,9 +6297,9 @@ 

+}
@@ -6403,23 +6327,23 @@

Java
Kotlin
-
{
+
{
   install(new MyTemplateEngineModule());            (1)
 
   get("/", ctx -> {
     MyModel model = ...;                (2)
     return new ModelAndView("index.html", model);  (3)
   });
-}

+}
@@ -6445,7 +6369,7 @@

Java
Kotlin

-
{
+
{
   install(new MyTemplateEngineModule());
 
   get("/", ctx -> {
@@ -6453,9 +6377,9 @@ 
(1)
   });
-}

+}
@@ -6514,7 +6438,7 @@

Java
Kotlin

-
{
+
{
   install(new HandlebarsModule());                 (1)
   install(new FreemarkerModule());                 (2)
 
@@ -6525,9 +6449,9 @@ 
(4)
   });
-}

+}
@@ -6643,7 +6567,7 @@

In-Memory Session

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     Session session = ctx.session();   (1)
 
@@ -6651,9 +6575,9 @@ 
(3)
   });
-}

+}
@@ -6687,7 +6611,7 @@

In-Memory Session with Custom Cookie

Java
Kotlin
-
{
+
{
   setSessionStore(SessionStore.memory(new Cookie("SESSION")));    (1)
 
   get("/", ctx -> {
@@ -6697,9 +6621,9 @@ 

+}
@@ -6727,7 +6651,7 @@

In-Memory Session with HTTP Header

Java
Kotlin
-
{
+
{
   setSessionStore(SessionStore.memory(SessionToken.header("TOKEN")));    (1)
 
   get("/", ctx -> {
@@ -6737,9 +6661,9 @@ 

+}
@@ -6767,7 +6691,7 @@

Java
Kotlin

-
{
+
{
   setSessionStore(SessionStore.memory(SessionToken.comibe(SessionToken.cookie("SESSION"), SessionToken.header("TOKEN"))));    (1)
 
   get("/", ctx -> {
@@ -6777,9 +6701,9 @@ 

+}
@@ -6823,7 +6747,7 @@

Usage

Java
Kotlin
-
{
+
{
   String secret = "super secret key";              (1)
 
   setSessionStore(SessionStore.signed(secret));    (2)
@@ -6835,9 +6759,9 @@ 

+}
@@ -6871,7 +6795,7 @@

Signed with headers

Java
Kotlin
-
{
+
{
   String secret = "super secret key";                                            (1)
 
   setSessionStore(SessionStore.signed(secret, SessionToken.header("TOKEN")));    (2)
@@ -6883,9 +6807,9 @@ 

+}
@@ -6932,7 +6856,7 @@

WebSocket
Java
Kotlin
-
{
+
{
   ws("/ws", (ctx, configurer) -> {             (1)
     configurer.onConnect(ws -> {
       ws.send("Connected");                    (2)
@@ -6950,9 +6874,9 @@ 

+}
@@ -7006,21 +6930,21 @@

Context

Java
Kotlin
-
{
+
{
   ws("/ws/{key}", (ctx, configurer) -> {
     String key = ctx.path("key").value();           (1)
     String foo = ctx.session().get("foo").value();  (2)
     ...
   });
-}

+}
@@ -7044,7 +6968,7 @@

JSON example

Java
Kotlin
-
import io.jooby.jackson.JacksonModule;
+
import io.jooby.jackson.JacksonModule;
 
 {
   install(new JackonModule());                         (1)
@@ -7055,9 +6979,9 @@ 
(3)
     })
   });
-}

+}
@@ -7092,7 +7016,7 @@

Context

Java
Kotlin
-
import io.jooby.jackson.JacksonModule;
+
import io.jooby.jackson.JacksonModule;
 
 {
   install(new JackonModule());                         (1)
@@ -7105,9 +7029,9 @@ 
Copy to clipboard

+}
@@ -7136,7 +7060,7 @@

application.conf
-
websocket.idleTimeout = 1h
+
websocket.idleTimeout = 1h

@@ -7151,7 +7075,7 @@

application.conf
-
websocket.maxSize = 128K
+
websocket.maxSize = 128K

@@ -7175,17 +7099,17 @@

Server-Sent Events

Java
Kotlin
-
{
+
{
   sse("/sse", sse -> {            (1)
     sse.send("Welcome");          (2)
   });
-}

+}
@@ -7209,7 +7133,7 @@

Server-Sent Events

Java
Kotlin
-
{
+
{
   sse("/sse", sse -> {
     sse.send(
         new ServerSentMessage("...")
@@ -7218,9 +7142,9 @@ 
Copy to clipboard

+}
@@ -7246,21 +7170,21 @@

Connection Lost

Java
Kotlin
-
{
+
{
   sse("/sse", sse -> {
     sse.onClose(() -> {
       // clean up
     });
   });
-}

+}
@@ -7273,17 +7197,17 @@

Keep Alive
Java
Kotlin
-
{
+
{
   sse("/sse", sse -> {
     sse.keepAlive(15, TimeUnit.SECONDS)
   });
-}

+}
@@ -7334,7 +7258,7 @@

Java
Kotlin

-
import static io.jooby.ExecutionMode.EVENT_LOOP;
+
import static io.jooby.ExecutionMode.EVENT_LOOP;
 import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
@@ -7346,16 +7270,16 @@ 
Copy to clipboard

+}
@@ -7373,7 +7297,7 @@

Java
Kotlin

-
import static io.jooby.ExecutionMode.EVENT_LOOP;
+
import static io.jooby.ExecutionMode.EVENT_LOOP;
 import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
@@ -7398,9 +7322,9 @@ 
Copy to clipboard

+}
@@ -7435,7 +7359,7 @@

Java
Kotlin

-
import static io.jooby.ExecutionMode.EVENT_LOOP;
+
import static io.jooby.ExecutionMode.EVENT_LOOP;
 import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
@@ -7459,9 +7383,9 @@ 
Copy to clipboard

+}
@@ -7495,7 +7419,7 @@

Java
Kotlin
-
import static io.jooby.ExecutionMode.WORKER;
+
import static io.jooby.ExecutionMode.WORKER;
 import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
@@ -7511,9 +7435,9 @@ 
Copy to clipboard

+}
@@ -7535,7 +7459,7 @@

Java
Kotlin

-
import static io.jooby.ExecutionMode.WORKER;
+
import static io.jooby.ExecutionMode.WORKER;
 import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
@@ -7553,9 +7477,9 @@ 
Copy to clipboard

+}
@@ -7624,7 +7548,7 @@

Java
Kotlin

-
import static io.jooby.Jooby.runApp;
+
import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
 
@@ -7642,9 +7566,9 @@ 
Copy to clipboard

+}
@@ -7757,17 +7681,17 @@

Java
Kotlin

-
{
+
{
   configureServer(server -> {
     server.workerThreads(Number);
   });
-}

+}
@@ -7804,21 +7728,21 @@

Generate a JSON String from handler
Java
Kotlin
-
{
+
{
   get("/json", ctx -> {
     ctx.setContentType(MediaType.json);
     return "{\"message\": \"Hello Raw Response\"}";
   });
-}

+}
@@ -7854,7 +7778,7 @@

Writer example

Java
Kotlin
-
{
+
{
   get("/chunk", ctx -> {
     try(Writer writer = ctx.responseWriter()) { (1)
       writer.write("chunk1");                   (2)
@@ -7864,9 +7788,9 @@ 
(3)
   });
-}

+}
@@ -7902,7 +7826,7 @@

Writer example

Java
Kotlin
-
{
+
{
   get("/chunk", ctx -> {
     return ctx.responseWriter(writer -> { (1)
       writer.write("chunk1");             (2)
@@ -7910,9 +7834,9 @@ 

+}
@@ -7935,7 +7859,7 @@

File download example
Java
Kotlin
-
{
+
{
   get("/download-file", ctx -> {
     Path source = Paths.get("logo.png");
     return new AttachedFile(source);               (1)
@@ -7945,9 +7869,9 @@ 
(2)
   });
-}

+}
@@ -7980,7 +7904,7 @@

File download with builder method

Java
Kotlin
-
FileDownload.Builder produceDownload(Context ctx) {
+
FileDownload.Builder produceDownload(Context ctx) {
   return FileDownload.build(...);
 }
 
@@ -7988,9 +7912,9 @@ 

+}
@@ -8021,7 +7945,7 @@

<
In event loop
Java
Kotlin
-
{
+
{
   mode(EVENT_LOOP);                  (1)
 
   use(ReactiveSupport.concurrent()); (2)
@@ -8033,9 +7957,9 @@ 
<
           ...                        (4)
         });
   })
-}

+}
@@ -8077,7 +8001,7 @@

<
In worker mode
Java
Kotlin
-
{
+
{
   mode(WORKER);                      (1)
 
   use(ReactiveSupport.concurrent()); (2)
@@ -8089,9 +8013,9 @@ 
<
           ...                        (4)
         });
   })
-}

+}

@@ -8133,7 +8057,7 @@

<
In default mode
Java
Kotlin
-
{
+
{
   mode(DEFAULT);                     (1)
 
   use(ReactiveSupport.concurrent()); (2)
@@ -8145,9 +8069,9 @@ 
<
           ...                        (4)
         });
   })
-}

+}

@@ -8194,7 +8118,7 @@

Java
Kotlin

-
{
+
{
   use(ReactiveSupport.concurrent());
 
   get("/non-blocking", ctx -> {
@@ -8202,9 +8126,9 @@ 

+}
@@ -8240,13 +8164,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-mutiny</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -8258,7 +8182,7 @@
Uni
Java
Kotlin
-
import io.jooby.mutiny;
+
import io.jooby.mutiny;
 import io.smallrye.mutiny.Uni;
 
 {
@@ -8270,9 +8194,9 @@ 
Uni

+}
@@ -8294,7 +8218,7 @@
Java
Kotlin
-
import io.jooby.mutiny;
+
import io.jooby.mutiny;
 import io.smallrye.mutiny.Multi;
 
 {
@@ -8305,9 +8229,9 @@ 

+}
@@ -8357,13 +8281,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-rxjava3</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -8375,7 +8299,7 @@
Java
Kotlin
-
import io.jooby.rxjava3.Reactivex;
+
import io.jooby.rxjava3.Reactivex;
 
 {
   use(Reactivex.rx());
@@ -8385,9 +8309,9 @@ 

+}
@@ -8407,7 +8331,7 @@
Java
Kotlin
-
import io.jooby.rxjava3.Reactivex;
+
import io.jooby.rxjava3.Reactivex;
 
 {
   use(Reactivex.rx());
@@ -8416,9 +8340,9 @@ 

+}
@@ -8469,13 +8393,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-reactor</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -8487,7 +8411,7 @@
Mo
Java
Kotlin
-
import io.jooby.Reactor;
+
import io.jooby.Reactor;
 
 {
   use(Reactor.reactor());
@@ -8497,9 +8421,9 @@ 
Mo
         .fromCallable(() -> "Mono")
         .map(it -> "Hello " + it);
   })
-}

+}
@@ -8519,7 +8443,7 @@
Fl
Java
Kotlin
-
import io.jooby.Reactor;
+
import io.jooby.Reactor;
 
 {
   use(Reactor.reactor())
@@ -8528,9 +8452,9 @@ 
Fl
     return Flux.range(1, 10)
         .map(it -> it + ", ");
   })
-}

+}
@@ -8577,14 +8501,14 @@

Coroutine handler:
-
{
+
{
   coroutine {
     get("/") {
       delay(100)           (1)
       "Hello Coroutines!"  (2)
     }
   }
-}

+}

@@ -8602,7 +8526,7 @@

Here is another example with an extension and suspending function:
-
{
+
{
   coroutine {
     get("/") {
       ctx.doSomething()         (1)
@@ -8613,7 +8537,7 @@ 
(2)
   return "Hello Coroutines!"  (3)
-}

+}

@@ -8643,7 +8567,7 @@

Coroutines with custom executor:
-
{
+
{
   worker(Executors.newCachedThreadPool())
 
   coroutine {
@@ -8653,7 +8577,7 @@ 
(3)
     }
   }
-}

+}

@@ -8682,7 +8606,7 @@

UNDISPATCHED
-
{
+
{
   coroutine(CoroutineStart.UNDISPATCHED) {
     get("/") {
       val n = 5 * 5        (1)
@@ -8690,7 +8614,7 @@ 
(3)
     }
   }
-}

+}

@@ -8715,7 +8639,7 @@

launchContext
-
{
+
{
   coroutine {
     launchContext { MDCContext() } (1)
 
@@ -8723,7 +8647,7 @@ 
Copy to clipboard

+}

@@ -8749,17 +8673,17 @@

send text

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     return ctx.send("Hello World!");
   });
-}

+}
@@ -8882,9 +8806,9 @@

-
{
+
{
   errorCode(MyException.class, StatusCode.XXX);
-}

+}

@@ -8896,23 +8820,23 @@

Error Handler

Java
Kotlin
-
{
+
{
   error((ctx, cause, statusCode) -> {                                      (1)
     Router router = ctx.getRouter();
     router.getLog().error("found `{}` error", statusCode.value(), cause);  (2)
     ctx.setResponseCode(statusCode);
     ctx.send("found `" + statusCode.value() + "` error");                  (3)
   });
-}

+}
@@ -8942,7 +8866,7 @@

Error with content negotiation

Java
Kotlin
-
import static io.jooby.MediaType.json;
+
import static io.jooby.MediaType.json;
 import static io.jooby.MediaType.html;
 
 {
@@ -8963,9 +8887,9 @@ 
(5)
     }
   });
-}

+}
@@ -9023,19 +8947,19 @@

Status Code Error Handler

Java
Kotlin
-
import static io.jooby.StatusCode.NOT_FOUND;
+
import static io.jooby.StatusCode.NOT_FOUND;
 {
   error(NOT_FOUND, (ctx, cause, statusCode) -> {
     ctx.send(statusCode);   (1)
   });
-}

+}
@@ -9073,17 +8997,17 @@

Exception Handler

Java
Kotlin
-
{
+
{
   error(MyException.class, (ctx, cause, statusCode) -> {
     // log and process MyException
   });
-}

+}
@@ -9104,7 +9028,7 @@

Usage
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.AccessLogHandler;
 ...
 {
@@ -9114,9 +9038,9 @@ 

+}
@@ -9217,7 +9141,7 @@

CorsExample

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.CorsHandler;
 ...
 {
@@ -9227,9 +9151,9 @@ 

+}
@@ -9277,7 +9201,7 @@

Cors options

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.CorsHandler;
 ...
 {
@@ -9289,9 +9213,9 @@ 

+}
@@ -9325,21 +9249,21 @@

application.conf
-
cors {
+
cors {
   origin: "*"
   credentials: true
   methods: [GET, POST],
   headers: [Content-Type],
   maxAge: 30m
   exposedHeaders: [Custom-Header]
-}

+}

Loading options
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.CorsHandler;
 ...
 {
@@ -9350,9 +9274,9 @@ 

+}
@@ -9393,10 +9317,10 @@

CSRF
-
<form method="POST" action="...">
+
<form method="POST" action="...">
     <input name="csrf" value="{{csrf}}" type="hidden" />
     ...
-</form>

+</form>

@@ -9446,7 +9370,7 @@

Example

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.GracefulShutdown;
 ...
 {
@@ -9454,15 +9378,15 @@ 
(1)
 
   // other routes go here
-}

+}
@@ -9512,7 +9436,7 @@

Head Example

Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.HeadHandler;
 ...
 {
@@ -9522,9 +9446,9 @@ 

+}
@@ -9563,32 +9487,32 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>com.github.vladimir-bukhtoyarov</groupId>
   <artifactId>bucket4j-core</artifactId>
   <version>8.0.1</version>
-</dependency>

+</dependency>
10 requests per minute
Java
Kotlin
-
{
+
{
   Bandwidth limit = Bandwidth.simple(10, Duration.ofMinutes(1));
   Bucket bucket = Bucket4j.builder().addLimit(limit).build();     (1)
 
   before(new RateLimitHandler(bucket));                           (2)
-}

+}
@@ -9607,57 +9531,57 @@

10 requests per minute per ip/remote address

Java
Kotlin
-
{
+
{
   before(new RateLimitHandler(remoteAddress -> {
     Bandwidth limit = Bandwidth.simple(10, Duration.ofMinutes(1));
     return Bucket4j.builder().addLimit(limit).build();
   }));
-}

+}
10 requests per minute per header value
Java
Kotlin
-
{
+
{
   before(new RateLimitHandler(key -> {
     Bandwidth limit = Bandwidth.simple(10, Duration.ofMinutes(1));
     return Bucket4j.builder().addLimit(limit).build();
   }, "ApiKey"));
-}

+}
10 requests per minute
Java
Kotlin
-
{
+
{
   Bandwidth limit = Bandwidth.simple(10, Duration.ofMinutes(1));
   Bucket bucket = Bucket4j.builder().addLimit(limit).build();     (1)
 
   before(new RateLimitHandler(bucket));                           (2)
-}

+}
@@ -9676,23 +9600,23 @@

Rate limit in a cluster

Java
Kotlin
-
{
+
{
   ProxyManager<String> buckets = ...;
   before(RateLimitHandler.cluster(key -> {
     return buckets.getProxy(key, () -> {
       return ...;
     });
   }));
-}

+}
@@ -9708,7 +9632,7 @@

<
Force SSL
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.SSLHandler;
 ...
 {
@@ -9720,9 +9644,9 @@ 
<
   get("/", ctx -> {
     return ctx.getScheme();
   });
-}

+}

@@ -9757,7 +9681,7 @@

<
Force SSL
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.SSLHandler;
 ...
 {
@@ -9769,9 +9693,9 @@ 
<
   get("/", ctx -> {
     return ctx.getScheme();
   });
-}

+}

@@ -9828,7 +9752,7 @@

<
Head Example
Java
Kotlin
-
import io.jooby.Jooby;
+
import io.jooby.Jooby;
 import io.jooby.TraceHandler;
 ...
 {
@@ -9838,9 +9762,9 @@ 
<
   get("/", ctx -> {
     ...
   });
-}

+}

@@ -9892,13 +9816,13 @@

Initializing the Environment

Java
Kotlin
-
{
+
{
   Environment env = getEnvironment();
-}

+}
@@ -9975,9 +9899,9 @@

File system loading
-
└── conf
+
└── conf
     └── application.conf
-└── myapp.jar

+└── myapp.jar

@@ -9985,7 +9909,7 @@

-
  Environment env = getEnvironment();
+
  Environment env = getEnvironment();

@@ -9995,8 +9919,8 @@

Classpath loading
-
└── myapp.jar
-   └── application.conf (file inside jar)
+
└── myapp.jar
+   └── application.conf (file inside jar)

@@ -10041,24 +9965,24 @@

application.conf
-
foo = foo
+
foo = foo

Property access
Java
Kotlin
-
{
+
{
   Environment env = getEnvironment();                (1)
   Config conf = env.getConfig();             (2)
   System.out.println(conf.getString("foo")); (3)
-}

+}
@@ -10083,7 +10007,7 @@

Program argument
-
java -jar myapp.jar foo=argument
+
java -jar myapp.jar foo=argument

@@ -10092,7 +10016,7 @@

System property
-
java -Dfoo=sysprop -jar myapp.jar
+
java -Dfoo=sysprop -jar myapp.jar

@@ -10101,7 +10025,7 @@

Environment variable
-
foo=envar java -jar myapp.jar
+
foo=envar java -jar myapp.jar

@@ -10114,21 +10038,21 @@

Environment property file
-
└── application.conf
-└── application.prod.conf
+
└── application.conf
+└── application.prod.conf

application.conf
-
foo = foo
-bar = devbar
+
foo = foo
+bar = devbar
application.prod.conf
-
bar = prodbar
+
bar = prodbar
@@ -10190,17 +10114,17 @@

Environment options

Java
Kotlin
-
{
+
{
   Environment env = setEnvironmentOptions(new EnvOptions() (1)
     .setFilename("myapp.conf")
   )
-}

+}
@@ -10222,17 +10146,17 @@

Direct instantiation

Java
Kotlin
-
{
+
{
   Config conf = ConfigFatory.load("/path/to/myapp.conf");  (1)
   Environment env = new Env(customConfig, "prod");         (2)
   setEnvironment(env);                                     (3)
-}

+}
@@ -10286,19 +10210,19 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>ch.qos.logback</groupId>
   <artifactId>logback-classic</artifactId>
   <version>1.5.6</version>
-</dependency>

+</dependency>
logback.xml
-
<?xml version="1.0" encoding="UTF-8"?>
+
<?xml version="1.0" encoding="UTF-8"?>
 <configuration>
 
   <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
@@ -10310,7 +10234,7 @@ 

+</configuration>
@@ -10330,7 +10254,7 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>org.apache.logging.log4j</groupId>
   <artifactId>log4j-slf4j-impl</artifactId>
   <version>2.23.1</version>
@@ -10340,17 +10264,17 @@ 
Copy to clipboard

+</dependency>
log4j.xml
-
<?xml version="1.0" encoding="UTF-8"?>
+
<?xml version="1.0" encoding="UTF-8"?>
 <Configuration>
   <Appenders>
     <Console name="stdout">
@@ -10362,7 +10286,7 @@ 

+</Configuration>
@@ -10390,9 +10314,9 @@

Example
-
conf
+
conf
 └── logback.conf
-└── logback.prod.conf

+└── logback.prod.conf

@@ -10414,13 +10338,13 @@

-
public class App extends Jooby {
+
public class App extends Jooby {
   private static final Logger log = ...
 
   public static void main(String[] args) {
     runApp(args, App::new);
   }
-}

+}

@@ -10528,13 +10452,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-test</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -10544,19 +10468,19 @@

App

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     get("/", ctx -> "Easy unit testing!");
   }
-}

+}
@@ -10566,7 +10490,7 @@

TestApp

Java
Kotlin
-
import io.jooby.test.MockRouter;
+
import io.jooby.test.MockRouter;
 
 public class TestApp {
 
@@ -10575,9 +10499,9 @@ 

+}
@@ -10600,29 +10524,29 @@

App

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     get("/", ctx -> ctx
         .setResponseCode(StatusCode.OK)
         .send("Easy unit testing")
     );
   }
-}

+}
Checking response metadata
Java
Kotlin
-
public class TestApp {
+
public class TestApp {
 
   @Test
   public void test() {
@@ -10632,9 +10556,9 @@ 

+}
@@ -10654,28 +10578,28 @@

App

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     post("/", ctx -> {
       String name = ctx.form("name").value();
       return name;
     });
   }
-}

+}
Using mock context
Java
Kotlin
-
public class TestApp {
+
public class TestApp {
 
   @Test
   public void test() {
@@ -10687,9 +10611,9 @@ 

+}
@@ -10711,7 +10635,7 @@

Mockito Context

Java
Kotlin
-
import static org.mockito.Mockito.mock;
+
import static org.mockito.Mockito.mock;
 import static org.mockito.Mockito.when;
 
 public class TestApp {
@@ -10728,9 +10652,9 @@ 

+}
@@ -10790,13 +10714,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-test</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -10806,19 +10730,19 @@

App

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     get("/", ctx -> "Easy testing!");
   }
-}

+}
@@ -10828,7 +10752,7 @@

TestApp

Java
Kotlin
-
import io.jooby.JoobyTest;
+
import io.jooby.JoobyTest;
 
 @JoobyTest(App.class)
 public class TestApp {
@@ -10845,9 +10769,9 @@ 

+}
@@ -10898,7 +10822,7 @@

Server port injection
-
@JoobyTest(App.class)
+
@JoobyTest(App.class)
 public void test(int serverPort) {
 
 }
@@ -10906,7 +10830,7 @@ 
Copy to clipboard

+}

@@ -10919,10 +10843,10 @@

Server path injection
-
@JoobyTest(App.class)
+
@JoobyTest(App.class)
 public void test(String serverPath) { (1)
 
-}

+}

@@ -10966,17 +10890,17 @@

App

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   public App(String argument) {         (1)
     get("/", ctx -> "Easy testing!");
   }
-}

+}
@@ -10994,7 +10918,7 @@

TestApp

Java
Kotlin
-
import io.jooby.JoobyTest;
+
import io.jooby.JoobyTest;
 
 public class TestApp {
 
@@ -11012,9 +10936,9 @@ 
(2)
     return new App("Argument");                                      (3)
   }
-}

+}
@@ -11085,7 +11009,7 @@

pom.xml
build.gradle

-
<plugins>
+
<plugins>
   ...
   <plugin>
     <groupId>io.jooby</groupId>
@@ -11093,9 +11017,9 @@ 

+</plugins>
@@ -11114,11 +11038,11 @@

pom.xml
build.gradle

-
<properties>
+
<properties>
   <application.class>myapp.App</application.class>
-</properties>

+</properties>
@@ -11128,9 +11052,9 @@

Maven
Gradle

-
mvn jooby:run
+
mvn jooby:run
@@ -11164,7 +11088,7 @@

<
pom.xml
build.gradle
-
<plugins>
+
<plugins>
   ...
   <plugin>
     <groupId>io.jooby</groupId>
@@ -11180,9 +11104,9 @@ 
<
     </configuration>
   </plugin>
   ...
-</plugins>

+</plugins>
@@ -11269,7 +11193,7 @@

Maven
Gradle

-
<build>
+
<build>
   <plugins>
     ...
     <plugin>
@@ -11296,9 +11220,9 @@ 

+</build>
@@ -11356,7 +11280,7 @@

stork.yml
-
# Name of application (make sure it has no spaces)
+
# Name of application (make sure it has no spaces)
 name: "${project.artifactId}"
 
 # Display name of application (can have spaces)
@@ -11396,7 +11320,7 @@ 

+symlink_java: true

@@ -11405,7 +11329,7 @@

Maven
-
<build>
+
<build>
   <plugins>
     <plugin>
         <groupId>io.repaint.maven</groupId>
@@ -11419,7 +11343,7 @@ 

+</build>

@@ -11460,13 +11384,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jetty</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -11476,13 +11400,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-netty</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -11492,13 +11416,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-undertow</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -11524,17 +11448,17 @@

<
Server
Java
Kotlin
-
import io.jooby.netty.NettyServer;
+
import io.jooby.netty.NettyServer;
 
 {
   install(new NettyServer());
-}

+}

@@ -11545,7 +11469,7 @@

<
Jetty Loom
Java
Kotlin
-
import io.jooby.jetty.JettyServer;
+
import io.jooby.jetty.JettyServer;
 
 import java.util.concurrent.Executors;
 
@@ -11559,9 +11483,9 @@ 
<
   worker.setVirtualThreadsExecutor(Executors.newVirtualThreadPerTaskExecutor());
 
   install(new JettyServer(worker));
-}

+}

@@ -11588,7 +11512,7 @@

Server Options
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setBufferSize(16384)
       .setCompressionLevel(6)
@@ -11605,9 +11529,9 @@ 
Copy to clipboard

+}
@@ -11680,7 +11604,7 @@

application.conf
-
server.bufferSize = 16384
+
server.bufferSize = 16384
 server.compressionLevel = 6
 server.port = 8080
 server.ioThreads = 16
@@ -11693,7 +11617,7 @@ 
Copy to clipboard

+server.expectContinue = false

@@ -11733,17 +11657,17 @@

Hello HTTPS
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setSecurePort(8443)             (1)
   );
-}

+}
@@ -11789,13 +11713,13 @@

Generates a PKCS12 certificate
-
mkcert -pkcs12 localhost
+
mkcert -pkcs12 localhost

Generates a X.509 certificate
-
mkcert localhost
+
mkcert localhost
@@ -11807,18 +11731,18 @@

X509

Java
Kotlin
-
{
+
{
   SslOptions ssl = SslOptions.x509("path/to/server.crt", "path/to/server.key");
   setServerOptions(new ServerOptions()
       .setSsl(ssl)                                                    (1)
   );
-}

+}
@@ -11838,30 +11762,30 @@

Ssl options:
-
server {
+
server {
   ssl {
     type: X509,
     cert: "path/to/server.crt",
     key: "path/to/server.key"
   }
-}

+}

X509 from configuration
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setSsl(SslOptions.from(getConfig()))
   );
-}

+}
@@ -11874,18 +11798,18 @@

PKCS12
Java
Kotlin
-
{
+
{
   SslOptions ssl = SslOptions.pkcs12("path/to/server.p12", "password");
   setServerOptions(new ServerOptions()
       .setSsl(ssl)                                                      (1)
   );
-}

+}
@@ -11905,30 +11829,30 @@

Ssl options:
-
server {
+
server {
   ssl {
     type: PKCS12,
     cert: "path/to/server.p12",
     password: "password"
   }
-}

+}

PKCS12 from configuration
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setSsl(SslOptions.from(getConfig()))
   );
-}

+}
@@ -11941,7 +11865,7 @@

Client Authentication
Java
Kotlin
-
{
+
{
   SslOptions ssl = SslOptions.pkcs12("path/to/server.p12", "password")
     .setTrustCert(Files.newInputStream("path/to/trustCert")) (1)
     .setTrustPassword("password") (2)
@@ -11950,16 +11874,16 @@ 

+}
@@ -11984,7 +11908,7 @@

Ssl options:
-
server {
+
server {
   ssl {
     type: PKCS12,
     cert: "path/to/server.p12",
@@ -11995,24 +11919,24 @@ 

+}

Mutual TLS from configuration
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setSsl(SslOptions.from(getConfig()))
   );
-}

+}
@@ -12025,19 +11949,19 @@

TLS example
Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setSsl(new SslOptions().setProtocol("TLSv1.3", "TLSv1.2"))
   );
-}

+}
@@ -12088,13 +12012,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-conscrypt</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -12114,7 +12038,7 @@

HTTP/2

Java
Kotlin
-
{
+
{
   setServerOptions(new ServerOptions()
       .setHttp2(true)
       .setSecurePort(8433)
@@ -12123,9 +12047,9 @@ 

+}
@@ -12189,7 +12113,7 @@

Java
Kotlin

-
import io.jooby.Extension;
+
import io.jooby.Extension;
 
 public class MyExtension implements Extension {
 
@@ -12201,9 +12125,9 @@ 
(4)
    }
-}

+}
@@ -12243,7 +12167,7 @@

Java
Kotlin

-
public class App extends Jooby {
+
public class App extends Jooby {
 
    {
      install(new MyExtension());                      (1)
@@ -12253,9 +12177,9 @@ 

+}
@@ -12308,13 +12232,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-avaje-inject</artifactId>
   <version>1.1.0</version>
-</dependency>

+</dependency>
@@ -12324,7 +12248,7 @@

Installing Avaje Inject

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
 
   {
     install(AvajeInjectModule.of());                     (1)
@@ -12338,9 +12262,9 @@ 
Copy to clipboard

+}
@@ -12372,14 +12296,14 @@

application.conf
-
currency = USD
+
currency = USD

Java
Kotlin
-
@Singleton
+
@Singleton
 public class BillingService {
 
   @Inject
@@ -12387,12 +12311,12 @@ 

+}
@@ -12405,7 +12329,7 @@

MVC and Avaje Inject
Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
 
   {
     install(AvajeInjectModule.of());  (1)
@@ -12416,15 +12340,15 @@ 
Copy to clipboard

+}
@@ -12456,13 +12380,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>com.google.dagger</groupId>
   <artifactId>dagger</artifactId>
   <version>2.20</version>
-</dependency>

+</dependency>
@@ -12472,7 +12396,7 @@

Maven
Gradle

-
<build>
+
<build>
   <plugins>
     <plugin>
       <groupId>org.apache.maven.plugins</groupId>
@@ -12489,15 +12413,15 @@ 
Copy to clipboard

+</build>
@@ -12507,7 +12431,7 @@

Dagger

Java
Kotlin
-
import static io.jooby.Jooby.runApp;
+
import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
 
@@ -12525,9 +12449,9 @@ 
Copy to clipboard

+}
@@ -12578,7 +12502,7 @@

MVC and Dagger

Java
Kotlin
-
import static io.jooby.Jooby.runApp;
+
import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
 
@@ -12593,9 +12517,9 @@ 
Copy to clipboard

+}
@@ -12628,7 +12552,7 @@

MVC and Dagger provider

Java
Kotlin
-
import static io.jooby.Jooby.runApp;
+
import static io.jooby.Jooby.runApp;
 
 public class App extends Jooby {
 
@@ -12643,9 +12567,9 @@ 
Copy to clipboard

+}
@@ -12680,13 +12604,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-guice</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -12696,7 +12620,7 @@

Installing Guice

Java
Kotlin
-
import io.jooby.guice.GuiceModule;
+
import io.jooby.guice.GuiceModule;
 import io.jooby.kt.runApp;
 
 public class App extends Jooby {
@@ -12713,9 +12637,9 @@ 
Copy to clipboard

+}
@@ -12750,14 +12674,14 @@

application.conf
-
currency = USD
+
currency = USD

Java
Kotlin
-
import javax.injext.Named;
+
import javax.injext.Named;
 import javax.injext.Inject;
 
 public class BillingService {
@@ -12767,11 +12691,11 @@ 
Copy to clipboard

+}
@@ -12784,7 +12708,7 @@

MVC and Guice
Java
Kotlin
-
import io.jooby.guice.GuiceModule;
+
import io.jooby.guice.GuiceModule;
 import io.jooby.kt.runApp
 
 public class App extends Jooby {
@@ -12798,9 +12722,9 @@ 
Copy to clipboard

+}
@@ -13087,13 +13011,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-kotlin</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -13594,7 +13518,7 @@

Pipeline in 1.x
-
{
+
{
   use("*", (req, rsp, chain) -> {
     System.out.println("first");
     // Moves execution to next handler: second
@@ -13610,7 +13534,7 @@ 

+}
@@ -13620,7 +13544,7 @@

Pipeline in 2.x
-
{
+
{
    use(next -> ctx -> {
      System.out.println("first");
      // Moves execution to next handler: second
@@ -13636,7 +13560,7 @@ 

+}

diff --git a/migration/3.x/index.html b/migration/3.x/index.html index 40759f6..4c6ce68 100644 --- a/migration/3.x/index.html +++ b/migration/3.x/index.html @@ -635,13 +635,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-kotlin</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
diff --git a/modules/avaje-inject/index.html b/modules/avaje-inject/index.html index 5bd0955..b224e2e 100644 --- a/modules/avaje-inject/index.html +++ b/modules/avaje-inject/index.html @@ -588,13 +588,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-avaje-inject</artifactId>
   <version>1.1.0</version>
-</dependency>

+</dependency>
@@ -604,7 +604,7 @@

Installing Avaje Inject

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
 
   {
     install(AvajeInjectModule.of());                     (1)
@@ -618,9 +618,9 @@ 

+}
@@ -652,14 +652,14 @@

application.conf
-
currency = USD
+
currency = USD

Java
Kotlin
-
@Singleton
+
@Singleton
 public class BillingService {
 
   @Inject
@@ -667,12 +667,12 @@ 
Copy to clipboard

+}
@@ -685,7 +685,7 @@

MVC and Avaje Inject
Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
 
   {
     install(AvajeInjectModule.of());  (1)
@@ -696,15 +696,15 @@ 
Copy to clipboard

+}
diff --git a/modules/avaje-jsonb/index.html b/modules/avaje-jsonb/index.html index a82422d..607d81e 100644 --- a/modules/avaje-jsonb/index.html +++ b/modules/avaje-jsonb/index.html @@ -594,13 +594,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-avaje-jsonb</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -610,7 +610,7 @@

Java
Kotlin

-
import io.jooby.avaje.jsonb.AvajeJsonbModule;
+
import io.jooby.avaje.jsonb.AvajeJsonbModule;
 
 {
   install(new AvajeJsonbModule());                  (1)
@@ -624,9 +624,9 @@ 
(3)
     ...
   });
-}

+}
@@ -669,7 +669,7 @@

Default Jsonb

Java
Kotlin
-
import io.jooby.avaje.jsonb.AvajeJsonbModule;
+
import io.jooby.avaje.jsonb.AvajeJsonbModule;
 import io.avaje.jsonb.Jsonb;
 
 {
@@ -678,16 +678,16 @@ 
Copy to clipboard

+}
@@ -697,23 +697,23 @@

Custom Jsonb

Java
Kotlin
-
import io.jooby.avaje.jsonb.AvajeJsonbModule;
+
import io.jooby.avaje.jsonb.AvajeJsonbModule;
 import io.avaje.jsonb.Jsonb;
 
 {
   var jsonb = Jsonb.builder().build();
 
   install(new AvajeJsonbModule(jsonb));
-}

+}
diff --git a/modules/aws/index.html b/modules/aws/index.html index c0afdda..d2b6e30 100644 --- a/modules/aws/index.html +++ b/modules/aws/index.html @@ -593,13 +593,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-awssdk-v1</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -609,13 +609,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>com.amazonaws</groupId>
   <artifactId>aws-java-sdk-s3</artifactId>
   <version></version>
-</dependency>

+</dependency>
@@ -624,8 +624,8 @@

application.conf
-
aws.accessKeyId = "your access key id"
-aws.secretKey = "your secret key"
+
aws.accessKeyId = "your access key id"
+aws.secretKey = "your secret key"

@@ -638,7 +638,7 @@

Java
Kotlin

-
import io.jooby.awssdkv1.AwsModule;
+
import io.jooby.awssdkv1.AwsModule;
 
 {
   install(
@@ -653,9 +653,9 @@ 
(4)
         })
    );
-}

+}
diff --git a/modules/caffeine/index.html b/modules/caffeine/index.html index a4e617e..636784a 100644 --- a/modules/caffeine/index.html +++ b/modules/caffeine/index.html @@ -593,13 +593,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-caffeine</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -609,7 +609,7 @@

Java
Kotlin

-
import io.jooby.caffeine.CaffeineSessionStore;
+
import io.jooby.caffeine.CaffeineSessionStore;
 
 {
   setSessionStore(new CaffeineSessionStore());   (1)
@@ -618,9 +618,9 @@ 
(2)
     // work with session
   });
-}

+}
diff --git a/modules/camel/index.html b/modules/camel/index.html index 9dff750..2779dda 100644 --- a/modules/camel/index.html +++ b/modules/camel/index.html @@ -596,13 +596,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-camel</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -612,7 +612,7 @@

Java
Kotlin

-
import io.jooby.camel.CamelModule;
+
import io.jooby.camel.CamelModule;
 
 {
   install(new CamelModule(new MyRoutes()));                       (1)
@@ -632,9 +632,9 @@ 

+}
@@ -682,29 +682,29 @@

application.conf
-
myprop = "my prop value"
+
myprop = "my prop value"

Java
Kotlin
-
public class MyRoutes extends RouteBuilder {
+
public class MyRoutes extends RouteBuilder {
 
   @Override public void configure() throws Exception {
     from("direct://foo")
         .log("{{myprop}}");
   }
-}

+}
@@ -720,7 +720,7 @@

Java
Kotlin

-
import io.jooby.guice.GuiceModule;
+
import io.jooby.guice.GuiceModule;
 import io.jooby.camel.CamelModule;
 
 {
@@ -736,9 +736,9 @@ 
(3)
         .log("${body}");
   }
-}

+}
@@ -799,8 +799,8 @@

application.conf
-
camel.main.name = My Camel Context
-camel.threadpool.poolSize = 10
+
camel.main.name = My Camel Context
+camel.threadpool.poolSize = 10

diff --git a/modules/ebean/index.html b/modules/ebean/index.html index d73b756..9222eda 100644 --- a/modules/ebean/index.html +++ b/modules/ebean/index.html @@ -599,7 +599,7 @@

Maven
Gradle

-
<!-- DataSource via HikariCP-->
+
<!-- DataSource via HikariCP-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
@@ -611,13 +611,13 @@ 

+</dependency>
@@ -627,13 +627,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>${mysql-connector-java.version}</version>
-</dependency>

+</dependency>
@@ -642,9 +642,9 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = myuser
-db.password = mypass

+db.password = mypass

@@ -654,7 +654,7 @@

Maven
Gradle

-
<plugin>
+
<plugin>
   <groupId>io.repaint.maven</groupId>
   <artifactId>tiles-maven-plugin</artifactId>
   <version>${tiles-maven-plugin.version}</version>
@@ -665,9 +665,9 @@ 

+</plugin>
@@ -687,7 +687,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.ebean.EbeanModule;
 
 {
@@ -699,9 +699,9 @@ 
(3)
     // work with Database
   });
-}

+}
@@ -743,7 +743,7 @@

TransactionalRequest

Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.ebean.EbeanModule;
 import io.jooby.ebean.TransactionalRequest;
 
@@ -763,9 +763,9 @@ 
Copy to clipboard

+}
@@ -799,21 +799,21 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Transactional(false)
 @GET("/")
 public void get(Context ctx) {
   // no automatic transaction management here
-}

+}
@@ -823,21 +823,21 @@

TransactionalRequest disabled by default

Java
Kotlin
-
import io.jooby.ebean.TransactionalRequest;
+
import io.jooby.ebean.TransactionalRequest;
 
 {
   ...
   use(new TransactionalRequest().enabledByDefault(false));
   ...
-}

+}
@@ -847,7 +847,7 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Inject
 private Database database;
@@ -856,9 +856,9 @@ 

+}
@@ -877,19 +877,19 @@

Transactional for script routes

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     ...
   }).attribute(Transactional.ATTRIBUTE, false);
-}

+}
@@ -903,15 +903,15 @@

<
Programmatically
Java
Kotlin
-
{
+
{
   DatabaseConfig dbConfig = ...;         (1)
   install(new EbeanModule(dbConfig));    (2)
-}

+}
@@ -929,14 +929,14 @@

<
Configuration
-
{
+
{
   ebean {
     ddl {
       generate = true
       run = true
     }
   }
-}

+}
diff --git a/modules/flyway/index.html b/modules/flyway/index.html index a40b74e..ad9293e 100644 --- a/modules/flyway/index.html +++ b/modules/flyway/index.html @@ -594,7 +594,7 @@

Maven
Gradle

-
<!-- DataSource via HikariCP-->
+
<!-- DataSource via HikariCP-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
@@ -606,13 +606,13 @@ 

+</dependency>

@@ -622,13 +622,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>${mysql-connector-java.version}</version>
-</dependency>

+</dependency>
@@ -637,9 +637,9 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = myuser
-db.password = mypass

+db.password = mypass

@@ -649,7 +649,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.flyway.FlywayModule;
 
 {
@@ -657,16 +657,16 @@ 
(2)
 
-}

+}
@@ -713,7 +713,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.flyway.FlywayModule;
 
 {
@@ -722,9 +722,9 @@ 

+}
diff --git a/modules/freemarker/index.html b/modules/freemarker/index.html index c3dfe78..4124bda 100644 --- a/modules/freemarker/index.html +++ b/modules/freemarker/index.html @@ -596,13 +596,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-freemarker</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

views/index.ftl
-
<p> Hello ${name}! </p>
+
<p> Hello ${name}! </p>

@@ -621,7 +621,7 @@

Java
Kotlin

-
import io.jooby.freemarker.FreemarkerModule;
+
import io.jooby.freemarker.FreemarkerModule;
 
 {
   install(new FreemarkerModule());
@@ -630,9 +630,9 @@ 

+}
@@ -677,8 +677,8 @@

application.conf
-
freemarker.cacheStorage = soft
-freemarker.strictSyntax = yes
+
freemarker.cacheStorage = soft
+freemarker.strictSyntax = yes

@@ -688,21 +688,21 @@

Java
Kotlin

-
import io.jooby.freemarker.FreemarkerModule;
+
import io.jooby.freemarker.FreemarkerModule;
 
 {
   Configuration freemarker = new Configuration();
 
   install(new FreemarkerModule(freemarker));
-}

+}
diff --git a/modules/graphql/index.html b/modules/graphql/index.html index 6584581..b5febf0 100644 --- a/modules/graphql/index.html +++ b/modules/graphql/index.html @@ -607,7 +607,7 @@

Maven
Gradle
-
<!-- GraphQL-->
+
<!-- GraphQL-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-graphql</artifactId>
@@ -619,13 +619,13 @@ 
Copy to clipboard

+</dependency>
@@ -633,7 +633,7 @@

-
type Query {
+
type Query {
     bookById(id: ID): Book
 }
 
@@ -648,7 +648,7 @@ 
Copy to clipboard

+}

@@ -658,7 +658,7 @@

Java
Kotlin

-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 import io.jooby.graphql.GraphQLModule;
 
 {
@@ -672,9 +672,9 @@ 

+}
@@ -719,23 +719,23 @@

<
Async Mode
Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 import io.jooby.graphql.GraphQLModule;
 
 {
   install(new GraphQLModule(...)
       .setAsync(false)                    (1)
   );
-}

+}

@@ -759,23 +759,23 @@

HTTP GET

Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 import io.jooby.graphql.GraphQLModule;
 
 {
   install(new GraphQLModule(...)
       .setSupportHttpGet(true)
   );
-}

+}
@@ -813,7 +813,7 @@

Maven
Gradle
-
<!--  JSON library-->
+
<!--  JSON library-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jackson</artifactId>
@@ -832,16 +832,16 @@ 

+</dependency>
@@ -851,7 +851,7 @@

Java
Kotlin

-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 import io.jooby.graphql.GraphQLModule;
 import io.jooby.graphql.GraphiQLModule;
 
@@ -861,9 +861,9 @@ 
(2)
 
   install(new GraphiQLModule());          (3)
-}

+}
@@ -905,7 +905,7 @@

Maven
Gradle

-
<!--  JSON library-->
+
<!--  JSON library-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jackson</artifactId>
@@ -924,16 +924,16 @@ 
Copy to clipboard

+</dependency>
@@ -943,7 +943,7 @@

Java
Kotlin

-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 import io.jooby.graphql.GraphQLModule;
 import io.jooby.graphql.GraphQLPlaygroundModule;
 
@@ -953,9 +953,9 @@ 
(2)
 
   install(new GraphQLPlaygroundModule());          (3)
-}

+}
diff --git a/modules/gson/index.html b/modules/gson/index.html index eba482d..fc2a9e7 100644 --- a/modules/gson/index.html +++ b/modules/gson/index.html @@ -594,13 +594,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-gson</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -610,7 +610,7 @@

Java
Kotlin

-
import io.jooby.gson.GsonModule;
+
import io.jooby.gson.GsonModule;
 
 {
   install(new GsonModule());                        (1)
@@ -624,9 +624,9 @@ 
(3)
     ...
   });
-}

+}
@@ -669,7 +669,7 @@

Default object mapper

Java
Kotlin
-
import io.jooby.gson.GsonModule;
+
import io.jooby.gson.GsonModule;
 
 {
   install(new GsonModule());
@@ -677,15 +677,15 @@ 

+}
@@ -695,21 +695,21 @@

Custom ObjectMapper

Java
Kotlin
-
import io.jooby.gson.GsonModule;
+
import io.jooby.gson.GsonModule;
 
 {
   Gson gson = new GsonBuilder().create();
 
   install(new GsonModule(gson));
-}

+}
diff --git a/modules/guice/index.html b/modules/guice/index.html index 057920b..88af133 100644 --- a/modules/guice/index.html +++ b/modules/guice/index.html @@ -588,13 +588,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-guice</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -604,7 +604,7 @@

Installing Guice

Java
Kotlin
-
import io.jooby.guice.GuiceModule;
+
import io.jooby.guice.GuiceModule;
 import io.jooby.kt.runApp;
 
 public class App extends Jooby {
@@ -621,9 +621,9 @@ 

+}
@@ -658,14 +658,14 @@

application.conf
-
currency = USD
+
currency = USD

Java
Kotlin
-
import javax.injext.Named;
+
import javax.injext.Named;
 import javax.injext.Inject;
 
 public class BillingService {
@@ -675,11 +675,11 @@ 
Copy to clipboard

+}
@@ -692,7 +692,7 @@

MVC and Guice
Java
Kotlin
-
import io.jooby.guice.GuiceModule;
+
import io.jooby.guice.GuiceModule;
 import io.jooby.kt.runApp
 
 public class App extends Jooby {
@@ -706,9 +706,9 @@ 

+}
diff --git a/modules/handlebars/index.html b/modules/handlebars/index.html index c0e059b..04e61a5 100644 --- a/modules/handlebars/index.html +++ b/modules/handlebars/index.html @@ -596,13 +596,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-handlebars</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

views/index.hbs
-
<p> Hello {{name}}! </p>
+
<p> Hello {{name}}! </p>

@@ -621,7 +621,7 @@

Java
Kotlin

-
import io.jooby.handlebars.HandlebarsModule;
+
import io.jooby.handlebars.HandlebarsModule;
 
 {
   install(new HandlebarsModule());
@@ -630,9 +630,9 @@ 

+}
@@ -675,7 +675,7 @@

Java
Kotlin

-
import io.jooby.handlebars.HandlebarsModule;
+
import io.jooby.handlebars.HandlebarsModule;
 
 {
   Handlebars handlebars = new Handlebars();
@@ -683,9 +683,9 @@ 
Copy to clipboard

+}
diff --git a/modules/hibernate/index.html b/modules/hibernate/index.html index fed9bb0..d1435dd 100644 --- a/modules/hibernate/index.html +++ b/modules/hibernate/index.html @@ -602,7 +602,7 @@

Maven
Gradle
-
<!-- DataSource via HikariCP-->
+
<!-- DataSource via HikariCP-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
@@ -614,13 +614,13 @@ 

+</dependency>
@@ -630,13 +630,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>${mysql-connector-java.version}</version>
-</dependency>

+</dependency>
@@ -645,9 +645,9 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = myuser
-db.password = mypass

+db.password = mypass

@@ -657,7 +657,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.hibernate.HibernateModule;
 {
   install(new HikariModule());                        (1)
@@ -682,9 +682,9 @@ 
(9)
     }
   });
-}

+}
@@ -796,7 +796,7 @@

TransactionalRequest

Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.hibernate.HibernateModule;
 import io.jooby.hibernate.TransactionalRequest;
 
@@ -816,9 +816,9 @@ 
Copy to clipboard

+}
@@ -876,21 +876,21 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Transactional(false)
 @GET("/")
 public void get(Context ctx) {
   // no automatic transaction management here
-}

+}
@@ -900,21 +900,21 @@

TransactionalRequest disabled by default

Java
Kotlin
-
import io.jooby.ebean.TransactionalRequest;
+
import io.jooby.ebean.TransactionalRequest;
 
 {
   ...
   use(new TransactionalRequest().enabledByDefault(false));
   ...
-}

+}
@@ -924,7 +924,7 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Inject
 private EntityManager entityManager;
@@ -933,9 +933,9 @@ 

+}
@@ -954,19 +954,19 @@

Transactional for script routes

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     ...
   }).attribute(Transactional.ATTRIBUTE, false);
-}

+}
@@ -987,19 +987,19 @@

UnitOfWork

Java
Kotlin
-
{
+
{
   get("/pets", ctx -> require(UnitOfWork.class)
       .apply(em -> em.createQuery("from Pet", Pet.class).getResultList()));
-}

+}
@@ -1014,7 +1014,7 @@

Multiple transactions

Java
Kotlin
-
{
+
{
   get("/update", ctx -> require(UnitOfWork.class)
       .apply((em, txh) -> {
         em.createQuery("from Pet", Pet.class).getResultList().forEach(pet -> {
@@ -1023,9 +1023,9 @@ 

+}
@@ -1049,7 +1049,7 @@

-
{
+
{
   get("/nope", ctx -> require(UnitOfWork.class)
       .apply(em -> {
 
@@ -1058,7 +1058,7 @@ 

+}
@@ -1066,13 +1066,13 @@

-
{
+
{
   use(new TransactionalRequest());
 
   // will lead to exception
   get("/nope", ctx -> require(UnitOfWork.class)
       .apply(em -> em.createQuery("from Pet", Pet.class).getResultList()));
-}

+}

@@ -1103,7 +1103,7 @@

application.conf
-
hibernate.hbm2ddl.auto = create
+
hibernate.hbm2ddl.auto = create

@@ -1113,7 +1113,7 @@

HibernateConfigurer:
-
import io.jooby.hibernate.HibernateConfigurer;
+
import io.jooby.hibernate.HibernateConfigurer;
 
 public class MyConfigurer extends HibernateConfigurer {
   /**
@@ -1164,7 +1164,7 @@ 
Copy to clipboard

+}

@@ -1173,13 +1173,13 @@

SessionProvider
-
{
+
{
   install(new HibernateModule().with(builder -> {
     return builder
      .flushMode(AUTO)
      .openSession();
   }));
-}

+}

diff --git a/modules/hikari/index.html b/modules/hikari/index.html index fa82d83..9ea2222 100644 --- a/modules/hikari/index.html +++ b/modules/hikari/index.html @@ -597,13 +597,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -613,13 +613,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>${mysql-connector-java.version}</version>
-</dependency>

+</dependency>
@@ -628,9 +628,9 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = myuser
-db.password = mypass

+db.password = mypass

@@ -640,7 +640,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 
 {
   install(new HikariModule());
@@ -649,9 +649,9 @@ 

+}
@@ -675,17 +675,17 @@

Custom database prefix
Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 
 {
   install(new HikariModule("mydb"));
-}

+}
@@ -695,17 +695,17 @@

No properties

Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 
 {
   install(new HikariModule("jdbc:mysql://localhost/mydb"));
-}

+}
@@ -736,20 +736,20 @@

application.conf
-
maindb.url = "jdbc:mysql://localhost/main"
+
maindb.url = "jdbc:mysql://localhost/main"
 maindb.user = myuser
 maindb.password = mypass
 
 auditdb.url = "jdbc:mysql://localhost/audit"
 auditdb.user = myuser
-auditdb.password = mypass

+auditdb.password = mypass
Multiple data sources
Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 
 {
   install(new HikariModule("maindb"));
@@ -762,9 +762,9 @@ 

+}
@@ -788,10 +788,10 @@

Maximum Pool Size
-
db.url = "jdbc:mysql://localhost/main"
+
db.url = "jdbc:mysql://localhost/main"
 db.user = myuser
 
-hikari.maximumPoolSize = 10

+hikari.maximumPoolSize = 10
@@ -800,7 +800,7 @@

Maximum Pool Size
-
maindb.url = "jdbc:mysql://localhost/main"
+
maindb.url = "jdbc:mysql://localhost/main"
 maindb.user = myuser
 maindb.password = mypass
 
@@ -810,7 +810,7 @@ 
Copy to clipboard

+auditdb.hikari.maximumPoolSize = 15

diff --git a/modules/jackson/index.html b/modules/jackson/index.html index 19aeb1b..cb62e98 100644 --- a/modules/jackson/index.html +++ b/modules/jackson/index.html @@ -595,13 +595,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jackson</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

Java
Kotlin

-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   install(new JacksonModule());                     (1)
@@ -625,9 +625,9 @@ 
(3)
     ...
   });
-}

+}
@@ -670,7 +670,7 @@

Default object mapper

Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   install(new JacksonModule());
@@ -678,15 +678,15 @@ 
Copy to clipboard

+}
@@ -696,21 +696,21 @@

Custom ObjectMapper

Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   ObjectMapper mapper = new ObjectMapper();
 
   install(new JacksonModule(mapper));
-}

+}
@@ -720,17 +720,17 @@

XmlMapper

Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   install(new JacksonModule(new XmlMapper()));
-}

+}
@@ -740,19 +740,19 @@

XmlMapper

Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   install(new JacksonModule(new ObjectMapper()));
   install(new JacksonModule(new XmlMapper()));
-}

+}
@@ -765,17 +765,17 @@

Provisioning Modules
Java
Kotlin
-
import io.jooby.json.JacksonModule;
+
import io.jooby.json.JacksonModule;
 
 {
   install(new JacksonModule().module(MyModule.class);
-}

+}
diff --git a/modules/jasypt/index.html b/modules/jasypt/index.html index 4b6c079..0eea86a 100644 --- a/modules/jasypt/index.html +++ b/modules/jasypt/index.html @@ -599,13 +599,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jasypt</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -614,9 +614,9 @@

application.conf
-
jasypt.password = password                              (1)
+
jasypt.password = password                              (1)
 
-enc.property = "uTSqb9grs1+vUv3iN8lItC0kl65lMG+8"       (2)

+enc.property = "uTSqb9grs1+vUv3iN8lItC0kl65lMG+8"       (2)

@@ -626,7 +626,7 @@

Java
Kotlin

-
import io.jooby.jasypt.JasyptModule;
+
import io.jooby.jasypt.JasyptModule;
 
 {
   install(new JasyptModule());                          (3)
@@ -634,9 +634,9 @@ 
(4)
 
   System.out.println(property);
-}

+}
@@ -687,21 +687,21 @@

Java
Kotlin

-
import io.jooby.jasypt.JasyptModule;
+
import io.jooby.jasypt.JasyptModule;
 
 {
   install(new JasyptModule());
 
   PBEStringEncryptor encryptor = require(PBEStringEncryptor.class);
-}

+}
@@ -726,8 +726,8 @@

application.conf
-
jasypt.password = mypassword
-jasypt.password = ${?JASYPT_PASSWORD}
+
jasypt.password = mypassword
+jasypt.password = ${?JASYPT_PASSWORD}

@@ -740,11 +740,11 @@

File password provider
-
{
+
{
   install(new JasyptModule(config -> {
     return new String(Files.path(Paths.get("mypassword"), UTF-8));
   }));
-}

+}

@@ -759,14 +759,14 @@

application.conf
-
jasypt.password = mypassword
+
jasypt.password = mypassword
 
 jasypt.algorithm = PBEWithMD5AndDES
 jasypt.keyObtentionIterations = 1000
 jasypt.poolSize = 2
 jasypt.ivGeneratorClassName = classname
 jasypt.saltGeneratorClassName = org.jasypt.salt.RandomSaltGenerator
-jasypt.providerName = SunJCE

+jasypt.providerName = SunJCE

diff --git a/modules/jdbi/index.html b/modules/jdbi/index.html index cced662..a7490f3 100644 --- a/modules/jdbi/index.html +++ b/modules/jdbi/index.html @@ -600,7 +600,7 @@

Maven
Gradle

-
<!-- DataSource via HikariCP-->
+
<!-- DataSource via HikariCP-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
@@ -612,13 +612,13 @@ 

+</dependency>
@@ -628,13 +628,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>mysql</groupId>
   <artifactId>mysql-connector-java</artifactId>
   <version>${mysql-connector-java.version}</version>
-</dependency>

+</dependency>
@@ -643,9 +643,9 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = myuser
-db.password = mypass

+db.password = mypass

@@ -655,7 +655,7 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.jdbi.JdbiModule;
 
 {
@@ -671,9 +671,9 @@ 

+}
@@ -731,7 +731,7 @@

TransactionalRequest

Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.jdbi.JdbiModule;
 import io.jooby.jdbi.TransactionalRequest;
 
@@ -749,9 +749,9 @@ 
Copy to clipboard

+}
@@ -790,21 +790,21 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Transactional(false)
 @GET("/")
 public void get(Context ctx) {
   // no automatic transaction management here
-}

+}
@@ -814,21 +814,21 @@

TransactionalRequest disabled by default

Java
Kotlin
-
import io.jooby.ebean.TransactionalRequest;
+
import io.jooby.ebean.TransactionalRequest;
 
 {
   ...
   use(new TransactionalRequest().enabledByDefault(false));
   ...
-}

+}
@@ -838,7 +838,7 @@

@Transactional

Java
Kotlin
-
import io.jooby.annotation.Transactional;
+
import io.jooby.annotation.Transactional;
 
 @Inject
 private Handle handle;
@@ -847,9 +847,9 @@ 

+}
@@ -868,19 +868,19 @@

Transactional for script routes

Java
Kotlin
-
{
+
{
   get("/", ctx -> {
     ...
   }).attribute(Transactional.ATTRIBUTE, false);
-}

+}
@@ -894,7 +894,7 @@

SQLObjects
Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.jdbi.JdbiModule;
 import io.jooby.jdbi.TransactionalRequest;
 
@@ -911,9 +911,9 @@ 

+}
@@ -943,7 +943,7 @@

<
Custom Jdbi
Java
Kotlin
-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.jdbi.JdbiModule;
 import io.jooby.jdbi.TransactionalRequest;
 
@@ -954,9 +954,9 @@ 
<
     Jdbi jdbi = Jdbi.create(dataSource);
     return jdbi;
   });
-}

+}
diff --git a/modules/jstachio/index.html b/modules/jstachio/index.html index 6d6928b..03a92f0 100644 --- a/modules/jstachio/index.html +++ b/modules/jstachio/index.html @@ -597,20 +597,20 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jstachio</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
Maven
Gradle
-
<build>
+
<build>
     <plugins>
         <plugin>
             <groupId>org.apache.maven.plugins</groupId>
@@ -627,14 +627,14 @@ 
Copy to clipboard

+</build>
@@ -647,11 +647,11 @@

Java
Kotlin

-
@JStache(path="index.mustache")            (1)
-public record IndexPage(String message){}
+
@JStache(path="index.mustache")            (1)
+public record IndexPage(String message){}
@@ -668,7 +668,7 @@

src/main/resources/index.mustache
-
<p>Hello {{message}}!</p>
+
<p>Hello {{message}}!</p>

@@ -678,7 +678,7 @@

Java
Kotlin

-
import io.jooby.jstachio.JStachioModule;
+
import io.jooby.jstachio.JStachioModule;
 
 {
   install(new JStachioModule());              (1)
@@ -686,9 +686,9 @@ 
(2)
   });
-}

+}
@@ -721,17 +721,17 @@

Java
Kotlin

-
import io.jooby.jstachio.JStachioModule;
+
import io.jooby.jstachio.JStachioModule;
 
 {
   install(new JStachioModule().bufferSize(1024));
-}

+}
@@ -742,20 +742,20 @@

Maven
Gradle

-
<dependencies>
+
<dependencies>
     <dependency>
         <groupId>io.jstach</groupId>
         <artifactId>jstachio-jmustache</artifactId>
         <version>1.3.5</version>
         <scope>runtime</scope>
     </dependency>
-<dependencies>

+<dependencies>
diff --git a/modules/jte/index.html b/modules/jte/index.html index 37509e1..74bfb60 100644 --- a/modules/jte/index.html +++ b/modules/jte/index.html @@ -599,13 +599,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jte</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -615,7 +615,7 @@

Maven
Gradle

-
<plugin>
+
<plugin>
     <groupId>gg.jte</groupId>
     <artifactId>jte-maven-plugin</artifactId>
     <version>${jte.version}</version>
@@ -631,9 +631,9 @@ 

+</plugin>
@@ -665,9 +665,9 @@

src/main/jte/hello.jte
-
@param String name
+
@param String name
 
-<p>Hello ${name}!</p>

+<p>Hello ${name}!</p>

@@ -677,7 +677,7 @@

Java
Kotlin

-
import io.jooby.jte.JteModule;
+
import io.jooby.jte.JteModule;
 
 {
   install(new JteModule(Paths.of("src", "main", "jte")));         (1)
@@ -685,9 +685,9 @@ 
(2)
   });
-}

+}
@@ -737,7 +737,7 @@

Maven
Gradle

-
<plugin>
+
<plugin>
     <groupId>gg.jte</groupId>
     <artifactId>jte-maven-plugin</artifactId>
     <version>${jte.version}</version>
@@ -754,9 +754,9 @@ 
Copy to clipboard

+</plugin>
diff --git a/modules/jwt-session-store/index.html b/modules/jwt-session-store/index.html index eefda1f..3923a9d 100644 --- a/modules/jwt-session-store/index.html +++ b/modules/jwt-session-store/index.html @@ -587,20 +587,20 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-jwt</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
JWT Session
Java
Kotlin
-
import io.jooby.session.JwtSessionStore;
+
import io.jooby.session.JwtSessionStore;
 
 {
   String secret = "super secret key";           (1)
@@ -614,9 +614,9 @@ 

+}
diff --git a/modules/kafka/index.html b/modules/kafka/index.html index 21360dd..d46cfe6 100644 --- a/modules/kafka/index.html +++ b/modules/kafka/index.html @@ -593,13 +593,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-kafka</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -608,13 +608,13 @@

application.conf
-
kafka.producer.bootstrap.servers = "localhost:9092"
+
kafka.producer.bootstrap.servers = "localhost:9092"
 kafka.producer.key.serializer = "org.apache.kafka.common.serialization.StringSerializer"
 kafka.producer.value.serializer = "org.apache.kafka.common.serialization.StringSerializer"
 
 kafka.consumer.bootstrap.servers = "localhost:9092"
 kafka.consumer.key.deserializer = "org.apache.kafka.common.serialization.StringDeserializer"
-kafka.consumer.value.deserializer = "org.apache.kafka.common.serialization.StringDeserializer"

+kafka.consumer.value.deserializer = "org.apache.kafka.common.serialization.StringDeserializer"

@@ -624,7 +624,7 @@

Java
Kotlin

-
import io.jooby.kafka.KafkaModule;
+
import io.jooby.kafka.KafkaModule;
 
 {
   install(new KafkaModule());                              (1)
@@ -638,9 +638,9 @@ 

+}
diff --git a/modules/metrics/index.html b/modules/metrics/index.html index 5abee09..443fea3 100644 --- a/modules/metrics/index.html +++ b/modules/metrics/index.html @@ -601,15 +601,15 @@

Maven
Gradle

-
<!-- Metrics Module-->
+
<!-- Metrics Module-->
 <dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-metrics</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -619,7 +619,7 @@

Java
Kotlin

-
{
+
{
   install(new MetricsModule()
       .threadDump()
       .ping()
@@ -628,9 +628,9 @@ 

+}
@@ -655,21 +655,21 @@

Java
Kotlin

-
{
+
{
   install(new MetricsModule()
       .metric("memory", new MemoryUsageGaugeSet())
       .metric("threads", new ThreadStatesGaugeSet())
       .metric("gc", new GarbageCollectorMetricSet())
       .metric("fs", new FileDescriptorRatioGauge()));
-}

+}
@@ -689,15 +689,15 @@

<
Java
Kotlin
-
{
+
{
   install(new MetricsModule()
       .healthCheck("deadlock", new ThreadDeadlockHealthCheck());
-}

+}

@@ -711,19 +711,19 @@

Java
Kotlin
-
{
+
{
   use(new MetricsModule());
 
   // inspected route
   get("/", context -> "Hello metrics!");
-}

+}
@@ -736,15 +736,15 @@

<
Java
Kotlin
-
{
+
{
   install(new MetricsModule()
       .threadDump();
-}

+}
@@ -757,7 +757,7 @@

Java
Kotlin
-
{
+
{
   install(new MetricsModule()
       .reporter(registry -> {
         ConsoleReporter reporter = ConsoleReporter.forRegistry(registry)
@@ -767,9 +767,9 @@ 

+}
@@ -796,7 +796,7 @@

Java
Kotlin

-
{
+
{
   MetricRegistry metricRegistry = new MetricRegistry();
   HealthCheckRegistry healthCheckRegistry = new HealthCheckRegistry();
 
@@ -805,9 +805,9 @@ 
Copy to clipboard

+}
@@ -830,15 +830,15 @@

Java
Kotlin
-
{
+
{
   install(new MetricsModule("/diag")
       .threadDump();
-}

+}
diff --git a/modules/node/index.html b/modules/node/index.html index dd18c70..38d764e 100644 --- a/modules/node/index.html +++ b/modules/node/index.html @@ -605,13 +605,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-node</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -620,13 +620,13 @@

package.json
-
{
+
{
   "name": "myapp",
   "version": "1.0.0",
   "scripts": {
     "build": "echo \"Default task\""         (1)
   }
-}

+}

@@ -636,17 +636,17 @@

Java
Kotlin

-
import io.jooby.node.NpmModule;
+
import io.jooby.node.NpmModule;
 
 {
   install(new NpmModule("v12.16.1"));        (2)
-}

+}
@@ -698,21 +698,21 @@

Java
Kotlin

-
import io.jooby.node.NpmModule;
+
import io.jooby.node.NpmModule;
 
 {
   install(new NpmModule("v12.16.1")
     .execute("run", "local")                 (1)
   );
-}

+}
@@ -805,7 +805,7 @@

pom.xml
-
<build>
+
<build>
   <plugins>
     ...
     <plugin>
@@ -853,7 +853,7 @@ 
Copy to clipboard

+</build>

diff --git a/modules/openapi/index.html b/modules/openapi/index.html index a879107..635e29c 100644 --- a/modules/openapi/index.html +++ b/modules/openapi/index.html @@ -620,7 +620,7 @@

<
pom.xml
build.gradle
-
<properties>
+
<properties>
   <application.class>myapp.App</application.class>
 </properties>
 ...
@@ -638,9 +638,9 @@ 
<
       </execution>
     </executions>
   </plugin>
-</plugins>

+</plugins>

@@ -691,7 +691,7 @@

Java
Kotlin

-
{
+
{
   install(new OpenAPIModule());        (1)
 
   path("/pets", () {                   (2)
@@ -702,9 +702,9 @@ 
Copy to clipboard

+}
@@ -797,7 +797,7 @@

Java
Kotlin

-
{
+
{
   install(new OpenAPIModule());
 
   mvc(new Pets());
@@ -811,9 +811,9 @@ 
Copy to clipboard

+}
@@ -845,13 +845,13 @@

<
Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.swagger.core.v3</groupId>
   <artifactId>swagger-annotations</artifactId>
   <version>2.2.22</version>
-</dependency>

+</dependency>

@@ -861,7 +861,7 @@

<
Script
Java
Kotlin
-
import io.swagger.v3.oas.annotations.Operation;
+
import io.swagger.v3.oas.annotations.Operation;
 ...
 
 public class App extends Jooby {
@@ -882,9 +882,9 @@ 
<
     long id = ctx.path("id").longValue();
     return repo.find(id);
   }
-}

+}

@@ -944,7 +944,7 @@

OpenAPIDefinition

Java
Kotlin
-
@OpenAPIDefinition(
+
@OpenAPIDefinition(
     info = @Info(
         title = "Title",
         description = "description",
@@ -966,9 +966,9 @@ 
Copy to clipboard

+}
@@ -1000,49 +1000,49 @@

Application level
Java
Kotlin
-
@Tag(name = "Pets", description = "Pet operations")
+
@Tag(name = "Pets", description = "Pet operations")
 class App extends Jooby {
   {
     // All routes now have the default tag: `Pets`
   }
-}

+}
Controller level
Java
Kotlin
-
@Tag(name = "Pets", description = "Pet operations")
+
@Tag(name = "Pets", description = "Pet operations")
 @Path("/pets")
 class Pets {
   // All web method now have the default tag: `Pets`
-}

+}
Method level
Java
Kotlin
-
@Tag(name = "Pets", description = "Pet operations")
+
@Tag(name = "Pets", description = "Pet operations")
 public List<Pet> list(Context ctx) {
   ...
-}

+}
@@ -1111,7 +1111,7 @@

conf/openapi.yaml
-
openapi: 3.0.1
+
openapi: 3.0.1
 info:
   title: My Super API
   description: |
@@ -1122,7 +1122,7 @@ 

+    url: http://www.apache.org/licenses/LICENSE-2.0.html

@@ -1152,13 +1152,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-swagger-ui</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -1174,13 +1174,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-redoc</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
diff --git a/modules/pac4j/index.html b/modules/pac4j/index.html index 27e4c88..690fdce 100644 --- a/modules/pac4j/index.html +++ b/modules/pac4j/index.html @@ -604,13 +604,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-pac4j</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -620,7 +620,7 @@

Simple login form

Java
Kotlin
-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 
 {
   install(new Pac4jModule());           (1)
@@ -629,9 +629,9 @@ 
(2)
     return "Hello " + user.getId();
   });
-}

+}
@@ -676,13 +676,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>org.pac4j</groupId>
   <artifactId>pac4j-oidc</artifactId>
   <version>5.7.0</version>
-</dependency>

+</dependency>
@@ -691,8 +691,8 @@

application.conf
-
oidc.clientId = 167480702619-8e1lo80dnu8bpk3k0lvvj27noin97vu9.apps.googleusercontent.com
-oidc.secret = MhMme_Ik6IH2JMnAT6MFIfee
+
oidc.clientId = 167480702619-8e1lo80dnu8bpk3k0lvvj27noin97vu9.apps.googleusercontent.com
+oidc.secret = MhMme_Ik6IH2JMnAT6MFIfee

@@ -702,7 +702,7 @@

Google

Java
Kotlin
-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 
 {
   install(new Pac4jModule()
@@ -720,9 +720,9 @@ 

+}
@@ -755,13 +755,13 @@

<
Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>org.pac4j</groupId>
   <artifactId>pac4j-oauth</artifactId>
   <version>5.7.0</version>
-</dependency>

+</dependency>
@@ -770,8 +770,8 @@

<
application.conf
-
twitter.key = CoxUiYwQOSFDReZYdjigBA
-twitter.secret = 2kAzunH5Btc4gRSaMr7D7MkyoJ5u1VzbOOzE8rBofs
+
twitter.key = CoxUiYwQOSFDReZYdjigBA
+twitter.secret = 2kAzunH5Btc4gRSaMr7D7MkyoJ5u1VzbOOzE8rBofs
@@ -781,7 +781,7 @@

<
Twitter
Java
Kotlin
-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 
 {
   install(new Pac4jModule()
@@ -794,9 +794,9 @@ 
<
     UserProfile user = ctx.getUser();
     return "Hello " + user.getId();
   });
-}

+}

@@ -824,13 +824,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>org.pac4j</groupId>
   <artifactId>pac4j-jwt</artifactId>
   <version>5.7.0</version>
-</dependency>

+</dependency>
@@ -839,7 +839,7 @@

application.conf
-
jwt.salt = CoxUiYwQOSFDReZYdjigBA
+
jwt.salt = CoxUiYwQOSFDReZYdjigBA

@@ -849,7 +849,7 @@

JWT

Java
Kotlin
-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 
 {
   install(new Pac4jModule()
@@ -866,9 +866,9 @@ 

+}
@@ -899,7 +899,7 @@

<
Java
Kotlin
-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 
 {
   install(new Pac4jModule()
@@ -907,9 +907,9 @@ 
<
       return ...;
     })
   );
-}

+}
@@ -932,7 +932,7 @@

Manual configuration
-
import org.pac4j.core.config.Config;
+
import org.pac4j.core.config.Config;
 {
 
   Config pac4j = new Config();
@@ -947,31 +947,31 @@ 

+}

Automatic configuration
-
{
+
{
 
   install(
       new Pac4jModule()
           .client("/api/*", new MyTestAuthorizer(), conf -> {...});
   );
-}

+}
Registry (or dependency injection) integration
-
{
+
{
 
   install(
       new Pac4jModule()
           .client("/api/*", MyTestAuthorizer.class, conf -> {...});
   );
-}

+}
@@ -988,7 +988,7 @@

Java
Kotlin

-
import io.jooby.pac4j.Pac4jModule;
+
import io.jooby.pac4j.Pac4jModule;
 import org.pac4j.core.config.Config;
 
 {
@@ -996,9 +996,9 @@ 

+}
diff --git a/modules/pebble/index.html b/modules/pebble/index.html index 00a256a..de8601b 100644 --- a/modules/pebble/index.html +++ b/modules/pebble/index.html @@ -596,13 +596,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-pebble</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

views/index.peb
-
<p> Hello {{name}}! </p>
+
<p> Hello {{name}}! </p>

@@ -621,7 +621,7 @@

Java
Kotlin

-
import io.jooby.pebble.PebbleModule;
+
import io.jooby.pebble.PebbleModule;
 
 {
   install(new PebbleModule());
@@ -630,9 +630,9 @@ 

+}
@@ -674,7 +674,7 @@

Java
Kotlin

-
import io.jooby.pebble.PebbleModule;
+
import io.jooby.pebble.PebbleModule;
 
 {
   // Apply custom configuration via builder
@@ -684,9 +684,9 @@ 
Copy to clipboard

+}
diff --git a/modules/quartz/index.html b/modules/quartz/index.html index 210d9f5..cc946d9 100644 --- a/modules/quartz/index.html +++ b/modules/quartz/index.html @@ -606,13 +606,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-quartz</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -622,17 +622,17 @@

Java
Kotlin

-
import io.jooby.quartz.QuartzModule;
+
import io.jooby.quartz.QuartzModule;
 
 {
   install(new QuartzModule(SampleJob.class));
-}

+}
@@ -642,7 +642,7 @@

Java
Kotlin

-
import io.quartz.Scheduled;
+
import io.quartz.Scheduled;
 
 import org.quartz.Job;
 
@@ -652,9 +652,9 @@ 

+}
@@ -691,7 +691,7 @@

Without Job interface

Java
Kotlin
-
import io.quartz.Scheduled;
+
import io.quartz.Scheduled;
 
 public class SampleJob {
 
@@ -699,9 +699,9 @@ 

+}
@@ -729,7 +729,7 @@

Job Group

Java
Kotlin
-
import io.quartz.Scheduled;
+
import io.quartz.Scheduled;
 
 public class SampleJob {
 
@@ -742,9 +742,9 @@ 

+}
@@ -797,7 +797,7 @@

Custom Job Factory
-
{
+
{
 
   Scheduler scheduler = QuartzModule.newScheduler(this);
 
@@ -809,7 +809,7 @@ 
Copy to clipboard

+}

@@ -818,7 +818,7 @@

Guice provisioning
-
import jakarta.inject.Inject;
+
import jakarta.inject.Inject;
 
 {
   install(new GuiceModule());
@@ -832,7 +832,7 @@ 
Copy to clipboard

+}

@@ -895,13 +895,13 @@

Maven
Gradle
-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-hikari</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -911,23 +911,23 @@

Java
Kotlin

-
import io.jooby.hikari.HikariModule;
+
import io.jooby.hikari.HikariModule;
 import io.jooby.quartz.QuartzModule;
 
 {
   install(new HikariModule());
 
   install(new QuartzModule(SampleJob.class));
-}

+}
@@ -936,11 +936,11 @@

application.conf
-
db.url = "jdbc:mysql://localhost/mydb"
+
db.url = "jdbc:mysql://localhost/mydb"
 db.user = "myuser"
 db.password = "mypassword"
 
-org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX

+org.quartz.jobStore.class = org.quartz.impl.jdbcjobstore.JobStoreTX

@@ -953,8 +953,8 @@

Thread Pool
-
# Set number of threads to use, default is to use the number of available processor
-org.quartz.threadPool.threadCount = 2
+
# Set number of threads to use, default is to use the number of available processor
+org.quartz.threadPool.threadCount = 2
@@ -966,14 +966,14 @@

Custom Scheduler
-
{
+
{
 
   Scheduler scheduler = QuartzModule.newScheduler(this);
   // configure scheduler as you need it
 
   install(new QuartzModule(scheduler, SampleJob.class));
 
-}

+}

@@ -985,7 +985,7 @@

Pausing Job at startup time
-
org.quartz.jobs.SampleJob.execute.enabled = false
+
org.quartz.jobs.SampleJob.execute.enabled = false

@@ -1002,23 +1002,23 @@

Quartz API

Java
Kotlin
-
import io.jooby.quartz.QuartzApp
+
import io.jooby.quartz.QuartzApp
 import io.jooby.quartz.QuartzModule;
 
 {
   install(new QuartzModule(SampleJob.class));
 
   use("/scheduler", new QuartzApp());
-}

+}
diff --git a/modules/redis/index.html b/modules/redis/index.html index 299f5d4..028d78f 100644 --- a/modules/redis/index.html +++ b/modules/redis/index.html @@ -596,13 +596,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-redis</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

application.conf
-
redis = "redis://localhost:6379"
+
redis = "redis://localhost:6379"

@@ -621,7 +621,7 @@

Java
Kotlin

-
import io.jooby.redis.RedisModule;
+
import io.jooby.redis.RedisModule;
 import io.lettuce.core.api.StatefulRedisConnection;
 
 {
@@ -631,9 +631,9 @@ 
(2)
     // work with redis
   });
-}

+}
@@ -698,7 +698,7 @@

Java
Kotlin

-
import io.jooby.redis.RedisModule;
+
import io.jooby.redis.RedisModule;
 import io.lettuce.core.api.StatefulRedisConnection;
 
 {
@@ -710,9 +710,9 @@ 

+}
@@ -733,9 +733,9 @@

application.conf
-
foo = "redis://server1:6379"
+
foo = "redis://server1:6379"
 
-bar = "redis://server2:6379"

+bar = "redis://server2:6379"

@@ -748,7 +748,7 @@

Usage
Java
Kotlin
-
import io.jooby.redis.RedisModule;
+
import io.jooby.redis.RedisModule;
 import io.jooby.redis.RedisSessionStore;
 
 import io.lettuce.core.RedisClient;
@@ -762,9 +762,9 @@ 
(3)
     // HTTP session is backed by Redis
   });
-}

+}
diff --git a/modules/rocker/index.html b/modules/rocker/index.html index b41d85b..01164e0 100644 --- a/modules/rocker/index.html +++ b/modules/rocker/index.html @@ -595,13 +595,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-rocker</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,7 +611,7 @@

Maven
Gradle

-
<plugin>
+
<plugin>
     <groupId>com.fizzed</groupId>
     <artifactId>rocker-maven-plugin</artifactId>
     <version>1.4.0</version>
@@ -627,9 +627,9 @@ 

+</plugin>
@@ -660,9 +660,9 @@

src/rocker/views/index.rocker.html
-
@args (String message)
+
@args (String message)
 
-<p>Hello @message!</p>

+<p>Hello @message!</p>

@@ -672,7 +672,7 @@

Java
Kotlin

-
import io.jooby.rocker.RockerModule;
+
import io.jooby.rocker.RockerModule;
 
 {
   install(new RockerModule());              (1)
@@ -680,9 +680,9 @@ 
(2)
   });
-}

+}
@@ -715,17 +715,17 @@

Java
Kotlin

-
import io.jooby.rocker.RockerModule;
+
import io.jooby.rocker.RockerModule;
 
 {
   install(new RockerModule().bufferSize(1024));
-}

+}
@@ -735,17 +735,17 @@

Java
Kotlin

-
import io.jooby.rocker.RockerModule;
+
import io.jooby.rocker.RockerModule;
 
 {
   install(new RockerModule().reuseBuffer(true));
-}

+}
diff --git a/modules/thymeleaf/index.html b/modules/thymeleaf/index.html index c6b236e..4f99cf2 100644 --- a/modules/thymeleaf/index.html +++ b/modules/thymeleaf/index.html @@ -596,13 +596,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-thymeleaf</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -611,14 +611,14 @@

views/index.html
-
<!DOCTYPE html>
+
<!DOCTYPE html>
 <html xmlns:th="http://www.thymeleaf.org">
 <body>
 <p>
   Hello <span th:text="${name}">World</span>
 </p>
 </body>
-</html>

+</html>

@@ -628,7 +628,7 @@

Java
Kotlin

-
import io.jooby.thymeleaf.ThymeleafModule;
+
import io.jooby.thymeleaf.ThymeleafModule;
 
 {
   install(new ThymeleafModule());
@@ -637,9 +637,9 @@ 

+}
@@ -682,23 +682,23 @@

Java
Kotlin

-
import io.jooby.thymeleaf.ThymeleafModule;
+
import io.jooby.thymeleaf.ThymeleafModule;
 
 {
   TemplateEngine templateEngine = new TemplateEngine();
   // configure as need it
 
   install(new ThymeleafModule(templateEngine));
-}

+}
diff --git a/modules/whoops/index.html b/modules/whoops/index.html index 84fd11c..0173e87 100644 --- a/modules/whoops/index.html +++ b/modules/whoops/index.html @@ -598,13 +598,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-whoops</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -614,7 +614,7 @@

Java
Kotlin

-
import io.jooby.whoops.WhoopsModule;
+
import io.jooby.whoops.WhoopsModule;
 
 {
   install(new WhoopsModule());                      (1)
@@ -622,9 +622,9 @@ 
(2)
   });
-}

+}
diff --git a/modules/yasson/index.html b/modules/yasson/index.html index 61181c0..db25193 100644 --- a/modules/yasson/index.html +++ b/modules/yasson/index.html @@ -594,13 +594,13 @@

Maven
Gradle

-
<dependency>
+
<dependency>
   <groupId>io.jooby</groupId>
   <artifactId>jooby-yasson</artifactId>
   <version>3.2.0</version>
-</dependency>

+</dependency>
@@ -610,7 +610,7 @@

Java
Kotlin

-
import io.jooby.json.YassonModule;
+
import io.jooby.json.YassonModule;
 
 {
   install(new YassonModule());                        (1)
@@ -624,9 +624,9 @@ 
(3)
     ...
   });
-}

+}
@@ -669,7 +669,7 @@

Default object mapper

Java
Kotlin
-
import io.jooby.json.YassonModule;
+
import io.jooby.json.YassonModule;
 
 {
   install(new YassonModule());
@@ -677,15 +677,15 @@ 
Copy to clipboard

+}
@@ -695,21 +695,21 @@

Custom ObjectMapper

Java
Kotlin
-
import io.jooby.json.YassonModule;
+
import io.jooby.json.YassonModule;
 
 {
   Jsonb jsonb = JsonbBuilder.create();
 
   install(new YassonModule(jsonb));
-}

+}
diff --git a/packaging/index.html b/packaging/index.html index 73cf689..95099e4 100644 --- a/packaging/index.html +++ b/packaging/index.html @@ -610,7 +610,7 @@

Maven
Gradle
-
<build>
+
<build>
   <plugins>
     ...
     <plugin>
@@ -637,9 +637,9 @@ 

+</build>
@@ -697,7 +697,7 @@

stork.yml
-
# Name of application (make sure it has no spaces)
+
# Name of application (make sure it has no spaces)
 name: "${project.artifactId}"
 
 # Display name of application (can have spaces)
@@ -737,7 +737,7 @@ 

+symlink_java: true

@@ -746,7 +746,7 @@

Maven
-
<build>
+
<build>
   <plugins>
     <plugin>
         <groupId>io.repaint.maven</groupId>
@@ -760,7 +760,7 @@ 

+</build>

diff --git a/usage/index.html b/usage/index.html index ec8c130..0bb0335 100644 --- a/usage/index.html +++ b/usage/index.html @@ -621,7 +621,7 @@

Java
Kotlin

-
  <build>
+
  <build>
     <plugins>
       <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
@@ -637,9 +637,9 @@ 
Copy to clipboard

+  </build>
@@ -729,11 +729,11 @@

Java
Kotlin

-
dependencies {
+
dependencies {
   annotationProcessor "io.jooby:jooby-apt:3.2.0"
-}

+}
@@ -834,7 +834,7 @@

Java
Kotlin

-
  <build>
+
  <build>
     <plugins>
       <plugin>
         <artifactId>maven-compiler-plugin</artifactId>
@@ -847,9 +847,9 @@ 
Copy to clipboard

+  </build>
@@ -875,14 +875,14 @@

Java
Kotlin

-
tasks.withType(JavaCompile) {
+
tasks.withType(JavaCompile) {
   options.compilerArgs << '-parameters'
   options.debug = true
-}

+}