Package net.sourceforge.pmd.properties

Class MethodMultiProperty

java.lang.Object

net.sourceforge.pmd.properties.MethodMultiProperty

All Implemented Interfaces:

Comparable<PropertyDescriptor<?>>, MultiValuePropertyDescriptor<Method>, PackagedPropertyDescriptor<List<Method>>, PropertyDescriptor<List<Method>>

@Deprecated
public final class MethodMultiProperty
extends Object

Deprecated.

Will be removed with 7.0.0 with no scheduled replacement

Defines a property type that can specify multiple methods to use as part of a rule. Rule developers can limit the rules to those within designated packages per the 'legalPackages' argument in the constructor which can be an array of partial package names, i.e., ["java.lang", "com.mycompany" ].

Version:

Refactored June 2017 (6.0.0)

Author:

Brian Remedios

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	MethodMultiProperty.MethodMultiPBuilder	Deprecated.

Field Summary

Fields

Modifier and Type	Field	Description
protected PackagedPropertyModule<T>	module	Deprecated.

Fields inherited from interface net.sourceforge.pmd.properties.MultiValuePropertyDescriptor

DEFAULT_DELIMITER, DEFAULT_NUMERIC_DELIMITER

Fields inherited from interface net.sourceforge.pmd.properties.PackagedPropertyDescriptor

MULTI_VALUE_DELIMITER, PACKAGE_NAME_DELIMITER

Constructor Summary

Constructors

Constructor	Description
MethodMultiProperty(String theName, String theDescription, Method[] theDefaults, String[] legalPackageNames, float theUIOrder)	Deprecated. Constructor for MethodMultiProperty using an array of defaults.
MethodMultiProperty(String theName, String theDescription, String methodDefaults, String[] legalPackageNames, float theUIOrder)	Deprecated. will be removed in 7.O.O
MethodMultiProperty(String theName, String theDescription, List<Method> theDefaults, String[] legalPackageNames, float theUIOrder)	Deprecated. Constructor for MethodProperty using a list of defaults.

Method Summary

Modifier and Type	Method	Description
protected void	addAttributesTo(Map<PropertyDescriptorField,String> attributes)	Deprecated. Adds this property's attributes to the map.
String	asDelimitedString(List<V> values)	Deprecated. Formats the object onto a string suitable for storage within the property map.
String	asString(Method value)	Deprecated. Returns a string representation of the value, even if it's null.
Map<PropertyDescriptorField,String>	attributeValuesById()	Returns a map representing all the property attributes of the receiver in string form.
int	compareTo(PropertyDescriptor<?> otherProperty)
protected Method	createFrom(String toParse)	Deprecated. Parse a string and returns an instance of a single value (not a list).
protected String	defaultAsString()	Deprecated. Returns a string representation of the default value.
List<V>	defaultValue()	Deprecated. Default value to use when the user hasn't specified one or when they wish to revert to a known-good state.
String	description()	Describes the property and the role it plays within the rule it is specified for.
boolean	equals(Object obj)
String	errorFor(List<V> values)	Deprecated. Validation function that returns a diagnostic error message for a sample property value.
int	hashCode()
boolean	isDefinedExternally()	True if this descriptor was defined in the ruleset xml.
boolean	isMultiValue()	Deprecated. Returns whether the property is multi-valued, i.e.
String[]	legalPackageNames()	Deprecated. Returns the legal package names.
char	multiValueDelimiter()	Deprecated. Return the character being used to delimit multiple property values within a single string.
String	name()	The name of the property without spaces as it serves as the key into the property map.
static MethodMultiProperty.MethodMultiPBuilder	named(String name)	Deprecated.
protected String[]	packageNamesIn(Map<PropertyDescriptorField,String> params)	Deprecated.
int	preferredRowCount()	If the datatype is a String then return the preferred number of rows to allocate in the text widget, returns a value of one for all other types.
String	propertyErrorFor(Rule rule)	Deprecated. A convenience method that returns an error string if the rule holds onto a property value that has a problem.
String	toString()
Class<Method>	type()	Deprecated. Denotes the value datatype.
float	uiOrder()	Denotes the relative order the property field should occupy if we are using an auto-generated UI to display and edit property values.
protected String	valueErrorFor(T value)	Deprecated. Checks a single value for a "missing value" error.
List<Method>	valueFrom(String valueString)	Deprecated. Returns the value represented by this string.

