reactor.io.net.http

Class HttpServer<IN,OUT>

java.lang.Object

reactor.io.net.ReactorPeer<IN,OUT,HttpChannel<IN,OUT>>

reactor.io.net.http.HttpServer<IN,OUT>

Type Parameters:

IN - The type that will be received by this server

OUT - The type that will be sent by this server

Direct Known Subclasses:

NettyHttpServer

public abstract class HttpServer<IN,OUT>
extends ReactorPeer<IN,OUT,HttpChannel<IN,OUT>>

Base functionality needed by all servers that communicate with clients over HTTP.

Field Summary

Fields

Modifier and Type	Field and Description
protected reactor.bus.registry.Registry<HttpChannel,ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>>>	routedWriters

Fields inherited from class reactor.io.net.ReactorPeer

started

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	HttpServer(reactor.Environment env, reactor.core.Dispatcher dispatcher, reactor.io.codec.Codec<reactor.io.buffer.Buffer,IN,OUT> codec)

Method Summary

Modifier and Type	Method and Description
HttpServer<IN,OUT>	delete(java.lang.String path, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Listen for HTTP DELETE on the passed path to be used as a routing condition.
HttpServer<IN,OUT>	get(java.lang.String path, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Listen for HTTP GET on the passed path to be used as a routing condition.
abstract java.net.InetSocketAddress	getListenAddress() Get the address to which this server is bound.
protected boolean	hasWebsocketEndpoints()
protected abstract void	onWebsocket(HttpChannel<IN,OUT> next)
HttpServer<IN,OUT>	post(java.lang.String path, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Listen for HTTP POST on the passed path to be used as a routing condition.
HttpServer<IN,OUT>	put(java.lang.String path, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Listen for HTTP PUT on the passed path to be used as a routing condition.
HttpServer<IN,OUT>	route(reactor.bus.selector.Selector<HttpChannel> condition, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> serviceFunction) Register an handler for the given Selector condition, incoming connections will query the internal registry to invoke the matching handlers.
protected java.lang.Iterable<? extends org.reactivestreams.Publisher<java.lang.Void>>	routeChannel(HttpChannel<IN,OUT> ch)
reactor.rx.Promise<java.lang.Void>	start() Start the server without any global handler, only the specific routed methods (get, post...) will apply.
HttpServer<IN,OUT>	ws(java.lang.String path, ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler) Listen for WebSocket on the passed path to be used as a routing condition.

Methods inherited from class reactor.io.net.ReactorPeer

doShutdown, doStart, getDefaultCodec, getDefaultDispatcher, getDefaultEnvironment, getDefaultPrefetchSize, shutdown, start

Methods inherited from class java.lang.Object

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

Field Detail

routedWriters

protected final reactor.bus.registry.Registry<HttpChannel,ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>>> routedWriters

Constructor Detail

HttpServer

protected HttpServer(reactor.Environment env,
                     reactor.core.Dispatcher dispatcher,
                     reactor.io.codec.Codec<reactor.io.buffer.Buffer,IN,OUT> codec)

Method Detail

start

public reactor.rx.Promise<java.lang.Void> start()

Start the server without any global handler, only the specific routed methods (get, post...) will apply.

Returns:

a Promise fulfilled when server is started

getListenAddress

public abstract java.net.InetSocketAddress getListenAddress()

Get the address to which this server is bound. If port 0 was used on configuration, try resolving the port.

Returns:

the bind address

route

public HttpServer<IN,OUT> route(reactor.bus.selector.Selector<HttpChannel> condition,
                                ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> serviceFunction)

Register an handler for the given Selector condition, incoming connections will query the internal registry to invoke the matching handlers. Implementation may choose to reply 404 if no route matches.

Parameters:

condition - a Selector to match the incoming connection with registered handler

serviceFunction - an handler to invoke for the given condition

Returns:

this

get

public final HttpServer<IN,OUT> get(java.lang.String path,
                                    ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Listen for HTTP GET on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers. e.g. "/test/{param}". Params are resolved using HttpChannel.param(String)

Parameters:

path - The HttpSelector to resolve against this path, pattern matching and capture are supported

handler - an handler to invoke for the given condition

Returns:

this

post

public final HttpServer<IN,OUT> post(java.lang.String path,
                                     ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Listen for HTTP POST on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers. e.g. "/test/{param}". Params are resolved using HttpChannel.param(String)

Parameters:

path - The HttpSelector to resolve against this path, pattern matching and capture are supported

handler - an handler to invoke for the given condition

Returns:

this

put

public final HttpServer<IN,OUT> put(java.lang.String path,
                                    ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Listen for HTTP PUT on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers. e.g. "/test/{param}". Params are resolved using HttpChannel.param(String)

Parameters:

path - The HttpSelector to resolve against this path, pattern matching and capture are supported

handler - an handler to invoke for the given condition

Returns:

this

ws

public final HttpServer<IN,OUT> ws(java.lang.String path,
                                   ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Listen for WebSocket on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers. e.g. "/test/{param}". Params are resolved using HttpChannel.param(String)

Parameters:

path - The HttpSelector to resolve against this path, pattern matching and capture are supported

handler - an handler to invoke for the given condition

Returns:

this

delete

public final HttpServer<IN,OUT> delete(java.lang.String path,
                                       ReactorChannelHandler<IN,OUT,HttpChannel<IN,OUT>> handler)

Listen for HTTP DELETE on the passed path to be used as a routing condition. Incoming connections will query the internal registry to invoke the matching handlers. e.g. "/test/{param}". Params are resolved using HttpChannel.param(String)

Parameters:

path - The HttpSelector to resolve against this path, pattern matching and capture are supported

handler - an handler to invoke for the given condition

Returns:

this

onWebsocket

protected abstract void onWebsocket(HttpChannel<IN,OUT> next)

hasWebsocketEndpoints

protected final boolean hasWebsocketEndpoints()

routeChannel

protected java.lang.Iterable<? extends org.reactivestreams.Publisher<java.lang.Void>> routeChannel(HttpChannel<IN,OUT> ch)