org.opennms.netmgt.config.poller

Class Service

java.lang.Object

org.opennms.netmgt.config.poller.Service

All Implemented Interfaces:

Serializable

public class Service
extends Object
implements Serializable

Service to be polled for addresses in this package.

Version:

$Revision$ $Date$

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
Service()

Method Summary

Methods

Modifier and Type	Method and Description
void	addParameter(int index, Parameter vParameter)
void	addParameter(Parameter vParameter)
void	deleteInterval()
Enumeration<Parameter>	enumerateParameter() Method enumerateParameter.
boolean	equals(Object obj) Overrides the java.lang.Object.equals method.
long	getInterval() Returns the value of field 'interval'.
String	getName() Returns the value of field 'name'.
Parameter[]	getParameter() Method getParameter.Returns the contents of the collection in an Array.
Parameter	getParameter(int index) Method getParameter.
List<Parameter>	getParameterCollection() Method getParameterCollection.Returns a reference to '_parameterList'.
int	getParameterCount() Method getParameterCount.
String	getStatus() Returns the value of field 'status'.
String	getUserDefined() Returns the value of field 'userDefined'.
int	hashCode() Overrides the java.lang.Object.hashCode method.
boolean	hasInterval() Method hasInterval.
boolean	isValid() Method isValid.
Iterator<Parameter>	iterateParameter() Method iterateParameter.
void	marshal(ContentHandler handler)
void	marshal(Writer out)
void	removeAllParameter()
boolean	removeParameter(Parameter vParameter) Method removeParameter.
Parameter	removeParameterAt(int index) Method removeParameterAt.
void	setInterval(long interval) Sets the value of field 'interval'.
void	setName(String name) Sets the value of field 'name'.
void	setParameter(int index, Parameter vParameter)
void	setParameter(List<Parameter> vParameterList) Sets the value of '_parameterList' by copying the given Vector.
void	setParameter(Parameter[] vParameterArray)
void	setParameterCollection(List<Parameter> parameterList) Deprecated.
void	setStatus(String status) Sets the value of field 'status'.
void	setUserDefined(String userDefined) Sets the value of field 'userDefined'.
static Service	unmarshal(Reader reader) Method unmarshal.
void	validate()

Methods inherited from class java.lang.Object

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

Constructor Detail

Service

public Service()

Method Detail

addParameter

public void addParameter(Parameter vParameter)
                  throws IndexOutOfBoundsException

Parameters:

vParameter -

Throws:

IndexOutOfBoundsException - if the index given is outside the bounds of the collection

addParameter

public void addParameter(int index,
                Parameter vParameter)
                  throws IndexOutOfBoundsException

Parameters:

index -

vParameter -

Throws:

IndexOutOfBoundsException - if the index given is outside the bounds of the collection

deleteInterval

public void deleteInterval()

enumerateParameter

public Enumeration<Parameter> enumerateParameter()

Method enumerateParameter.

Returns:

an Enumeration over all possible elements of this collection

equals

public boolean equals(Object obj)

Overrides the java.lang.Object.equals method.

Overrides:

equals in class Object

Parameters:

obj -

Returns:

true if the objects are equal.

getInterval

public long getInterval()

Returns the value of field 'interval'. The field 'interval' has the following description: Interval at which the service is to be polled

Returns:

the value of field 'Interval'.

getName

public String getName()

Returns the value of field 'name'. The field 'name' has the following description: Service name

Returns:

the value of field 'Name'.

getParameter

public Parameter getParameter(int index)
                       throws IndexOutOfBoundsException

Method getParameter.

Parameters:

index -

Returns:

the value of the org.opennms.netmgt.config.poller.Parameter at the given index

Throws:

IndexOutOfBoundsException - if the index given is outside the bounds of the collection

getParameter

public Parameter[] getParameter()

Method getParameter.Returns the contents of the collection in an Array.

Note: Just in case the collection contents are changing in another thread, we pass a 0-length Array of the correct type into the API call. This way we know that the Array returned is of exactly the correct length.

Returns:

this collection as an Array

getParameterCollection

public List<Parameter> getParameterCollection()