Methods inherited from class java.lang.Object

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

Methods inherited from interface net.sourceforge.pmd.properties.PropertyDescriptor

asDelimitedString, attributeValuesById, compareTo, defaultValue, description, errorFor, isDefinedExternally, isMultiValue, name, preferredRowCount, propertyErrorFor, uiOrder

Field Detail

module

protected final PackagedPropertyModule<T> module

Deprecated.

Constructor Detail

MethodMultiProperty

public MethodMultiProperty(String theName,
                           String theDescription,
                           Method[] theDefaults,
                           String[] legalPackageNames,
                           float theUIOrder)

Deprecated.

Constructor for MethodMultiProperty using an array of defaults.

Parameters:

theName - String

theDescription - String

theDefaults - Method[]

legalPackageNames - String[]

theUIOrder - float

MethodMultiProperty

public MethodMultiProperty(String theName,
                           String theDescription,
                           List<Method> theDefaults,
                           String[] legalPackageNames,
                           float theUIOrder)

Deprecated.

Constructor for MethodProperty using a list of defaults.

Parameters:

theName - String

theDescription - String

theDefaults - Method[]

legalPackageNames - String[]

theUIOrder - float

Throws:

IllegalArgumentException

MethodMultiProperty

public MethodMultiProperty(String theName,
                           String theDescription,
                           String methodDefaults,
                           String[] legalPackageNames,
                           float theUIOrder)

Deprecated.

will be removed in 7.O.O

Constructor for MethodProperty.

Parameters:

theName - String

theDescription - String

methodDefaults - String

legalPackageNames - String[]

theUIOrder - float

Throws:

IllegalArgumentException

Method Detail

asString

public String asString(Method value)

Deprecated.

Returns a string representation of the value, even if it's null.

Parameters:

value - The value to describe

Returns:

A string representation of the value

createFrom

protected Method createFrom(String toParse)

Deprecated.

Parse a string and returns an instance of a single value (not a list).

Parameters:

toParse - String to parse

Returns:

An instance of a value

type

public Class<Method> type()

Deprecated.

Description copied from interface: PropertyDescriptor

Denotes the value datatype. For multi value properties, this is not the List class but the list's component class.

Returns:

Class literal of the value type

valueFrom

public List<Method> valueFrom(String valueString)
                       throws IllegalArgumentException

Deprecated.

Description copied from interface: PropertyDescriptor

Returns the value represented by this string.

Specified by:

valueFrom in interface PropertyDescriptor<List<Method>>

Parameters:

valueString - The string to parse

Returns:

The value represented by the string

Throws:

IllegalArgumentException - if the given string cannot be parsed

named

public static MethodMultiProperty.MethodMultiPBuilder named(String name)

Deprecated.

addAttributesTo

protected void addAttributesTo(Map<PropertyDescriptorField,String> attributes)

Deprecated.

Adds this property's attributes to the map. Subclasses can override this to add more PropertyDescriptorField.

Parameters:

attributes - The map to fill

valueErrorFor

protected String valueErrorFor(T value)

Deprecated.

Checks a single value for a "missing value" error.

Parameters:

value - Value to check

Returns:

A descriptive String of the error or null if there was none

legalPackageNames

public String[] legalPackageNames()

Deprecated.

Description copied from interface: PackagedPropertyDescriptor

Returns the legal package names.

Specified by:

legalPackageNames in interface PackagedPropertyDescriptor<T>

Returns:

The legal package names

packageNamesIn

protected String[] packageNamesIn(Map<PropertyDescriptorField,String> params)

Deprecated.

isMultiValue

public final boolean isMultiValue()

Deprecated.

Description copied from interface: PropertyDescriptor

Returns whether the property is multi-valued, i.e. an array of strings,

