Class JdkHttpRestServer

java.lang.Object

org.refcodes.observer.AbstractObservable<RestEndpoint, HttpRequest>

org.refcodes.rest.AbstractRestServer

org.refcodes.rest.JdkHttpRestServer

All Implemented Interfaces:

Closable, Closable.CloseBuilder<ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>, ConnectionComponent<HttpServerContext>, ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>, ConnectionOpenable<HttpServerContext>, ConnectionOpenable.ConnectionOpenBuilder<HttpServerContext, ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>, ConnectionStatusAccessor, LinkComponent, Openable, OpenedAccessor, MaxConnectionsAccessor, MaxConnectionsAccessor.MaxConnectionsBuilder<HttpRestServer>, MaxConnectionsAccessor.MaxConnectionsMutator, MaxConnectionsAccessor.MaxConnectionsProperty, Disposable, PortAccessor, PortAccessor.PortBuilder<HttpRestServer>, PortAccessor.PortMutator, PortAccessor.PortProperty, Observable<RestEndpoint>, Observers<RestEndpoint, RestServer>, HttpExceptionHandlerAccessor, HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<HttpRestServer>, HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator, HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty, HttpExceptionHandlingAccessor, HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<HttpRestServer>, HttpExceptionHandlingAccessor.HttpExceptionHandlingMutator, HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty, HttpRestServer, RestServer, KeyStoreDescriptorAccessor, KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<HttpRestServer>, KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator, KeyStoreDescriptorAccessor.KeyStoreDescriptorProperty, BaseLocatorAccessor, BaseLocatorAccessor.BaseLocatorBuilder<RestServer>, BaseLocatorAccessor.BaseLocatorMutator, BaseLocatorAccessor.BaseLocatorProperty, BasicAuthObservable<HttpRestServer>, HttpsConnectionRequestObservable<HttpRestServer>, HttpServerInterceptable, MediaTypeFactoryLookup, MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, PostHttpInterceptable<PostHttpServerInterceptor>, PostHttpServerInterceptable, PreHttpInterceptable<PreHttpServerInterceptor>, PreHttpServerInterceptable, RealmAccessor, RealmAccessor.RealmBuilder<RestServer>, RealmAccessor.RealmMutator, RealmAccessor.RealmProperty, SchemeAccessor, SchemeAccessor.SchemeBuilder<HttpRestServer>, SchemeAccessor.SchemeMutator, SchemeAccessor.SchemeProperty

Direct Known Subclasses:

JdkHttpRestServerSingleton

public class JdkHttpRestServer
extends AbstractRestServer
implements HttpRestServer

Implementation of the HttpRestServer interface using the HttpRestServer defined in the com.sun.net.httpserver package. The JdkHttpRestServer is being initialized with some common MediaTypeFactory instances (as implemented by the AbstractRestServer). At the time of writing this document the MediaTypeFactory instances being preconfigured are:

• JsonMediaTypeFactory
• XmlMediaTypeFactory
• TextMediaTypeFactory
• FormMediaTypeFactory

The JdkHttpRestServer supports HTTP as well as HTTPS protocols as being based on the HttpRestServer as well as on the HttpsServer. For opening up an HTTPS connection, refer to the methods such as HttpRestServer.open(String, KeyStoreDescriptor, int) or HttpRestServer.open(KeyStoreDescriptor, int) and the like.

Set the system property SystemProperty.LOG_DEBUG to true (set when invoking the JRA by passing the argument -Dlog.debug=true to the java executable) to log additional erroneous situations e.g. related to content types and accept types alongside marshaling and unmarshaling.

TODO 2026-03-08 Support HTTPS/2 with the https://github.com/robaho/httpserver drop in replacement for the com.sun.net.httpserver.HttpsServer. TODO 2026-03-08 Use one main open() method with a single HttpOptions argument (extending the Options type) for felexible but still typesafe configuration.

Nested Class Summary

Nested classes/interfaces inherited from interface BaseLocatorAccessor

BaseLocatorAccessor.BaseLocatorBuilder<B>, BaseLocatorAccessor.BaseLocatorMutator, BaseLocatorAccessor.BaseLocatorProperty

Nested classes/interfaces inherited from interface Closable

