Interface RestServer

All Superinterfaces:

BaseLocatorAccessor, BaseLocatorAccessor.BaseLocatorBuilder<RestServer>, BaseLocatorAccessor.BaseLocatorMutator, BaseLocatorAccessor.BaseLocatorProperty, MediaTypeFactoryLookup, MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, Observable<RestEndpoint>, Observers<RestEndpoint, RestServer>, RealmAccessor, RealmAccessor.RealmBuilder<RestServer>, RealmAccessor.RealmMutator, RealmAccessor.RealmProperty

All Known Subinterfaces:

HttpRestRegistryServer<DESC,B>, HttpRestServer

All Known Implementing Classes:

AbstractHttpRestRegistryServerDecorator, AbstractHttpRestServerDecorator, AbstractRestServer, JdkHttpRestServer, JdkHttpRestServerSingleton, LoopbackRestServer, LoopbackRestServerSingleton

public interface RestServer
extends Observable<RestEndpoint>, Observers<RestEndpoint, RestServer>, MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup, RealmAccessor.RealmProperty, RealmAccessor.RealmBuilder<RestServer>, BaseLocatorAccessor.BaseLocatorProperty, BaseLocatorAccessor.BaseLocatorBuilder<RestServer>

The RestServer acts as the target for clients issuing REST requests. RestEndpointBuilder instances, most easily being created with the onRequest(HttpMethod, String, RestRequestConsumer) method (or the like), are registered as listeners to the RestServer ( HttpRestServer). The RestServer (HttpRestServer) fires RestRequestEvent events to the RestRequestConsumers of an RestEndpoint dedicated to an according locator (pattern) for a specific HttpMethod.

Nested Class Summary

Nested classes/interfaces inherited from interface BaseLocatorAccessor

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

Nested classes/interfaces inherited from interface MediaTypeFactoryLookup

MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup

Nested classes/interfaces inherited from interface RealmAccessor

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

Method Summary

Modifier and Type	Method	Description
default RestEndpointBuilder	onDelete(String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming DELETE methods.
default RestEndpointBuilder	onDelete(Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming DELETE methods.
default RestEndpointBuilder	onGet(String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming GET methods.
default RestEndpointBuilder	onGet(Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming GET methods.
default RestEndpointBuilder	onPost(String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming POST methods.
default RestEndpointBuilder	onPost(Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming POST methods.
default RestEndpointBuilder	onPut(String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming PUT methods.
default RestEndpointBuilder	onPut(Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Even more convenient: Everything done here can also be done using onRequest(HttpMethod, String, RestRequestConsumer): Registers a RestRequestConsumer with the given Locator-Pattern to incoming PUT methods.
default RestEndpointBuilder	onRequest(String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Registers a preconfigured RestEndpoint, triggerd by any HTTP method, and returns its instance.
default RestEndpointBuilder	onRequest(Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Registers a preconfigured RestEndpoint, triggerd by any HTTP method, and returns its instance.
default boolean	onRequest(RestEndpoint aRestEndpoint)	For the sake of unified naming, this method just delegates to Observable.subscribeObserver(Object).
default RestEndpointBuilder	onRequest(HttpMethod aHttpMethod, String aLocatorPathPattern, RestRequestConsumer aRequestConsumer)	Registers a preconfigured RestEndpoint with the least required attributes and returns its instance.
default RestEndpointBuilder	onRequest(HttpMethod aHttpMethod, Pattern aLocatorRegExp, RestRequestConsumer aRequestConsumer)	Registers a preconfigured RestEndpoint with the least required attributes and returns its instance.
default RestServer	withBaseLocator(String aBaseLocator)
default RestServer	withDisableObservers()
default RestServer	withEnableObservers()
default RestServer	withObserversActive(boolean isActive)
default RestServer	withRealm(String aRealm)

Methods inherited from interface BaseLocatorAccessor

getBaseLocator

Methods inherited from interface BaseLocatorAccessor.BaseLocatorMutator

setBaseLocator

Methods inherited from interface BaseLocatorAccessor.BaseLocatorProperty

letBaseLocator

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 RealmAccessor

getRealm

Methods inherited from interface RealmAccessor.RealmMutator

setRealm

Methods inherited from interface RealmAccessor.RealmProperty

letRealm

Method Details

withObserversActive

default RestServer withObserversActive(boolean isActive)

Specified by:

withObserversActive in interface Observers<RestEndpoint, RestServer>

withEnableObservers

default RestServer withEnableObservers()

Specified by:

withEnableObservers in interface Observers<RestEndpoint, RestServer>

withDisableObservers

default RestServer withDisableObservers()

Specified by:

withDisableObservers in interface Observers<RestEndpoint, RestServer>

onRequest

default boolean onRequest(RestEndpoint aRestEndpoint)

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

Parameters:

aRestEndpoint - the rest endpoint

Returns:

true, if successful

withBaseLocator

default RestServer withBaseLocator(String aBaseLocator)

Specified by:

withBaseLocator in interface BaseLocatorAccessor.BaseLocatorBuilder<RestServer>

withRealm

default RestServer withRealm(String aRealm)

Specified by:

withRealm in interface RealmAccessor.RealmBuilder<RestServer>

onRequest

default RestEndpointBuilder onRequest(String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorPathPattern - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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

onRequest

default RestEndpointBuilder onRequest(Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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

onRequest

default RestEndpointBuilder onRequest(HttpMethod aHttpMethod,
 String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

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

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

Returns:

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

onRequest

default RestEndpointBuilder onRequest(HttpMethod aHttpMethod,
 Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound. A value of null means that any locator may trigger this RestEndpoint.

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

Returns:

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

onGet

default RestEndpointBuilder onGet(String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

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

Returns:

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

onGet

default RestEndpointBuilder onGet(Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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

onPut

default RestEndpointBuilder onPut(String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

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

Returns:

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

onPut

default RestEndpointBuilder onPut(Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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

onPost

default RestEndpointBuilder onPost(String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

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

Returns:

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

onPost

default RestEndpointBuilder onPost(Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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

onDelete

default RestEndpointBuilder onDelete(String aLocatorPathPattern,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

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

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

Returns:

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

onDelete

default RestEndpointBuilder onDelete(Pattern aLocatorRegExp,
 RestRequestConsumer aRequestConsumer)

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

Parameters:

aLocatorRegExp - The local locator (regular expression) pattern to which this RestEndpoint is bound.

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

Returns:

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