org.cojen.dirmi

Interface SessionAcceptor

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

StandardSessionAcceptor

public interface SessionAcceptor
extends Closeable

Accepts sessions from remote endpoints.

Author:

Brian S O'Neill

See Also:

Environment

Method Summary

Modifier and Type	Method and Description
void	accept(SessionListener listener) Returns immediately and calls listener asynchronously, but no more than once.
void	acceptAll(Object shared) Returns immediately and starts automatically accepting all sessions asynchronously, sending a shared object.
void	close() Prevents new sessions from being accepted and closes all existing sessions created from this acceptor.
Object	getLocalAddress()

Method Detail

acceptAll

void acceptAll(Object shared)

Returns immediately and starts automatically accepting all sessions asynchronously, sending a shared object. No attempt is made to receive objects sent by remote client sessions. Exceptions thrown during session establishment are discarded. The accept method may be called at any time to switch to manual session acceptance.

Parameters:

shared - shared remote or serializable object to send to accepted sessions

accept

void accept(SessionListener listener)

Returns immediately and calls listener asynchronously, but no more than once. The accept method must be called again (possibly with the same listener instance) in order to accept more sessions. If no listener is accepting incoming sessions, then the session is closed after a timeout elapses. The acceptAll method may be called at any time to switch to automatic session acceptance.

getLocalAddress

Object getLocalAddress()

Returns:

local address of accepted sessions or null if unknown

close

void close()
    throws IOException

Prevents new sessions from being accepted and closes all existing sessions created from this acceptor.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Throws:

IOException