Closable.CloseAutomaton, Closable.CloseBuilder<B>

Nested classes/interfaces inherited from interface ConnectionComponent

ConnectionComponent.ConnectionAutomaton<CON>, ConnectionComponent.ConnectionComponentBuilder<CON,B>

Nested classes/interfaces inherited from interface ConnectionOpenable

ConnectionOpenable.ConnectionOpenAutomaton<CON>, ConnectionOpenable.ConnectionOpenBuilder<CON,B>

Nested classes/interfaces inherited from interface ConnectionStatusAccessor

ConnectionStatusAccessor.ConnectionStatusMutator, ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface HttpExceptionHandlerAccessor

HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<B>, HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator, HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty

Nested classes/interfaces inherited from interface HttpExceptionHandlingAccessor

HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<B>, HttpExceptionHandlingAccessor.HttpExceptionHandlingMutator, HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty

Nested classes/interfaces inherited from interface KeyStoreDescriptorAccessor

KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<B>, KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator, KeyStoreDescriptorAccessor.KeyStoreDescriptorProperty

Nested classes/interfaces inherited from interface LinkComponent

LinkComponent.LinkAutomaton, LinkComponent.LinkComponentBuilder<B>

Nested classes/interfaces inherited from interface MaxConnectionsAccessor

MaxConnectionsAccessor.MaxConnectionsBuilder<B>, MaxConnectionsAccessor.MaxConnectionsMutator, MaxConnectionsAccessor.MaxConnectionsProperty

Nested classes/interfaces inherited from interface MediaTypeFactoryLookup

MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup

Nested classes/interfaces inherited from interface Openable

Openable.OpenAutomaton, Openable.OpenBuilder<B>

Nested classes/interfaces inherited from interface OpenedAccessor

OpenedAccessor.OpenedMutator, OpenedAccessor.OpenedProperty

Nested classes/interfaces inherited from interface PortAccessor

PortAccessor.PortBuilder<B>, PortAccessor.PortMutator, PortAccessor.PortProperty

Nested classes/interfaces inherited from interface RealmAccessor

RealmAccessor.RealmBuilder<B>, RealmAccessor.RealmMutator, RealmAccessor.RealmProperty

Nested classes/interfaces inherited from interface SchemeAccessor

SchemeAccessor.SchemeBuilder<B>, SchemeAccessor.SchemeMutator, SchemeAccessor.SchemeProperty

Field Summary

Fields

Modifier and Type	Field	Description
protected static final String	CONTEXT_PATH

Fields inherited from class AbstractRestServer

_isVerbose

Constructor Summary

Constructors

Constructor	Description
JdkHttpRestServer()	Constructs a JdkHttpRestServer.
JdkHttpRestServer(boolean isVerbose)	Constructs a JdkHttpRestServer.
JdkHttpRestServer(ExecutorService aExecutorService)	Constructs a JdkHttpRestServer.
JdkHttpRestServer(ExecutorService aExecutorService, boolean isVerbose)	Constructs a JdkHttpRestServer.
JdkHttpRestServer(ThreadingModel aThreadingModel)	Constructs a JdkHttpRestServer.
JdkHttpRestServer(ThreadingModel aThreadingModel, boolean isVerbose)	Constructs a JdkHttpRestServer.

Method Summary

