diff --git a/index.html b/index.html index 1743eb5..c7799db 100644 --- a/index.html +++ b/index.html @@ -570,7 +570,7 @@

Welcome to Jooby!

by Edgar Espina
-3.1.3 +3.2.0
Table of Contents
@@ -932,7 +932,7 @@

Welcome!!

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

+}
@@ -962,7 +962,7 @@

-

Latest Release: 3.1.3.

+

Latest Release: 3.2.0.

Looking for a previous version?

@@ -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 @@ 

+}
@@ -1189,7 +1189,7 @@

@@ -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.1.3</version>
-</dependency>

+  <version>3.2.0</version>
+</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.1.3</version>
-</dependency>

+  <version>3.2.0</version>
+</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.1.3</version>
-</dependency>

+  <version>3.2.0</version>
+</dependency>
@@ -5069,20 +5069,20 @@

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

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

MVC API:

Java
Kotlin
-
import io.jooby.annotation.*;
+
import io.jooby.annotation.*;
 
 @Path("/mvc")                  (1)
 public class Controller {
@@ -5130,9 +5130,9 @@ 
Copy to clipboard

+}
@@ -5191,7 +5191,7 @@

Simple MVC route registration

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

+}
@@ -5218,7 +5218,7 @@

Class MVC route registration

Java
Kotlin
-
public class App extends Jooby {
+
public class App extends Jooby {
   {
     mvc(MyController.class);
   }
@@ -5226,15 +5226,15 @@ 

+}
@@ -5259,7 +5259,7 @@

Provider MVC route registration

Java
Kotlin
-
import jakarta.inject.Provider;
+
import jakarta.inject.Provider;
 
 public class App extends Jooby {
   {
@@ -5271,9 +5271,9 @@ 

+}
@@ -5308,21 +5308,21 @@

Headers

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

+}
@@ -5341,21 +5341,21 @@

Non valid Java name

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

+}
@@ -5368,21 +5368,21 @@