org.jboss.remoting3

Interface HandleableCloseable<T>

Type Parameters:

T - the type that is passed to the close handler

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable

All Known Subinterfaces:

Channel, Connection, ConnectionHandler, ConnectionProvider, Endpoint, Registration

All Known Implementing Classes:

AbstractHandleableCloseable, ConnectionImpl, EndpointImpl, EndpointImpl.MapRegistration, HttpUpgradeConnectionProvider, LocalChannel, LocalConnectionProvider, LocalConnectionProvider.LoopbackConnectionHandler, RemoteConnectionChannel, RemoteConnectionHandler, RemoteConnectionProvider

public interface HandleableCloseable<T>
extends java.io.Closeable

A Remoting resource that can be closed.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	HandleableCloseable.Key A key which may be used to remove this handler.

Method Summary

Modifier and Type	Method and Description
HandleableCloseable.Key	addCloseHandler(CloseHandler<? super T> handler) Add a handler that will be called upon close.
void	awaitClosed() Wait for a resource close to complete.
void	awaitClosedUninterruptibly() Wait for a resource close to complete.
void	close() Close this resource.
void	closeAsync() Asynchronously close this resource.

Method Detail

close

void close()
    throws java.io.IOException

Close this resource. Call any registered close handlers. Calling this method more than once will not have any additional effect.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Throws:

java.io.IOException - if the close failed

awaitClosed

void awaitClosed()
          throws java.lang.InterruptedException

Wait for a resource close to complete.

Throws:

java.lang.InterruptedException - if the operation is interrupted

awaitClosedUninterruptibly

void awaitClosedUninterruptibly()

Wait for a resource close to complete.

closeAsync

void closeAsync()

Asynchronously close this resource. Returns immediately.

addCloseHandler

HandleableCloseable.Key addCloseHandler(CloseHandler<? super T> handler)

Add a handler that will be called upon close. If the resource is already closed, the handler will be called immediately.

Parameters:

handler - the close handler

Returns:

a key which may be used to later remove this handler