Modifier and Type	Method	Description
boolean	addPostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)
boolean	addPreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)
void	close()
ConnectionStatus	getConnectionStatus()
HttpExceptionHandler	getHttpExceptionHandler()	Retrieves the HttpExceptionHandler from the HttpExceptionHandler property.
HttpExceptionHandling	getHttpExceptionHandling()	Retrieves the HttpExceptionHandling from the HttpExceptionHandling property.
protected HttpServer	getHttpServer()	Gets the HTTP server.
KeyStoreDescriptor	getKeyStoreDescriptor()
int	getMaxConnections()
int	getPort()
Scheme	getScheme()
boolean	hasPostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)
boolean	hasPreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)
HttpRestServer	onBasicAuthRequest(BasicAuthObserver aBasicAuthObserver)
HttpRestServer	onConnectionRequest(HttpsConnectionRequestObserver aObserver)
protected void	open(HttpServer aHttpServer)	A hook to be used when using custom HttpRestServer ( HttpsServer) by custom open(...) methods of sub-classes of this JdkHttpRestServer.
void	open(String aProtocol, KeyStoreDescriptor aStoreDescriptor, int aPort, int aMaxConnections)	Opens the HTTPS sever connection (socket) at the given port allowing the given number of maximum connections at the same time using the provided HTTPS configuration parameters.
protected void	postIntercept(HttpServerRequest aRequest, HttpServerResponse aResponse)	Invoked to post-process a HttpServerRequest alongside a HttpServerResponse.
protected void	preIntercept(HttpServerRequest aRequest, HttpServerResponse aResponse)	Invoked to pre-process a HttpServerRequest alongside a HttpServerResponse.
boolean	removePostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)
boolean	removePreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)
void	setHttpExceptionHandler(HttpExceptionHandler aHttpErrorHandler)	Sets the HttpExceptionHandler for the HttpExceptionHandler property.
void	setHttpExceptionHandling(HttpExceptionHandling aHttpErrorHandling)	Sets the HttpExceptionHandling for the HttpExceptionHandling property.
void	setKeyStoreDescriptor(KeyStoreDescriptor aKeyStoreDescriptor)
void	setMaxConnections(int aMaxConnections)
void	setPort(int aPort)
void	setProtocol(String aProtocol)
void	setScheme(Scheme aScheme)
String	toProtocol()
JdkHttpRestServer	withBaseLocator(String aBaseLocator)
JdkHttpRestServer	withClose()
JdkHttpRestServer	withCloseIn(int aCloseMillis)
JdkHttpRestServer	withCloseQuietly()
JdkHttpRestServer	withCloseUnchecked()
JdkHttpRestServer	withDisableObservers()
JdkHttpRestServer	withEnableObservers()
JdkHttpRestServer	withHttpExceptionHandler(HttpExceptionHandler aHttpErrorHandler)	Sets the HttpExceptionHandler for the HttpExceptionHandler property.
JdkHttpRestServer	withHttpExceptionHandling(HttpExceptionHandling aHttpErrorHandling)	Sets the HttpExceptionHandling for the HttpExceptionHandling property.
JdkHttpRestServer	withKeyStoreDescriptor(KeyStoreDescriptor aKeyStoreDescriptor)
JdkHttpRestServer	withMaxConnections(int aMaxConnections)
JdkHttpRestServer	withObserversActive(boolean isActive)
JdkHttpRestServer	withOnHttpException(HttpExceptionHandler aHttpExceptionHandler)	Sets the HttpExceptionHandler for the HttpExceptionHandler property.
JdkHttpRestServer	withOpen(int aPort)	Builder method for opening the HttpRestServer.
JdkHttpRestServer	withOpen(HttpServerContext aConnection)
JdkHttpRestServer	withOpenUnchecked(HttpServerContext aConnection)
JdkHttpRestServer	withPort(int aPort)
JdkHttpRestServer	withProtocol(String aProtocol)
JdkHttpRestServer	withRealm(String aRealm)
JdkHttpRestServer	withScheme(Scheme aScheme)

Methods inherited from class AbstractRestServer

addMediaTypeFactory, dispose, fireEvent, getBaseLocator, getFactoryMediaTypes, getRealm, initMedaTypeFactories, isObserversActive, observers, onHttpRequest, setBaseLocator, setObserversActive, setRealm, subscribeObserver, toMediaTypeFactory, toNegotiatedContenType, toResponseBody, unsubscribeObserver

Methods inherited from class AbstractObservable

clear, doHandleEventListenerException, fireEvent, getThreadPriority, hasObserver, isEmpty, setThreadPriority, size

Methods inherited from class Object

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

Methods inherited from interface BaseLocatorAccessor

getBaseLocator

Methods inherited from interface BaseLocatorAccessor.BaseLocatorMutator

setBaseLocator

Methods inherited from interface BaseLocatorAccessor.BaseLocatorProperty

letBaseLocator

Methods inherited from interface Closable

closeIn, closeQuietly, closeUnchecked

Methods inherited from interface ConnectionOpenable

openUnchecked

Methods inherited from interface ConnectionStatusAccessor

isOpened

