io.reactivex.netty.protocol.http.server

Class HttpServer<I,O>

java.lang.Object

io.reactivex.netty.protocol.http.server.HttpServer<I,O>

Type Parameters:

I - The type of objects received as content from a request to this server.

O - The type of objects written as content from a response from this server.

All Implemented Interfaces:

io.reactivex.netty.events.EventSource<HttpServerEventsListener>

Direct Known Subclasses:

HttpServerImpl

public abstract class HttpServer<I,O>
extends java.lang.Object
implements io.reactivex.netty.events.EventSource<HttpServerEventsListener>

An HTTP server.

Constructor Summary

Constructors

Constructor and Description
HttpServer()

Method Summary

Modifier and Type	Method and Description
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerAfter(io.netty.util.concurrent.EventExecutorGroup group, java.lang.String baseName, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerAfter(java.lang.String baseName, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerBefore(io.netty.util.concurrent.EventExecutorGroup group, java.lang.String baseName, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerBefore(java.lang.String baseName, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerFirst(io.netty.util.concurrent.EventExecutorGroup group, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerFirst(java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerLast(io.netty.util.concurrent.EventExecutorGroup group, java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract <II,OO> HttpServer<II,OO>	addChannelHandlerLast(java.lang.String name, rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory) Adds a ChannelHandler to ChannelPipeline for all connections created by this server.
abstract void	awaitShutdown() Waits for the shutdown of this server.
abstract void	awaitShutdown(long duration, java.util.concurrent.TimeUnit timeUnit) Waits for the shutdown of this server, waiting a maximum of the passed duration.
abstract <T> HttpServer<I,O>	channelOption(io.netty.channel.ChannelOption<T> option, T value) Creates a new server instance, inheriting all configurations from this server and adding a ChannelOption for the server socket created by the newly created server instance.
abstract <T> HttpServer<I,O>	clientChannelOption(io.netty.channel.ChannelOption<T> option, T value) Creates a new server instance, inheriting all configurations from this server and adding a ChannelOption for the client socket created by the newly created server instance.
abstract HttpServer<I,O>	enableWireLogging(io.netty.handler.logging.LogLevel wireLoggingLevel) Creates a new client instances, inheriting all configurations from this client and enabling wire logging at the passed level for the newly created client instance.
abstract java.net.SocketAddress	getServerAddress() Returns the address at which this server is running.
abstract int	getServerPort() Returns the port at which this server is running.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer() Creates a new server using an ephemeral port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(int port) Creates a new server using the passed port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(int port, io.netty.channel.EventLoopGroup eventLoopGroup, java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass) Creates a new server using the passed port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(int port, io.netty.channel.EventLoopGroup serverGroup, io.netty.channel.EventLoopGroup clientGroup, java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass) Creates a new server using the passed port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(java.net.SocketAddress socketAddress) Creates a new server using the passed port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(java.net.SocketAddress socketAddress, io.netty.channel.EventLoopGroup eventLoopGroup, java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass) Creates a new server using the passed port.
static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf>	newServer(java.net.SocketAddress socketAddress, io.netty.channel.EventLoopGroup serverGroup, io.netty.channel.EventLoopGroup clientGroup, java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass) Creates a new server using the passed port.
abstract <II,OO> HttpServer<II,OO>	pipelineConfigurator(rx.functions.Action1<io.netty.channel.ChannelPipeline> pipelineConfigurator) Creates a new client instances, inheriting all configurations from this client and using the passed action to configure all the connections created by the newly created client instance.
abstract HttpServer<I,O>	secure(rx.functions.Func1<io.netty.buffer.ByteBufAllocator,javax.net.ssl.SSLEngine> sslEngineFactory) Creates a new server instances, inheriting all configurations from this server and using the passed sslEngineFactory for all secured connections accepted by the newly created server instance.
abstract HttpServer<I,O>	secure(io.reactivex.netty.ssl.SslCodec sslCodec) Creates a new server instances, inheriting all configurations from this server and using the passed sslCodec for all secured connections accepted by the newly created server instance.
abstract HttpServer<I,O>	secure(javax.net.ssl.SSLEngine sslEngine) Creates a new server instances, inheriting all configurations from this server and using the passed sslEngine for all secured connections accepted by the newly created server instance.
abstract HttpServer<I,O>	sendHttp10ResponseFor10Request(boolean sendHttp10ResponseFor10Request) According to the specification, an HTTP server must send the highest HTTP version response, it is compatible with.
abstract void	shutdown() Shutdown this server and waits till the server socket is closed.
abstract HttpServer<I,O>	start(RequestHandler<I,O> requestHandler) Starts this server.
abstract HttpServer<I,O>	unsafeSecure() Creates a new server instances, inheriting all configurations from this server and using a self-signed certificate for all secured connections accepted by the newly created server instance.

Methods inherited from class java.lang.Object

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

Methods inherited from interface io.reactivex.netty.events.EventSource

subscribe

Constructor Detail

HttpServer

public HttpServer()

Method Detail

channelOption

public abstract <T> HttpServer<I,O> channelOption(io.netty.channel.ChannelOption<T> option,
                                                  T value)

Creates a new server instance, inheriting all configurations from this server and adding a ChannelOption for the server socket created by the newly created server instance.

Parameters:

option - Option to add.

value - Value for the option.

Returns:

A new HttpServer instance.

clientChannelOption

public abstract <T> HttpServer<I,O> clientChannelOption(io.netty.channel.ChannelOption<T> option,
                                                        T value)

Creates a new server instance, inheriting all configurations from this server and adding a ChannelOption for the client socket created by the newly created server instance.

Parameters:

option - Option to add.

value - Value for the option.

Returns:

A new HttpServer instance.

addChannelHandlerFirst

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerFirst(java.lang.String name,
                                                                 rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added at the first position of the pipeline as specified by ChannelPipeline.addFirst(String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

name - Name of the handler.

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerFirst

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerFirst(io.netty.util.concurrent.EventExecutorGroup group,
                                                                 java.lang.String name,
                                                                 rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added at the first position of the pipeline as specified by ChannelPipeline.addFirst(EventExecutorGroup, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

group - The EventExecutorGroup which will be used to execute the ChannelHandler methods

name - The name of the handler to append

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerLast

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerLast(java.lang.String name,
                                                                rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added at the last position of the pipeline as specified by ChannelPipeline.addLast(String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

name - Name of the handler.

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerLast

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerLast(io.netty.util.concurrent.EventExecutorGroup group,
                                                                java.lang.String name,
                                                                rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added at the last position of the pipeline as specified by ChannelPipeline.addLast(EventExecutorGroup, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

group - the EventExecutorGroup which will be used to execute the ChannelHandler methods

name - the name of the handler to append

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerBefore

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerBefore(java.lang.String baseName,
                                                                  java.lang.String name,
                                                                  rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added before an existing handler with the passed baseName in the pipeline as specified by ChannelPipeline.addBefore(String, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

baseName - the name of the existing handler

name - Name of the handler.

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerBefore

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerBefore(io.netty.util.concurrent.EventExecutorGroup group,
                                                                  java.lang.String baseName,
                                                                  java.lang.String name,
                                                                  rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added before an existing handler with the passed baseName in the pipeline as specified by ChannelPipeline.addBefore(EventExecutorGroup, String, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

group - the EventExecutorGroup which will be used to execute the ChannelHandler methods

baseName - the name of the existing handler

name - the name of the handler to append

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerAfter

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerAfter(java.lang.String baseName,
                                                                 java.lang.String name,
                                                                 rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added after an existing handler with the passed baseName in the pipeline as specified by ChannelPipeline.addAfter(String, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

baseName - the name of the existing handler

name - Name of the handler.

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

addChannelHandlerAfter

public abstract <II,OO> HttpServer<II,OO> addChannelHandlerAfter(io.netty.util.concurrent.EventExecutorGroup group,
                                                                 java.lang.String baseName,
                                                                 java.lang.String name,
                                                                 rx.functions.Func0<io.netty.channel.ChannelHandler> handlerFactory)

Adds a ChannelHandler to ChannelPipeline for all connections created by this server. The specified handler is added after an existing handler with the passed baseName in the pipeline as specified by ChannelPipeline.addAfter(EventExecutorGroup, String, String, ChannelHandler)

For better flexibility of pipeline modification, the method pipelineConfigurator(Action1) will be more convenient.

Parameters:

group - the EventExecutorGroup which will be used to execute the ChannelHandler methods

baseName - the name of the existing handler

name - the name of the handler to append

handlerFactory - Factory to create handler instance to add.

Returns:

A new HttpServer instance.

pipelineConfigurator

public abstract <II,OO> HttpServer<II,OO> pipelineConfigurator(rx.functions.Action1<io.netty.channel.ChannelPipeline> pipelineConfigurator)

Creates a new client instances, inheriting all configurations from this client and using the passed action to configure all the connections created by the newly created client instance.

Parameters:

pipelineConfigurator - Action to configure ChannelPipeline.

Returns:

A new HttpServer instance.

secure

public abstract HttpServer<I,O> secure(rx.functions.Func1<io.netty.buffer.ByteBufAllocator,javax.net.ssl.SSLEngine> sslEngineFactory)

Creates a new server instances, inheriting all configurations from this server and using the passed sslEngineFactory for all secured connections accepted by the newly created server instance. If the SSLEngine instance can be statically, created, secure(SSLEngine) can be used.

Parameters:

sslEngineFactory - Factory for all secured connections created by the newly created server instance.

Returns:

A new HttpServer instance.

secure

public abstract HttpServer<I,O> secure(javax.net.ssl.SSLEngine sslEngine)

Creates a new server instances, inheriting all configurations from this server and using the passed sslEngine for all secured connections accepted by the newly created server instance. If the SSLEngine instance can not be statically, created, secure(Func1) )} can be used.

Parameters:

sslEngine - SSLEngine for all secured connections created by the newly created server instance.

Returns:

A new HttpServer instance.

secure

public abstract HttpServer<I,O> secure(io.reactivex.netty.ssl.SslCodec sslCodec)

Creates a new server instances, inheriting all configurations from this server and using the passed sslCodec for all secured connections accepted by the newly created server instance. This is required only when the SslHandler used by SslCodec is to be modified before adding to the ChannelPipeline. For most of the cases, secure(Func1) or secure(SSLEngine) will be enough.

Parameters:

sslCodec - SslCodec for all secured connections created by the newly created server instance.

Returns:

A new HttpServer instance.

unsafeSecure

public abstract HttpServer<I,O> unsafeSecure()

Creates a new server instances, inheriting all configurations from this server and using a self-signed certificate for all secured connections accepted by the newly created server instance. This is only for testing and should not be used for real production servers.

Returns:

A new HttpServer instance.

enableWireLogging

public abstract HttpServer<I,O> enableWireLogging(io.netty.handler.logging.LogLevel wireLoggingLevel)

Creates a new client instances, inheriting all configurations from this client and enabling wire logging at the passed level for the newly created client instance.

Parameters:

wireLoggingLevel - Logging level at which the wire logs will be logged. The wire logging will only be done if logging is enabled at this level for LoggingHandler

Returns:

A new HttpServer instance.

sendHttp10ResponseFor10Request

public abstract HttpServer<I,O> sendHttp10ResponseFor10Request(boolean sendHttp10ResponseFor10Request)

According to the specification, an HTTP server must send the highest HTTP version response, it is compatible with. Since, all implementations of this server are expected to be HTTP 1.1 compatible, they should always send the response for 1.1. However, in some cases, if desired, this behavior can be overridden to send 1.0 response for 1.0 request. If so desired, the behavior can be enabled/ disabled by this method.

Parameters:

sendHttp10ResponseFor10Request - If true then sends 1.0 version response for 1.0 request.

Returns:

A new HttpServer instance.

getServerPort

public abstract int getServerPort()

Returns the port at which this server is running.

For servers using ephemeral ports, this would return the actual port used, only after the server is started.

Returns:

The port at which this server is running.

getServerAddress

public abstract java.net.SocketAddress getServerAddress()

Returns the address at which this server is running.

Returns:

The address at which this server is running.

start

public abstract HttpServer<I,O> start(RequestHandler<I,O> requestHandler)

Starts this server.

Parameters:

requestHandler - Connection handler that will handle any new client connections to this server.

Returns:

This server.

shutdown

public abstract void shutdown()

Shutdown this server and waits till the server socket is closed.

awaitShutdown

public abstract void awaitShutdown()

Waits for the shutdown of this server.

This does not actually shutdown the server. It just waits for some other action to shutdown.

awaitShutdown

public abstract void awaitShutdown(long duration,
                                   java.util.concurrent.TimeUnit timeUnit)

Waits for the shutdown of this server, waiting a maximum of the passed duration.

This does not actually shutdown the server. It just waits for some other action to shutdown.

Parameters:

duration - Duration to wait for shutdown.

timeUnit - Timeunit for the duration to wait for shutdown.

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer()

Creates a new server using an ephemeral port. The port used can be found by getServerPort()

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(int port)

Creates a new server using the passed port.

Parameters:

port - Port for the server. 0 to use ephemeral port.

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(int port,
                                                                                    io.netty.channel.EventLoopGroup eventLoopGroup,
                                                                                    java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass)

Creates a new server using the passed port.

Parameters:

port - Port for the server. 0 to use ephemeral port.

eventLoopGroup - Eventloop group to be used for server as well as client sockets.

channelClass - The class to be used for server channel.

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(int port,
                                                                                    io.netty.channel.EventLoopGroup serverGroup,
                                                                                    io.netty.channel.EventLoopGroup clientGroup,
                                                                                    java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass)

Creates a new server using the passed port.

Parameters:

port - Port for the server. 0 to use ephemeral port.

serverGroup - Eventloop group to be used for server sockets.

clientGroup - Eventloop group to be used for client sockets.

channelClass - The class to be used for server channel.

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(java.net.SocketAddress socketAddress)

Creates a new server using the passed port.

Parameters:

socketAddress - Socket address for the server.

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(java.net.SocketAddress socketAddress,
                                                                                    io.netty.channel.EventLoopGroup eventLoopGroup,
                                                                                    java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass)

Creates a new server using the passed port.

Parameters:

socketAddress - Socket address for the server.

eventLoopGroup - Eventloop group to be used for server as well as client sockets.

channelClass - The class to be used for server channel.

Returns:

A new HttpServer

newServer

public static HttpServer<io.netty.buffer.ByteBuf,io.netty.buffer.ByteBuf> newServer(java.net.SocketAddress socketAddress,
                                                                                    io.netty.channel.EventLoopGroup serverGroup,
                                                                                    io.netty.channel.EventLoopGroup clientGroup,
                                                                                    java.lang.Class<? extends io.netty.channel.ServerChannel> channelClass)

Creates a new server using the passed port.

Parameters:

socketAddress - Socket address for the server.

serverGroup - Eventloop group to be used for server sockets.

clientGroup - Eventloop group to be used for client sockets.

channelClass - The class to be used for server channel.

Returns:

A new HttpServer