diff --git a/index.html b/index.html index 1cf6623..f025e69 100644 --- a/index.html +++ b/index.html @@ -570,7 +570,7 @@

Welcome to Jooby!

by Edgar Espina
-3.0.8 +3.0.10
Table of Contents
@@ -930,7 +930,7 @@

Welcome!!

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

+}
@@ -960,7 +960,7 @@

-

Latest Release: 3.0.8.

+

Latest Release: 3.0.10.

Looking for a previous version?

@@ -1026,7 +1026,7 @@

Script with sub-class:

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

+}

@@ -1064,7 +1064,7 @@

Script without subclass:

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

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

MVC API:

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

+}
@@ -1187,7 +1187,7 @@

@@ -1247,7 +1247,7 @@

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

+jooby>

@@ -1270,13 +1270,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
@@ -1294,13 +1294,13 @@

Maven
Gradle

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

+  <version>3.0.10</version>
+</dependency>
@@ -1310,13 +1310,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
@@ -1329,7 +1329,7 @@

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

@@ -1338,7 +1338,7 @@

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

@@ -1348,7 +1348,7 @@

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

@@ -1357,7 +1357,7 @@

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

@@ -1366,7 +1366,7 @@

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

@@ -1379,13 +1379,13 @@

Snippet

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

+}
@@ -1422,7 +1422,7 @@

Routes:

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

+}
@@ -1488,16 +1488,16 @@

Java
Kotlin

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

+}
@@ -1508,7 +1508,7 @@

Java
Kotlin

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

+}
@@ -1541,7 +1541,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();
@@ -1561,9 +1561,9 @@ 

+}
@@ -1603,13 +1603,13 @@

Java
Koltin

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

+}
@@ -1619,21 +1619,21 @@

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

+}
@@ -1652,23 +1652,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;
   });
-}

+}
@@ -1691,21 +1691,21 @@

Optional path variable:

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

+}
@@ -1740,21 +1740,21 @@

Regex path variable:

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

+}
@@ -1789,7 +1789,7 @@

catchall

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

+}
@@ -1879,7 +1879,7 @@

Java
Kotlin

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

+}
@@ -1938,16 +1938,16 @@

<

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

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

+}
@@ -2033,16 +2033,16 @@

<

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

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

+}
@@ -2080,16 +2080,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)
@@ -2098,9 +2098,9 @@ 

+}
@@ -2134,7 +2134,7 @@

Side-Effect Handler:

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

+}
@@ -2182,7 +2182,7 @@

Safe After:

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

+}
@@ -2226,7 +2226,7 @@

Run code depending of success or failure responses:

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

+}
@@ -2254,21 +2254,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)
     }
   });
-}

+}
@@ -2289,7 +2289,7 @@

Suppressed exceptions:

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

+}
@@ -2351,7 +2351,7 @@

Example

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

+}
@@ -2398,7 +2398,7 @@

Java
Kotlin

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

+}
@@ -2455,7 +2455,7 @@

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

+}
@@ -2497,13 +2497,13 @@

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

+}

@@ -2528,7 +2528,7 @@

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

+}

@@ -2594,7 +2594,7 @@

Scoped filter:

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

+}

@@ -2669,15 +2669,15 @@

Route operator

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

+}
@@ -2699,7 +2699,7 @@

Routes with path prefix:

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

+}
@@ -2762,7 +2762,7 @@

Composing

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

+}
@@ -2825,7 +2825,7 @@

Composing with path prefix

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

+}
@@ -2873,7 +2873,7 @@

Installing

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

+}
@@ -2935,10 +2935,10 @@

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

+}

@@ -2947,9 +2947,9 @@

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

+}

@@ -2967,7 +2967,7 @@

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

+}
@@ -3038,16 +3038,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;
 ...
 {
 
@@ -3056,9 +3056,9 @@ 
(2)
 
   });
-}

+}
@@ -3089,18 +3089,18 @@

HTTP Header

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

+}
@@ -3121,7 +3121,7 @@

Usage

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

+}
@@ -3208,13 +3208,13 @@

Java
Kotlin

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

+}
@@ -3225,13 +3225,13 @@

Java
Kotlin

-
{
+
{
   setContextAsService(true);
-}

+}
@@ -3258,7 +3258,7 @@

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

@@ -3269,13 +3269,13 @@

Java
Kotlin

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

+}
@@ -3306,7 +3306,7 @@

Java
Kotlin

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

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

+}
@@ -3401,7 +3401,7 @@

Syntax:

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

+}
@@ -3454,7 +3454,7 @@

Java
Kotlin

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

+}
@@ -3565,7 +3565,7 @@

Java
Kotlin

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

+}
@@ -3711,7 +3711,7 @@

Java
Kotlin

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

+}
@@ -3797,7 +3797,7 @@

Java
Kotlin

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

+}
@@ -3899,17 +3899,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)
@@ -3943,13 +3943,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)
@@ -3975,23 +3975,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)
-  });

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

Java
Kotlin

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

+}
@@ -4044,7 +4044,7 @@

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

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

Java
Kotlin

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

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

Java
Kotlin

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

+}
@@ -4260,7 +4260,7 @@

Java
Kotlin

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

+}
@@ -4337,7 +4337,7 @@

Java
Kotlin

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

+}
@@ -4432,7 +4432,7 @@

Traversal

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

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

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

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

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

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

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

+}
@@ -4718,7 +4718,7 @@

Java
Kotlin

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

+}
@@ -4779,10 +4779,10 @@

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

+}

@@ -4793,7 +4793,7 @@

JSON example:

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

+}
@@ -4862,13 +4862,13 @@

Maven
Gradle

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

+  <version>3.0.10</version>
+</dependency>
@@ -4886,7 +4886,7 @@

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

+}
@@ -4938,10 +4938,10 @@

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

+}

@@ -4952,7 +4952,7 @@

JSON example:

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

+}
@@ -5031,13 +5031,13 @@

Maven
Gradle

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

+  <version>3.0.10</version>
+</dependency>
@@ -5067,20 +5067,20 @@

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

+}
@@ -5108,7 +5108,7 @@

MVC API:

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

+}
@@ -5189,7 +5189,7 @@

Simple MVC route registration

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

+}
@@ -5216,7 +5216,7 @@

Class MVC route registration

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

+}
@@ -5257,7 +5257,7 @@

Provider MVC route registration

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

+}
@@ -5306,21 +5306,21 @@

Headers

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

+}
@@ -5339,21 +5339,21 @@

Non valid Java name

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

+}
@@ -5366,21 +5366,21 @@