diff --git a/index.html b/index.html index c4f1364..5e7e793 100644 --- a/index.html +++ b/index.html @@ -7,7 +7,7 @@ - + jooby: do more! more easily!! @@ -569,7 +569,7 @@
@@ -963,7 +980,7 @@

-

Latest Release: 3.4.1.

+

Latest Release: 3.4.2.

Looking for a previous version?

@@ -1029,7 +1046,7 @@

Script with sub-class:

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

+}

@@ -1067,7 +1084,7 @@

Script without subclass:

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

+}
@@ -1106,7 +1123,7 @@

MVC API:

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

+}
@@ -1190,7 +1207,7 @@

@@ -1250,7 +1267,7 @@

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

+jooby>

@@ -1273,13 +1290,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
@@ -1297,13 +1314,13 @@

Maven
Gradle

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

+  <version>3.4.2</version>
+</dependency>
@@ -1313,13 +1330,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
@@ -1332,7 +1349,7 @@

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

@@ -1341,7 +1358,7 @@

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

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

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

@@ -1360,7 +1377,7 @@

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

@@ -1369,7 +1386,7 @@

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

@@ -1382,13 +1399,13 @@

Snippet

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

+}
@@ -1425,7 +1442,7 @@

Routes:

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

+}
@@ -1491,16 +1508,16 @@

Java
Kotlin

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

+}
@@ -1511,7 +1528,7 @@

Java
Kotlin

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

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

+}
@@ -1606,13 +1623,13 @@

Java
Koltin

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

+}
@@ -1622,21 +1639,21 @@

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

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

+}
@@ -1694,21 +1711,21 @@

Optional path variable:

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

+}
@@ -1743,21 +1760,21 @@

Regex path variable:

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

+}
@@ -1792,7 +1809,7 @@

catchall

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

+}
@@ -1882,7 +1899,7 @@

Java
Kotlin

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

+}
@@ -1941,16 +1958,16 @@

<

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

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

+}
@@ -2036,16 +2053,16 @@

<

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

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

+}
@@ -2083,16 +2100,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)
@@ -2101,9 +2118,9 @@ 

+}
@@ -2137,7 +2154,7 @@

Side-Effect Handler:

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

+}
@@ -2185,7 +2202,7 @@

Safe After:

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

+}
@@ -2229,7 +2246,7 @@

Run code depending of success or failure responses:

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

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

+}
@@ -2292,7 +2309,7 @@

Suppressed exceptions:

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

+}
@@ -2354,7 +2371,7 @@

Example

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

+}
@@ -2401,7 +2418,7 @@

Java
Kotlin

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

+}
@@ -2458,7 +2475,7 @@

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

+}
@@ -2500,13 +2517,13 @@

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

+}

@@ -2531,7 +2548,7 @@

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

+}

@@ -2597,7 +2614,7 @@

Scoped filter:

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

+}

@@ -2672,15 +2689,15 @@

Route operator

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

+}
@@ -2702,7 +2719,7 @@

Routes with path prefix:

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

+}
@@ -2765,7 +2782,7 @@

Composing

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

+}
@@ -2828,7 +2845,7 @@

Composing with path prefix

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

+}
@@ -2876,7 +2893,7 @@

Installing

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

+}
@@ -2938,10 +2955,10 @@

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

+}

@@ -2950,9 +2967,9 @@

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

+}

@@ -2970,7 +2987,7 @@

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

+}
@@ -3041,16 +3058,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;
 ...
 {
 
@@ -3059,9 +3076,9 @@ 
(2)
 
   });
-}

+}
@@ -3092,18 +3109,18 @@

HTTP Header

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

+}
@@ -3124,7 +3141,7 @@

Usage

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

+}
@@ -3211,13 +3228,13 @@

Java
Kotlin

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

+}
@@ -3228,13 +3245,13 @@

Java
Kotlin

-
{
+
{
   setContextAsService(true);
-}

+}
@@ -3261,7 +3278,7 @@

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

@@ -3272,13 +3289,13 @@

Java
Kotlin

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

+}
@@ -3309,7 +3326,7 @@

Java
Kotlin

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

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

+}
@@ -3404,7 +3421,7 @@

Syntax:

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

+}
@@ -3457,7 +3474,7 @@

Java
Kotlin

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

+}
@@ -3568,7 +3585,7 @@

Java
Kotlin

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

+}
@@ -3714,7 +3731,7 @@

Java
Kotlin

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

+}
@@ -3800,7 +3817,7 @@

Java
Kotlin

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

+}
@@ -3902,17 +3919,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)
@@ -3946,13 +3963,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)
@@ -3978,23 +3995,23 @@

Java
Kotlin

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

+  });
@@ -4021,19 +4038,19 @@

Java
Kotlin

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

+}
@@ -4047,7 +4064,7 @@

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

+});
@@ -4084,15 +4101,15 @@

Java
Kotlin

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

+});
@@ -4143,7 +4160,7 @@

Java
Kotlin

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

+}
@@ -4263,7 +4280,7 @@

Java
Kotlin

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

+}
@@ -4340,7 +4357,7 @@

Java
Kotlin

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

+}
@@ -4435,7 +4452,7 @@

Traversal

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

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

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

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

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

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

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

+}
@@ -4721,7 +4738,7 @@

Java
Kotlin

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

+}
@@ -4782,10 +4799,10 @@

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

+}

@@ -4796,7 +4813,7 @@

JSON example:

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

+}
@@ -4865,13 +4882,13 @@

Maven
Gradle

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

+  <version>3.4.2</version>
+</dependency>
@@ -4889,7 +4906,7 @@

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

+}
@@ -4941,10 +4958,10 @@

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

+}

@@ -4955,7 +4972,7 @@

JSON example:

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

+}
@@ -5034,13 +5051,13 @@

Maven
Gradle

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

+  <version>3.4.2</version>
+</dependency>
@@ -5069,20 +5086,20 @@

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

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

MVC API:

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

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

Simple MVC route registration

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

+}
@@ -5233,21 +5250,21 @@

Headers

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

+}
@@ -5266,21 +5283,21 @@

Non valid Java name

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

+}
@@ -5293,21 +5310,21 @@