CharacterMultiProperty (PMD Core 6.4.0 API)

java.lang.Object
- net.sourceforge.pmd.properties.CharacterMultiProperty

All Implemented Interfaces:

java.lang.Comparable<PropertyDescriptor<?>>, MultiValuePropertyDescriptor<java.lang.Character>, PropertyDescriptor<java.util.List<java.lang.Character>>
```
public final class CharacterMultiProperty
extends java.lang.Object
```
Multi-valued character property.

Version:

Refactored June 2017 (6.0.0)

Author:

Brian Remedios

Nested Class Summary

Nested Classes
Modifier and Type Class Description

static class CharacterMultiProperty.CharacterMultiPBuilder

Nested Classes
Modifier and Type	Class	Description
`static class`	`CharacterMultiProperty.CharacterMultiPBuilder`

Field Summary
- Fields inherited from interface net.sourceforge.pmd.properties.MultiValuePropertyDescriptor
  DEFAULT_DELIMITER, DEFAULT_NUMERIC_DELIMITER

Constructor Summary

Constructors
Constructor	Description
`CharacterMultiProperty(java.lang.String theName, java.lang.String theDescription, java.lang.Character[] defaultValues, float theUIOrder, char delimiter)`	Constructor using an array of defaults.
`CharacterMultiProperty(java.lang.String theName, java.lang.String theDescription, java.util.List<java.lang.Character> defaultValues, float theUIOrder, char delimiter)`	Constructor using a list of defaults.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`protected void`	`addAttributesTo(java.util.Map<PropertyDescriptorField,java.lang.String> attributes)`	Adds this property's attributes to the map.
`java.lang.String`	`asDelimitedString(java.util.List<V> values)`	Formats the object onto a string suitable for storage within the property map.
`protected java.lang.String`	`asString(V value)`	Returns a string representation of the value, even if it's null.
`java.util.Map<PropertyDescriptorField,java.lang.String>`	`attributeValuesById()`	Returns a map representing all the property attributes of the receiver in string form.
`int`	`compareTo(PropertyDescriptor<?> otherProperty)`
`protected java.lang.Character`	`createFrom(java.lang.String toParse)`	Parse a string and returns an instance of a single value (not a list).
`protected java.lang.String`	`defaultAsString()`	Returns a string representation of the default value.
`java.util.List<V>`	`defaultValue()`	Default value to use when the user hasn't specified one or when they wish to revert to a known-good state.
`java.lang.String`	`description()`	Describes the property and the role it plays within the rule it is specified for.
`boolean`	`equals(java.lang.Object obj)`
`java.lang.String`	`errorFor(java.util.List<V> values)`	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()`	Returns whether the property is multi-valued, i.e.
`char`	`multiValueDelimiter()`	Return the character being used to delimit multiple property values within a single string.
`java.lang.String`	`name()`	The name of the property without spaces as it serves as the key into the property map.
`static CharacterMultiProperty.CharacterMultiPBuilder`	`named(java.lang.String name)`
`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.
`java.lang.String`	`propertyErrorFor(Rule rule)`	A convenience method that returns an error string if the rule holds onto a property value that has a problem.
`java.lang.String`	`toString()`
`java.lang.Class<java.lang.Character>`	`type()`	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 java.lang.String`	`valueErrorFor(V value)`	Checks a single value for a "missing value" error.
`java.util.List<java.lang.Character>`	`valueFrom(java.lang.String valueString)`	Returns the value represented by this string.

Methods inherited from interface java.lang.Comparable
compareTo

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.sourceforge.pmd.properties.PropertyDescriptor
attributeValuesById, description, isDefinedExternally, name, preferredRowCount, uiOrder

- Constructor Detail
  - CharacterMultiProperty
```
public CharacterMultiProperty(java.lang.String theName,
                              java.lang.String theDescription,
                              java.lang.Character[] defaultValues,
                              float theUIOrder,
                              char delimiter)
