Package VASSAL.build

Class AbstractBuildable

java.lang.Object

VASSAL.build.AbstractBuildable

All Implemented Interfaces:

Buildable, PropertyNameSource, ValidityChecker

Direct Known Subclasses:

AbstractConfigurable, BoardPicker, BrowserHelpFile, ChatServerControls, ConnectionWindow, EventLog, MapCenterer, ModuleExtension, PieceMover, Scroller

public abstract class AbstractBuildable
extends Object
implements Buildable, ValidityChecker, PropertyNameSource

Abstract implementation of the Buildable interface To make a Buildable component, extend this class. You'll need to implement the methods and specify the Buildable attributes of this class, and the build process is handled automatically.

Field Summary

Fields

Modifier and Type	Field	Description
protected List<Buildable>	buildComponents
protected ValidityChecker	validator

Constructor Summary

Constructors

Constructor	Description
AbstractBuildable()

Method Summary

Modifier and Type	Method	Description
void	add(Buildable b)	Add a Buildable object to this object
void	build(Element e)	Build this component by getting all XML attributes of the XML element and calling setAttribute(java.lang.String, java.lang.Object) with the String value of the attribute
<T> Enumeration<T>	getAllDescendantComponents(Class<T> target)	Deprecated, for removal: This API element is subject to removal in a future version. Use getAllDescendantComponentsOf(Class) instead.
<T> List<T>	getAllDescendantComponentsOf(Class<T> target)	Recursively descend the build tree and return a List of all components that are instances of the given class
abstract String[]	getAttributeNames()
abstract String	getAttributeValueString(String key)	Return a String representation of the attribute with the given name.
List<Buildable>	getBuildables()	Returns a Collection of Buildable objects which are the direct children of this object in the Buildable containment hierarchy.
Enumeration<Buildable>	getBuildComponents()	Deprecated, for removal: This API element is subject to removal in a future version. Use getBuildables() instead.
Element	getBuildElement(Document doc)
<T> Enumeration<T>	getComponents(Class<T> target)	Deprecated, for removal: This API element is subject to removal in a future version. Use getComponentsOf(Class) instead.
<T> List<T>	getComponentsOf(Class<T> target)
List<String>	getPropertyNames()	Default implementation of PropertyNameSource - No properties exposed
abstract void	setAttribute(String key, Object value)	Sets an attribute value for this component.
void	validate(Buildable target, ValidationReport report)

Methods inherited from class java.lang.Object

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

Methods inherited from interface VASSAL.build.Buildable

addTo

Field Details

buildComponents

protected List<Buildable> buildComponents

validator

protected ValidityChecker validator

Constructor Details

AbstractBuildable

public AbstractBuildable()

Method Details

build

public void build(Element e)

Build this component by getting all XML attributes of the XML element and calling setAttribute(java.lang.String, java.lang.Object) with the String value of the attribute

Specified by:

build in interface Buildable

Parameters:

e - the XML element containing the object data

getAttributeNames

public abstract String[] getAttributeNames()

Returns:

a list of all attribute names for this component

setAttribute

public abstract void setAttribute(String key, Object value)

Sets an attribute value for this component. The key parameter will be one of those listed in getAttributeNames(). If the value parameter is a String, it will be the value returned by getAttributeValueString(java.lang.String) for the same key. If the implementing class extends AbstractConfigurable, then value will be an instance of the corresponding Class listed in AbstractConfigurable.getAttributeTypes()

Parameters:

key - the name of the attribute. Will be one of those listed in getAttributeNames()

getAttributeValueString

public abstract String getAttributeValueString(String key)

Return a String representation of the attribute with the given name. When initializing a module, this String value will be passed to setAttribute(java.lang.String, java.lang.Object).

Parameters:

key - the name of the attribute. Will be one of those listed in getAttributeNames()

getComponents

@Deprecated(since="2020-08-06", forRemoval=true) public <T> Enumeration<T> getComponents(Class<T> target)

Deprecated, for removal: This API element is subject to removal in a future version.

Use getComponentsOf(Class) instead.

Returns:

all build components that are an instance of the given class

getComponentsOf

public <T> List<T> getComponentsOf(Class<T> target)

Returns:

all build components that are an instance of the given class

getAllDescendantComponents

@Deprecated(since="2020-08-06", forRemoval=true) public <T> Enumeration<T> getAllDescendantComponents(Class<T> target)

Deprecated, for removal: This API element is subject to removal in a future version.

Use getAllDescendantComponentsOf(Class) instead.

Recursively descend the build tree and return an enumeration of all components that are instances of the given class

Parameters:

target - Target class

Returns:

Results

getAllDescendantComponentsOf

public <T> List<T> getAllDescendantComponentsOf(Class<T> target)

Recursively descend the build tree and return a List of all components that are instances of the given class

Parameters:

target - Target class

Returns:

Results

getBuildElement

public Element getBuildElement(Document doc)

Specified by:

getBuildElement in interface Buildable

Returns:

an XML element from which this component can be built

add

public void add(Buildable b)

Add a Buildable object to this object

Specified by:

add in interface Buildable

getBuildComponents

@Deprecated(since="2020-08-06", forRemoval=true) public Enumeration<Buildable> getBuildComponents()

Deprecated, for removal: This API element is subject to removal in a future version.

Use getBuildables() instead.

Returns an enumeration of Buildable objects which are the direct children of this object in the Buildable containment hierarchy. The getBuildElement(org.w3c.dom.Document) method uses these objects to construct the XML element from which this object can be built.

getBuildables

public List<Buildable> getBuildables()

Returns a Collection of Buildable objects which are the direct children of this object in the Buildable containment hierarchy. The getBuildElement(org.w3c.dom.Document) method uses these objects to construct the XML element from which this object can be built.

validate

public void validate(Buildable target, ValidationReport report)

Specified by:

validate in interface ValidityChecker

getPropertyNames

public List<String> getPropertyNames()

Default implementation of PropertyNameSource - No properties exposed

Specified by:

getPropertyNames in interface PropertyNameSource