io.javalin

Class Javalin

java.lang.Object

io.javalin.Javalin

public class Javalin
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
JavalinConfig	config Do not use this field unless you know what you're doing.
protected EventManager	eventManager
static org.slf4j.Logger	log
protected JavalinServer	server
protected JavalinServlet	servlet
protected JavalinWsServlet	wsServlet

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	Javalin()
	Javalin(JavalinServer server, JavalinWsServlet wsServlet)

Method Summary

Modifier and Type	Method and Description
Javalin	addHandler(HandlerType httpMethod, java.lang.String path, Handler handler) Adds a request handler for the specified handlerType and path to the instance.
Javalin	addHandler(HandlerType handlerType, java.lang.String path, Handler handler, java.util.Set<Role> roles) Adds a request handler for the specified handlerType and path to the instance.
Javalin	after(Handler handler) Adds an AFTER request handler for all routes in the instance.
Javalin	after(java.lang.String path, Handler handler) Adds an AFTER request handler for the specified path to the instance.
<T> T	attribute(java.lang.Class<T> clazz) Retrieve an attribute stored on the instance.
Javalin	attribute(java.lang.Class clazz, java.lang.Object obj) Registers an attribute on the instance.
Javalin	before(Handler handler) Adds a BEFORE request handler for all routes in the instance.
Javalin	before(java.lang.String path, Handler handler) Adds a BEFORE request handler for the specified path to the instance.
static Javalin	create() Creates a new instance without any custom configuration.
static Javalin	create(java.util.function.Consumer<JavalinConfig> config) Creates a new instance with the user provided configuration.
static Javalin	createStandalone()
static Javalin	createStandalone(java.util.function.Consumer<JavalinConfig> config)
Javalin	delete(java.lang.String path, Handler handler) Adds a DELETE request handler for the specified path to the instance.
Javalin	delete(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a DELETE request handler with the given roles for the specified path to the instance.
Javalin	error(int statusCode, Handler handler) Adds an error mapper to the instance.
Javalin	error(int statusCode, java.lang.String contentType, Handler handler) Adds an error mapper for the specified content-type to the instance.
Javalin	events(java.util.function.Consumer<EventListener> listener)
<T extends java.lang.Exception> Javalin	exception(java.lang.Class<T> exceptionClass, ExceptionHandler<? super T> exceptionHandler) Adds an exception mapper to the instance.
Javalin	get(java.lang.String path, Handler handler) Adds a GET request handler for the specified path to the instance.
Javalin	get(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a GET request handler with the given roles for the specified path to the instance.
Javalin	head(java.lang.String path, Handler handler) Adds a HEAD request handler for the specified path to the instance.
Javalin	head(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a HEAD request handler with the given roles for the specified path to the instance.
Javalin	options(java.lang.String path, Handler handler) Adds a OPTIONS request handler for the specified path to the instance.
Javalin	options(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a OPTIONS request handler with the given roles for the specified path to the instance.
Javalin	patch(java.lang.String path, Handler handler) Adds a PATCH request handler for the specified path to the instance.
Javalin	patch(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a PATCH request handler with the given roles for the specified path to the instance.
int	port() Get which port instance is running on Mostly useful if you start the instance with port(0) (random port)
Javalin	post(java.lang.String path, Handler handler) Adds a POST request handler for the specified path to the instance.
Javalin	post(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a POST request handler with the given roles for the specified path to the instance.
Javalin	put(java.lang.String path, Handler handler) Adds a PUT request handler for the specified path to the instance.
Javalin	put(java.lang.String path, Handler handler, java.util.Set<Role> permittedRoles) Adds a PUT request handler with the given roles for the specified path to the instance.
Javalin	routes(EndpointGroup endpointGroup) Creates a temporary static instance in the scope of the endpointGroup.
JavalinServer	server() Get the JavalinServer
JavalinServlet	servlet()
Javalin	sse(java.lang.String path, java.util.function.Consumer<SseClient> client) Adds a lambda handler for a Server Sent Event connection on the specified path.
Javalin	sse(java.lang.String path, java.util.function.Consumer<SseClient> client, java.util.Set<Role> permittedRoles) Adds a lambda handler for a Server Sent Event connection on the specified path.
Javalin	start() Synchronously starts the application instance on the default port (7000).
Javalin	start(int port) Synchronously starts the application instance on the specified port.
Javalin	start(java.lang.String host, int port) Synchronously starts the application instance on the specified port with the given host IP to bind to.
Javalin	stop() Synchronously stops the application instance.
Javalin	ws(java.lang.String path, java.util.function.Consumer<WsHandler> ws) Adds a WebSocket handler on the specified path.
Javalin	ws(java.lang.String path, java.util.function.Consumer<WsHandler> ws, java.util.Set<Role> permittedRoles) Adds a WebSocket handler on the specified path with the specified roles.
Javalin	wsAfter(java.util.function.Consumer<WsHandler> wsHandler) Adds a WebSocket after handler for all routes in the instance.
Javalin	wsAfter(java.lang.String path, java.util.function.Consumer<WsHandler> wsHandler) Adds a WebSocket after handler for the specified path to the instance.
Javalin	wsBefore(java.util.function.Consumer<WsHandler> wsHandler) Adds a WebSocket before handler for all routes in the instance.
Javalin	wsBefore(java.lang.String path, java.util.function.Consumer<WsHandler> wsHandler) Adds a WebSocket before handler for the specified path to the instance.
<T extends java.lang.Exception> Javalin	wsException(java.lang.Class<T> exceptionClass, WsExceptionHandler<? super T> exceptionHandler) Adds a WebSocket exception mapper to the instance.
JavalinWsServlet	wsServlet()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

log

public static org.slf4j.Logger log

config

public JavalinConfig config

Do not use this field unless you know what you're doing. Application config should be declared in create(Consumer)

server

protected JavalinServer server

wsServlet

protected JavalinWsServlet wsServlet

servlet

protected JavalinServlet servlet

eventManager

protected EventManager eventManager

Constructor Detail

Javalin

protected Javalin()

Javalin

public Javalin(JavalinServer server,
               JavalinWsServlet wsServlet)

Method Detail

create

public static Javalin create()

Creates a new instance without any custom configuration.

See Also:

create(Consumer)

create

public static Javalin create(java.util.function.Consumer<JavalinConfig> config)

Creates a new instance with the user provided configuration. The server does not run until start() is called.

Returns:

application instance.

See Also:

start(), start(int)

createStandalone

public static Javalin createStandalone(java.util.function.Consumer<JavalinConfig> config)

createStandalone

public static Javalin createStandalone()

servlet

public JavalinServlet servlet()

wsServlet

public JavalinWsServlet wsServlet()

server

@Nullable
public JavalinServer server()

Get the JavalinServer

start

public Javalin start(java.lang.String host,
                     int port)

Synchronously starts the application instance on the specified port with the given host IP to bind to.

Parameters:

host - The host IP to bind to

port - to run on

Returns:

running application instance.

See Also:

create(), start()

start

public Javalin start(int port)

Synchronously starts the application instance on the specified port.

Parameters:

port - to run on

Returns:

running application instance.

See Also:

create(), start()

start

public Javalin start()

Synchronously starts the application instance on the default port (7000). To start on a random port use start(int) with port 0.

Returns:

running application instance.

See Also:

create()

stop

public Javalin stop()

Synchronously stops the application instance.

Returns:

stopped application instance.

events

public Javalin events(java.util.function.Consumer<EventListener> listener)

port

public int port()

Get which port instance is running on Mostly useful if you start the instance with port(0) (random port)

attribute

public Javalin attribute(java.lang.Class clazz,
                         java.lang.Object obj)

Registers an attribute on the instance. Instance is available on the Context through Context.appAttribute(java.lang.Class<T>). Ex: app.attribute(MyExt.class, myExtInstance()) The method must be called before start().

attribute

public <T> T attribute(java.lang.Class<T> clazz)

Retrieve an attribute stored on the instance. Available on the Context through Context.appAttribute(java.lang.Class<T>). Ex: app.attribute(MyExt.class).myMethod() Ex: ctx.appAttribute(MyExt.class).myMethod()

routes

public Javalin routes(@NotNull
                      EndpointGroup endpointGroup)

Creates a temporary static instance in the scope of the endpointGroup. Allows you to call get(handler), post(handler), etc. without without using the instance prefix.

See Also:

Handler groups in documentation, ApiBuilder

exception

public <T extends java.lang.Exception> Javalin exception(@NotNull
                                                         java.lang.Class<T> exceptionClass,
                                                         @NotNull
                                                         ExceptionHandler<? super T> exceptionHandler)

Adds an exception mapper to the instance.

See Also:

Exception mapping in docs

error

public Javalin error(int statusCode,
                     @NotNull
                     Handler handler)

Adds an error mapper to the instance. Useful for turning error-codes (404, 500) into standardized messages/pages

See Also:

Error mapping in docs

error

public Javalin error(int statusCode,
                     @NotNull
                     java.lang.String contentType,
                     @NotNull
                     Handler handler)

Adds an error mapper for the specified content-type to the instance. Useful for turning error-codes (404, 500) into standardized messages/pages

See Also:

Error mapping in docs

addHandler

public Javalin addHandler(@NotNull
                          HandlerType handlerType,
                          @NotNull
                          java.lang.String path,
                          @NotNull
                          Handler handler,
                          @NotNull
                          java.util.Set<Role> roles)

Adds a request handler for the specified handlerType and path to the instance. Requires an access manager to be set on the instance. This is the method that all the verb-methods (get/post/put/etc) call.

See Also:

AccessManager, Handlers in docs

addHandler

public Javalin addHandler(@NotNull
                          HandlerType httpMethod,
                          @NotNull
                          java.lang.String path,
                          @NotNull
                          Handler handler)

Adds a request handler for the specified handlerType and path to the instance. This is the method that all the verb-methods (get/post/put/etc) call.

See Also:

Handlers in docs

get

public Javalin get(@NotNull
                   java.lang.String path,
                   @NotNull
                   Handler handler)

Adds a GET request handler for the specified path to the instance.

See Also:

Handlers in docs

post

public Javalin post(@NotNull
                    java.lang.String path,
                    @NotNull
                    Handler handler)

Adds a POST request handler for the specified path to the instance.

See Also:

Handlers in docs

put

public Javalin put(@NotNull
                   java.lang.String path,
                   @NotNull
                   Handler handler)

Adds a PUT request handler for the specified path to the instance.

See Also:

Handlers in docs

patch

public Javalin patch(@NotNull
                     java.lang.String path,
                     @NotNull
                     Handler handler)

Adds a PATCH request handler for the specified path to the instance.

See Also:

Handlers in docs

delete

public Javalin delete(@NotNull
                      java.lang.String path,
                      @NotNull
                      Handler handler)

Adds a DELETE request handler for the specified path to the instance.

See Also:

Handlers in docs

head

public Javalin head(@NotNull
                    java.lang.String path,
                    @NotNull
                    Handler handler)

Adds a HEAD request handler for the specified path to the instance.

See Also:

Handlers in docs

options

public Javalin options(@NotNull
                       java.lang.String path,
                       @NotNull
                       Handler handler)

Adds a OPTIONS request handler for the specified path to the instance.

See Also:

Handlers in docs

get

public Javalin get(@NotNull
                   java.lang.String path,
                   @NotNull
                   Handler handler,
                   @NotNull
                   java.util.Set<Role> permittedRoles)

Adds a GET request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

post

public Javalin post(@NotNull
                    java.lang.String path,
                    @NotNull
                    Handler handler,
                    @NotNull
                    java.util.Set<Role> permittedRoles)

Adds a POST request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

put

public Javalin put(@NotNull
                   java.lang.String path,
                   @NotNull
                   Handler handler,
                   @NotNull
                   java.util.Set<Role> permittedRoles)

Adds a PUT request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

patch

public Javalin patch(@NotNull
                     java.lang.String path,
                     @NotNull
                     Handler handler,
                     @NotNull
                     java.util.Set<Role> permittedRoles)

Adds a PATCH request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

delete

public Javalin delete(@NotNull
                      java.lang.String path,
                      @NotNull
                      Handler handler,
                      @NotNull
                      java.util.Set<Role> permittedRoles)

Adds a DELETE request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

head

public Javalin head(@NotNull
                    java.lang.String path,
                    @NotNull
                    Handler handler,
                    @NotNull
                    java.util.Set<Role> permittedRoles)

Adds a HEAD request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

options

public Javalin options(@NotNull
                       java.lang.String path,
                       @NotNull
                       Handler handler,
                       @NotNull
                       java.util.Set<Role> permittedRoles)

Adds a OPTIONS request handler with the given roles for the specified path to the instance. Requires an access manager to be set on the instance.

See Also:

AccessManager, Handlers in docs

sse

public Javalin sse(@NotNull
                   java.lang.String path,
                   @NotNull
                   java.util.function.Consumer<SseClient> client)

Adds a lambda handler for a Server Sent Event connection on the specified path.

sse

public Javalin sse(@NotNull
                   java.lang.String path,
                   @NotNull
                   java.util.function.Consumer<SseClient> client,
                   @NotNull
                   java.util.Set<Role> permittedRoles)

Adds a lambda handler for a Server Sent Event connection on the specified path. Requires an access manager to be set on the instance.

before

public Javalin before(@NotNull
                      java.lang.String path,
                      @NotNull
                      Handler handler)

Adds a BEFORE request handler for the specified path to the instance.

See Also:

Handlers in docs

before

public Javalin before(@NotNull
                      Handler handler)

Adds a BEFORE request handler for all routes in the instance.

See Also:

Handlers in docs

after

public Javalin after(@NotNull
                     java.lang.String path,
                     @NotNull
                     Handler handler)

Adds an AFTER request handler for the specified path to the instance.

See Also:

Handlers in docs

after

public Javalin after(@NotNull
                     Handler handler)

Adds an AFTER request handler for all routes in the instance.

See Also:

Handlers in docs

wsException

public <T extends java.lang.Exception> Javalin wsException(@NotNull
                                                           java.lang.Class<T> exceptionClass,
                                                           @NotNull
                                                           WsExceptionHandler<? super T> exceptionHandler)

Adds a WebSocket exception mapper to the instance.

See Also:

Exception mapping in docs

ws

public Javalin ws(@NotNull
                  java.lang.String path,
                  @NotNull
                  java.util.function.Consumer<WsHandler> ws)

Adds a WebSocket handler on the specified path.

See Also:

WebSockets in docs

ws

public Javalin ws(@NotNull
                  java.lang.String path,
                  @NotNull
                  java.util.function.Consumer<WsHandler> ws,
                  @NotNull
                  java.util.Set<Role> permittedRoles)

Adds a WebSocket handler on the specified path with the specified roles. Requires an access manager to be set on the instance.

See Also:

AccessManager, WebSockets in docs

wsBefore

public Javalin wsBefore(@NotNull
                        java.lang.String path,
                        @NotNull
                        java.util.function.Consumer<WsHandler> wsHandler)

Adds a WebSocket before handler for the specified path to the instance.

wsBefore

public Javalin wsBefore(@NotNull
                        java.util.function.Consumer<WsHandler> wsHandler)

Adds a WebSocket before handler for all routes in the instance.

wsAfter

public Javalin wsAfter(@NotNull
                       java.lang.String path,
                       @NotNull
                       java.util.function.Consumer<WsHandler> wsHandler)

Adds a WebSocket after handler for the specified path to the instance.

wsAfter

public Javalin wsAfter(@NotNull
                       java.util.function.Consumer<WsHandler> wsHandler)

Adds a WebSocket after handler for all routes in the instance.