org.opennms.protocols.xml.collector

Class AbstractXmlCollectionHandler

java.lang.Object

org.opennms.protocols.xml.collector.AbstractXmlCollectionHandler

All Implemented Interfaces:

XmlCollectionHandler

Direct Known Subclasses:

AbstractJsonCollectionHandler, DefaultXmlCollectionHandler, HttpCollectionHandler, Sftp3gppXmlCollectionHandler

public abstract class AbstractXmlCollectionHandler
extends Object
implements XmlCollectionHandler

The Abstract Class XML Collection Handler.

All XmlCollectionHandler should extend this class.

Author:

Alejandro Galue

Constructor Summary

Constructors

Constructor and Description
AbstractXmlCollectionHandler()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	fillCollectionSet(CollectionAgent agent, XmlCollectionSet collectionSet, XmlSource source, Document doc) Fill collection set.
protected XmlCollectionResource	getCollectionResource(CollectionAgent agent, String instance, String resourceType, Date timestamp) Gets the collection resource.
NodeDao	getNodeDao() Gets the Node DAO.
RrdRepository	getRrdRepository() Gets the RRD repository.
String	getServiceName() Gets the service name.
protected Date	getTimeStamp(Document doc, XPath xpath, XmlGroup group) Gets the time stamp.
protected Document	getXmlDocument(InputStream is, Request request) Gets the XML document.
protected Document	getXmlDocument(String urlString, Request request) Gets the XML document.
protected XmlResourceType	getXmlResourceType(CollectionAgent agent, String resourceType) Gets the XML resource type.
protected ThreadCategory	log() Log.
protected Request	parseRequest(Request unformattedRequest, CollectionAgent agent) Parses the request.
protected String	parseString(String reference, String unformattedString, OnmsNode node, String ipAddress) Parses the string.
protected String	parseUrl(String unformattedUrl, CollectionAgent agent, Integer collectionStep) Parses the URL.
protected abstract void	processXmlResource(XmlCollectionResource collectionResource, AttributeGroupType attribGroupType) Process XML resource.
void	setNodeDao(NodeDao nodeDao) Sets the Node DAO.
void	setRrdRepository(RrdRepository rrdRepository) Sets the RRD repository.
void	setServiceName(String serviceName) Sets the service name associated with this Collection Handler.

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.opennms.protocols.xml.collector.XmlCollectionHandler

collect

Constructor Detail

AbstractXmlCollectionHandler

public AbstractXmlCollectionHandler()

Method Detail

setServiceName

public void setServiceName(String serviceName)

Description copied from interface: XmlCollectionHandler

Sets the service name associated with this Collection Handler.

Specified by:

setServiceName in interface XmlCollectionHandler

Parameters:

serviceName - the new service name

setRrdRepository

public void setRrdRepository(RrdRepository rrdRepository)

Description copied from interface: XmlCollectionHandler

Sets the RRD repository.

Specified by:

setRrdRepository in interface XmlCollectionHandler

Parameters:

rrdRepository - the new RRD repository

getServiceName

public String getServiceName()

Gets the service name.

Returns:

the service name

getRrdRepository

public RrdRepository getRrdRepository()

Gets the RRD repository.

Returns:

the RRD repository

getNodeDao

public NodeDao getNodeDao()

Gets the Node DAO.

Returns:

the Node DAO

setNodeDao

public void setNodeDao(NodeDao nodeDao)

Sets the Node DAO.

Parameters:

nodeDao - the new Node DAO

fillCollectionSet

protected void fillCollectionSet(CollectionAgent agent,
                     XmlCollectionSet collectionSet,
                     XmlSource source,
                     Document doc)
                          throws XPathExpressionException,
                                 ParseException

Fill collection set.

Parameters:

agent - the agent

collectionSet - the collection set

source - the source

doc - the doc

Throws:

XPathExpressionException - the x path expression exception

ParseException - the parse exception

processXmlResource

protected abstract void processXmlResource(XmlCollectionResource collectionResource,
                      AttributeGroupType attribGroupType)

Process XML resource.

Parameters:

collectionResource - the collection resource

attribGroupType - the attribute group type

getCollectionResource

protected XmlCollectionResource getCollectionResource(CollectionAgent agent,
                                          String instance,
                                          String resourceType,
                                          Date timestamp)

Gets the collection resource.

Parameters:

agent - the collection agent

instance - the resource instance

resourceType - the resource type

timestamp - the timestamp

Returns:

the collection resource

getTimeStamp

protected Date getTimeStamp(Document doc,
                XPath xpath,
                XmlGroup group)
                     throws XPathExpressionException

Gets the time stamp.

Parameters:

doc - the doc

xpath - the xpath

group - the group

Returns:

the time stamp

Throws:

XPathExpressionException - the x path expression exception

parseUrl

protected String parseUrl(String unformattedUrl,
              CollectionAgent agent,
              Integer collectionStep)
                   throws IllegalArgumentException

Parses the URL.

Additional placeholders:

• step, The Collection Step in seconds

Parameters:

unformattedUrl - the unformatted URL

agent - the collection agent

collectionStep - the collection step (in seconds)

Returns:

the string

Throws:

IllegalArgumentException - the illegal argument exception

parseRequest

protected Request parseRequest(Request unformattedRequest,
                   CollectionAgent agent)
                        throws IllegalArgumentException

Parses the request.

Parameters:

unformattedRequest - the unformatted request

agent - the agent

Returns:

the request

Throws:

IllegalArgumentException - the illegal argument exception

parseString

protected String parseString(String reference,
                 String unformattedString,
                 OnmsNode node,
                 String ipAddress)
                      throws IllegalArgumentException

Parses the string.

Valid placeholders are:

• ipaddr, The Node IP Address
• step, The Collection Step in seconds
• nodeId, The Node ID
• nodeLabel, The Node Label
• foreignId, The Node Foreign ID
• foreignSource, The Node Foreign Source
• Any asset property defined on the node.

Parameters:

reference - the reference

unformattedString - the unformatted string

node - the node

ipAddress - the IP address

Returns:

the string

Throws:

IllegalArgumentException - the illegal argument exception

getXmlDocument

protected Document getXmlDocument(String urlString,
                      Request request)

Gets the XML document.

Parameters:

urlString - the URL string

request - the request

Returns:

the XML document

getXmlDocument

protected Document getXmlDocument(InputStream is,
                      Request request)

Gets the XML document.

Parameters:

is - the input stream

request - the request

Returns:

the XML document

getXmlResourceType

protected XmlResourceType getXmlResourceType(CollectionAgent agent,
                                 String resourceType)

Gets the XML resource type.

Parameters:

agent - the collection agent

resourceType - the resource type

Returns:

the XML resource type

log

protected ThreadCategory log()

Log.

Returns:

the thread category