Package org.refcodes.rest

Class HttpRestServerSugar

java.lang.Object

org.refcodes.rest.HttpRestServerSugar

public class HttpRestServerSugar
extends Object

Declarative syntactic sugar which may be statically imported in order to allow declarative definitions of RESTful server functionality: import static org.refcodes.rest.HttpRestServerSugar.*;

Constructor Summary

Constructors

Constructor	Description
HttpRestServerSugar()

Method Summary

Modifier and Type	Method	Description
static HttpRestServer	close()	See Closable.close()
static HttpRestServer	closeIn(int aCloseInMillis)	See Closable.closeIn(int)
static HttpRestServer	closeQuietly()	See Closable.closeQuietly()
static HttpRestServer	onBasicAuthRequest(org.refcodes.net.BasicAuthObserver aObserver)	See BasicAuthObservable.onBasicAuthRequest(BasicAuthObserver)
static RestEndpointBuilder	onDelete(String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onDelete(String, RestRequestObserver)
static RestEndpointBuilder	onDelete(Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onDelete(String, RestRequestObserver)
static RestEndpointBuilder	onGet(String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onGet(String, RestRequestObserver)
static RestEndpointBuilder	onGet(Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onGet(String, RestRequestObserver)
static RestEndpointBuilder	onPost(String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onPost(String, RestRequestObserver)
static RestEndpointBuilder	onPost(Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onPost(String, RestRequestObserver)
static RestEndpointBuilder	onPut(String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onPut(String, RestRequestObserver)
static RestEndpointBuilder	onPut(Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onPut(String, RestRequestObserver)
static RestEndpointBuilder	onRequest(String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onRequest(String, RestRequestObserver)
static RestEndpointBuilder	onRequest(Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onRequest(String, RestRequestObserver)
static RestEndpointBuilder	onRequest(org.refcodes.net.HttpMethod aHttpMethod, String aLocatorPathPattern, RestRequestObserver aRequestObserver)	See RestServer.onRequest(HttpMethod, String, RestRequestObserver)
static RestEndpointBuilder	onRequest(org.refcodes.net.HttpMethod aHttpMethod, Pattern aLocatorRegExp, RestRequestObserver aRequestObserver)	See RestServer.onRequest(HttpMethod, String, RestRequestObserver)
static HttpRestServer	open(int aPort)	See HttpRestServer.open(int)
static HttpRestServer	open(int aPort, int aMaxConnections)	See HttpRestServer.open(int, int)
static HttpRestServer	open(String aSecureSocketProtocol, org.refcodes.security.KeyStoreDescriptor aStoreDescriptor, Integer aPort)	See HttpRestServer.open(String, KeyStoreDescriptor, int)
static HttpRestServer	open(String aSecureSocketProtocol, org.refcodes.security.KeyStoreDescriptor aStoreDescriptor, Integer aPort, int aMaxConnections)	See HttpRestServer.open(String, KeyStoreDescriptor, int, int).
static HttpRestServer	open(org.refcodes.net.HttpServerContext aCtx)	See ConnectionOpenable.open(Object)
static HttpRestServer	open(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor, Integer aPort)	See HttpRestServer.open(KeyStoreDescriptor, int)
static HttpRestServer	open(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor, Integer aPort, int aMaxConnections)	See HttpRestServer.open(KeyStoreDescriptor, int, int )
static boolean	unsubscribeObserver(RestEndpoint aEndpoint)	See Observable.unsubscribeObserver(Object)
static HttpRestServer	withBaseLocator(String aBaseLocator)	See HttpRestServer.withBaseLocator(String).
static HttpRestServer	withRealm(String aRealm)	See HttpRestServer.withRealm(String)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpRestServerSugar

public HttpRestServerSugar()

Method Detail

close

public static HttpRestServer close()
                            throws org.refcodes.component.CloseException

See Closable.close()

Returns:

The HttpRestServer

Throws:

org.refcodes.component.CloseException - the close exception

closeIn

public static HttpRestServer closeIn(int aCloseInMillis)

See Closable.closeIn(int)

Parameters:

aCloseInMillis - The close in millis

Returns:

The HttpRestServer

closeQuietly

public static HttpRestServer closeQuietly()

See Closable.closeQuietly()

Returns:

The HttpRestServer

onBasicAuthRequest

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

See BasicAuthObservable.onBasicAuthRequest(BasicAuthObserver)

Parameters:

aObserver - The observer

Returns:

The HttpRestServer

onDelete

public static RestEndpointBuilder onDelete(String aLocatorPathPattern,
                                           RestRequestObserver aRequestObserver)

See RestServer.onDelete(String, RestRequestObserver)

Parameters:

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onGet

public static RestEndpointBuilder onGet(String aLocatorPathPattern,
                                        RestRequestObserver aRequestObserver)

See RestServer.onGet(String, RestRequestObserver)

Parameters:

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onPost

public static RestEndpointBuilder onPost(String aLocatorPathPattern,
                                         RestRequestObserver aRequestObserver)

See RestServer.onPost(String, RestRequestObserver)

Parameters:

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder See RestServer.onPost(String, RestRequestObserver)

onPut

public static RestEndpointBuilder onPut(String aLocatorPathPattern,
                                        RestRequestObserver aRequestObserver)

See RestServer.onPut(String, RestRequestObserver)

Parameters:

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onRequest

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

See RestServer.onRequest(HttpMethod, String, RestRequestObserver)

Parameters:

aHttpMethod - The HTTP-Method

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onRequest

public static RestEndpointBuilder onRequest(String aLocatorPathPattern,
                                            RestRequestObserver aRequestObserver)

See RestServer.onRequest(String, RestRequestObserver)

Parameters:

aLocatorPathPattern - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onDelete

public static RestEndpointBuilder onDelete(Pattern aLocatorRegExp,
                                           RestRequestObserver aRequestObserver)

See RestServer.onDelete(String, RestRequestObserver)

Parameters:

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onGet

public static RestEndpointBuilder onGet(Pattern aLocatorRegExp,
                                        RestRequestObserver aRequestObserver)

See RestServer.onGet(String, RestRequestObserver)

Parameters:

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onPost

public static RestEndpointBuilder onPost(Pattern aLocatorRegExp,
                                         RestRequestObserver aRequestObserver)

See RestServer.onPost(String, RestRequestObserver)

Parameters:

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder See RestServer.onPost(String, RestRequestObserver)

onPut

public static RestEndpointBuilder onPut(Pattern aLocatorRegExp,
                                        RestRequestObserver aRequestObserver)

See RestServer.onPut(String, RestRequestObserver)

Parameters:

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onRequest

public static RestEndpointBuilder onRequest(org.refcodes.net.HttpMethod aHttpMethod,
                                            Pattern aLocatorRegExp,
                                            RestRequestObserver aRequestObserver)

See RestServer.onRequest(HttpMethod, String, RestRequestObserver)

Parameters:

aHttpMethod - The HTTP-Method

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

onRequest

public static RestEndpointBuilder onRequest(Pattern aLocatorRegExp,
                                            RestRequestObserver aRequestObserver)

See RestServer.onRequest(String, RestRequestObserver)

Parameters:

aLocatorRegExp - The locator pattern

aRequestObserver - The request observer

Returns:

The RestEndpointBuilder

open

public static HttpRestServer open(org.refcodes.net.HttpServerContext aCtx)
                           throws org.refcodes.component.OpenException

See ConnectionOpenable.open(Object)

Parameters:

aCtx - The context describing the parameters required to open the connection.

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

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

See HttpRestServer.open(int)

Parameters:

aPort - The port

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

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

See HttpRestServer.open(int, int)

Parameters:

aPort - The port

aMaxConnections - The max connections

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

public static HttpRestServer open(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                                  Integer aPort)
                           throws org.refcodes.component.OpenException

See HttpRestServer.open(KeyStoreDescriptor, int)

Parameters:

aStoreDescriptor - The store descriptor describing your KeyStore required by HTTP.

aPort - The port

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

public static HttpRestServer open(org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                                  Integer aPort,
                                  int aMaxConnections)
                           throws org.refcodes.component.OpenException

See HttpRestServer.open(KeyStoreDescriptor, int, int )

Parameters:

aStoreDescriptor - The store descriptor describing your KeyStore required by HTTP.

aPort - The port

aMaxConnections - The max connections

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

public static HttpRestServer open(String aSecureSocketProtocol,
                                  org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                                  Integer aPort)
                           throws org.refcodes.component.OpenException

See HttpRestServer.open(String, KeyStoreDescriptor, int)

Parameters:

aSecureSocketProtocol - The secure socket protocol

aStoreDescriptor - The store descriptor describing your KeyStore required by HTTP.

aPort - The port

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

open

public static HttpRestServer open(String aSecureSocketProtocol,
                                  org.refcodes.security.KeyStoreDescriptor aStoreDescriptor,
                                  Integer aPort,
                                  int aMaxConnections)
                           throws org.refcodes.component.OpenException

See HttpRestServer.open(String, KeyStoreDescriptor, int, int).

Parameters:

aSecureSocketProtocol - The secure socket protocol

aStoreDescriptor - The store descriptor describing your KeyStore required by HTTP.

aPort - The port

aMaxConnections - The max connections

Returns:

The HttpRestServer

Throws:

org.refcodes.component.OpenException - thrown in case the open operation caused problems.

unsubscribeObserver

public static boolean unsubscribeObserver(RestEndpoint aEndpoint)

See Observable.unsubscribeObserver(Object)

Parameters:

aEndpoint - The endpoint

Returns:

true, if successful

withBaseLocator

public static HttpRestServer withBaseLocator(String aBaseLocator)

See HttpRestServer.withBaseLocator(String).

Parameters:

aBaseLocator - The base locator

Returns:

The HttpRestServer

withRealm

public static HttpRestServer withRealm(String aRealm)

See HttpRestServer.withRealm(String)

Parameters:

aRealm - The realm

Returns:

The HttpRestServer