org.eclipse.jetty.server

Class AbstractNetworkConnector

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.AbstractConnector

org.eclipse.jetty.server.AbstractNetworkConnector

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, Connector, NetworkConnector, Container, Destroyable, Dumpable, Graceful, LifeCycle

Direct Known Subclasses:

ServerConnector

@ManagedObject(value="AbstractNetworkConnector")
public abstract class AbstractNetworkConnector
extends AbstractConnector
implements NetworkConnector

An abstract Network Connector.

Extends the AbstractConnector support for the NetworkConnector interface.

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

Container.InheritedListener, Container.Listener

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.String	_host
private int	_port

Fields inherited from class org.eclipse.jetty.server.AbstractConnector

LOG

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
AbstractNetworkConnector(Server server, java.util.concurrent.Executor executor, Scheduler scheduler, ByteBufferPool pool, int acceptors, ConnectionFactory... factories)

Method Summary

Modifier and Type	Method and Description
void	close() Performs the activities needed to close the network communication (for example, to stop accepting network connections).
protected void	doStart() Starts the managed lifecycle beans in the order they were added.
protected void	doStop() Stops the managed lifecycle beans in the reverse order they were added.
java.lang.String	getHost()
int	getLocalPort()
int	getPort()
protected boolean	handleAcceptFailure(java.lang.Throwable ex)
void	open() Performs the activities needed to open the network communication (for example, to start accepting incoming network connections).
void	setHost(java.lang.String host)
void	setPort(int port)
java.util.concurrent.Future<java.lang.Void>	shutdown()
java.lang.String	toString()

Methods inherited from class org.eclipse.jetty.server.AbstractConnector

accept, addConnectionFactory, addFirstConnectionFactory, addIfAbsentConnectionFactory, clearConnectionFactories, getAcceptorPriorityDelta, getAcceptors, getByteBufferPool, getConnectedEndPoints, getConnectionFactories, getConnectionFactory, getConnectionFactory, getDefaultConnectionFactory, getDefaultProtocol, getExecutor, getIdleTimeout, getName, getProtocols, getScheduler, getServer, interruptAcceptors, isAccepting, join, join, onEndPointClosed, onEndPointOpened, removeConnectionFactory, setAccepting, setAcceptorPriorityDelta, setConnectionFactories, setDefaultProtocol, setIdleTimeout, setName

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, dumpThis, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.eclipse.jetty.server.NetworkConnector

isOpen

Methods inherited from interface org.eclipse.jetty.server.Connector

getByteBufferPool, getConnectedEndPoints, getConnectionFactories, getConnectionFactory, getConnectionFactory, getDefaultConnectionFactory, getExecutor, getIdleTimeout, getName, getProtocols, getScheduler, getServer, getTransport

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, start, stop, stop

Methods inherited from interface org.eclipse.jetty.util.component.Container

addBean, addBean, addEventListener, getBean, getBeans, getBeans, getContainedBeans, isManaged, manage, removeBean, removeEventListener, unmanage

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dump, dump

Field Detail

_host

private volatile java.lang.String _host

_port

private volatile int _port

Constructor Detail

AbstractNetworkConnector

public AbstractNetworkConnector(Server server,
                                java.util.concurrent.Executor executor,
                                Scheduler scheduler,
                                ByteBufferPool pool,
                                int acceptors,
                                ConnectionFactory... factories)

Method Detail

setHost

public void setHost(java.lang.String host)

getHost

@ManagedAttribute(value="The network interface this connector binds to as an IP address or a hostname.  If null or 0.0.0.0, then bind to all interfaces.")
public java.lang.String getHost()

Specified by:

getHost in interface NetworkConnector

Returns:

The hostname representing the interface to which this connector will bind, or null for all interfaces.

setPort

public void setPort(int port)

getPort

@ManagedAttribute(value="Port this connector listens on. If set the 0 a random port is assigned which may be obtained with getLocalPort()")
public int getPort()

Specified by:

getPort in interface NetworkConnector

Returns:

The configured port for the connector or 0 if any available port may be used.

getLocalPort

public int getLocalPort()

Specified by:

getLocalPort in interface NetworkConnector

Returns:

The actual port the connector is listening on, or -1 if it has not been opened, or -2 if it has been closed.

doStart

protected void doStart()
                throws java.lang.Exception

Description copied from class: ContainerLifeCycle

Starts the managed lifecycle beans in the order they were added.

Overrides:

doStart in class AbstractConnector

Throws:

java.lang.Exception

doStop

protected void doStop()
               throws java.lang.Exception

Description copied from class: ContainerLifeCycle

Stops the managed lifecycle beans in the reverse order they were added.

Overrides:

doStop in class AbstractConnector

Throws:

java.lang.Exception

open

public void open()
          throws java.io.IOException

Description copied from interface: NetworkConnector

Performs the activities needed to open the network communication (for example, to start accepting incoming network connections).

Specified by:

open in interface NetworkConnector

Throws:

java.io.IOException - if this connector cannot be opened

See Also:

NetworkConnector.close()

close

public void close()

Description copied from interface: NetworkConnector

Performs the activities needed to close the network communication (for example, to stop accepting network connections).

Once a connector has been closed, it cannot be opened again without first calling LifeCycle.stop() and it will not be active again until a subsequent call to LifeCycle.start()

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface NetworkConnector

shutdown

public java.util.concurrent.Future<java.lang.Void> shutdown()

Specified by:

shutdown in interface Graceful

Overrides:

shutdown in class AbstractConnector

handleAcceptFailure

protected boolean handleAcceptFailure(java.lang.Throwable ex)

Overrides:

handleAcceptFailure in class AbstractConnector

toString

public java.lang.String toString()

Overrides:

toString in class AbstractConnector