org.opennms.netmgt.config

Class DiscoveryConfigFactory

java.lang.Object

org.opennms.netmgt.config.DiscoveryConfigFactory

All Implemented Interfaces:

DiscoveryConfigurationFactory

public class DiscoveryConfigFactory
extends Object
implements DiscoveryConfigurationFactory

This is the singleton class used to load the configuration for the OpenNMS Discovery service from the discovery-configuration xml file. 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:

Mike Davidson

Field Summary

Fields

Modifier and Type	Field and Description
static char	COMMENT_CHAR
static String	COMMENT_STR

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	DiscoveryConfigFactory()

Method Summary

Modifier and Type	Method and Description
static boolean	addToSpecificsFromURL(List<IPPollAddress> specifics, InputStream is, long timeout, int retries) addToSpecificsFromURL
static boolean	addToSpecificsFromURL(List<IPPollAddress> specifics, String url, long timeout, int retries) The file URL is read and a 'specific IP' is added for each entry in this file.
DiscoveryConfiguration	getConfiguration() Return the discovery configuration object.
Iterable<IPPollAddress>	getConfiguredAddresses() getConfiguredAddresses
Iterator<IPPollAddress>	getExcludingInterator(Iterator<IPPollAddress> it) getExcludingInterator
String	getForeignSource(InetAddress address) getForeignSource
long	getInitialSleepTime() getInitialSleepTime
static DiscoveryConfigFactory	getInstance() Return the singleton instance of this factory.
int	getIntraPacketDelay() getIntraPacketDelay
List<IPPollRange>	getRanges() getRanges
Lock	getReadLock()
long	getRestartSleepTime() getRestartSleepTime
List<IPPollAddress>	getSpecifics() getSpecifics
List<IPPollAddress>	getURLSpecifics() getURLSpecifics
Lock	getWriteLock()
static void	init() Load the config from the default config file and create the singleton instance of this factory.
boolean	isExcluded(InetAddress address) isExcluded
static void	reload() Reload the config from the default config file
void	saveConfiguration(DiscoveryConfiguration configuration) saveConfiguration
protected void	saveXml(String xml) saveXml
protected void	setConfig(org.springframework.core.io.FileSystemResource resource)
static void	setInstance(DiscoveryConfigFactory factory) Set the singleton instance of this factory.

Methods inherited from class java.lang.Object

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

Field Detail

COMMENT_STR

public static final String COMMENT_STR

See Also:

Constant Field Values

COMMENT_CHAR

public static final char COMMENT_CHAR

See Also:

Constant Field Values

Constructor Detail

DiscoveryConfigFactory

protected DiscoveryConfigFactory()

Method Detail

setConfig

protected void setConfig(org.springframework.core.io.FileSystemResource resource)
                  throws org.exolab.castor.xml.MarshalException,
                         org.exolab.castor.xml.ValidationException,
                         IOException

Throws:

org.exolab.castor.xml.MarshalException

org.exolab.castor.xml.ValidationException

IOException

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 DiscoveryConfigFactory 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(DiscoveryConfigFactory factory)

Set the singleton instance of this factory.

getConfiguration

public DiscoveryConfiguration getConfiguration()

Return the discovery configuration object.

Returns:

a DiscoveryConfiguration object.

saveXml

protected void saveXml(String xml)
                throws IOException

saveXml

Parameters:

xml - a String object.

Throws:

IOException - if any.

saveConfiguration

public void saveConfiguration(DiscoveryConfiguration configuration)
                       throws org.exolab.castor.xml.MarshalException,
                              org.exolab.castor.xml.ValidationException,
                              IOException

saveConfiguration

Parameters:

configuration - a DiscoveryConfiguration object.

Throws:

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

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

IOException - if any.

addToSpecificsFromURL

public static boolean addToSpecificsFromURL(List<IPPollAddress> specifics,
                                            String url,
                                            long timeout,
                                            int retries)

 The file URL is read and a 'specific IP' is added for each entry
  in this file. Each line in the URL file can be one of -
  <IP><space>#<comments>
  or
  <IP>
  or
  #<comments>

  Lines starting with a '#' are ignored and so are characters after
  a '<space>#' in a line.
 

Parameters:

specifics - the list to add to

url - the URL file

timeout - the timeout for all entries in this URL

retries - the retries for all entries in this URL

Returns:

a boolean.

addToSpecificsFromURL

public static boolean addToSpecificsFromURL(List<IPPollAddress> specifics,
                                            InputStream is,
                                            long timeout,
                                            int retries)
                                     throws IOException

addToSpecificsFromURL

Parameters:

specifics - a List object.

is - a InputStream object.

timeout - a long.

retries - a int.

Returns:

a boolean.

Throws:

IOException - if any.

getURLSpecifics

public List<IPPollAddress> getURLSpecifics()

getURLSpecifics

Specified by:

getURLSpecifics in interface DiscoveryConfigurationFactory

Returns:

a List object.

getRanges

public List<IPPollRange> getRanges()

getRanges

Specified by:

getRanges in interface DiscoveryConfigurationFactory

Returns:

a List object.

getSpecifics

public List<IPPollAddress> getSpecifics()

getSpecifics

Specified by:

getSpecifics in interface DiscoveryConfigurationFactory

Returns:

a List object.

isExcluded

public boolean isExcluded(InetAddress address)

isExcluded

Specified by:

isExcluded in interface DiscoveryConfigurationFactory

Parameters:

address - a InetAddress object.

Returns:

a boolean.

getForeignSource

public String getForeignSource(InetAddress address)

Description copied from interface: DiscoveryConfigurationFactory

getForeignSource

Specified by:

getForeignSource in interface DiscoveryConfigurationFactory

Returns:

a String

getIntraPacketDelay

public int getIntraPacketDelay()

getIntraPacketDelay

Specified by:

getIntraPacketDelay in interface DiscoveryConfigurationFactory

Returns:

a int.

getExcludingInterator

public Iterator<IPPollAddress> getExcludingInterator(Iterator<IPPollAddress> it)

getExcludingInterator

Specified by:

getExcludingInterator in interface DiscoveryConfigurationFactory

Parameters:

it - a Iterator object.

Returns:

a Iterator object.

getConfiguredAddresses

public Iterable<IPPollAddress> getConfiguredAddresses()

getConfiguredAddresses

Specified by:

getConfiguredAddresses in interface DiscoveryConfigurationFactory

Returns:

a Iterable object.

getRestartSleepTime

public long getRestartSleepTime()

getRestartSleepTime

Specified by:

getRestartSleepTime in interface DiscoveryConfigurationFactory

Returns:

a long.

getInitialSleepTime

public long getInitialSleepTime()

getInitialSleepTime

Specified by:

getInitialSleepTime in interface DiscoveryConfigurationFactory

Returns:

a long.