com.sun.multicast.reliable.channel
Class ChannelManagerFinder

java.lang.Object
  |
  +--com.sun.multicast.reliable.channel.ChannelManagerFinder

public class ChannelManagerFinder

extends java.lang.Object

A channel manager finder. This class contains static methods that may be used to find ChannelManager and PrimaryChannelManager objects. The caller application obtains the channel manager's name externally (e.g. directory or web site). The name should be in the form of a URL, of the form :///. If the name is null, the channel manager finder returns a local channel manager.

See Also:

ChannelManager, PrimaryChannelManager

Method Summary

static ChannelManager	getChannelManager(java.lang.String principal) Get a ChannelManager object that goes with the supplied principal name.
static PrimaryChannelManager	getPrimaryChannelManager(java.lang.String principal) Get a PrimaryChannelManager object that goes with the supplied principal name.

Methods inherited from class java.lang.Object

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

Method Detail

getChannelManager

public static ChannelManager getChannelManager(java.lang.String principal)
                                        throws RMException,
                                               ChannelManagerNotFoundException

Get a ChannelManager object that goes with the supplied principal name. If the local ChannelManager object is desired, pass null for the name.

Parameters:

principal - the principal name (null to get the local ChannelManager object)

Returns:

a ChannelManager object for that name

Throws:

RMException - if a reliable-multicast-related exception occurs

ChannelManagerNotFoundException - if the channel manager could not be found

getPrimaryChannelManager

public static PrimaryChannelManager getPrimaryChannelManager(java.lang.String principal)
                                                      throws RMException,
                                                             ChannelManagerNotFoundException

Get a PrimaryChannelManager object that goes with the supplied principal name. If the local PrimaryChannelManager object is desired, pass null for the name.

Parameters:

principal - the principal name (null to get the local PrimaryChannelManager object)

Returns:

a PrimaryChannelManager object for that name

Throws:

RMException - if a reliable-multicast-related exception occurs

ChannelManagerNotFoundException - if the channel manager could not be found