org.refcodes.rest

Class AbstractHttpRestServerDecorator<B extends HttpRestServer>

java.lang.Object

org.refcodes.rest.AbstractHttpRestServerDecorator<B>

All Implemented Interfaces:

org.refcodes.component.Closable, org.refcodes.component.Closable.CloseBuilder<org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>, org.refcodes.component.ConnectionComponent<org.refcodes.net.HttpServerContext>, org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>, org.refcodes.component.ConnectionOpenable<org.refcodes.net.HttpServerContext>, org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<org.refcodes.net.HttpServerContext,org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>, org.refcodes.component.ConnectionStatusAccessor, org.refcodes.component.LinkComponent, org.refcodes.component.Openable, org.refcodes.io.MaxConnectionsAccessor, org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsBuilder<HttpRestServer>, org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsMutator, org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsProperty, org.refcodes.mixin.PortAccessor, org.refcodes.mixin.PortAccessor.PortBuilder<HttpRestServer>, org.refcodes.mixin.PortAccessor.PortMutator, org.refcodes.mixin.PortAccessor.PortProperty, org.refcodes.net.BaseLocatorAccessor, org.refcodes.net.BaseLocatorAccessor.BaseLocatorBuilder<RestServer>, org.refcodes.net.BaseLocatorAccessor.BaseLocatorMutator, org.refcodes.net.BaseLocatorAccessor.BaseLocatorProperty, org.refcodes.net.BasicAuthObservable<HttpRestServer>, org.refcodes.net.HttpsConnectionRequestObservable<HttpRestServer>, org.refcodes.net.MediaTypeFactoryLookup, org.refcodes.net.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, org.refcodes.net.RealmAccessor, org.refcodes.net.RealmAccessor.RealmBuilder<RestServer>, org.refcodes.net.RealmAccessor.RealmMutator, org.refcodes.net.RealmAccessor.RealmProperty, org.refcodes.net.SchemeAccessor, org.refcodes.net.SchemeAccessor.SchemeBuilder<HttpRestServer>, org.refcodes.net.SchemeAccessor.SchemeMutator, org.refcodes.net.SchemeAccessor.SchemeProperty, org.refcodes.observer.Observable<RestEndpoint>, org.refcodes.observer.Observers<RestEndpoint,RestServer>, HttpRestServer, RestServer, org.refcodes.runtime.RequestCorrelation<RestServer>, org.refcodes.runtime.SessionCorrelation<RestServer>, org.refcodes.security.KeyStoreDescriptorAccessor, org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<HttpRestServer>, org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator, org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorProperty

Direct Known Subclasses:

AbstractHttpRegistryRestServerDecorator

public abstract class AbstractHttpRestServerDecorator<B extends HttpRestServer>
extends Object
implements HttpRestServer

Abstract class for easily decorating a HttpRestServer.

Nested Class Summary

Nested classes/interfaces inherited from interface org.refcodes.net.MediaTypeFactoryLookup

org.refcodes.net.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup

Nested classes/interfaces inherited from interface org.refcodes.net.RealmAccessor

org.refcodes.net.RealmAccessor.RealmBuilder<B extends org.refcodes.net.RealmAccessor.RealmBuilder<B>>, org.refcodes.net.RealmAccessor.RealmMutator, org.refcodes.net.RealmAccessor.RealmProperty

Nested classes/interfaces inherited from interface org.refcodes.net.BaseLocatorAccessor

org.refcodes.net.BaseLocatorAccessor.BaseLocatorBuilder<B extends org.refcodes.net.BaseLocatorAccessor.BaseLocatorBuilder<B>>, org.refcodes.net.BaseLocatorAccessor.BaseLocatorMutator, org.refcodes.net.BaseLocatorAccessor.BaseLocatorProperty

Nested classes/interfaces inherited from interface org.refcodes.component.LinkComponent

org.refcodes.component.LinkComponent.LinkAutomaton, org.refcodes.component.LinkComponent.LinkComponentBuilder<B extends org.refcodes.component.LinkComponent.LinkComponentBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Openable

org.refcodes.component.Openable.OpenAutomaton, org.refcodes.component.Openable.OpenBuilder<B extends org.refcodes.component.Openable.OpenBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionStatusAccessor

