org.jacorb.config

Class JacORBConfiguration

java.lang.Object

org.jacorb.config.JacORBConfiguration

All Implemented Interfaces:

Configuration

public class JacORBConfiguration
extends Object
implements Configuration

Version:

$Id$

Author:

Gerald Brose

Method Summary

Modifier and Type	Method and Description
String	getAttribute(String key) Returns the value of the configuration attribute with the given key.
String	getAttribute(String key, String defaultValue) Returns the value of the configuration attribute with the given key.
boolean	getAttributeAsBoolean(String key)
boolean	getAttributeAsBoolean(String key, boolean defaultValue)
int	getAttributeAsInteger(String key) Returns the value of the configuration attribute with the given key, as an integer.
int	getAttributeAsInteger(String key, int defaultValue) Returns the value of the configuration attribute with the given key, as an integer.
long	getAttributeAsLong(String key, long defaultValue) Returns the value of the configuration attribute with the given key, as a long value.
Object	getAttributeAsObject(String key) Create an object from the given property.
Object	getAttributeAsObject(String key, String defaultClass)
List	getAttributeList(String key) For a property that has a list of comma-separated values, this method returns these values as a list of Strings.
String[]	getAttributeNames()
List	getAttributeNamesWithPrefix(String prefix) return all attribute names that start with the specified prefix
static Configuration	getConfiguration(Properties props, ORB orb, boolean isApplet) Factory method
org.slf4j.Logger	getLogger(String name) Returns a Logger that logs JacORB system messages.
String	getLoggerName(Class clz)
ORB	getORB()
void	setAttribute(String key, String value) Sets the value of a single attribute.

Methods inherited from class java.lang.Object

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

Method Detail

getConfiguration

public static Configuration getConfiguration(Properties props,
                                             ORB orb,
                                             boolean isApplet)
                                      throws ConfigurationException

Factory method

Throws:

ConfigurationException

setAttribute

public void setAttribute(String key,
                         String value)

Sets the value of a single attribute.

Specified by:

setAttribute in interface Configuration

getORB

public ORB getORB()

Specified by:

getORB in interface Configuration

Returns:

the ORB for which this configuration was created

getLogger

public org.slf4j.Logger getLogger(String name)

Returns a Logger that logs JacORB system messages. This uses the SLF4J logging facade. The actual logging backend is chosen at deployment time, by putting a corresponding SLF4J adapter jar on the classpath. The JacORB root logger is named "jacorb". Sublogger names all start with this prefix. If the property jacorb.implname is set, and the property jacorb.log.split_on_implname is true, then all loggers for that particular ORB instance are rooted in jacorb.. Here's a guideline how to use logging levels in the code: error Conditions that indicate a bug in JacORB or user code, or a wrong configuration. This includes, but is not limited to, errors that will lead to termination of the program (fatal errors). warn Conditions that demand attention, but are handled properly according to the CORBA spec. For example, abnormal termination of a connection, reaching of a resource limit (queue full). info Start/stop of subsystems, establishing and closing of connections, registering objects with a POA. debug Information that might be needed for finding bugs in JacORB or user code. Anything that relates to the normal processing of individual messages should come under this level. For each CORBA message, there should at least one debug message when subsystem boundaries are crossed (e.g. GIOPConnection -> POA -> User Code).

Specified by:

getLogger in interface Configuration

Parameters:

name - the name of the logger, which also functions as a log category

Returns:

a Logger for a given name

getLoggerName

public String getLoggerName(Class clz)

Specified by:

getLoggerName in interface Configuration

getAttribute

public String getAttribute(String key)

Description copied from interface: Configuration

Returns the value of the configuration attribute with the given key. If the attribute value for this key is undefined, the exception ConfigurationException is thrown.

Specified by:

getAttribute in interface Configuration

See Also:

Configuration.getAttribute(java.lang.String)

getAttribute

public String getAttribute(String key,
                           String defaultValue)

Description copied from interface: Configuration

Returns the value of the configuration attribute with the given key. If the attribute value for this key is undefined, the defaultValue is returned.

Specified by:

getAttribute in interface Configuration

See Also:

Configuration.getAttribute(java.lang.String, java.lang.String)

getAttributeAsInteger

public int getAttributeAsInteger(String key,
                                 int defaultValue)

Description copied from interface: Configuration

Returns the value of the configuration attribute with the given key, as an integer. If the attribute value for this key is undefined, the defaultValue is returned.

Specified by:

getAttributeAsInteger in interface Configuration

See Also:

Configuration.getAttributeAsInteger(java.lang.String, int)

getAttributeAsInteger

public int getAttributeAsInteger(String key)

Description copied from interface: Configuration

Returns the value of the configuration attribute with the given key, as an integer. If the attribute value for this key is undefined, the exception ConfigurationException is thrown.

Specified by:

getAttributeAsInteger in interface Configuration

See Also:

Configuration.getAttributeAsInteger(java.lang.String)

getAttributeAsLong

public long getAttributeAsLong(String key,
                               long defaultValue)

Description copied from interface: Configuration

Returns the value of the configuration attribute with the given key, as a long value. If the attribute value for this key is undefined, the defaultValue is returned.

Specified by:

getAttributeAsLong in interface Configuration

See Also:

Configuration.getAttributeAsLong(java.lang.String, long)

getAttributeList

public List getAttributeList(String key)

Description copied from interface: Configuration

For a property that has a list of comma-separated values, this method returns these values as a list of Strings. If the property is not set, an empty list is returned.

Specified by:

getAttributeList in interface Configuration

See Also:

Configuration.getAttributeList(java.lang.String)

getAttributeAsObject

public Object getAttributeAsObject(String key)
                            throws ConfigurationException

Description copied from interface: Configuration

Create an object from the given property. The class's default constructor will be used.

Specified by:

getAttributeAsObject in interface Configuration

Returns:

an object of the class of the keys value, or null, if no class name is found for the key

Throws:

ConfigurationException

See Also:

Configuration.getAttributeAsObject(java.lang.String)

getAttributeAsObject

public Object getAttributeAsObject(String key,
                                   String defaultClass)
                            throws ConfigurationException

Specified by:

getAttributeAsObject in interface Configuration

Throws:

ConfigurationException

See Also:

Configuration.getAttributeAsObject(java.lang.String, java.lang.String)

getAttributeAsBoolean

public boolean getAttributeAsBoolean(String key)
                              throws ConfigurationException

Specified by:

getAttributeAsBoolean in interface Configuration

Throws:

ConfigurationException

See Also:

Configuration.getAttributeAsBoolean(java.lang.String)

getAttributeAsBoolean

public boolean getAttributeAsBoolean(String key,
                                     boolean defaultValue)

Specified by:

getAttributeAsBoolean in interface Configuration

See Also:

Configuration.getAttributeAsBoolean(java.lang.String, boolean)

getAttributeNames

public String[] getAttributeNames()

getAttributeNamesWithPrefix

public List getAttributeNamesWithPrefix(String prefix)

Description copied from interface: Configuration

return all attribute names that start with the specified prefix

Specified by:

getAttributeNamesWithPrefix in interface Configuration

See Also:

Configuration.getAttributeNamesWithPrefix(java.lang.String)