Methods inherited from interface HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator

onHttpException

Methods inherited from interface HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty

letHttpExceptionHandler

Methods inherited from interface HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty

letHttpExceptionHandling

Methods inherited from interface HttpRestServer

open, open, open, open, open, open, open, open, open, open, open, open

Methods inherited from interface HttpServerInterceptable

addHttpInterceptor, hasHttpInterceptor, removeHttpInterceptor

Methods inherited from interface KeyStoreDescriptorAccessor.KeyStoreDescriptorProperty

letKeyStoreDescriptor

Methods inherited from interface MaxConnectionsAccessor.MaxConnectionsProperty

letMaxConnections

Methods inherited from interface MediaTypeFactoryLookup

getFactoryMediaTypes, hasMediaTypeFactory, toMediaTypeFactory

Methods inherited from interface MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup

addMediaTypeFactory

Methods inherited from interface Observable

hasObserver, subscribeObserver, unsubscribeObserver

Methods inherited from interface Observers

disableObservers, enableObservers, isObserversActive, observers, setObserversActive

Methods inherited from interface Openable

openUnchecked

Methods inherited from interface PortAccessor.PortProperty

letPort

Methods inherited from interface RealmAccessor

getRealm

Methods inherited from interface RealmAccessor.RealmMutator

setRealm

Methods inherited from interface RealmAccessor.RealmProperty

letRealm

Methods inherited from interface RestServer

onDelete, onDelete, onGet, onGet, onPost, onPost, onPut, onPut, onRequest, onRequest, onRequest, onRequest, onRequest

Methods inherited from interface SchemeAccessor.SchemeProperty

letProtocol, letScheme

Field Details

CONTEXT_PATH

protected static final String CONTEXT_PATH

Constructor Details

JdkHttpRestServer

public JdkHttpRestServer(ThreadingModel aThreadingModel)

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. The provided ThreadingModel defines whether to use a single-threaded or a multi-threaded threading model. Threads are created as daemon threads. For more control on thread generation use the constructor JdkHttpRestServer(ExecutorService).

Parameters:

aThreadingModel - Specifies to either use a single-threaded threading model (no ExecutorService) or a multi-threaded threading model with a default ExecutorService as of ControlFlowUtility.createCachedExecutorService(boolean).

JdkHttpRestServer

public JdkHttpRestServer(ThreadingModel aThreadingModel,
 boolean isVerbose)

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. The provided ThreadingModel defines whether to use a single-threaded or a multi-threaded threading model. Threads are created as daemon threads. For more control on thread generation use the constructor JdkHttpRestServer(ExecutorService).

Parameters:

aThreadingModel - Specifies to either use a single-threaded threading model (no ExecutorService) or a multi-threaded threading model with a default ExecutorService as of ControlFlowUtility.createCachedExecutorService(boolean).

isVerbose - When true, any unknown content- and accept-types are logged.

JdkHttpRestServer

public JdkHttpRestServer()

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. Uses a multi threaded threading model with a default ExecutorService as of ControlFlowUtility.createCachedExecutorService(boolean). Threads are created as daemon threads. For more control on thread generation use the constructor JdkHttpRestServer(ExecutorService).

JdkHttpRestServer

public JdkHttpRestServer(boolean isVerbose)

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. Uses a multi threaded threading model with a default ExecutorService as of ControlFlowUtility.createCachedExecutorService(boolean). Threads are created as daemon threads. For more control on thread generation use the constructor JdkHttpRestServer(ExecutorService).

Parameters:

isVerbose - When true, any unknown content- and accept-types are logged.

JdkHttpRestServer

public JdkHttpRestServer(ExecutorService aExecutorService)

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. Uses a multi threaded threading model.

Parameters:

aExecutorService - An executor service to be used when creating Threads.

JdkHttpRestServer

public JdkHttpRestServer(ExecutorService aExecutorService,
 boolean isVerbose)

Constructs a JdkHttpRestServer. Use HttpRestServer.open(int) or similar to make it listen on your port. Uses a multi threaded threading model.

Parameters:

aExecutorService - An executor service to be used when creating Threads.

isVerbose - When true, any unknown content- and accept-types are logged.

Method Details

close

public void close()
           throws IOException

Specified by:

close in interface Closable

Throws:

IOException

open

public void open(String aProtocol,
 KeyStoreDescriptor aStoreDescriptor,
 int aPort,
 int aMaxConnections)
          throws IOException

Opens the HTTPS sever connection (socket) at the given port allowing the given number of maximum connections at the same time using the provided HTTPS configuration parameters.

Specified by:

open in interface HttpRestServer

Parameters:

aProtocol - The protocol to use, e.g. "TLS".

aStoreDescriptor - The store descriptor describing your KeyStore required for HTTPS.

aPort - The port on which to listen for requests.

aMaxConnections - The number of maximum connections at the same time.

Throws:

IOException - thrown in case something went wrong such as the port being already in use.

getConnectionStatus

public ConnectionStatus getConnectionStatus()

Specified by:

getConnectionStatus in interface ConnectionStatusAccessor

getHttpExceptionHandler

public HttpExceptionHandler getHttpExceptionHandler()

Retrieves the HttpExceptionHandler from the HttpExceptionHandler property.

Specified by:

getHttpExceptionHandler in interface HttpExceptionHandlerAccessor

Returns:

The HttpExceptionHandler stored by the HttpExceptionHandler property.

setHttpExceptionHandler

public void setHttpExceptionHandler(HttpExceptionHandler aHttpErrorHandler)

Sets the HttpExceptionHandler for the HttpExceptionHandler property.

Specified by:

setHttpExceptionHandler in interface HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator

Parameters:

aHttpErrorHandler - The HttpExceptionHandler to be stored by the HttpExceptionHandler property.

getHttpExceptionHandling

public HttpExceptionHandling getHttpExceptionHandling()

Retrieves the HttpExceptionHandling from the HttpExceptionHandling property.

Specified by:

getHttpExceptionHandling in interface HttpExceptionHandlingAccessor

Returns:

The HttpExceptionHandling stored by the HttpExceptionHandling property.

setHttpExceptionHandling

public void setHttpExceptionHandling(HttpExceptionHandling aHttpErrorHandling)

Sets the HttpExceptionHandling for the HttpExceptionHandling property.

Specified by:

setHttpExceptionHandling in interface HttpExceptionHandlingAccessor.HttpExceptionHandlingMutator

Parameters:

aHttpErrorHandling - The HttpExceptionHandling to be stored by the HttpExceptionHandling property.

onConnectionRequest

public HttpRestServer onConnectionRequest(HttpsConnectionRequestObserver aObserver)

Specified by:

onConnectionRequest in interface HttpsConnectionRequestObservable<HttpRestServer>

onBasicAuthRequest

public HttpRestServer onBasicAuthRequest(BasicAuthObserver aBasicAuthObserver)

Specified by:

onBasicAuthRequest in interface BasicAuthObservable<HttpRestServer>

setPort

public void setPort(int aPort)

Specified by:

setPort in interface PortAccessor.PortMutator

getPort

public int getPort()

Specified by:

getPort in interface PortAccessor

setScheme

public void setScheme(Scheme aScheme)

Specified by:

setScheme in interface SchemeAccessor.SchemeMutator

getScheme

public Scheme getScheme()

Specified by:

getScheme in interface SchemeAccessor

toProtocol

public String toProtocol()

Specified by:

toProtocol in interface SchemeAccessor

setProtocol

public void setProtocol(String aProtocol)

Specified by:

setProtocol in interface SchemeAccessor.SchemeMutator

getKeyStoreDescriptor

public KeyStoreDescriptor getKeyStoreDescriptor()

Specified by:

getKeyStoreDescriptor in interface KeyStoreDescriptorAccessor

setKeyStoreDescriptor

public void setKeyStoreDescriptor(KeyStoreDescriptor aKeyStoreDescriptor)

Specified by:

setKeyStoreDescriptor in interface KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator

getMaxConnections

public int getMaxConnections()

Specified by:

getMaxConnections in interface MaxConnectionsAccessor

setMaxConnections

public void setMaxConnections(int aMaxConnections)

Specified by:

setMaxConnections in interface MaxConnectionsAccessor.MaxConnectionsMutator

hasPreHttpInterceptor

public boolean hasPreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)

Specified by:

hasPreHttpInterceptor in interface PreHttpInterceptable<PreHttpServerInterceptor>

addPreHttpInterceptor

public boolean addPreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)

Specified by:

addPreHttpInterceptor in interface PreHttpInterceptable<PreHttpServerInterceptor>

removePreHttpInterceptor

public boolean removePreHttpInterceptor(PreHttpServerInterceptor aPreInterceptor)

Specified by:

removePreHttpInterceptor in interface PreHttpInterceptable<PreHttpServerInterceptor>

hasPostHttpInterceptor

public boolean hasPostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)

Specified by:

hasPostHttpInterceptor in interface PostHttpInterceptable<PostHttpServerInterceptor>

addPostHttpInterceptor

public boolean addPostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)

Specified by:

addPostHttpInterceptor in interface PostHttpInterceptable<PostHttpServerInterceptor>

removePostHttpInterceptor

public boolean removePostHttpInterceptor(PostHttpServerInterceptor aPostInterceptor)

Specified by:

removePostHttpInterceptor in interface PostHttpInterceptable<PostHttpServerInterceptor>

withRealm

public JdkHttpRestServer withRealm(String aRealm)

Specified by:

withRealm in interface HttpRestServer

Specified by:

withRealm in interface RealmAccessor.RealmBuilder<RestServer>

Specified by:

withRealm in interface RestServer

withCloseUnchecked

public JdkHttpRestServer withCloseUnchecked()

Specified by:

withCloseUnchecked in interface Closable.CloseBuilder<ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

withObserversActive

public JdkHttpRestServer withObserversActive(boolean isActive)

Specified by:

withObserversActive in interface Observers<RestEndpoint, RestServer>

Specified by:

withObserversActive in interface RestServer

withEnableObservers

public JdkHttpRestServer withEnableObservers()

Specified by:

withEnableObservers in interface Observers<RestEndpoint, RestServer>

Specified by:

withEnableObservers in interface RestServer

withDisableObservers

public JdkHttpRestServer withDisableObservers()

Specified by:

withDisableObservers in interface Observers<RestEndpoint, RestServer>

Specified by:

withDisableObservers in interface RestServer

withOnHttpException

public JdkHttpRestServer withOnHttpException(HttpExceptionHandler aHttpExceptionHandler)

Sets the HttpExceptionHandler for the HttpExceptionHandler property.

Specified by:

withOnHttpException in interface HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<HttpRestServer>

Parameters:

aHttpExceptionHandler - The HttpExceptionHandler to be stored by the HttpExceptionHandler property.

Returns:

The builder for applying multiple build operations.

withOpenUnchecked

public JdkHttpRestServer withOpenUnchecked(HttpServerContext aConnection)

Specified by:

withOpenUnchecked in interface ConnectionOpenable.ConnectionOpenBuilder<HttpServerContext, ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

withHttpExceptionHandler

public JdkHttpRestServer withHttpExceptionHandler(HttpExceptionHandler aHttpErrorHandler)

Sets the HttpExceptionHandler for the HttpExceptionHandler property.

Specified by:

withHttpExceptionHandler in interface HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<HttpRestServer>

Specified by:

withHttpExceptionHandler in interface HttpRestServer

Parameters:

aHttpErrorHandler - The HttpExceptionHandler to be stored by the HttpExceptionHandler property.

Returns:

The builder for applying multiple build operations.

withHttpExceptionHandling

public JdkHttpRestServer withHttpExceptionHandling(HttpExceptionHandling aHttpErrorHandling)

Sets the HttpExceptionHandling for the HttpExceptionHandling property.

Specified by:

withHttpExceptionHandling in interface HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<HttpRestServer>

Specified by:

withHttpExceptionHandling in interface HttpRestServer

Parameters:

aHttpErrorHandling - The HttpExceptionHandling to be stored by the HttpExceptionHandling property.

Returns:

The builder for applying multiple build operations.

withBaseLocator

public JdkHttpRestServer withBaseLocator(String aBaseLocator)

Specified by:

withBaseLocator in interface BaseLocatorAccessor.BaseLocatorBuilder<RestServer>

Specified by:

withBaseLocator in interface HttpRestServer

Specified by:

withBaseLocator in interface RestServer