org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusMutator, org.refcodes.component.ConnectionStatusAccessor.ConnectionStatusProperty

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionComponent

org.refcodes.component.ConnectionComponent.ConnectionAutomaton<CON>, org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B extends org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<CON,B>>

Nested classes/interfaces inherited from interface org.refcodes.component.ConnectionOpenable

org.refcodes.component.ConnectionOpenable.ConnectionOpenAutomaton<CON>, org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B extends org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<CON,B>>

Nested classes/interfaces inherited from interface org.refcodes.component.Closable

org.refcodes.component.Closable.CloseAutomaton, org.refcodes.component.Closable.CloseBuilder<B extends org.refcodes.component.Closable.CloseBuilder<B>>

Nested classes/interfaces inherited from interface org.refcodes.mixin.PortAccessor

org.refcodes.mixin.PortAccessor.PortBuilder<B extends org.refcodes.mixin.PortAccessor.PortBuilder<B>>, org.refcodes.mixin.PortAccessor.PortMutator, org.refcodes.mixin.PortAccessor.PortProperty

Nested classes/interfaces inherited from interface org.refcodes.net.SchemeAccessor

org.refcodes.net.SchemeAccessor.SchemeBuilder<B extends org.refcodes.net.SchemeAccessor.SchemeBuilder<B>>, org.refcodes.net.SchemeAccessor.SchemeMutator, org.refcodes.net.SchemeAccessor.SchemeProperty

Nested classes/interfaces inherited from interface org.refcodes.security.KeyStoreDescriptorAccessor

org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<B extends org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorBuilder<B>>, org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator, org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorProperty

Nested classes/interfaces inherited from interface org.refcodes.io.MaxConnectionsAccessor

org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsBuilder<B extends org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsBuilder<B>>, org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsMutator, org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsProperty

Field Summary

Fields

Modifier and Type	Field and Description
protected HttpRestServer	_server

Constructor Summary

Constructors

Constructor and Description
AbstractHttpRestServerDecorator(HttpRestServer aServer) Decorates the given HttpRestServer with additional functionality.

Method Summary