Method getParameterCollection.Returns a reference to '_parameterList'. No type checking is performed on any modifications to the Vector.

Returns:

a reference to the Vector backing this class

getParameterCount

public int getParameterCount()

Method getParameterCount.

Returns:

the size of this collection

getStatus

public String getStatus()

Returns the value of field 'status'. The field 'status' has the following description: Status of the service. The service is polled only if this is set to 'on'.

Returns:

the value of field 'Status'.

getUserDefined

public String getUserDefined()

Returns the value of field 'userDefined'. The field 'userDefined' has the following description: Specifies if the service is user defined. Used specifically for UI purposes.

Returns:

the value of field 'UserDefined'.

hasInterval

public boolean hasInterval()

Method hasInterval.

Returns:

true if at least one Interval has been added

hashCode

public int hashCode()

Overrides the java.lang.Object.hashCode method.

The following steps came from Effective Java Programming Language Guide by Joshua Bloch, Chapter 3

Overrides:

hashCode in class Object

Returns:

a hash code value for the object.

isValid

public boolean isValid()

Method isValid.

Returns:

true if this object is valid according to the schema

iterateParameter

public Iterator<Parameter> iterateParameter()

Method iterateParameter.

Returns:

an Iterator over all possible elements in this collection

marshal

public void marshal(Writer out)
             throws org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Parameters:

out -

Throws:

org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling

org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

marshal

public void marshal(ContentHandler handler)
             throws IOException,
                    org.exolab.castor.xml.MarshalException,
                    org.exolab.castor.xml.ValidationException

Parameters:

handler -

Throws:

IOException - if an IOException occurs during marshaling

org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling

removeAllParameter

public void removeAllParameter()

removeParameter

public boolean removeParameter(Parameter vParameter)

Method removeParameter.

Parameters:

vParameter -

Returns:

true if the object was removed from the collection.

removeParameterAt

public Parameter removeParameterAt(int index)

Method removeParameterAt.

Parameters:

index -

Returns:

the element removed from the collection

setInterval

public void setInterval(long interval)

Sets the value of field 'interval'. The field 'interval' has the following description: Interval at which the service is to be polled

Parameters:

interval - the value of field 'interval'.

setName

public void setName(String name)

Sets the value of field 'name'. The field 'name' has the following description: Service name

Parameters:

name - the value of field 'name'.

setParameter

public void setParameter(int index,
                Parameter vParameter)
                  throws IndexOutOfBoundsException

Parameters:

index -

vParameter -

Throws:

IndexOutOfBoundsException - if the index given is outside the bounds of the collection

setParameter

public void setParameter(Parameter[] vParameterArray)

Parameters:

vParameterArray -

setParameter

public void setParameter(List<Parameter> vParameterList)

Sets the value of '_parameterList' by copying the given Vector. All elements will be checked for type safety.

Parameters:

vParameterList - the Vector to copy.

setParameterCollection

public void setParameterCollection(List<Parameter> parameterList)

Deprecated.

Sets the value of '_parameterList' by setting it to the given Vector. No type checking is performed.

Parameters:

parameterList - the Vector to set.

setStatus

public void setStatus(String status)

Sets the value of field 'status'. The field 'status' has the following description: Status of the service. The service is polled only if this is set to 'on'.

Parameters:

status - the value of field 'status'.

setUserDefined

public void setUserDefined(String userDefined)

Sets the value of field 'userDefined'. The field 'userDefined' has the following description: Specifies if the service is user defined. Used specifically for UI purposes.

Parameters:

userDefined - the value of field 'userDefined'.

unmarshal

public static Service unmarshal(Reader reader)
                         throws org.exolab.castor.xml.MarshalException,
                                org.exolab.castor.xml.ValidationException

Method unmarshal.

Parameters:

reader -

Returns:

the unmarshaled org.opennms.netmgt.config.poller.Service

Throws:

org.exolab.castor.xml.MarshalException - if object is null or if any SAXException is thrown during marshaling

org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema

validate

public void validate()
              throws org.exolab.castor.xml.ValidationException

Throws:

org.exolab.castor.xml.ValidationException - if this object is an invalid instance according to the schema