net.sourceforge.pmd

Class AbstractPropertySource

java.lang.Object

net.sourceforge.pmd.AbstractPropertySource

All Implemented Interfaces:

PropertySource

Direct Known Subclasses:

AbstractRenderer, AbstractRule

public abstract class AbstractPropertySource
extends Object
implements PropertySource

Base class for objects which can be configured through properties. Rules and Reports are such objects.

Author:

Brian Remedios

Field Summary

Fields

Modifier and Type	Field and Description
protected List<PropertyDescriptor<?>>	propertyDescriptors The list of known properties that can be configured.
protected Map<PropertyDescriptor<?>,Object>	propertyValuesByDescriptor The values for each property.

Constructor Summary

Constructors

Constructor and Description
AbstractPropertySource()

Method Summary

Methods

Modifier and Type	Method and Description
protected List<PropertyDescriptor<?>>	copyPropertyDescriptors() Creates a copied list of the property descriptors and returns it.
protected Map<PropertyDescriptor<?>,Object>	copyPropertyValues() Creates a copied map of the values of the properties and returns it.
void	definePropertyDescriptor(PropertyDescriptor<?> propertyDescriptor) Define a new property via a PropertyDescriptor.
String	dysfunctionReason() Returns a description of why the receiver may be dysfunctional.
abstract String	getName() Gets the name of the property source.
Map<PropertyDescriptor<?>,Object>	getPropertiesByPropertyDescriptor() Returns all the current property values for the receiver or an immutable empty map if none are specified.
<T> T	getProperty(PropertyDescriptor<T> propertyDescriptor) Get the typed value for the given property.
PropertyDescriptor<?>	getPropertyDescriptor(String name) Get the PropertyDescriptor for the given property name.
List<PropertyDescriptor<?>>	getPropertyDescriptors() Get the PropertyDescriptors for all defined properties.
boolean	hasDescriptor(PropertyDescriptor<?> descriptor) Returns whether this Rule has the specified PropertyDescriptor.
Set<PropertyDescriptor<?>>	ignoredProperties() Return the properties that are effectively ignored due to the configuration of the rule and values held by other properties.
<T> void	setProperty(PropertyDescriptor<T> propertyDescriptor, T value) Set the property value specified (will be type-checked)
void	useDefaultValueFor(PropertyDescriptor<?> desc) Clears out any user-specified value for the property allowing it to use the default value in the descriptor.
boolean	usesDefaultValues() Returns whether this Rule uses default values for properties.

Methods inherited from class java.lang.Object

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

Field Detail

propertyDescriptors

protected List<PropertyDescriptor<?>> propertyDescriptors

The list of known properties that can be configured.

propertyValuesByDescriptor

protected Map<PropertyDescriptor<?>,Object> propertyValuesByDescriptor

The values for each property.

Constructor Detail

AbstractPropertySource

public AbstractPropertySource()

Method Detail

copyPropertyDescriptors

protected List<PropertyDescriptor<?>> copyPropertyDescriptors()

Creates a copied list of the property descriptors and returns it.

Returns:

a copy of the property descriptors.

copyPropertyValues

protected Map<PropertyDescriptor<?>,Object> copyPropertyValues()

Creates a copied map of the values of the properties and returns it.

Returns:

a copy of the values

ignoredProperties

public Set<PropertyDescriptor<?>> ignoredProperties()

Return the properties that are effectively ignored due to the configuration of the rule and values held by other properties. This can be used to disable corresponding widgets in a UI.

Specified by:

ignoredProperties in interface PropertySource

Returns:

the properties that are ignored

definePropertyDescriptor

public void definePropertyDescriptor(PropertyDescriptor<?> propertyDescriptor)

Define a new property via a PropertyDescriptor.

Specified by:

definePropertyDescriptor in interface PropertySource

Parameters:

propertyDescriptor - The property descriptor.

getName

public abstract String getName()

Gets the name of the property source. This is e.g. the rule name or the report name.

Returns:

the name

getPropertyDescriptor

public PropertyDescriptor<?> getPropertyDescriptor(String name)

Get the PropertyDescriptor for the given property name.

Specified by:

getPropertyDescriptor in interface PropertySource

Parameters:

name - The name of the property.

Returns:

The PropertyDescriptor for the named property, null if there is no such property defined.

hasDescriptor

public boolean hasDescriptor(PropertyDescriptor<?> descriptor)

Returns whether this Rule has the specified PropertyDescriptor.

Specified by:

hasDescriptor in interface PropertySource

Parameters:

descriptor - The PropertyDescriptor for which to check.

Returns:

boolean true if the descriptor is present, false otherwise.

getPropertyDescriptors

public List<PropertyDescriptor<?>> getPropertyDescriptors()

Get the PropertyDescriptors for all defined properties. The properties are returned sorted by UI order.

Specified by:

getPropertyDescriptors in interface PropertySource

Returns:

The PropertyDescriptors in UI order.

getProperty

public <T> T getProperty(PropertyDescriptor<T> propertyDescriptor)

Get the typed value for the given property.

Specified by:

getProperty in interface PropertySource

Type Parameters:

T - The underlying type of the property descriptor.

Parameters:

propertyDescriptor - The property descriptor.

Returns:

The property value.

setProperty

public <T> void setProperty(PropertyDescriptor<T> propertyDescriptor,
                   T value)

Set the property value specified (will be type-checked)

Specified by:

setProperty in interface PropertySource

Type Parameters:

T - The underlying type of the property descriptor.

Parameters:

propertyDescriptor - The property descriptor.

value - The value to set.

getPropertiesByPropertyDescriptor

public Map<PropertyDescriptor<?>,Object> getPropertiesByPropertyDescriptor()

Returns all the current property values for the receiver or an immutable empty map if none are specified.

Specified by:

getPropertiesByPropertyDescriptor in interface PropertySource

Returns:

all current property values or a empty map.

usesDefaultValues

public boolean usesDefaultValues()

Returns whether this Rule uses default values for properties.

Specified by:

usesDefaultValues in interface PropertySource

Returns:

boolean true if the properties all have default values, false otherwise.

useDefaultValueFor

public void useDefaultValueFor(PropertyDescriptor<?> desc)

Clears out any user-specified value for the property allowing it to use the default value in the descriptor.

Specified by:

useDefaultValueFor in interface PropertySource

Parameters:

desc - the property to clear out

dysfunctionReason

public String dysfunctionReason()

Returns a description of why the receiver may be dysfunctional. Usually due to missing property values or some kind of conflict between values. Returns null if the receiver is ok.

Specified by:

dysfunctionReason in interface PropertySource

Returns:

String