org.jgroups.conf

Class ConfiguratorFactory

java.lang.Object

org.jgroups.conf.ConfiguratorFactory

public class ConfiguratorFactory
extends Object

The ConfigurationFactory is a factory that returns a protocol stack configurator. The protocol stack configurator is an object that read a stack configuration and parses it so that the ProtocolStack can create a stack.
Currently the factory returns one of the following objects:
1. XmlConfigurator - parses XML files
2. PlainConfigurator - uses the old style strings UDP:FRAG: etc etc

Author:

Filip Hanik (filip@filip.net), Bela Ban

Field Summary

Fields

Modifier and Type	Field and Description
static String	JAXP_MISSING_ERROR_MSG

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ConfiguratorFactory()

Method Summary

Methods

Modifier and Type	Method and Description
static InputStream	getConfigStream(File file)
static InputStream	getConfigStream(Object properties)
static InputStream	getConfigStream(String properties) Returns a JGroups XML configuration InputStream based on the provided properties string.
static InputStream	getConfigStream(URL url)
static ProtocolStackConfigurator	getStackConfigurator(Element element) Returns a protocol stack configurator based on the XML configuration provided by the specified XML element.
static ProtocolStackConfigurator	getStackConfigurator(File file) Returns a protocol stack configurator based on the XML configuration provided by the specified File.
static ProtocolStackConfigurator	getStackConfigurator(InputStream input)
static ProtocolStackConfigurator	getStackConfigurator(String properties) Returns a protocol stack configurator based on the provided properties string.
static ProtocolStackConfigurator	getStackConfigurator(URL url) Returns a protocol stack configurator based on the XML configuration provided at the specified URL.
static void	substituteVariables(ProtocolStackConfigurator configurator) Replace variables of the form ${var:default} with the getProperty(var, default)

Methods inherited from class java.lang.Object

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

Field Detail

JAXP_MISSING_ERROR_MSG

public static final String JAXP_MISSING_ERROR_MSG

See Also:

Constant Field Values

Constructor Detail

ConfiguratorFactory

protected ConfiguratorFactory()

Method Detail

getStackConfigurator

public static ProtocolStackConfigurator getStackConfigurator(File file)
                                                      throws Exception

Returns a protocol stack configurator based on the XML configuration provided by the specified File.

Parameters:

file - a File with a JGroups XML configuration.

Returns:

a ProtocolStackConfigurator containing the stack configuration.

Throws:

Exception - if problems occur during the configuration of the protocol stack.

getStackConfigurator

public static ProtocolStackConfigurator getStackConfigurator(InputStream input)
                                                      throws Exception

Throws:

Exception

getStackConfigurator

public static ProtocolStackConfigurator getStackConfigurator(URL url)
                                                      throws Exception

Returns a protocol stack configurator based on the XML configuration provided at the specified URL.

Parameters:

url - a URL pointing to a JGroups XML configuration.

Returns:

a ProtocolStackConfigurator containing the stack configuration.

Throws:

Exception - if problems occur during the configuration of the protocol stack.

getStackConfigurator

public static ProtocolStackConfigurator getStackConfigurator(Element element)
                                                      throws Exception

Returns a protocol stack configurator based on the XML configuration provided by the specified XML element.

Parameters:

element - a XML element containing a JGroups XML configuration.

Returns:

a ProtocolStackConfigurator containing the stack configuration.

Throws:

Exception - if problems occur during the configuration of the protocol stack.

getStackConfigurator

public static ProtocolStackConfigurator getStackConfigurator(String properties)
                                                      throws Exception

Returns a protocol stack configurator based on the provided properties string.

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 configuration, or a string representing a file name that contains a JGroups XML configuration.

Throws:

Exception

getConfigStream

public static InputStream getConfigStream(File file)
                                   throws Exception

Throws:

Exception

getConfigStream

public static InputStream getConfigStream(URL url)
                                   throws Exception

Throws:

Exception

getConfigStream

public static InputStream getConfigStream(String properties)
                                   throws IOException

Returns a JGroups XML configuration InputStream based on the provided properties string.

Parameters:

properties - a string representing a system resource containing a JGroups XML configuration, a string representing a URL pointing to a JGroups ML configuration, or a string representing a file name that contains a JGroups XML configuration.

Throws:

IOException - if the provided properties string appears to be a valid URL but is unreachable.

getConfigStream

public static InputStream getConfigStream(Object properties)
                                   throws IOException

Throws:

IOException

substituteVariables

public static void substituteVariables(ProtocolStackConfigurator configurator)

Replace variables of the form ${var:default} with the getProperty(var, default)

Parameters:

configurator -