Package io.helidon.microprofile.server

Class Server.Builder

java.lang.Object

io.helidon.microprofile.server.Server.Builder

Enclosing interface:

Server

public static final class Server.Builder
extends java.lang.Object

Builder to build Server instance.

Method Summary

Modifier and Type	Method	Description
Server.Builder	addApplication(JaxRsApplication application)	Add a JAX-RS application with all possible options to this server.
Server.Builder	addApplication(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)	JAX-RS application class to use.
Server.Builder	addApplication(java.lang.String contextRoot, java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)	JAX-RS application class to use.
Server.Builder	addApplication(java.lang.String contextRoot, javax.ws.rs.core.Application application)	JAX-RS application to use.
Server.Builder	addApplication(javax.ws.rs.core.Application application)	JAX-RS application to use.
Server.Builder	addExtension(MpService service)
Server.Builder	addResourceClass(java.lang.Class<?> resource)	Add a JAX-RS resource class to use.
Server	build()	Build a server based on this builder.
Server.Builder	cdiContainer(javax.enterprise.inject.se.SeContainer cdiContainer)	Configure CDI container to use.
Server.Builder	config(Config config)	Configuration instance to use to configure this server (Helidon config).
Server.Builder	config(org.eclipse.microprofile.config.Config config)	Configuration instance to use to configure this server (Microprofile config).
java.util.List<JaxRsApplication>	getApplications()
Server.Builder	host(java.lang.String host)	Configure listen host.
Server.Builder	port(int port)	Configure listen port.
Server.Builder	resourceConfig(org.glassfish.jersey.server.ResourceConfig config)	JAX-RS resource configuration to use.
Server.Builder	setDefaultExecutorServiceSupplier(java.util.function.Supplier<? extends java.util.concurrent.ExecutorService> supplier)	Set a supplier of an executor service to use for tasks connected with application processing (JAX-RS).

Methods inherited from class java.lang.Object

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

Method Detail

build

public Server build()

Build a server based on this builder.

Returns:

Server instance to be started

Throws:

MpException - in case the server fails to be created

host

public Server.Builder host(java.lang.String host)

Configure listen host.

Parameters:

host - hostname

Returns:

modified builder

addExtension

public Server.Builder addExtension(MpService service)

setDefaultExecutorServiceSupplier

public Server.Builder setDefaultExecutorServiceSupplier(java.util.function.Supplier<? extends java.util.concurrent.ExecutorService> supplier)

Set a supplier of an executor service to use for tasks connected with application processing (JAX-RS).

Parameters:

supplier - executor service supplier, only called when an application is configured without its own executor service

Returns:

updated builder instance

port

public Server.Builder port(int port)

Configure listen port.

Parameters:

port - port

Returns:

modified builder

config

public Server.Builder config(Config config)

Configuration instance to use to configure this server (Helidon config).

Parameters:

config - configuration to use

Returns:

modified builder

config

public Server.Builder config(org.eclipse.microprofile.config.Config config)

Configuration instance to use to configure this server (Microprofile config).

Parameters:

config - configuration to use

Returns:

modified builder

cdiContainer

public Server.Builder cdiContainer(javax.enterprise.inject.se.SeContainer cdiContainer)

Configure CDI container to use. Use this method if you need to manually configure the CDI container. Also understand, that whatever happens during container initialization is already done and cannot be undone, such as when microprofile configuration is used. If you use this method and then set explicit config using config(Config), you may end up with some classes configured from default MP config.

Parameters:

cdiContainer - container to use, currently this requires Weld, as Jersey CDI integration depends on it; not other CDI provider is tested

Returns:

modified builder

resourceConfig

public Server.Builder resourceConfig(org.glassfish.jersey.server.ResourceConfig config)

JAX-RS resource configuration to use.

Order is (e.g. if application is defined, resource classes are ignored):

• All Applications and Application classes
• Resource classes
• Resource config

Parameters:

config - configuration to bootstrap Jersey

Returns:

modified builder

addApplication

public Server.Builder addApplication(JaxRsApplication application)

Add a JAX-RS application with all possible options to this server.

Parameters:

application - application to add

Returns:

updated builder instance

addApplication

public Server.Builder addApplication(javax.ws.rs.core.Application application)

JAX-RS application to use. If more than one application is added, they must be registered on different ApplicationPath. Also you must make sure that paths do not overlap, as that may cause unexpected results (e.g. registering one application under root ("/") and another under "/app1" would not work as expected).

Order is (e.g. if application is defined, resource classes are ignored):

• All Applications and Application classes
• Resource classes
• Resource config

Parameters:

application - application to bootstrap Jersey

Returns:

modified builder

addApplication

public Server.Builder addApplication(java.lang.String contextRoot,
                                     javax.ws.rs.core.Application application)

JAX-RS application to use. If more than one application is added, they must be registered on different ApplicationPath. Also you must make sure that paths do not overlap, as that may cause unexpected results (e.g. registering one application under root ("/") and another under "/app1" would not work as expected).

Order is (e.g. if application is defined, resource classes are ignored):

• All Applications and Application classes
• Resource classes
• Resource config

Parameters:

contextRoot - context root this application will be available under

application - application to bootstrap Jersey

Returns:

modified builder

addApplication

public Server.Builder addApplication(java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

JAX-RS application class to use.

Order is (e.g. if application is defined, resource classes are ignored):

• Application class
• Application
• Resource classes
• Resource config

Parameters:

applicationClass - application class to bootstrap Jersey

Returns:

modified builder

addApplication

public Server.Builder addApplication(java.lang.String contextRoot,
                                     java.lang.Class<? extends javax.ws.rs.core.Application> applicationClass)

JAX-RS application class to use.

Order is (e.g. if application is defined, resource classes are ignored):

• Applications and application classes
• Resource classes
• Resource config

Parameters:

contextRoot - context root to serve this application under

applicationClass - application class to bootstrap Jersey

Returns:

modified builder

addResourceClass

public Server.Builder addResourceClass(java.lang.Class<?> resource)

Add a JAX-RS resource class to use.

Order is (e.g. if application is defined, resource classes are ignored):

• Applications and application classes
• Resource classes
• Resource config

Parameters:

resource - resource class to add, list of these classes is used to bootstrap Jersey

Returns:

modified builder

getApplications

public java.util.List<JaxRsApplication> getApplications()