Modifier and Type	Method and Description
boolean	addMediaTypeFactory(org.refcodes.net.MediaTypeFactory aMediaTypeFactory)
void	close()
void	closeIn(int aCloseInMillis)
void	closeQuietly()
void	closeUnchecked()
void	disableRequestCorrelation()
void	disableSessionCorrelation()
void	enableRequestCorrelation()
void	enableSessionCorrelation()
String	getBaseLocator()
org.refcodes.net.MediaType[]	getFactoryMediaTypes()
org.refcodes.security.KeyStoreDescriptor	getKeyStoreDescriptor()
int	getMaxConnections()
int	getPort()
String	getRealm()
org.refcodes.data.Scheme	getScheme()
boolean	hasMediaTypeFactory(org.refcodes.net.MediaType aMediaType)
boolean	hasObserverSubscription(RestEndpoint aObserver)
boolean	hasRequestCorrelation()
boolean	hasSessionCorrelation()
Iterator<RestEndpoint>	observers()
HttpRestServer	onBasicAuthRequest(org.refcodes.net.BasicAuthObserver aObserver)
HttpRestServer	onConnectionRequest(org.refcodes.net.HttpsConnectionRequestObserver aObserver)
RestEndpointBuilder	onDelete(String aLocatorPattern, RestRequestObserver aRequestObserver) Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming DELETE methods.
RestEndpointBuilder	onGet(String aLocatorPattern, RestRequestObserver aRequestObserver) Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming GET methods.
RestEndpointBuilder	onPost(String aLocatorPattern, RestRequestObserver aRequestObserver) Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming POST methods.
RestEndpointBuilder	onPut(String aLocatorPattern, RestRequestObserver aRequestObserver) Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming PUT methods.
RestEndpointBuilder	onRequest(org.refcodes.net.HttpMethod aHttpMethod, String aLocatorPattern, RestRequestObserver aRequestObserver) Registers a pre-configured RestEndpoint with the least required attributes and returns its instance.
boolean	onRequest(RestEndpoint aRestEndpoint) For the sake of unified naming, this method just delegates to Observable.subscribeObserver(Object).
RestEndpointBuilder	onRequest(String aLocatorPattern, RestRequestObserver aRequestObserver) Registers a pre-configured RestEndpoint, triggerd by any HTTP method, and returns its instance.
void	open(int aPort) Opens the HTTP sever connection (socket) at the given port
void	open(int aPort, int aMaxConnections) Opens the HTTP sever connection (socket) at the given port allowing the given number of maximum connections at the same time.
void	open(String aProtocol, org.refcodes.security.KeyStoreDescriptor aStoreDescriptor, int aPort) Same as HttpRestServer.open(String, KeyStoreDescriptor, int, int) but: The number of maximum connections at the same time is decided upon by the implementations's default value.
void	open(String aProtocol, org.refcodes.security.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.
void	openUnchecked(org.refcodes.net.HttpServerContext aConnection)
void	setBaseLocator(String aBaseLocator)
void	setKeyStoreDescriptor(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor)
void	setMaxConnections(int aMaxConnections)
void	setPort(int aPort)
void	setProtocol(String aProtocol)
void	setRealm(String aRealm)
void	setRequestCorrelation(boolean hasRequestCorrelation)
void	setScheme(org.refcodes.data.Scheme aScheme)
void	setSessionCorrelation(boolean hasSessionCorrelation)
boolean	subscribeObserver(RestEndpoint aObserver)
org.refcodes.net.MediaTypeFactory	toMediaTypeFactory(org.refcodes.net.MediaType aMediaType)
String	toProtocol()
boolean	unsubscribeObserver(RestEndpoint aObserver)
HttpRestServer	withBaseLocator(String aBaseLocator)
HttpRestServer	withClose()
HttpRestServer	withCloseIn(int aCloseInMillis)
HttpRestServer	withCloseQuietly()
HttpRestServer	withCloseUnchecked()
HttpRestServer	withDisableRequestCorrelation()
HttpRestServer	withDisableSessionCorrelation()
HttpRestServer	withEnableRequestCorrelation()
HttpRestServer	withEnableSessionCorrelation()
HttpRestServer	withOpen(org.refcodes.net.HttpServerContext aConnection)
HttpRestServer	withOpenUnchecked(org.refcodes.net.HttpServerContext aConnection)
HttpRestServer	withRealm(String aRealm)
HttpRestServer	withRequestCorrelation(boolean hasRequestCorrelation)
HttpRestServer	withSessionCorrelation(boolean hasSessionCorrelation)

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.refcodes.rest.HttpRestServer

open, open, open, open, open, open, open, open, open, withKeyStoreDescriptor, withMaxConnections, withPort, withProtocol, withScheme

Methods inherited from interface org.refcodes.rest.RestServer

withDisableObservers, withEnableObservers, withObserversActive

Methods inherited from interface org.refcodes.observer.Observers

disableObservers, enableObservers, isObserversActive, setObserversActive

Methods inherited from interface org.refcodes.component.Openable

openUnchecked

Methods inherited from interface org.refcodes.component.ConnectionStatusAccessor

getConnectionStatus, isConnectionOpened

Field Detail

_server

protected HttpRestServer _server

Constructor Detail

AbstractHttpRestServerDecorator

public AbstractHttpRestServerDecorator(HttpRestServer aServer)

Decorates the given HttpRestServer with additional functionality.

Parameters:

aServer - The HttpRestServer to be decorated.

Method Detail

getPort

public int getPort()

Specified by:

getPort in interface org.refcodes.mixin.PortAccessor

setPort

public void setPort(int aPort)

Specified by:

setPort in interface org.refcodes.mixin.PortAccessor.PortMutator

getScheme

public org.refcodes.data.Scheme getScheme()

Specified by:

getScheme in interface org.refcodes.net.SchemeAccessor

setScheme

public void setScheme(org.refcodes.data.Scheme aScheme)

Specified by:

setScheme in interface org.refcodes.net.SchemeAccessor.SchemeMutator

addMediaTypeFactory

public boolean addMediaTypeFactory(org.refcodes.net.MediaTypeFactory aMediaTypeFactory)

Specified by:

addMediaTypeFactory in interface org.refcodes.net.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup

close

public void close()
           throws org.refcodes.component.CloseException

Specified by:

close in interface org.refcodes.component.Closable

Throws:

org.refcodes.component.CloseException

closeIn

public void closeIn(int aCloseInMillis)

Specified by:

closeIn in interface org.refcodes.component.Closable

closeQuietly

public void closeQuietly()

Specified by:

closeQuietly in interface org.refcodes.component.Closable

closeUnchecked

public void closeUnchecked()

Specified by:

closeUnchecked in interface org.refcodes.component.Closable

disableRequestCorrelation

public void disableRequestCorrelation()

Specified by:

disableRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

disableSessionCorrelation

public void disableSessionCorrelation()

Specified by:

disableSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

enableRequestCorrelation

public void enableRequestCorrelation()

Specified by:

enableRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

enableSessionCorrelation

public void enableSessionCorrelation()

Specified by:

enableSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

getBaseLocator

public String getBaseLocator()

Specified by:

getBaseLocator in interface org.refcodes.net.BaseLocatorAccessor

getFactoryMediaTypes

public org.refcodes.net.MediaType[] getFactoryMediaTypes()

Specified by:

getFactoryMediaTypes in interface org.refcodes.net.MediaTypeFactoryLookup

getRealm

public String getRealm()

Specified by:

getRealm in interface org.refcodes.net.RealmAccessor

hasMediaTypeFactory

public boolean hasMediaTypeFactory(org.refcodes.net.MediaType aMediaType)

Specified by:

hasMediaTypeFactory in interface org.refcodes.net.MediaTypeFactoryLookup

hasObserverSubscription

public boolean hasObserverSubscription(RestEndpoint aObserver)

Specified by:

hasObserverSubscription in interface org.refcodes.observer.Observable<RestEndpoint>

hasRequestCorrelation

public boolean hasRequestCorrelation()

Specified by:

hasRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

hasSessionCorrelation

public boolean hasSessionCorrelation()

Specified by:

hasSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

onBasicAuthRequest

public HttpRestServer onBasicAuthRequest(org.refcodes.net.BasicAuthObserver aObserver)

Specified by:

onBasicAuthRequest in interface org.refcodes.net.BasicAuthObservable<HttpRestServer>

onConnectionRequest

public HttpRestServer onConnectionRequest(org.refcodes.net.HttpsConnectionRequestObserver aObserver)

Specified by:

onConnectionRequest in interface org.refcodes.net.HttpsConnectionRequestObservable<HttpRestServer>

onDelete

public RestEndpointBuilder onDelete(String aLocatorPattern,
                                    RestRequestObserver aRequestObserver)

Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming DELETE methods. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onDelete in interface RestServer

Parameters:

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

onGet

public RestEndpointBuilder onGet(String aLocatorPattern,
                                 RestRequestObserver aRequestObserver)

Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming GET methods. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onGet in interface RestServer

Parameters:

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

onPost

public RestEndpointBuilder onPost(String aLocatorPattern,
                                  RestRequestObserver aRequestObserver)

Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming POST methods. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onPost in interface RestServer

Parameters:

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

onPut

public RestEndpointBuilder onPut(String aLocatorPattern,
                                 RestRequestObserver aRequestObserver)

Even more convenient: Everything done here can also be done using RestServer.onRequest(HttpMethod, String, RestRequestObserver): Registers a RestRequestObserver with the given Locator-Pattern to incoming PUT methods. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onPut in interface RestServer

Parameters:

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

onRequest

public RestEndpointBuilder onRequest(org.refcodes.net.HttpMethod aHttpMethod,
                                     String aLocatorPattern,
                                     RestRequestObserver aRequestObserver)

Registers a pre-configured RestEndpoint with the least required attributes and returns its instance. To unsubscribe via Observable.unsubscribeObserver(Object), use the returned instance. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onRequest in interface RestServer

Parameters:

aHttpMethod - The HTTP-Method to which this RestEndpoint is bound. A value of null means that any HTTP-Method may trigger this RestEndpoint.

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound. A value of null means that any locator may trigger this RestEndpoint.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

onRequest

public boolean onRequest(RestEndpoint aRestEndpoint)

For the sake of unified naming, this method just delegates to Observable.subscribeObserver(Object).

Specified by:

onRequest in interface RestServer

Parameters:

aRestEndpoint - the a rest endpoint

Returns:

true, if successful

onRequest

public RestEndpointBuilder onRequest(String aLocatorPattern,
                                     RestRequestObserver aRequestObserver)

Registers a pre-configured RestEndpoint, triggerd by any HTTP method, and returns its instance. To unsubscribe via Observable.unsubscribeObserver(Object), use the returned instance. Attention: Invoke Openable.open() to activate this endpoint!

Specified by:

onRequest in interface RestServer

Parameters:

aLocatorPattern - The local Locator-Pattern to which this RestEndpoint is bound.

aRequestObserver - The listener processing a request targeted at this RestEndpoint.

Returns:

The pre-configured RestEndpoint which acts as handle to unsubscribe the RestEndpoint via Observable.unsubscribeObserver(Object).

open

public void open(int aPort)
          throws org.refcodes.component.OpenException

Opens the HTTP sever connection (socket) at the given port

Specified by:

open in interface HttpRestServer

Parameters:

aPort - The port on which to listen for requests.

Throws:

org.refcodes.component.OpenException - thrown in case something went wrong such as the port being already in use.

open

public void open(int aPort,
                 int aMaxConnections)
          throws org.refcodes.component.OpenException

Opens the HTTP sever connection (socket) at the given port allowing the given number of maximum connections at the same time.

Specified by:

open in interface HttpRestServer

Parameters:

aPort - The port on which to listen for requests.

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

Throws:

org.refcodes.component.OpenException - thrown in case something went wrong such as the port being already in use.

open

public void open(String aProtocol,
                 org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                 int aPort)
          throws org.refcodes.component.OpenException

Same as HttpRestServer.open(String, KeyStoreDescriptor, int, int) but:

• The number of maximum connections at the same time is decided upon by the implementations's default value.

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.

Throws:

org.refcodes.component.OpenException - thrown in case something went wrong such as the port being already in use.

open

public void open(String aProtocol,
                 org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                 int aPort,
                 int aMaxConnections)
          throws org.refcodes.component.OpenException

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:

org.refcodes.component.OpenException - thrown in case something went wrong such as the port being already in use.

openUnchecked

public void openUnchecked(org.refcodes.net.HttpServerContext aConnection)

Specified by:

openUnchecked in interface org.refcodes.component.ConnectionOpenable<org.refcodes.net.HttpServerContext>

setBaseLocator

public void setBaseLocator(String aBaseLocator)

Specified by:

setBaseLocator in interface org.refcodes.net.BaseLocatorAccessor.BaseLocatorMutator

setRealm

public void setRealm(String aRealm)

Specified by:

setRealm in interface org.refcodes.net.RealmAccessor.RealmMutator

setRequestCorrelation

public void setRequestCorrelation(boolean hasRequestCorrelation)

Specified by:

setRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

setSessionCorrelation

public void setSessionCorrelation(boolean hasSessionCorrelation)

Specified by:

setSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

subscribeObserver

public boolean subscribeObserver(RestEndpoint aObserver)

Specified by:

subscribeObserver in interface org.refcodes.observer.Observable<RestEndpoint>

toMediaTypeFactory

public org.refcodes.net.MediaTypeFactory toMediaTypeFactory(org.refcodes.net.MediaType aMediaType)

Specified by:

toMediaTypeFactory in interface org.refcodes.net.MediaTypeFactoryLookup

unsubscribeObserver

public boolean unsubscribeObserver(RestEndpoint aObserver)

Specified by:

unsubscribeObserver in interface org.refcodes.observer.Observable<RestEndpoint>

observers

public Iterator<RestEndpoint> observers()

Specified by:

observers in interface org.refcodes.observer.Observers<RestEndpoint,RestServer>

withBaseLocator

public HttpRestServer withBaseLocator(String aBaseLocator)

Specified by:

withBaseLocator in interface org.refcodes.net.BaseLocatorAccessor.BaseLocatorBuilder<RestServer>

Specified by:

withBaseLocator in interface HttpRestServer

Specified by:

withBaseLocator in interface RestServer

withClose

public HttpRestServer withClose()
                         throws org.refcodes.component.CloseException

Specified by:

withClose in interface org.refcodes.component.Closable.CloseBuilder<org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

Specified by:

withClose in interface HttpRestServer

Throws:

org.refcodes.component.CloseException

withCloseIn

public HttpRestServer withCloseIn(int aCloseInMillis)

Specified by:

withCloseIn in interface org.refcodes.component.Closable.CloseBuilder<org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

Specified by:

withCloseIn in interface HttpRestServer

withCloseQuietly

public HttpRestServer withCloseQuietly()

Specified by:

withCloseQuietly in interface org.refcodes.component.Closable.CloseBuilder<org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

Specified by:

withCloseQuietly in interface HttpRestServer

withCloseUnchecked

public HttpRestServer withCloseUnchecked()

Specified by:

withCloseUnchecked in interface org.refcodes.component.Closable.CloseBuilder<org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

withDisableRequestCorrelation

public HttpRestServer withDisableRequestCorrelation()

Specified by:

withDisableRequestCorrelation in interface HttpRestServer

Specified by:

withDisableRequestCorrelation in interface RestServer

Specified by:

withDisableRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

withDisableSessionCorrelation

public HttpRestServer withDisableSessionCorrelation()

Specified by:

withDisableSessionCorrelation in interface HttpRestServer

Specified by:

withDisableSessionCorrelation in interface RestServer

Specified by:

withDisableSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

withEnableRequestCorrelation

public HttpRestServer withEnableRequestCorrelation()

Specified by:

withEnableRequestCorrelation in interface HttpRestServer

Specified by:

withEnableRequestCorrelation in interface RestServer

Specified by:

withEnableRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

withEnableSessionCorrelation

public HttpRestServer withEnableSessionCorrelation()

Specified by:

withEnableSessionCorrelation in interface HttpRestServer

Specified by:

withEnableSessionCorrelation in interface RestServer

Specified by:

withEnableSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

withOpen

public HttpRestServer withOpen(org.refcodes.net.HttpServerContext aConnection)
                        throws org.refcodes.component.OpenException

Specified by:

withOpen in interface org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<org.refcodes.net.HttpServerContext,org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

Specified by:

withOpen in interface HttpRestServer

Throws:

org.refcodes.component.OpenException

withOpenUnchecked

public HttpRestServer withOpenUnchecked(org.refcodes.net.HttpServerContext aConnection)

Specified by:

withOpenUnchecked in interface org.refcodes.component.ConnectionOpenable.ConnectionOpenBuilder<org.refcodes.net.HttpServerContext,org.refcodes.component.ConnectionComponent.ConnectionComponentBuilder<org.refcodes.net.HttpServerContext,HttpRestServer>>

withRealm

public HttpRestServer withRealm(String aRealm)

Specified by:

withRealm in interface org.refcodes.net.RealmAccessor.RealmBuilder<RestServer>

Specified by:

withRealm in interface HttpRestServer

Specified by:

withRealm in interface RestServer

withRequestCorrelation

public HttpRestServer withRequestCorrelation(boolean hasRequestCorrelation)

Specified by:

withRequestCorrelation in interface HttpRestServer

Specified by:

withRequestCorrelation in interface RestServer

Specified by:

withRequestCorrelation in interface org.refcodes.runtime.RequestCorrelation<RestServer>

withSessionCorrelation

public HttpRestServer withSessionCorrelation(boolean hasSessionCorrelation)

Specified by:

withSessionCorrelation in interface HttpRestServer

Specified by:

withSessionCorrelation in interface RestServer

Specified by:

withSessionCorrelation in interface org.refcodes.runtime.SessionCorrelation<RestServer>

getMaxConnections

public int getMaxConnections()

Specified by:

getMaxConnections in interface org.refcodes.io.MaxConnectionsAccessor

getKeyStoreDescriptor

public org.refcodes.security.KeyStoreDescriptor getKeyStoreDescriptor()

Specified by:

getKeyStoreDescriptor in interface org.refcodes.security.KeyStoreDescriptorAccessor

setKeyStoreDescriptor

public void setKeyStoreDescriptor(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor)

Specified by:

setKeyStoreDescriptor in interface org.refcodes.security.KeyStoreDescriptorAccessor.KeyStoreDescriptorMutator

setMaxConnections

public void setMaxConnections(int aMaxConnections)

Specified by:

setMaxConnections in interface org.refcodes.io.MaxConnectionsAccessor.MaxConnectionsMutator

setProtocol

public void setProtocol(String aProtocol)

Specified by:

setProtocol in interface org.refcodes.net.SchemeAccessor.SchemeMutator

toProtocol

public String toProtocol()

Specified by:

toProtocol in interface org.refcodes.net.SchemeAccessor