Module org.eclipse.jetty.server

Package 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:

Closeable, AutoCloseable, Connector, NetworkConnector, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.Graceful, org.eclipse.jetty.util.component.LifeCycle

Direct Known Subclasses:

ServerConnector

@ManagedObject("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

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

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

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

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

org.eclipse.jetty.util.component.Dumpable.DumpableContainer

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

org.eclipse.jetty.util.component.Graceful.Shutdown, org.eclipse.jetty.util.component.Graceful.ThrowingRunnable

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

org.eclipse.jetty.util.component.LifeCycle.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.server.NetworkConnector

NetworkConnector.Listener

Field Summary

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

LOG

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

FAILED, STARTED, STARTING, STOPPED, STOPPING

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

KEY

Constructor Summary

Constructors

Constructor	Description
AbstractNetworkConnector(Server server, Executor executor, org.eclipse.jetty.util.thread.Scheduler scheduler, org.eclipse.jetty.io.ByteBufferPool bufferPool, int acceptors, ConnectionFactory... factories)

Method Summary

Modifier and Type	Method	Description
void	close()	Performs the activities needed to close the network communication (for example, to stop accepting network connections).
protected void	doStart()
protected void	doStop()
String	getHost()
int	getLocalPort()
int	getPort()
protected boolean	handleAcceptFailure(Throwable ex)
void	open()	Performs the activities needed to open the network communication (for example, to start accepting incoming network connections).
void	setHost(String host)
void	setPort(int port)
CompletableFuture<Void>	shutdown()
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, getShutdownIdleTimeout, interruptAcceptors, isAccepting, isShutdown, join, join, onEndPointClosed, onEndPointOpened, removeConnectionFactory, setAccepting, setAcceptorPriorityDelta, setConnectionFactories, setDefaultProtocol, setIdleTimeout, setName, setShutdownIdleTimeout

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

addBean, addBean, addEventListener, addManaged, contains, destroy, dump, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, installBean, installBean, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans, updateBeans

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

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, 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.Connector

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

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

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

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

dump, dump, dumpSelf

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

isDumpable

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

isShutdown

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

addEventListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, start, stop

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

isOpen

Constructor Details

AbstractNetworkConnector

public AbstractNetworkConnector(Server server,
 Executor executor,
 org.eclipse.jetty.util.thread.Scheduler scheduler,
 org.eclipse.jetty.io.ByteBufferPool bufferPool,
 int acceptors,
 ConnectionFactory... factories)

Method Details

setHost

public void setHost(String host)

getHost

@ManagedAttribute("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 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("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 Exception

Overrides:

doStart in class AbstractConnector

Throws:

Exception

doStop

protected void doStop()
               throws Exception

Overrides:

doStop in class AbstractConnector

Throws:

Exception

open

public void open()
          throws IOException

Description copied from interface: NetworkConnector

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

Implementation must be idempotent.

Specified by:

open in interface NetworkConnector

Throws:

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().

Implementation must be idempotent.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface NetworkConnector

shutdown

public CompletableFuture<Void> shutdown()

Specified by:

shutdown in interface org.eclipse.jetty.util.component.Graceful

Overrides:

shutdown in class AbstractConnector

handleAcceptFailure

protected boolean handleAcceptFailure(Throwable ex)

Overrides:

handleAcceptFailure in class AbstractConnector

toString

public String toString()

Overrides:

toString in class AbstractConnector