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

Author:

Mike Davidson

Field Summary

Fields

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

Constructor Summary

Constructors

Constructor and Description
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()
int	getIntraPacketDelay() getIntraPacketDelay
List<IPPollRange>	getRanges() getRanges
Lock	getReadLock()
long	getRestartSleepTime() getRestartSleepTime
List<IPPollAddress>	getSpecifics() getSpecifics
List<IPPollAddress>	getURLSpecifics() getURLSpecifics
Lock	getWriteLock()
boolean	isExcluded(InetAddress address) isExcluded
void	reload() Reload the config from the default config file.
void	saveConfiguration(DiscoveryConfiguration configuration) saveConfiguration
protected void	saveXml(String xml) saveXml

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

public DiscoveryConfigFactory()

Method Detail

getInstance

public static DiscoveryConfigFactory getInstance()

getReadLock

public Lock getReadLock()

getWriteLock

public Lock getWriteLock()

reload

public void reload()

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.

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.