org.jboss.dna.common.component
Class ComponentConfig

java.lang.Object
  org.jboss.dna.common.component.ComponentConfig

All Implemented Interfaces:

java.lang.Comparable<ComponentConfig>

Direct Known Subclasses:

RuleSet, SequencerConfig

@Immutable
public class ComponentConfig
extends java.lang.Object
implements java.lang.Comparable<ComponentConfig>

Author:

Randall Hauch

Constructor Summary

ComponentConfig(java.lang.String name, java.lang.String description, long timestamp, java.lang.String classname, java.lang.String... classpath)
Create a component configuration.

ComponentConfig(java.lang.String name, java.lang.String description, java.lang.String classname, java.lang.String... classpath)
Create a component configuration.

Method Summary

int	compareTo(ComponentConfig that)
boolean	equals(java.lang.Object obj)
java.lang.String	getComponentClassname() Get the fully-qualified name of the Java class used for instances of this component
java.util.List<java.lang.String>	getComponentClasspath() Get the classpath defined in terms of strings compatible with a ClassLoaderFactory.
java.lang.String[]	getComponentClasspathArray() Get the classpath defined as an array of strings compatible with a ClassLoaderFactory.
java.lang.String	getDescription() Get the description for this component
java.lang.String	getName() Get the name of this component.
long	getTimestamp() Get the system timestamp when this configuration object was created.
boolean	hasChanged(ComponentConfig component) Determine whether this component has changed with respect to the supplied component.
int	hashCode()

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ComponentConfig

public ComponentConfig(java.lang.String name,
                       java.lang.String description,
                       java.lang.String classname,
                       java.lang.String... classpath)

Create a component configuration.

Parameters:

name - the name of the configuration, which is considered to be a unique identifier

description - the description

classname - the name of the Java class used for the component

classpath - the optional classpath (defined in a way compatible with a ClassLoaderFactory

Throws:

java.lang.IllegalArgumentException - if the name is null, empty or blank, or if the classname is null, empty or not a valid Java classname

ComponentConfig

public ComponentConfig(java.lang.String name,
                       java.lang.String description,
                       long timestamp,
                       java.lang.String classname,
                       java.lang.String... classpath)

Create a component configuration.

Parameters:

name - the name of the configuration, which is considered to be a unique identifier

description - the description

timestamp - the timestamp that this component was last changed

classname - the name of the Java class used for the component

classpath - the optional classpath (defined in a way compatible with a ClassLoaderFactory

Throws:

java.lang.IllegalArgumentException - if the name is null, empty or blank, or if the classname is null, empty or not a valid Java classname

Method Detail

getName

public java.lang.String getName()

Get the name of this component.

Returns:

the component name; never null, empty or blank

getDescription

public java.lang.String getDescription()

Get the description for this component

Returns:

the description

getComponentClassname

public java.lang.String getComponentClassname()

Get the fully-qualified name of the Java class used for instances of this component

Returns:

the Java class name of this component; never null or empty and always a valid Java class name

getComponentClasspath

public java.util.List<java.lang.String> getComponentClasspath()

Get the classpath defined in terms of strings compatible with a ClassLoaderFactory.

Returns:

the classpath; never null but possibly empty

getComponentClasspathArray

public java.lang.String[] getComponentClasspathArray()

Get the classpath defined as an array of strings compatible with a ClassLoaderFactory.

Returns:

the classpath as an array; never null but possibly empty

getTimestamp

public long getTimestamp()

Get the system timestamp when this configuration object was created.

Returns:

the timestamp

compareTo

public int compareTo(ComponentConfig that)

Specified by:

compareTo in interface java.lang.Comparable<ComponentConfig>

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

hasChanged

public boolean hasChanged(ComponentConfig component)

Determine whether this component has changed with respect to the supplied component. This method basically checks all attributes, whereas equals only checks the type and getName().

Parameters:

component - the component to be compared with this one

Returns:

true if this componet and the supplied component have some changes, or false if they are exactly equivalent

Throws:

java.lang.IllegalArgumentException - if the supplied component reference is null or is not the same type as this object