io.dropwizard.jetty

Class HttpConnectorFactory

java.lang.Object

io.dropwizard.jetty.HttpConnectorFactory

All Implemented Interfaces:

io.dropwizard.jackson.Discoverable, ConnectorFactory

Direct Known Subclasses:

HttpsConnectorFactory

public class HttpConnectorFactory
extends Object
implements ConnectorFactory

Builds HTTP connectors.

Configuration Parameters:

Name	Default	Description
port	8080	The TCP/IP port on which to listen for incoming connections.
bindHost	(none)	The hostname to bind to.
headerCacheSize	512 bytes	The size of the header field cache.
outputBufferSize	32KiB	The size of the buffer into which response content is aggregated before being sent to the client. A larger buffer can improve performance by allowing a content producer to run without blocking, however larger buffers consume more memory and may induce some latency before a client starts processing the content.
maxRequestHeaderSize	8KiB	The maximum size of a request header. Larger headers will allow for more and/or larger cookies plus larger form content encoded in a URL. However, larger headers consume more memory and can make a server more vulnerable to denial of service attacks.
maxResponseHeaderSize	8KiB	The maximum size of a response header. Larger headers will allow for more and/or larger cookies and longer HTTP headers (eg for redirection). However, larger headers will also consume more memory.
inputBufferSize	8KiB	The size of the per-connection input buffer.
idleTimeout	30 seconds	The maximum idle time for a connection, which roughly translates to the Socket.setSoTimeout(int) call, although with NIO implementations other mechanisms may be used to implement the timeout. The max idle time is applied: When waiting for a new message to be received on a connection When waiting for a new message to be sent on a connection This value is interpreted as the maximum time between some progress being made on the connection. So if a single byte is read or written, then the timeout is reset.
minBufferPoolSize	64 bytes	The minimum size of the buffer pool.
bufferPoolIncrement	1KiB	The increment by which the buffer pool should be increased.
maxBufferPoolSize	64KiB	The maximum size of the buffer pool.
acceptorThreads	half the # of CPUs	The number of worker threads dedicated to accepting connections.
selectorThreads	the # of CPUs	The number of worker threads dedicated to sending and receiving data.
acceptQueueSize	(OS default)	The size of the TCP/IP accept queue for the listening socket.
reuseAddress	true	Whether or not SO_REUSEADDR is enabled on the listening socket.
soLingerTime	(disabled)	Enable/disable SO_LINGER with the specified linger time.
useServerHeader	false	Whether or not to add the Server header to each response.
useDateHeader	true	Whether or not to add the Date header to each response.
useForwardedHeaders	true	Whether or not to look at X-Forwarded-* headers added by proxies. See ForwardedRequestCustomizer for details.

Constructor Summary

Constructors

Constructor and Description
HttpConnectorFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static ConnectorFactory	admin()
static ConnectorFactory	application()
org.eclipse.jetty.server.Connector	build(org.eclipse.jetty.server.Server server, com.codahale.metrics.MetricRegistry metrics, String name, org.eclipse.jetty.util.thread.ThreadPool threadPool) Create a new connector.
protected org.eclipse.jetty.io.ByteBufferPool	buildBufferPool()
protected org.eclipse.jetty.server.ServerConnector	buildConnector(org.eclipse.jetty.server.Server server, org.eclipse.jetty.util.thread.Scheduler scheduler, org.eclipse.jetty.io.ByteBufferPool bufferPool, String name, org.eclipse.jetty.util.thread.ThreadPool threadPool, org.eclipse.jetty.server.ConnectionFactory... factories)
protected org.eclipse.jetty.server.HttpConfiguration	buildHttpConfiguration()
protected org.eclipse.jetty.server.HttpConnectionFactory	buildHttpConnectionFactory(org.eclipse.jetty.server.HttpConfiguration httpConfig)
int	getAcceptorThreads()
Integer	getAcceptQueueSize()
String	getBindHost()
io.dropwizard.util.Size	getBufferPoolIncrement()
io.dropwizard.util.Size	getHeaderCacheSize()
io.dropwizard.util.Duration	getIdleTimeout()
io.dropwizard.util.Size	getInputBufferSize()
io.dropwizard.util.Size	getMaxBufferPoolSize()
io.dropwizard.util.Size	getMaxRequestHeaderSize()
io.dropwizard.util.Size	getMaxResponseHeaderSize()
io.dropwizard.util.Size	getMinBufferPoolSize()
io.dropwizard.util.Size	getOutputBufferSize()
int	getPort()
int	getSelectorThreads()
io.dropwizard.util.Duration	getSoLingerTime()
boolean	isReuseAddress()
boolean	isUseDateHeader()
boolean	isUseForwardedHeaders()
boolean	isUseServerHeader()
void	setAcceptorThreads(int acceptorThreads)
void	setAcceptQueueSize(Integer acceptQueueSize)
void	setBindHost(String bindHost)
void	setBufferPoolIncrement(io.dropwizard.util.Size bufferPoolIncrement)
void	setHeaderCacheSize(io.dropwizard.util.Size headerCacheSize)
void	setIdleTimeout(io.dropwizard.util.Duration idleTimeout)
void	setInputBufferSize(io.dropwizard.util.Size inputBufferSize)
void	setMaxBufferPoolSize(io.dropwizard.util.Size maxBufferPoolSize)
void	setMaxRequestHeaderSize(io.dropwizard.util.Size maxRequestHeaderSize)
void	setMaxResponseHeaderSize(io.dropwizard.util.Size maxResponseHeaderSize)
void	setMinBufferPoolSize(io.dropwizard.util.Size minBufferPoolSize)
void	setOutputBufferSize(io.dropwizard.util.Size outputBufferSize)
void	setPort(int port)
void	setReuseAddress(boolean reuseAddress)
void	setSelectorThreads(int selectorThreads)
void	setSoLingerTime(io.dropwizard.util.Duration soLingerTime)
void	setUseDateHeader(boolean useDateHeader)
void	setUseForwardedHeaders(boolean useForwardedHeaders)
void	setUseServerHeader(boolean useServerHeader)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpConnectorFactory

public HttpConnectorFactory()

Method Detail

application

public static ConnectorFactory application()

admin

public static ConnectorFactory admin()

getPort

public int getPort()

setPort

public void setPort(int port)

getBindHost

public String getBindHost()

setBindHost

public void setBindHost(String bindHost)

getHeaderCacheSize

public io.dropwizard.util.Size getHeaderCacheSize()

setHeaderCacheSize

public void setHeaderCacheSize(io.dropwizard.util.Size headerCacheSize)

getOutputBufferSize

public io.dropwizard.util.Size getOutputBufferSize()

setOutputBufferSize

public void setOutputBufferSize(io.dropwizard.util.Size outputBufferSize)

getMaxRequestHeaderSize

public io.dropwizard.util.Size getMaxRequestHeaderSize()

setMaxRequestHeaderSize

public void setMaxRequestHeaderSize(io.dropwizard.util.Size maxRequestHeaderSize)

getMaxResponseHeaderSize

public io.dropwizard.util.Size getMaxResponseHeaderSize()

setMaxResponseHeaderSize

public void setMaxResponseHeaderSize(io.dropwizard.util.Size maxResponseHeaderSize)

getInputBufferSize

public io.dropwizard.util.Size getInputBufferSize()

setInputBufferSize

public void setInputBufferSize(io.dropwizard.util.Size inputBufferSize)

getIdleTimeout

public io.dropwizard.util.Duration getIdleTimeout()

setIdleTimeout

public void setIdleTimeout(io.dropwizard.util.Duration idleTimeout)

getMinBufferPoolSize

public io.dropwizard.util.Size getMinBufferPoolSize()

setMinBufferPoolSize

public void setMinBufferPoolSize(io.dropwizard.util.Size minBufferPoolSize)

getBufferPoolIncrement

public io.dropwizard.util.Size getBufferPoolIncrement()

setBufferPoolIncrement

public void setBufferPoolIncrement(io.dropwizard.util.Size bufferPoolIncrement)

getMaxBufferPoolSize

public io.dropwizard.util.Size getMaxBufferPoolSize()

setMaxBufferPoolSize

public void setMaxBufferPoolSize(io.dropwizard.util.Size maxBufferPoolSize)

getAcceptorThreads

public int getAcceptorThreads()

setAcceptorThreads

public void setAcceptorThreads(int acceptorThreads)

getSelectorThreads

public int getSelectorThreads()

setSelectorThreads

public void setSelectorThreads(int selectorThreads)

getAcceptQueueSize

public Integer getAcceptQueueSize()

setAcceptQueueSize

public void setAcceptQueueSize(Integer acceptQueueSize)

isReuseAddress

public boolean isReuseAddress()

setReuseAddress

public void setReuseAddress(boolean reuseAddress)

getSoLingerTime

public io.dropwizard.util.Duration getSoLingerTime()

setSoLingerTime

public void setSoLingerTime(io.dropwizard.util.Duration soLingerTime)

isUseServerHeader

public boolean isUseServerHeader()

setUseServerHeader

public void setUseServerHeader(boolean useServerHeader)

isUseDateHeader

public boolean isUseDateHeader()

setUseDateHeader

public void setUseDateHeader(boolean useDateHeader)

isUseForwardedHeaders

public boolean isUseForwardedHeaders()

setUseForwardedHeaders

public void setUseForwardedHeaders(boolean useForwardedHeaders)

build

public org.eclipse.jetty.server.Connector build(org.eclipse.jetty.server.Server server,
                                       com.codahale.metrics.MetricRegistry metrics,
                                       String name,
                                       org.eclipse.jetty.util.thread.ThreadPool threadPool)

Description copied from interface: ConnectorFactory

Create a new connector.

Specified by:

build in interface ConnectorFactory

Parameters:

server - the application's Server instance

metrics - the application's metrics

name - the application's name

threadPool - the application's thread pool

Returns:

a Connector

buildConnector

protected org.eclipse.jetty.server.ServerConnector buildConnector(org.eclipse.jetty.server.Server server,
                                                      org.eclipse.jetty.util.thread.Scheduler scheduler,
                                                      org.eclipse.jetty.io.ByteBufferPool bufferPool,
                                                      String name,
                                                      org.eclipse.jetty.util.thread.ThreadPool threadPool,
                                                      org.eclipse.jetty.server.ConnectionFactory... factories)

buildHttpConnectionFactory

protected org.eclipse.jetty.server.HttpConnectionFactory buildHttpConnectionFactory(org.eclipse.jetty.server.HttpConfiguration httpConfig)

buildHttpConfiguration

protected org.eclipse.jetty.server.HttpConfiguration buildHttpConfiguration()

buildBufferPool

protected org.eclipse.jetty.io.ByteBufferPool buildBufferPool()