Package org.glassfish.grizzly.http.server

Class HttpServer

java.lang.Object

org.glassfish.grizzly.http.server.HttpServer

public class HttpServer
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field	Description
protected GrizzlyJmxManager	jmxManager
protected java.lang.Object	managementObject

Constructor Summary

Constructors

Constructor	Description
HttpServer()

Method Summary

Modifier and Type	Method	Description
void	addListener(NetworkListener listener)	Adds the specified listener to the server instance.
protected java.util.Set<ContentEncoding>	configureCompressionEncodings(NetworkListener listener)
static HttpServer	createSimpleServer()
static HttpServer	createSimpleServer(java.lang.String docRoot)
static HttpServer	createSimpleServer(java.lang.String docRoot, int port)
static HttpServer	createSimpleServer(java.lang.String docRoot, java.lang.String host, int port)
static HttpServer	createSimpleServer(java.lang.String docRoot, java.lang.String host, PortRange range)
static HttpServer	createSimpleServer(java.lang.String docRoot, java.net.SocketAddress socketAddress)
static HttpServer	createSimpleServer(java.lang.String docRoot, PortRange range)
protected void	disableJMX()
protected void	enableJMX()
HttpHandler	getHttpHandler()
NetworkListener	getListener(java.lang.String name)
java.util.Collection<NetworkListener>	getListeners()
java.lang.Object	getManagementObject(boolean clear)
ServerConfiguration	getServerConfiguration()
boolean	isStarted()
NetworkListener	removeListener(java.lang.String name)	Removes the NetworkListener associated with the specified name.
GrizzlyFuture<HttpServer>	shutdown()	Gracefully shuts down the HttpServer instance.
GrizzlyFuture<HttpServer>	shutdown(long gracePeriod, java.util.concurrent.TimeUnit timeUnit)
void	shutdownNow()	Immediately shuts down the HttpServer instance.
void	start()	Starts the HttpServer.
void	stop()	Deprecated. use shutdownNow()

Methods inherited from class java.lang.Object

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

Field Detail

jmxManager

protected volatile GrizzlyJmxManager jmxManager

managementObject

protected volatile java.lang.Object managementObject

Constructor Detail

HttpServer

public HttpServer()

Method Detail

getServerConfiguration

public final ServerConfiguration getServerConfiguration()

Returns:

the ServerConfiguration used to configure this HttpServer instance

addListener

public void addListener(NetworkListener listener)

Adds the specified listener to the server instance.

If the server is already running when this method is called, the listener will be started.

Parameters:

listener - the NetworkListener to associate with this server instance.

getListener

public NetworkListener getListener(java.lang.String name)

Parameters:

name - the NetworkListener name.

Returns:

the NetworkListener, if any, associated with the specified name.

getListeners

public java.util.Collection<NetworkListener> getListeners()

Returns:

a read only Collection over the listeners associated with this HttpServer instance.

removeListener

public NetworkListener removeListener(java.lang.String name)

Removes the NetworkListener associated with the specified name.

If the server is running when this method is invoked, the listener will be stopped before being returned.

Parameters:

name - the name of the NetworkListener to remove.

Returns:

NetworkListener, that has been removed, or null if the listener with the given name doesn't exist

start

public void start()
           throws java.io.IOException

Starts the HttpServer.

Throws:

java.io.IOException - if an error occurs while attempting to start the server.

getHttpHandler

public HttpHandler getHttpHandler()

Returns:

the HttpHandler used by this HttpServer instance.

isStarted

public boolean isStarted()

Returns:

true if this HttpServer has been started.

getManagementObject

public java.lang.Object getManagementObject(boolean clear)

shutdown

public GrizzlyFuture<HttpServer> shutdown(long gracePeriod,
                                          java.util.concurrent.TimeUnit timeUnit)

shutdown

public GrizzlyFuture<HttpServer> shutdown()

Gracefully shuts down the HttpServer instance.

shutdownNow

public void shutdownNow()

Immediately shuts down the HttpServer instance.

stop

@Deprecated
public void stop()

Deprecated.

use shutdownNow()

Immediately shuts down the HttpServer instance.

createSimpleServer

public static HttpServer createSimpleServer()

Returns:

a HttpServer configured to listen to requests on NetworkListener.DEFAULT_NETWORK_HOST:NetworkListener.DEFAULT_NETWORK_PORT, using the directory in which the server was launched the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot)

Parameters:

docRoot - the document root, can be null when no static pages are needed

Returns:

a HttpServer configured to listen to requests on NetworkListener.DEFAULT_NETWORK_HOST:NetworkListener.DEFAULT_NETWORK_PORT, using the specified docRoot as the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot,
                                            int port)

Parameters:

docRoot - the document root, can be null when no static pages are needed

port - the network port to which this listener will bind

Returns:

a HttpServer configured to listen to requests on NetworkListener.DEFAULT_NETWORK_HOST:port, using the specified docRoot as the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot,
                                            PortRange range)

Parameters:

docRoot - the document root, can be null when no static pages are needed

range - port range to attempt to bind to

Returns:

a HttpServer configured to listen to requests on NetworkListener.DEFAULT_NETWORK_HOST:[port-range], using the specified docRoot as the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot,
                                            java.net.SocketAddress socketAddress)

Parameters:

docRoot - the document root, can be null when no static pages are needed

socketAddress - the endpoint address to which this listener will bind

Returns:

a HttpServer configured to listen to requests on socketAddress, using the specified docRoot as the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot,
                                            java.lang.String host,
                                            int port)

Parameters:

docRoot - the document root, can be null when no static pages are needed

host - the network port to which this listener will bind

port - the network port to which this listener will bind

Returns:

a HttpServer configured to listen to requests on host:port, using the specified docRoot as the server's document root

createSimpleServer

public static HttpServer createSimpleServer(java.lang.String docRoot,
                                            java.lang.String host,
                                            PortRange range)

Parameters:

docRoot - the document root, can be null when no static pages are needed

host - the network port to which this listener will bind

range - port range to attempt to bind to

Returns:

a HttpServer configured to listen to requests on host:[port-range], using the specified docRoot as the server's document root

enableJMX

protected void enableJMX()

disableJMX

protected void disableJMX()

configureCompressionEncodings

protected java.util.Set<ContentEncoding> configureCompressionEncodings(NetworkListener listener)