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

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

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


Copyright © 1999-2012 The Exolab Group. All Rights Reserved.