org.opennms.netmgt.config
Class AmiPeerFactory

java.lang.Object
  org.opennms.netmgt.config.AmiPeerFactory

public class AmiPeerFactory
extends Object

This class is the main repository for AMI configuration information used by the capabilities daemon. When this class is loaded it reads the AMI configuration into memory, and uses the configuration to find the AmiAgentConfig objects for specific addresses. If an address cannot be located in the configuration then a default peer instance is returned to the caller. Note: Users of this class should make sure the init() is called before calling any other method to ensure the config is loaded before accessing other convenience methods.

Author:

Jeff Gehlbach, OpenNMS

Method Summary

AmiAgentConfig	getAgentConfig(InetAddress agentInetAddress) getAgentConfig
static AmiConfig	getAmiConfig() getAmiConfig
static AmiPeerFactory	getInstance() Return the singleton instance of this factory.
Lock	getReadLock()
Lock	getWriteLock()
static void	init() Load the config from the default config file and create the singleton instance of this factory.
static void	reload() Reload the config from the default config file
void	saveCurrent() Saves the current settings to disk
static void	setAmiConfig(AmiConfig m_config) setAmiConfig
static void	setInstance(AmiPeerFactory singleton) setInstance

Methods inherited from class java.lang.Object

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

Method Detail

getReadLock

public Lock getReadLock()

getWriteLock

public Lock getWriteLock()

init

public static void init()
                 throws IOException,
                        org.exolab.castor.xml.MarshalException,
                        org.exolab.castor.xml.ValidationException

Load the config from the default config file and create the singleton instance of this factory.

Throws:

IOException - Thrown if the specified config file cannot be read

org.exolab.castor.xml.MarshalException - Thrown if the file does not conform to the schema.

org.exolab.castor.xml.ValidationException - Thrown if the contents do not match the required schema.

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

reload

public static void reload()
                   throws IOException,
                          org.exolab.castor.xml.MarshalException,
                          org.exolab.castor.xml.ValidationException

Reload the config from the default config file

Throws:

IOException - Thrown if the specified config file cannot be read/loaded

org.exolab.castor.xml.MarshalException - Thrown if the file does not conform to the schema.

org.exolab.castor.xml.ValidationException - Thrown if the contents do not match the required schema.

IOException - if any.

org.exolab.castor.xml.MarshalException - if any.

org.exolab.castor.xml.ValidationException - if any.

getInstance

public static AmiPeerFactory getInstance()

Return the singleton instance of this factory.

Returns:

The current factory instance.

Throws:

IllegalStateException - Thrown if the factory has not yet been initialized.

setInstance

public static void setInstance(AmiPeerFactory singleton)

setInstance

Parameters:

singleton - a AmiPeerFactory object.

setAmiConfig

public static void setAmiConfig(AmiConfig m_config)

setAmiConfig

Parameters:

m_config - a AmiConfig object.

saveCurrent

public void saveCurrent()
                 throws Exception

Saves the current settings to disk

Throws:

Exception - if saving settings to disk fails.

getAgentConfig

public AmiAgentConfig getAgentConfig(InetAddress agentInetAddress)

getAgentConfig

Parameters:

agentInetAddress - a InetAddress object.

Returns:

a AmiAgentConfig object.

getAmiConfig

public static AmiConfig getAmiConfig()

getAmiConfig

Returns:

a AmiConfig object.