org.opennms.netmgt.config.datacollection
Class Collect

java.lang.Object
  org.opennms.netmgt.config.datacollection.Collect

All Implemented Interfaces:

Serializable

public class Collect
extends Object
implements Serializable

container for list of MIB groups to be collected for the system

See Also:

Serialized Form

Constructor Summary

Collect()

Method Summary

void	addIncludeGroup(int index, String vIncludeGroup)
void	addIncludeGroup(String includeGroup)
Enumeration<String>	enumerateIncludeGroup() Method enumerateIncludeGroup.
boolean	equals(Object obj) Overrides the Object.equals method.
String[]	getIncludeGroup() Method getIncludeGroup.Returns the contents of the collection in an Array.
String	getIncludeGroup(int index) Method getIncludeGroup.
List<String>	getIncludeGroupCollection() Method getIncludeGroupCollection.Returns a reference to '_includeGroupList'.
int	getIncludeGroupCount() Method getIncludeGroupCount.
int	hashCode() Overrides the Object.hashCode method.
boolean	isValid() Deprecated.
Iterator<String>	iterateIncludeGroup() Method iterateIncludeGroup.
void	marshal(ContentHandler handler) Deprecated.
void	marshal(Writer out) Deprecated.
void	removeAllIncludeGroup()
boolean	removeIncludeGroup(String includeGroup) Method removeIncludeGroup.
String	removeIncludeGroupAt(int index) Method removeIncludeGroupAt.
void	setIncludeGroup(int index, String includeGroup)
void	setIncludeGroup(List<String> includeGroups) Sets the value of '_includeGroupList' by copying the given Vector.
void	setIncludeGroup(String[] includeGroups)
void	setIncludeGroupCollection(List<String> includeGroups) Deprecated.
static Collect	unmarshal(Reader reader) Deprecated.
void	validate() Deprecated.

Methods inherited from class java.lang.Object

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

Constructor Detail

Collect

public Collect()

Method Detail

addIncludeGroup

public void addIncludeGroup(String includeGroup)
                     throws IndexOutOfBoundsException

Parameters:

includeGroup -

Throws:

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

addIncludeGroup

public void addIncludeGroup(int index,
                            String vIncludeGroup)
                     throws IndexOutOfBoundsException

Parameters:

index -

vIncludeGroup -

Throws:

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

enumerateIncludeGroup

public Enumeration<String> enumerateIncludeGroup()

Method enumerateIncludeGroup.

Returns:

an Enumeration over all possible elements of this collection

equals

public boolean equals(Object obj)

Overrides the Object.equals method.

Overrides:

equals in class Object

Parameters:

obj -

Returns:

true if the objects are equal.

getIncludeGroup

public String getIncludeGroup(int index)
                       throws IndexOutOfBoundsException

Method getIncludeGroup.

Parameters:

index -

Returns:

the value of the String at the given index

Throws:

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

getIncludeGroup

public String[] getIncludeGroup()

Method getIncludeGroup.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

getIncludeGroupCollection

public List<String> getIncludeGroupCollection()

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

Returns:

a reference to the Vector backing this class

getIncludeGroupCount

public int getIncludeGroupCount()

Method getIncludeGroupCount.

Returns:

the size of this collection

hashCode

public int hashCode()

Overrides the 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

@Deprecated
public boolean isValid()

Deprecated.

Method isValid.

Returns:

true if this object is valid according to the schema

iterateIncludeGroup

public Iterator<String> iterateIncludeGroup()

Method iterateIncludeGroup.

Returns:

an Iterator over all possible elements in this collection

marshal

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

Deprecated.

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

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

Deprecated.

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

removeAllIncludeGroup

public void removeAllIncludeGroup()

removeIncludeGroup

public boolean removeIncludeGroup(String includeGroup)

Method removeIncludeGroup.

Parameters:

includeGroup -

Returns:

true if the object was removed from the collection.

removeIncludeGroupAt

public String removeIncludeGroupAt(int index)

Method removeIncludeGroupAt.

Parameters:

index -

Returns:

the element removed from the collection

setIncludeGroup

public void setIncludeGroup(int index,
                            String includeGroup)
                     throws IndexOutOfBoundsException

Parameters:

index -

includeGroup -

Throws:

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

setIncludeGroup

public void setIncludeGroup(String[] includeGroups)

Parameters:

includeGroups -

setIncludeGroup

public void setIncludeGroup(List<String> includeGroups)

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

Parameters:

includeGroups - the Vector to copy.

setIncludeGroupCollection

public void setIncludeGroupCollection(List<String> includeGroups)

Deprecated.

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

Parameters:

includeGroups - the Vector to set.

unmarshal

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

Deprecated.

Method unmarshal.

Parameters:

reader -

Returns:

the unmarshaled org.opennms.netmgt.config.datacollection.Collect

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

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

Deprecated.

Throws:

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