org.jgroups

Class JChannelFactory

public class JChannelFactory extends Object implements ChannelFactory

JChannelFactory creates pure Java implementations of the Channel interface. See JChannel for a discussion of channel properties.
Constructor Summary
JChannelFactory()
Constructs a JChannelFactory instance that contains no protocol stack configuration.
JChannelFactory(File properties)
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
JChannelFactory(Element properties)
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
JChannelFactory(URL properties)
Constructs a JChannelFactory instance that utilizes the specified file for protocl stack configuration.
JChannelFactory(String properties)
Constructs a JChannel instance with the protocol stack configuration based upon the specified properties parameter.
Method Summary
ChannelcreateChannel(Object properties)
Creates a JChannel implementation of the Channel interface.
ChannelcreateChannel()
Creates a JChannel implementation of the Channel interface using the protocol stack configuration information specfied during construction of an instance of this factory.

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(File properties)
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(Element properties)
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(URL properties)
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(String properties)
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(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.

Creates a JChannel implementation of the Channel interface.

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()
Creates a JChannel implementation of the Channel interface using the protocol stack configuration information specfied during construction of an instance of this factory.

Throws: ChannelException if the creation of the channel failed.

Copyright ? 1998-2005 Bela Ban. All Rights Reserved.