Class LoopbackRestServer

java.lang.Object

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

org.refcodes.rest.AbstractRestServer

org.refcodes.rest.LoopbackRestServer

All Implemented Interfaces:

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

Direct Known Subclasses:

LoopbackRestServerSingleton

public class LoopbackRestServer
extends AbstractRestServer

Implements a RestServer to be used as loopback device e.g. for testing purposes such as testing your RestRequestConsumer implementations. Use the onHttpRequest(InetSocketAddress, InetSocketAddress, HttpMethod, Url, RequestHeaderFields, InputStream, HttpServerResponse) method to simulate REST requests on the LoopbackRestServer. An registered RestEndpoint instances being targeted at will be invoked accordingly.

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

Field Summary

Fields inherited from class AbstractRestServer

_isVerbose

Constructor Summary

Constructors

Constructor	Description
LoopbackRestServer()

Method Summary

Modifier and Type	Method	Description
void	onHttpRequest(InetSocketAddress aLocalAddress, InetSocketAddress aClientAddress, HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aRequestHeaderFields, InputStream aHttpInputStream, HttpServerResponse aHttpServerResponse)	Invoke this method to simulate a REST request to be handled by the according registered RestEndpoint instances:.
void	onHttpRequest(InetSocketAddress aLocalAddress, InetSocketAddress aClientAddress, HttpMethod aHttpMethod, Url aUrl, RequestHeaderFields aRequestHeaderFields, String aHttpBody, HttpServerResponse aHttpServerResponse)	Invoke this method to simulate a REST request to be handled by the according registered RestEndpoint instances:.
LoopbackRestServer	withBaseLocator(String aBaseLocator)
LoopbackRestServer	withDisableObservers()
LoopbackRestServer	withEnableObservers()
LoopbackRestServer	withObserversActive(boolean isActive)
LoopbackRestServer	withRealm(String aRealm)

Methods inherited from class AbstractRestServer

addMediaTypeFactory, dispose, fireEvent, getBaseLocator, getFactoryMediaTypes, getRealm, initMedaTypeFactories, isObserversActive, observers, postIntercept, preIntercept, 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.BaseLocatorProperty

letBaseLocator

Methods inherited from interface MediaTypeFactoryLookup

hasMediaTypeFactory

Methods inherited from interface Observable

hasObserver

Methods inherited from interface Observers

disableObservers, enableObservers

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

Constructor Details

LoopbackRestServer

public LoopbackRestServer()

Method Details

onHttpRequest

public void onHttpRequest(InetSocketAddress aLocalAddress,
 InetSocketAddress aClientAddress,
 HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aRequestHeaderFields,
 String aHttpBody,
 HttpServerResponse aHttpServerResponse)
                   throws HttpStatusException

Invoke this method to simulate a REST request to be handled by the according registered RestEndpoint instances:.

Parameters:

aLocalAddress - the local address

aClientAddress - the client address

aHttpMethod - The method for the simulated REST request to be used

aUrl - The query string part of the request.

aRequestHeaderFields - The simulated REST request's Header-Fields to be used

aHttpBody - The raw body for the simulated REST request to be used.

aHttpServerResponse - The HttpServerResponse to be filled with the complete result of processing the request.

Throws:

HttpStatusException - thrown in case of HTTP status code related exceptions (e.g. as of a HTTP response was of an erroneous status).

onHttpRequest

public void onHttpRequest(InetSocketAddress aLocalAddress,
 InetSocketAddress aClientAddress,
 HttpMethod aHttpMethod,
 Url aUrl,
 RequestHeaderFields aRequestHeaderFields,
 InputStream aHttpInputStream,
 HttpServerResponse aHttpServerResponse)
                   throws HttpStatusException

Invoke this method to simulate a REST request to be handled by the according registered RestEndpoint instances:.

Overrides:

onHttpRequest in class AbstractRestServer

Parameters:

aLocalAddress - the local address

aClientAddress - the client address

aHttpMethod - The method for the simulated REST request to be used

aUrl - The query string part of the request.

aRequestHeaderFields - The simulated REST request's Header-Fields to be used

aHttpInputStream - The HTTP InputStream representing the body for the simulated REST request to be used.

aHttpServerResponse - The HttpServerResponse to be filled with the complete result of processing the request.

Throws:

HttpStatusException - thrown in case of HTTP status code related exceptions (e.g. as of a HTTP response was of an erroneous status).

withBaseLocator

public LoopbackRestServer withBaseLocator(String aBaseLocator)

withRealm

public LoopbackRestServer withRealm(String aRealm)

withObserversActive

public LoopbackRestServer withObserversActive(boolean isActive)

withEnableObservers

public LoopbackRestServer withEnableObservers()

withDisableObservers

public LoopbackRestServer withDisableObservers()