org.apache.cxf.transport.http_undertow

Class UndertowHTTPServerEngineFactory

java.lang.Object

org.apache.cxf.transport.http_undertow.UndertowHTTPServerEngineFactory

Direct Known Subclasses:

UndertowHTTPServerEngineFactoryBeanDefinitionParser.SpringUndertowHTTPServerEngineFactory

public class UndertowHTTPServerEngineFactory
extends Object

This Bus Extension handles the configuration of network port numbers for use with "http" or "https". This factory caches the UndertowHTTPServerEngines so that they may be retrieved if already previously configured.

Constructor Summary

Constructors

Constructor and Description
UndertowHTTPServerEngineFactory()
UndertowHTTPServerEngineFactory(Bus b)
UndertowHTTPServerEngineFactory(Bus b, Map<String,TLSServerParameters> tls, Map<String,ThreadingParameters> threading)

Method Summary

Modifier and Type	Method and Description
UndertowHTTPServerEngine	createUndertowHTTPServerEngine(int port, String protocol) Calls thru to {createUndertowHTTPServerEngine(String, int, String) with a 'null' host value
UndertowHTTPServerEngine	createUndertowHTTPServerEngine(String host, int port, String protocol) This call creates a new UndertowHTTPServerEngine initialized for "http" or "https" on the given port.
static void	destroyForPort(int port) This method removes the Server Engine from the port map and stops it.
Bus	getBus()
MBeanServer	getMBeanServer()
Map<String,ThreadingParameters>	getThreadingParametersMap()
Map<String,TLSServerParameters>	getTlsServerParametersMap()
void	initComplete()
void	postShutdown()
void	preShutdown()
UndertowHTTPServerEngine	retrieveUndertowHTTPServerEngine(int port) This call retrieves a previously configured UndertowHTTPServerEngine for the given port.
void	setBus(Bus bus) This call is used to set the bus.
void	setEnginesList(List<UndertowHTTPServerEngine> enginesList)
void	setThreadingParametersMap(Map<String,ThreadingParameters> threadingParamsMap) This call sets the ThreadingParameters for a UndertowHTTPServerEngine
void	setTLSServerParametersForPort(int port, TLSServerParameters tlsParams) calls thru to {createUndertowHTTPServerEngine(String, int, String) with 'null' for host value
void	setTLSServerParametersForPort(String host, int port, TLSServerParameters tlsParams) This call sets TLSServerParameters for a UndertowHTTPServerEngine that will be subsequently created.
void	setTlsServerParametersMap(Map<String,TLSServerParameters> tlsParamsMap) This call sets TLSParametersMap for a UndertowHTTPServerEngine

Methods inherited from class java.lang.Object

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

Constructor Detail

UndertowHTTPServerEngineFactory

public UndertowHTTPServerEngineFactory()

UndertowHTTPServerEngineFactory

public UndertowHTTPServerEngineFactory(Bus b)

UndertowHTTPServerEngineFactory

public UndertowHTTPServerEngineFactory(Bus b,
                                       Map<String,TLSServerParameters> tls,
                                       Map<String,ThreadingParameters> threading)

Method Detail

setBus

public final void setBus(Bus bus)

This call is used to set the bus. It should only be called once.

Parameters:

bus -

getBus

public Bus getBus()

setTlsServerParametersMap

public void setTlsServerParametersMap(Map<String,TLSServerParameters> tlsParamsMap)

This call sets TLSParametersMap for a UndertowHTTPServerEngine

getTlsServerParametersMap

public Map<String,TLSServerParameters> getTlsServerParametersMap()

setEnginesList

public void setEnginesList(List<UndertowHTTPServerEngine> enginesList)

setThreadingParametersMap

public void setThreadingParametersMap(Map<String,ThreadingParameters> threadingParamsMap)

This call sets the ThreadingParameters for a UndertowHTTPServerEngine

getThreadingParametersMap

public Map<String,ThreadingParameters> getThreadingParametersMap()

setTLSServerParametersForPort

public void setTLSServerParametersForPort(String host,
                                          int port,
                                          TLSServerParameters tlsParams)
                                   throws GeneralSecurityException,
                                          IOException

This call sets TLSServerParameters for a UndertowHTTPServerEngine that will be subsequently created. It will not alter an engine that has already been created for that network port.

Parameters:

host - if not null, server will listen on this address/host, otherwise, server will listen on all local addresses.

port - The network port number to bind to the engine.

tlsParams - The tls server parameters. Cannot be null.

Throws:

IOException

GeneralSecurityException

setTLSServerParametersForPort

public void setTLSServerParametersForPort(int port,
                                          TLSServerParameters tlsParams)
                                   throws GeneralSecurityException,
                                          IOException

calls thru to {createUndertowHTTPServerEngine(String, int, String) with 'null' for host value

Throws:

GeneralSecurityException

IOException

retrieveUndertowHTTPServerEngine

public UndertowHTTPServerEngine retrieveUndertowHTTPServerEngine(int port)

This call retrieves a previously configured UndertowHTTPServerEngine for the given port. If none exists, this call returns null.

createUndertowHTTPServerEngine

public UndertowHTTPServerEngine createUndertowHTTPServerEngine(String host,
                                                               int port,
                                                               String protocol)
                                                        throws GeneralSecurityException,
                                                               IOException

This call creates a new UndertowHTTPServerEngine initialized for "http" or "https" on the given port. The determination of "http" or "https" will depend on configuration of the engine's bean name. If an UndertowHTTPEngine already exists, or the port is already in use, a BindIOException will be thrown. If the engine is being Spring configured for TLS a GeneralSecurityException may be thrown.

Parameters:

host - if not null, server will listen on this host/address, otherwise server will listen on all local addresses.

port - listen port for server

protocol - "http" or "https"

Returns:

Throws:

GeneralSecurityException

IOException

createUndertowHTTPServerEngine

public UndertowHTTPServerEngine createUndertowHTTPServerEngine(int port,
                                                               String protocol)
                                                        throws GeneralSecurityException,
                                                               IOException

Calls thru to {createUndertowHTTPServerEngine(String, int, String) with a 'null' host value

Throws:

GeneralSecurityException

IOException

destroyForPort

public static void destroyForPort(int port)

This method removes the Server Engine from the port map and stops it.

getMBeanServer

public MBeanServer getMBeanServer()

initComplete

public void initComplete()

postShutdown

public void postShutdown()

preShutdown

public void preShutdown()