org.exolab.core.messenger
Interface SystemChannel

All Superinterfaces:

Channel

public interface SystemChannel

extends Channel

A SystemChannel is reponsible for managing channel open and close requests on a Connection.

Typically, there will be one SystemChannel per Connection. This channel is not accessible to users.

Version:

$Revision: 1.2 $ $Date: 2002/02/17 20:46:54 $

Author:

Tim Anderson

See Also:

Channel, ChannelAcceptor, Connection

Method Summary

void	close(Channel channel) Close a channel
Channel	open(java.lang.String name) Open a channel for the specified name.

Methods inherited from interface org.exolab.core.messenger.Channel

close, invoke, receive, receive, send, setChannelListener

Method Detail

open

public Channel open(java.lang.String name)
             throws java.rmi.RemoteException

Open a channel for the specified name. A ChannelAcceptor must be available on the other end of the connection, accepting requests for the named channel.

Parameters:

name - the channel name

Returns:

an open channel

Throws:

java.rmi.RemoteException - if an error occurs opening the channel

InvalidChannelException - there is no ChannelAcceptor listening for requests for the specified name

java.lang.IllegalArgumentException - if name is null

close

public void close(Channel channel)
           throws java.rmi.RemoteException

Close a channel

Parameters:

channel - the channel to close

Throws:

java.rmi.RemoteException - if an error occurs closing the channel

java.lang.IllegalArgumentException - if channel is null