java.lang.Object
org.refcodes.observer.AbstractObservable<RestEndpoint,org.refcodes.web.HttpRequest>
org.refcodes.rest.AbstractRestServer
- All Implemented Interfaces:
org.refcodes.mixin.Disposable
,org.refcodes.mixin.Loggable
,org.refcodes.observer.Observable<RestEndpoint>
,org.refcodes.observer.Observers<RestEndpoint,
,RestServer> HttpExceptionHandlerAccessor
,HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<RestServer>
,HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator
,HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty
,HttpExceptionHandlingAccessor
,HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<RestServer>
,HttpExceptionHandlingAccessor.HttpExceptionHandlingMutator
,HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty
,RestServer
,org.refcodes.runtime.RequestCorrelation<RestServer>
,org.refcodes.runtime.SessionCorrelation<RestServer>
,org.refcodes.web.BaseLocatorAccessor
,org.refcodes.web.BaseLocatorAccessor.BaseLocatorBuilder<RestServer>
,org.refcodes.web.BaseLocatorAccessor.BaseLocatorMutator
,org.refcodes.web.BaseLocatorAccessor.BaseLocatorProperty
,org.refcodes.web.MediaTypeFactoryLookup
,org.refcodes.web.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup
,org.refcodes.web.RealmAccessor
,org.refcodes.web.RealmAccessor.RealmBuilder<RestServer>
,org.refcodes.web.RealmAccessor.RealmMutator
,org.refcodes.web.RealmAccessor.RealmProperty
- Direct Known Subclasses:
HttpRestServerImpl
,LoopbackRestServerImpl
public abstract class AbstractRestServer
extends org.refcodes.observer.AbstractObservable<RestEndpoint,org.refcodes.web.HttpRequest>
implements RestServer
Implementation of the base functionality of the
RestServer
interface
omitting the HTTP handling part being the foundation for various
RestServer
implementations such as HttpRestServerImpl
or
LoopbackRestServerImpl
. The AbstractRestServer
is
pre-configured with the following MediaTypeFactory
instances:
JsonMediaTypeFactory
XmlMediaTypeFactory
TextMediaTypeFactory
FormMediaTypeFactory
initMedaTypeFactories()
,
therein calling addMediaTypeFactory(MediaTypeFactory)
to add (by
also invoking super's initMedaTypeFactories()
) or to set your own
(without invoking super's initMedaTypeFactories()
)
MediaTypeFactory
instances.-
Nested Class Summary
Nested classes/interfaces inherited from interface org.refcodes.web.BaseLocatorAccessor
org.refcodes.web.BaseLocatorAccessor.BaseLocatorBuilder<B extends org.refcodes.web.BaseLocatorAccessor.BaseLocatorBuilder<B>>, org.refcodes.web.BaseLocatorAccessor.BaseLocatorMutator, org.refcodes.web.BaseLocatorAccessor.BaseLocatorProperty
Nested classes/interfaces inherited from interface org.refcodes.rest.HttpExceptionHandlerAccessor
HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<B extends HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder<B>>, HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator, HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty
Nested classes/interfaces inherited from interface org.refcodes.rest.HttpExceptionHandlingAccessor
HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<B extends HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder<B>>, HttpExceptionHandlingAccessor.HttpExceptionHandlingMutator, HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty
Nested classes/interfaces inherited from interface org.refcodes.web.MediaTypeFactoryLookup
org.refcodes.web.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup
Nested classes/interfaces inherited from interface org.refcodes.web.RealmAccessor
org.refcodes.web.RealmAccessor.RealmBuilder<B extends org.refcodes.web.RealmAccessor.RealmBuilder<B>>, org.refcodes.web.RealmAccessor.RealmMutator, org.refcodes.web.RealmAccessor.RealmProperty
-
Field Summary
Modifier and TypeFieldDescriptionprotected boolean
protected boolean
protected HttpExceptionHandler
protected HttpExceptionHandling
Fields inherited from interface org.refcodes.mixin.Loggable
RUNTIME_LOGGER_CLASS, RUNTIME_LOGGER_FACTORY_CLASS, RUNTIME_LOGGER_FACTORY_METHOD
-
Constructor Summary
ConstructorDescriptionConstructs aAbstractRestServer
pre-configured withMediaTypeFactory
instances for JSON and REST.AbstractRestServer
(ExecutorService aExecutorService) CConstructs aAbstractRestServer
pre-configured withMediaTypeFactory
instances for JSON and REST. -
Method Summary
Modifier and TypeMethodDescriptionboolean
addMediaTypeFactory
(org.refcodes.web.MediaTypeFactory aMediaTypeFactory) void
dispose()
protected void
doRequestCorrelation
(org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.HttpServerResponse aServerResponse) Do request correlation.protected void
doSessionCorrelation
(org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.HttpServerResponse aServerResponse) Do session correlation.protected boolean
fireEvent
(org.refcodes.web.HttpRequest aEvent, RestEndpoint aObserver, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) org.refcodes.web.MediaType[]
Retrieves theHttpExceptionHandler
from theHttpExceptionHandler
property.Retrieves theHttpExceptionHandling
from theHttpExceptionHandling
property.getRealm()
boolean
boolean
protected void
Adds the defaultMediaTypeFactory
instances.boolean
protected void
onHttpRequest
(InetSocketAddress aLocalAddress, InetSocketAddress aRemoteAddress, org.refcodes.web.HttpMethod aHttpMethod, org.refcodes.web.Url aUrl, org.refcodes.web.RequestHeaderFields aRequestHeaderFields, InputStream aHttpInputStream, org.refcodes.web.HttpServerResponse aHttpServerResponse) Extensions of this class disect an incoming request and pass it to this method for doing the actual invocation of the registeredRestEndpoint
instances.void
setBaseLocator
(String aBaseLocator) void
setHttpExceptionHandler
(HttpExceptionHandler aHttpErrorHandler) Sets theHttpExceptionHandler
for theHttpExceptionHandler
property.void
setHttpExceptionHandling
(HttpExceptionHandling aHttpErrorHandling) Sets theHttpExceptionHandling
for theHttpExceptionHandling
property.void
setObserversActive
(boolean isActive) void
void
setRequestCorrelation
(boolean hasRequestCorrelation) void
setSessionCorrelation
(boolean hasSessionCorrelation) boolean
subscribeObserver
(RestEndpoint aObserver) org.refcodes.web.MediaTypeFactory
toMediaTypeFactory
(org.refcodes.web.MediaType aMediaType) protected org.refcodes.web.ContentType
toNegotiatedContenType
(org.refcodes.web.RequestHeaderFields aRequestHeaderFields) Determines the best fitting respone'sContentType
.protected byte[]
toResponseBody
(Object aResponse, org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.ResponseHeaderFields aResponseHeaderFields) Creates aString
MediaType
encoded as of theHeaderField.CONTENT_TYPE
from the response header or if not set as of theHeaderField.ACCEPT
from the request header or if not set as of theHeaderField.CONTENT_TYPE
from the request header.boolean
unsubscribeObserver
(RestEndpoint aObserver) Methods inherited from class org.refcodes.observer.AbstractObservable
clear, doHandleEventListenerException, fireEvent, getThreadPriority, hasObserverSubscription, isEmpty, setThreadPriority, size
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Methods inherited from interface org.refcodes.web.BaseLocatorAccessor.BaseLocatorProperty
letBaseLocator
Methods inherited from interface org.refcodes.rest.HttpExceptionHandlerAccessor.HttpExceptionHandlerBuilder
withHttpExceptionHandler, withOnHttpException
Methods inherited from interface org.refcodes.rest.HttpExceptionHandlerAccessor.HttpExceptionHandlerMutator
onHttpException
Methods inherited from interface org.refcodes.rest.HttpExceptionHandlerAccessor.HttpExceptionHandlerProperty
letHttpExceptionHandler
Methods inherited from interface org.refcodes.rest.HttpExceptionHandlingAccessor.HttpExceptionHandlingBuilder
withHttpExceptionHandling
Methods inherited from interface org.refcodes.rest.HttpExceptionHandlingAccessor.HttpExceptionHandlingProperty
letHttpExceptionHandling
Methods inherited from interface org.refcodes.mixin.Loggable
alert, alert, critical, critical, debug, error, info, notice, panic, trace, warn, warn
Methods inherited from interface org.refcodes.web.MediaTypeFactoryLookup
hasMediaTypeFactory
Methods inherited from interface org.refcodes.observer.Observable
hasObserverSubscription
Methods inherited from interface org.refcodes.observer.Observers
disableObservers, enableObservers
Methods inherited from interface org.refcodes.web.RealmAccessor.RealmProperty
letRealm
Methods inherited from interface org.refcodes.runtime.RequestCorrelation
disableRequestCorrelation, enableRequestCorrelation
Methods inherited from interface org.refcodes.rest.RestServer
onDelete, onDelete, onGet, onGet, onPost, onPost, onPut, onPut, onRequest, onRequest, onRequest, onRequest, onRequest, withBaseLocator, withDisableObservers, withDisableRequestCorrelation, withDisableSessionCorrelation, withEnableObservers, withEnableRequestCorrelation, withEnableSessionCorrelation, withObserversActive, withRealm, withRequestCorrelation, withSessionCorrelation
Methods inherited from interface org.refcodes.runtime.SessionCorrelation
disableSessionCorrelation, enableSessionCorrelation
-
Field Details
-
_hasRequestCorrelation
protected boolean _hasRequestCorrelation -
_hasSessionCorrelation
protected boolean _hasSessionCorrelation -
_httpExceptionHandling
-
_httpExceptionHandler
-
-
Constructor Details
-
AbstractRestServer
public AbstractRestServer()Constructs aAbstractRestServer
pre-configured withMediaTypeFactory
instances for JSON and REST. -
AbstractRestServer
CConstructs aAbstractRestServer
pre-configured withMediaTypeFactory
instances for JSON and REST.- Parameters:
aExecutorService
- An executor service to be used when creatingThread
s.
-
-
Method Details
-
initMedaTypeFactories
protected void initMedaTypeFactories()Adds the defaultMediaTypeFactory
instances. Can be overridden. -
getHttpExceptionHandler
Retrieves theHttpExceptionHandler
from theHttpExceptionHandler
property.- Specified by:
getHttpExceptionHandler
in interfaceHttpExceptionHandlerAccessor
- Returns:
- The
HttpExceptionHandler
stored by theHttpExceptionHandler
property.
-
setHttpExceptionHandler
Sets theHttpExceptionHandler
for theHttpExceptionHandler
property.- Specified by:
setHttpExceptionHandler
in interfaceHttpExceptionHandlerAccessor.HttpExceptionHandlerMutator
- Parameters:
aHttpErrorHandler
- TheHttpExceptionHandler
to be stored by theHttpExceptionHandler
property.
-
getHttpExceptionHandling
Retrieves theHttpExceptionHandling
from theHttpExceptionHandling
property.- Specified by:
getHttpExceptionHandling
in interfaceHttpExceptionHandlingAccessor
- Returns:
- The
HttpExceptionHandling
stored by theHttpExceptionHandling
property.
-
setHttpExceptionHandling
Sets theHttpExceptionHandling
for theHttpExceptionHandling
property.- Specified by:
setHttpExceptionHandling
in interfaceHttpExceptionHandlingAccessor.HttpExceptionHandlingMutator
- Parameters:
aHttpErrorHandling
- TheHttpExceptionHandling
to be stored by theHttpExceptionHandling
property.
-
setObserversActive
public void setObserversActive(boolean isActive) - Specified by:
setObserversActive
in interfaceorg.refcodes.observer.Observers<RestEndpoint,
RestServer> - Overrides:
setObserversActive
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
isObserversActive
public boolean isObserversActive()- Specified by:
isObserversActive
in interfaceorg.refcodes.observer.Observers<RestEndpoint,
RestServer> - Overrides:
isObserversActive
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
observers
- Specified by:
observers
in interfaceorg.refcodes.observer.Observers<RestEndpoint,
RestServer> - Overrides:
observers
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
setRequestCorrelation
public void setRequestCorrelation(boolean hasRequestCorrelation) - Specified by:
setRequestCorrelation
in interfaceorg.refcodes.runtime.RequestCorrelation<RestServer>
-
hasRequestCorrelation
public boolean hasRequestCorrelation()- Specified by:
hasRequestCorrelation
in interfaceorg.refcodes.runtime.RequestCorrelation<RestServer>
-
setSessionCorrelation
public void setSessionCorrelation(boolean hasSessionCorrelation) - Specified by:
setSessionCorrelation
in interfaceorg.refcodes.runtime.SessionCorrelation<RestServer>
-
hasSessionCorrelation
public boolean hasSessionCorrelation()- Specified by:
hasSessionCorrelation
in interfaceorg.refcodes.runtime.SessionCorrelation<RestServer>
-
getRealm
- Specified by:
getRealm
in interfaceorg.refcodes.web.RealmAccessor
-
setRealm
- Specified by:
setRealm
in interfaceorg.refcodes.web.RealmAccessor.RealmMutator
-
getBaseLocator
- Specified by:
getBaseLocator
in interfaceorg.refcodes.web.BaseLocatorAccessor
-
setBaseLocator
- Specified by:
setBaseLocator
in interfaceorg.refcodes.web.BaseLocatorAccessor.BaseLocatorMutator
-
subscribeObserver
- Specified by:
subscribeObserver
in interfaceorg.refcodes.observer.Observable<RestEndpoint>
- Overrides:
subscribeObserver
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
unsubscribeObserver
- Specified by:
unsubscribeObserver
in interfaceorg.refcodes.observer.Observable<RestEndpoint>
- Overrides:
unsubscribeObserver
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
addMediaTypeFactory
public boolean addMediaTypeFactory(org.refcodes.web.MediaTypeFactory aMediaTypeFactory) - Specified by:
addMediaTypeFactory
in interfaceorg.refcodes.web.MediaTypeFactoryLookup.MutableMediaTypeFactoryLookup
-
toMediaTypeFactory
public org.refcodes.web.MediaTypeFactory toMediaTypeFactory(org.refcodes.web.MediaType aMediaType) - Specified by:
toMediaTypeFactory
in interfaceorg.refcodes.web.MediaTypeFactoryLookup
-
getFactoryMediaTypes
public org.refcodes.web.MediaType[] getFactoryMediaTypes()- Specified by:
getFactoryMediaTypes
in interfaceorg.refcodes.web.MediaTypeFactoryLookup
-
dispose
public void dispose()- Specified by:
dispose
in interfaceorg.refcodes.mixin.Disposable
- Overrides:
dispose
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest>
-
onHttpRequest
protected void onHttpRequest(InetSocketAddress aLocalAddress, InetSocketAddress aRemoteAddress, org.refcodes.web.HttpMethod aHttpMethod, org.refcodes.web.Url aUrl, org.refcodes.web.RequestHeaderFields aRequestHeaderFields, InputStream aHttpInputStream, org.refcodes.web.HttpServerResponse aHttpServerResponse) throws org.refcodes.web.HttpStatusException Extensions of this class disect an incoming request and pass it to this method for doing the actual invocation of the registeredRestEndpoint
instances. An extension might call this method from inside an event (request) handler.- Parameters:
aLocalAddress
- The host and port of your REST service.aRemoteAddress
- The host and port for the caller.aHttpMethod
- TheHttpMethod
of the request.aUrl
- TheUrl
from which to take the URL specific data.aRequestHeaderFields
- The Header-Fields (HeaderFields
) belonging to the request.aHttpInputStream
- The body passed by the request.aHttpServerResponse
- AHttpServerResponse
instance to be used by the extension to produce an according HTTP-Response.- Throws:
org.refcodes.web.HttpStatusException
- thrown in case of anRestEndpoint
responsible for the given request encountered a problem or noneRestEndpoint
felt responsible to produce aHttpServerResponse
.
-
toNegotiatedContenType
protected org.refcodes.web.ContentType toNegotiatedContenType(org.refcodes.web.RequestHeaderFields aRequestHeaderFields) Determines the best fitting respone'sContentType
. The default Content-Type-Negotiation implementation of this method makes use of theRequestHeaderFields
and matches them against the supportedMediaType
types ( retrieved viagetFactoryMediaTypes()
). May be overwritten to enforce another Content-Type-Negotiation strategy.- Parameters:
aRequestHeaderFields
- The request'sHeaderField
instance to use when determining the best fitting respone'sContentType
.- Returns:
- The best fitting (as of the implemented Content-Type-Negotiation strategy) Content-Type to be used for the response.
-
toResponseBody
protected byte[] toResponseBody(Object aResponse, org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.ResponseHeaderFields aResponseHeaderFields) throws org.refcodes.exception.MarshalException, org.refcodes.web.UnsupportedMediaTypeException Creates aString
MediaType
encoded as of theHeaderField.CONTENT_TYPE
from the response header or if not set as of theHeaderField.ACCEPT
from the request header or if not set as of theHeaderField.CONTENT_TYPE
from the request header.- Parameters:
aResponse
- The response which to encode as of the detectedMediaType
s.aRequestHeaderFields
- The Header-Fields from the request.aResponseHeaderFields
- The Header-Fields from the response.- Returns:
- An accordingly encoded response as byte array.
- Throws:
org.refcodes.exception.MarshalException
- thrown when marshaling / serializing an object failed.org.refcodes.web.UnsupportedMediaTypeException
- thrown in case none of the identified media types is supported, e.g. no requiredMediaTypeFactory
has been registered as ofaddMediaTypeFactory(MediaTypeFactory)
.
-
fireEvent
protected boolean fireEvent(org.refcodes.web.HttpRequest aEvent, RestEndpoint aObserver, org.refcodes.controlflow.ExecutionStrategy aExecutionStrategy) throws org.refcodes.exception.VetoException - Specified by:
fireEvent
in classorg.refcodes.observer.AbstractObservable<RestEndpoint,
org.refcodes.web.HttpRequest> - Throws:
org.refcodes.exception.VetoException
-
doRequestCorrelation
protected void doRequestCorrelation(org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.HttpServerResponse aServerResponse) Do request correlation.- Parameters:
aRequestHeaderFields
- the request Header-FieldsaServerResponse
- the server response
-
doSessionCorrelation
protected void doSessionCorrelation(org.refcodes.web.RequestHeaderFields aRequestHeaderFields, org.refcodes.web.HttpServerResponse aServerResponse) Do session correlation.- Parameters:
aRequestHeaderFields
- the request Header-FieldsaServerResponse
- the server response
-