org.jgroups
Class JChannelFactory

java.lang.Object
  extended byorg.jgroups.JChannelFactory
All Implemented Interfaces:
ChannelFactory

public class JChannelFactory
extends java.lang.Object
implements ChannelFactory

JChannelFactory creates pure Java implementations of the Channel interface.


Constructor Summary
JChannelFactory()
          Deprecated. This constructor should only be used in conjunction with the deprecated getChannel(Object) method of this class.
JChannelFactory(org.w3c.dom.Element properties)
          Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
JChannelFactory(java.io.File properties)
          Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
JChannelFactory(java.lang.String properties)
          Constructs a JChannel instance with the protocol stack configuration based upon the specified properties parameter.
JChannelFactory(java.net.URL properties)
          Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
 
Method Summary
 Channel createChannel()
          Creates a JChannel implementation of the Channel interface using the protocol stack configuration information specfied during construction of an instance of this factory.
 Channel createChannel(java.lang.Object properties)
          Deprecated. JChannel's conversion to type-specific construction, and the subsequent deprecation of its JChannel(Object) constructor, necessitate the deprecation of this factory method as well. Type-specific protocol stack configuration should be specfied during construction of an instance of this factory.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

JChannelFactory

public JChannelFactory()
Deprecated. This constructor should only be used in conjunction with the deprecated getChannel(Object) method of this class.

Constructs a JChannelFactory instance that contains no protocol stack configuration.


JChannelFactory

public JChannelFactory(java.io.File properties)
                throws ChannelException
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.

Parameters:
properties - a file containing a JGroups XML protocol stack configuration.
Throws:
ChannelException - if problems occur during the interpretation of the protocol stack configuration.

JChannelFactory

public JChannelFactory(org.w3c.dom.Element properties)
                throws ChannelException
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.

Parameters:
properties - a XML element containing a JGroups XML protocol stack configuration.
Throws:
ChannelException - if problems occur during the interpretation of the protocol stack configuration.

JChannelFactory

public JChannelFactory(java.net.URL properties)
                throws ChannelException
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.

Parameters:
properties - a URL pointing to a JGroups XML protocol stack configuration.
Throws:
ChannelException - if problems occur during the interpretation of the protocol stack configuration.

JChannelFactory

public JChannelFactory(java.lang.String properties)
                throws ChannelException
Constructs a JChannel instance with the protocol stack configuration based upon the specified properties parameter.

Parameters:
properties - an old style property string, a string representing a system resource containing a JGroups XML configuration, a string representing a URL pointing to a JGroups XML XML configuration, or a string representing a file name that contains a JGroups XML configuration.
Throws:
ChannelException - if problems occur during the interpretation of the protocol stack configuration.
Method Detail

createChannel

public Channel createChannel(java.lang.Object properties)
                      throws ChannelException
Deprecated. JChannel's conversion to type-specific construction, and the subsequent deprecation of its JChannel(Object) constructor, necessitate the deprecation of this factory method as well. Type-specific protocol stack configuration should be specfied during construction of an instance of this factory.

Creates a JChannel implementation of the Channel interface.

Specified by:
createChannel in interface ChannelFactory
Parameters:
properties - the protocol stack configuration information; a null value means use the default protocol stack configuration.
Throws:
ChannelException - if the creation of the channel failed.

createChannel

public Channel createChannel()
                      throws ChannelException
Creates a JChannel implementation of the Channel interface using the protocol stack configuration information specfied during construction of an instance of this factory.

Specified by:
createChannel in interface ChannelFactory
Throws:
ChannelException - if the creation of the channel failed.


Copyright ? 2001,2002 www.jgroups.com . All Rights Reserved.