As unary property rule properties will return a value of one, you must use the get/setProperty accessors when working with the actual values. When working with multi-value properties then the get/setProperties accessors must be used.

Specified by:

isMultiValue in interface PropertyDescriptor<V>

Returns:

boolean

propertyErrorFor

public String propertyErrorFor(Rule rule)

Deprecated.

Description copied from interface: PropertyDescriptor

A convenience method that returns an error string if the rule holds onto a property value that has a problem. Returns null otherwise.

Specified by:

propertyErrorFor in interface PropertyDescriptor<V>

Parameters:

rule - Rule

Returns:

String

errorFor

public String errorFor(List<V> values)

Deprecated.

Description copied from interface: PropertyDescriptor

Validation function that returns a diagnostic error message for a sample property value. Returns null if the value is acceptable.

Specified by:

errorFor in interface PropertyDescriptor<V>

Parameters:

values - The value to check.

Returns:

A diagnostic message.

defaultAsString

protected String defaultAsString()

Deprecated.

Returns a string representation of the default value.

Returns:

A string representation of the default value.

defaultValue

public List<V> defaultValue()

Deprecated.

Description copied from interface: PropertyDescriptor

Default value to use when the user hasn't specified one or when they wish to revert to a known-good state.

Specified by:

defaultValue in interface PropertyDescriptor<V>

Returns:

Object

multiValueDelimiter

public char multiValueDelimiter()

Deprecated.

Description copied from interface: MultiValuePropertyDescriptor

Return the character being used to delimit multiple property values within a single string. You must ensure that this character does not appear within any rule property values to avoid deserialization errors.

Specified by:

multiValueDelimiter in interface MultiValuePropertyDescriptor<V>

Returns:

char

asDelimitedString

public final String asDelimitedString(List<V> values)

Deprecated.

Description copied from interface: PropertyDescriptor

Formats the object onto a string suitable for storage within the property map.

Specified by:

asDelimitedString in interface PropertyDescriptor<V>

Parameters:

values - Object

Returns:

String

description

public String description()

Description copied from interface: PropertyDescriptor

Describes the property and the role it plays within the rule it is specified for. Could be used in a tooltip.

Specified by:

description in interface PropertyDescriptor<T>

Returns:

String

uiOrder

public float uiOrder()

Description copied from interface: PropertyDescriptor

Denotes the relative order the property field should occupy if we are using an auto-generated UI to display and edit property values. If the value returned has a non-zero fractional part then this is can be used to place adjacent fields on the same row.

Specified by:

uiOrder in interface PropertyDescriptor<T>

Returns:

The relative order compared to other properties of the same rule

compareTo

public final int compareTo(PropertyDescriptor<?> otherProperty)

Specified by:

compareTo in interface Comparable<T>

Specified by:

compareTo in interface PropertyDescriptor<T>

preferredRowCount

public int preferredRowCount()

Description copied from interface: PropertyDescriptor

If the datatype is a String then return the preferred number of rows to allocate in the text widget, returns a value of one for all other types. Useful for multi-line XPATH editors.

Specified by:

preferredRowCount in interface PropertyDescriptor<T>

Returns:

int

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

name

public String name()

Description copied from interface: PropertyDescriptor

The name of the property without spaces as it serves as the key into the property map.

Specified by:

name in interface PropertyDescriptor<T>

Returns:

String

attributeValuesById

public final Map<PropertyDescriptorField,String> attributeValuesById()

Description copied from interface: PropertyDescriptor

Returns a map representing all the property attributes of the receiver in string form.

Specified by:

attributeValuesById in interface PropertyDescriptor<T>

Returns:

map

isDefinedExternally

public boolean isDefinedExternally()

Description copied from interface: PropertyDescriptor

True if this descriptor was defined in the ruleset xml. This precision is necessary for the RuleSetWriter to write out the property correctly: if it was defined externally, then its definition must be written out, otherwise only its value.

Specified by:

isDefinedExternally in interface PropertyDescriptor<T>

Returns:

True if the descriptor was defined in xml