org.opennms.netmgt.config

Class SnmpPeerFactory

java.lang.Object

org.opennms.netmgt.config.SnmpPeerFactory

All Implemented Interfaces:

SnmpAgentConfigFactory

Direct Known Subclasses:

ProxySnmpAgentConfigFactory

public class SnmpPeerFactory
extends Object
implements SnmpAgentConfigFactory

This class is the main repository for SNMP configuration information used by the capabilities daemon. When this class is loaded it reads the snmp configuration into memory, and uses the configuration to find the SnmpAgentConfig 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:

David Hustace, Weave, Gerald Turner

Constructor Summary

Constructors

Constructor and Description
SnmpPeerFactory(org.springframework.core.io.Resource resource) Constructor for SnmpPeerFactory.

Method Summary

Modifier and Type	Method and Description
void	define(SnmpEventInfo info) Enhancement: Allows specific or ranges to be merged into SNMP configuration with many other attributes.
SnmpAgentConfig	getAgentConfig(InetAddress agentAddress)
SnmpAgentConfig	getAgentConfig(InetAddress agentInetAddress, int requestedSnmpVersion)
SnmpAgentConfig	getAgentConfig(InetAddress agentAddress, String location) getAgentConfig
SnmpAgentConfig	getAgentConfig(InetAddress agentInetAddress, String location, int requestedSnmpVersion)
static File	getFile()
static SnmpPeerFactory	getInstance() Load the config from the default config file and create the singleton instance of this factory.
protected Lock	getReadLock()
SnmpConfig	getSnmpConfig() getSnmpConfig
String	getSnmpConfigAsString() Creates a string containing the XML of the current SnmpConfig
int	getVersionCode(Definition def, SnmpConfig config, int requestedSnmpVersion)
protected Lock	getWriteLock()
static void	init()
void	saveCurrent() Saves the current settings to disk
void	saveToFile(File file)
static void	setFile(File configFile) setFile
static void	setInstance(SnmpPeerFactory singleton) setInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

SnmpPeerFactory

public SnmpPeerFactory(org.springframework.core.io.Resource resource)

Constructor for SnmpPeerFactory.

Parameters:

resource - a Resource object.

Method Detail

getReadLock

protected Lock getReadLock()

getWriteLock

protected Lock getWriteLock()

init

public static void init()
                 throws IOException

Throws:

IOException

getInstance

public static SnmpPeerFactory getInstance()

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

setInstance

public static void setInstance(SnmpPeerFactory singleton)

setInstance

Parameters:

singleton - a SnmpPeerFactory object.

getFile

public static File getFile()
                    throws IOException

Throws:

IOException

setFile

public static void setFile(File configFile)

setFile

Parameters:

configFile - a File object.

saveCurrent

public void saveCurrent()
                 throws IOException

Saves the current settings to disk

Throws:

IOException - if any.

saveToFile

public void saveToFile(File file)
                throws UnsupportedEncodingException,
                       FileNotFoundException,
                       IOException

Throws:

UnsupportedEncodingException

FileNotFoundException

IOException

getAgentConfig

public SnmpAgentConfig getAgentConfig(InetAddress agentAddress)

getAgentConfig

public SnmpAgentConfig getAgentConfig(InetAddress agentAddress,
                                      String location)

Description copied from interface: SnmpAgentConfigFactory

getAgentConfig

Specified by:

getAgentConfig in interface SnmpAgentConfigFactory

Parameters:

agentAddress - a InetAddress object.

location - a String object.

Returns:

a SnmpAgentConfig object.

getAgentConfig

public SnmpAgentConfig getAgentConfig(InetAddress agentInetAddress,
                                      int requestedSnmpVersion)

getAgentConfig

public SnmpAgentConfig getAgentConfig(InetAddress agentInetAddress,
                                      String location,
                                      int requestedSnmpVersion)

getVersionCode

public int getVersionCode(Definition def,
                          SnmpConfig config,
                          int requestedSnmpVersion)

getSnmpConfig

public SnmpConfig getSnmpConfig()

getSnmpConfig

Returns:

a SnmpConfig object.

define

public void define(SnmpEventInfo info)

Enhancement: Allows specific or ranges to be merged into SNMP configuration with many other attributes. Uses new classes the wrap JAXB-generated code to help with merging, comparing, and optimizing definitions. Thanks for your initial work on this Gerald. Puts a specific IP address with associated read-community string into the currently loaded snmp-config.xml.

Parameters:

info - a SnmpEventInfo object.

getSnmpConfigAsString

public String getSnmpConfigAsString()

Creates a string containing the XML of the current SnmpConfig

Returns:

Marshalled SnmpConfig