```
    Constructor using an array of defaults.
    
    Parameters:
    
    theName - Name
    
    theDescription - Description
    
    defaultValues - Array of defaults
    
    theUIOrder - UI order
    
    delimiter - The delimiter to use
    
    Throws:
    
    java.lang.IllegalArgumentException - if the delimiter is in the default values
  - CharacterMultiProperty
```
public CharacterMultiProperty(java.lang.String theName,
                              java.lang.String theDescription,
                              java.util.List<java.lang.Character> defaultValues,
                              float theUIOrder,
                              char delimiter)
```
    Constructor using a list of defaults.
    
    Parameters:
    
    theName - Name
    
    theDescription - Description
    
    defaultValues - List of defaults
    
    theUIOrder - UI order
    
    delimiter - The delimiter to use
    
    Throws:
    
    java.lang.IllegalArgumentException - if the delimiter is in the default values
- Method Detail
  - createFrom
```
protected java.lang.Character createFrom(java.lang.String toParse)
```
    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 java.lang.Class<java.lang.Character> type()
```
    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 java.util.List<java.lang.Character> valueFrom(java.lang.String valueString)
                                              throws java.lang.IllegalArgumentException
```
    Description copied from interface: PropertyDescriptor
    
    Returns the value represented by this string.
    
    Specified by:
    
    valueFrom in interface PropertyDescriptor<java.util.List<java.lang.Character>>
    
    Parameters:
    
    valueString - The string to parse
    
    Returns:
    
    The value represented by the string
    
    Throws:
    
    java.lang.IllegalArgumentException - if the given string cannot be parsed
  - named
```
public static CharacterMultiProperty.CharacterMultiPBuilder named(java.lang.String name)
```
  - isMultiValue
```
public final boolean isMultiValue()
```
    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 java.lang.String propertyErrorFor(Rule rule)
```
    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 java.lang.String errorFor(java.util.List<V> values)
```
    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.
  - valueErrorFor
```
protected java.lang.String valueErrorFor(V value)
```
    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
  - defaultAsString
```
protected java.lang.String defaultAsString()
```
    Returns a string representation of the default value.
    
    Returns:
    
    A string representation of the default value.
  - defaultValue
```
public java.util.List<V> defaultValue()
```
    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()
```
    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
  - asString
```
protected java.lang.String asString(V value)
```
    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
  - asDelimitedString
```
public final java.lang.String asDelimitedString(java.util.List<V> values)
```
    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
  - addAttributesTo
```
protected void addAttributesTo(java.util.Map<PropertyDescriptorField,java.lang.String> attributes)
```
    Adds this property's attributes to the map. Subclasses can override this to add more PropertyDescriptorField.
    
    Parameters:
    
    attributes - The map to fill
  - description
```
public java.lang.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.
    Example:
    name -> 0.0 description 1.0 minValue -> 2.0 maxValue -> 2.1
    ..would have their fields placed like:
    name: [ ] description: [ ] minimum: [ ] maximum: [ ]
    
    Specified by:
    
    uiOrder in interface PropertyDescriptor<T>
    
    Returns:
    
    float
  - compareTo
```
public final int compareTo(PropertyDescriptor<?> otherProperty)
```
    Specified by:
    
    compareTo in interface java.lang.Comparable<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(java.lang.Object obj)
```
    Overrides:
    
    equals in class java.lang.Object
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - name
```
public java.lang.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 java.util.Map<PropertyDescriptorField,java.lang.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

Class CharacterMultiProperty

Nested Class Summary

Field Summary

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

Constructor Summary

Method Summary

Methods inherited from interface java.lang.Comparable

Methods inherited from class java.lang.Object

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

Constructor Detail

CharacterMultiProperty

CharacterMultiProperty

Method Detail

createFrom

type

valueFrom

named

isMultiValue

propertyErrorFor

errorFor

valueErrorFor

defaultAsString

defaultValue

multiValueDelimiter

asString

asDelimitedString

addAttributesTo

description

uiOrder

compareTo

preferredRowCount

equals

hashCode

toString

name

attributeValuesById

isDefinedExternally