withClose

public JdkHttpRestServer withClose()
                            throws IOException

Specified by:

withClose in interface Closable.CloseBuilder<ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

Specified by:

withClose in interface HttpRestServer

Throws:

IOException

withCloseQuietly

public JdkHttpRestServer withCloseQuietly()

Specified by:

withCloseQuietly in interface Closable.CloseBuilder<ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

Specified by:

withCloseQuietly in interface HttpRestServer

withCloseIn

public JdkHttpRestServer withCloseIn(int aCloseMillis)

Specified by:

withCloseIn in interface Closable.CloseBuilder<ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

Specified by:

withCloseIn in interface HttpRestServer

withOpen

public JdkHttpRestServer withOpen(HttpServerContext aConnection)
                           throws IOException

Specified by:

withOpen in interface ConnectionOpenable.ConnectionOpenBuilder<HttpServerContext, ConnectionComponent.ConnectionComponentBuilder<HttpServerContext, HttpRestServer>>

Specified by:

withOpen in interface HttpRestServer

Throws:

IOException

withOpen

public JdkHttpRestServer withOpen(int aPort)
                           throws IOException

Builder method for opening the HttpRestServer. Delegates to HttpRestServer.open(int) and returns this method.

Specified by:

withOpen in interface HttpRestServer

Parameters:

aPort - The port on which to listen for requests.

Returns:

This instance for applying method chaining.

Throws:

IOException - thrown in case something went wrong such as the port being already in use.

withPort

public JdkHttpRestServer withPort(int aPort)

Specified by:

withPort in interface HttpRestServer

Specified by:

withPort in interface PortAccessor.PortBuilder<HttpRestServer>

withScheme

public JdkHttpRestServer withScheme(Scheme aScheme)

Specified by:

withScheme in interface HttpRestServer

Specified by:

withScheme in interface SchemeAccessor.SchemeBuilder<HttpRestServer>

withProtocol

public JdkHttpRestServer withProtocol(String aProtocol)

Specified by:

withProtocol in interface HttpRestServer

Specified by:

withProtocol in interface SchemeAccessor.SchemeBuilder<HttpRestServer>

withKeyStoreDescriptor

public JdkHttpRestServer withKeyStoreDescriptor(KeyStoreDescriptor aKeyStoreDescriptor)

Specified by:

withKeyStoreDescriptor in interface HttpRestServer

Specified by:

withKeyStoreDescriptor in interface KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<HttpRestServer>

withMaxConnections

public JdkHttpRestServer withMaxConnections(int aMaxConnections)

Specified by:

withMaxConnections in interface HttpRestServer

Specified by:

withMaxConnections in interface MaxConnectionsAccessor.MaxConnectionsBuilder<HttpRestServer>

preIntercept

protected void preIntercept(HttpServerRequest aRequest,
 HttpServerResponse aResponse)

Invoked to pre-process a HttpServerRequest alongside a HttpServerResponse.

Overrides:

preIntercept in class AbstractRestServer

Parameters:

aRequest - The HttpServerRequest to pre-process.

aResponse - The HttpServerResponse to post-process.

postIntercept

protected void postIntercept(HttpServerRequest aRequest,
 HttpServerResponse aResponse)

Invoked to post-process a HttpServerRequest alongside a HttpServerResponse.

Overrides:

postIntercept in class AbstractRestServer

Parameters:

aRequest - The HttpServerRequest to post-process.

aResponse - The HttpServerResponse to post-process.

getHttpServer

protected HttpServer getHttpServer()

Gets the HTTP server.

Returns:

the HTTP server

open

protected void open(HttpServer aHttpServer)
             throws IOException

A hook to be used when using custom HttpRestServer ( HttpsServer) by custom open(...) methods of sub-classes of this JdkHttpRestServer. E.g JdkHttpRestServer uses this hook to pre-configure a HttpsServer for HTTPS. The passed HttpRestServer ( HttpsServer) must already be bound to a port and enabled with the number of concurrent connections as of HttpServer.bind(InetSocketAddress, int).

Parameters:

aHttpServer - The HttpRestServer to be used. E.g. an HttpsServer might be used to enable HTTPS.

Throws:

IOException - in case opening with the provided HttpRestServer fails.