org.apache.sshd.common.util.closeable

Class AbstractCloseable

java.lang.Object

org.apache.sshd.common.util.logging.AbstractLoggingBean

org.apache.sshd.common.util.closeable.IoBaseCloseable

org.apache.sshd.common.util.closeable.AbstractCloseable

All Implemented Interfaces:

Closeable, AutoCloseable, Channel

Direct Known Subclasses:

AbstractInnerCloseable, AbstractIoServiceFactory, ChannelAsyncInputStream, ChannelAsyncOutputStream, ClientUserAuthService, DefaultAgentForwardSupport, MinaService, Nio2Session, ServerUserAuthService, SocksProxy

public abstract class AbstractCloseable
extends IoBaseCloseable

Provides some default implementations

Author:

Apache MINA SSHD Project

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AbstractCloseable.State

Field Summary

Fields

Modifier and Type	Field and Description
protected CloseFuture	closeFuture A future that will be set 'closed' when the object is actually closed
protected Object	lock Lock object for this session state
protected AtomicReference<AbstractCloseable.State>	state State of this object

Fields inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

log

Fields inherited from interface org.apache.sshd.common.Closeable

CLOSE_WAIT_TIMEOUT, DEFAULT_CLOSE_WAIT_TIMEOUT

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	AbstractCloseable()
protected	AbstractCloseable(String discriminator)

Method Summary

Modifier and Type	Method and Description
void	addCloseFutureListener(SshFutureListener<CloseFuture> listener) Pre-register a listener to be informed when resource is closed.
protected Builder	builder()
CloseFuture	close(boolean immediately) Close this resource asynchronously and return a future.
protected CloseFuture	doCloseGracefully()
protected void	doCloseImmediately() doCloseImmediately is called once and only once with state == Immediate Overriding methods should always call the base implementation.
boolean	isClosed() Returns true if this object has been closed.
boolean	isClosing() Returns true if the Closeable.close(boolean) method has been called.
protected void	preClose() preClose is guaranteed to be called before doCloseGracefully or doCloseImmediately.
void	removeCloseFutureListener(SshFutureListener<CloseFuture> listener) Remove a pre-registered close event listener

Methods inherited from class org.apache.sshd.common.util.logging.AbstractLoggingBean

getSimplifiedLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.sshd.common.Closeable

close, close, getMaxCloseWaitTime, isOpen

Field Detail

lock

protected final Object lock

Lock object for this session state

state

protected final AtomicReference<AbstractCloseable.State> state

State of this object

closeFuture

protected final CloseFuture closeFuture

A future that will be set 'closed' when the object is actually closed

Constructor Detail

AbstractCloseable

protected AbstractCloseable()

AbstractCloseable

protected AbstractCloseable(String discriminator)

Method Detail

addCloseFutureListener

public void addCloseFutureListener(SshFutureListener<CloseFuture> listener)

Description copied from interface: Closeable

Pre-register a listener to be informed when resource is closed. If resource is already closed, the listener will be invoked immediately and not registered for future notification

Parameters:

listener - The notification SshFutureListener - never null

removeCloseFutureListener

public void removeCloseFutureListener(SshFutureListener<CloseFuture> listener)

Description copied from interface: Closeable

Remove a pre-registered close event listener

Parameters:

listener - The register SshFutureListener - never null. Ignored if not registered or resource already closed

close

public CloseFuture close(boolean immediately)

Description copied from interface: Closeable

Close this resource asynchronously and return a future. Resources support two closing modes: a graceful mode which will cleanly close the resource and an immediate mode which will close the resources abruptly.

Parameters:

immediately - true if the resource should be shut down abruptly, false for a graceful close

Returns:

a CloseFuture representing the close request

isClosed

public boolean isClosed()

Description copied from interface: Closeable

Returns true if this object has been closed.

Returns:

true if closing

isClosing

public boolean isClosing()

Description copied from interface: Closeable

Returns true if the Closeable.close(boolean) method has been called. Note that this method will return true even if this Closeable.isClosed() returns true.

Returns:

true if closing

preClose

protected void preClose()

preClose is guaranteed to be called before doCloseGracefully or doCloseImmediately. When preClose() is called, isClosing() == true

doCloseGracefully

protected CloseFuture doCloseGracefully()

doCloseImmediately

protected void doCloseImmediately()

doCloseImmediately is called once and only once with state == Immediate

Overriding methods should always call the base implementation. It may be called concurrently while preClose() or doCloseGracefully is executing

builder

protected Builder builder()