org.xins.common.types.standard
Class Properties

java.lang.Object
  org.xins.common.types.Type
      org.xins.common.types.standard.Properties

public class Properties

extends Type

Standard type _properties.

Since:

XINS 1.0.0

Version:

$Revision: 1.17 $ $Date: 2006/10/24 09:31:14 $

Author:

Ernst de Haan

Field Summary

static Properties

SINGLETON The only instance of this class.

Constructor Summary

protected

Properties(String name, Type nameType, Type valueType) Constructs a new Properties object (constructor for subclasses).

Method Summary

static PropertyReader	fromStringForOptional(String string) Constructs a PropertyReader from the specified string.
static PropertyReader	fromStringForRequired(String string) Constructs a PropertyReader from the specified string which is guaranteed to be non-null.
protected Object	fromStringImpl(String string) Converts from a String to an instance of the value class for this type (implementation method).
protected boolean	isValidValueImpl(String string) Determines if the specified String value is considered valid for this type (implementation method).
String	toString(Object value) Generates a string representation of the specified value for this type.
static String	toString(PropertyReader value) Converts the specified PropertyReader to a string.

Methods inherited from class org.xins.common.types.Type

checkValue, fromString, getName, getValueClass, isValidValue, toString

Methods inherited from class java.lang.Object

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

Field Detail

SINGLETON

public static final Properties SINGLETON

The only instance of this class. This field is never null.

Constructor Detail

Properties

protected Properties(String name,
                     Type nameType,
                     Type valueType)

Constructs a new Properties object (constructor for subclasses).

Parameters:

name - the name of this type, cannot be null.

nameType - the type for property names, or null if Text should be assumed.

valueType - the type for property values, or null if Text should be assumed.

Method Detail

fromStringForRequired

public static PropertyReader fromStringForRequired(String string)
                                            throws IllegalArgumentException,
                                                   TypeValueException

Constructs a PropertyReader from the specified string which is guaranteed to be non-null.

Parameters:

string - the string to convert, cannot be null.

Returns:

the PropertyReader object, never null.

Throws:

IllegalArgumentException - if string == null.

TypeValueException - if the specified string does not represent a valid value for this type.

fromStringForOptional

public static PropertyReader fromStringForOptional(String string)
                                            throws TypeValueException

Constructs a PropertyReader from the specified string.

Parameters:

string - the string to convert, can be null.

Returns:

the PropertyReader, or null if string == null.

Throws:

TypeValueException - if the specified string does not represent a valid value for this type.

toString

public static String toString(PropertyReader value)

Converts the specified PropertyReader to a string.

Parameters:

value - the value to convert, can be null.

Returns:

the textual representation of the value, or null if and only if value == null.

isValidValueImpl

protected final boolean isValidValueImpl(String string)

Description copied from class: Type

Determines if the specified String value is considered valid for this type (implementation method).

This method is called from Type.isValidValue(String). When called from that method, it is guaranteed that the argument is not null.

The implementation of this method in class Type returns true.

Overrides:

isValidValueImpl in class Type

Parameters:

string - the String value that should be checked for validity, never null.

Returns:

true if and only if the specified String value is valid, false otherwise.

fromStringImpl

protected final Object fromStringImpl(String string)
                               throws TypeValueException

Description copied from class: Type

Converts from a String to an instance of the value class for this type (implementation method).

This method is not required to check the validity of the specified value (since Type.isValidValueImpl(String) should have been called before) but if it does, then it may throw a TypeValueException.

Specified by:

fromStringImpl in class Type

Parameters:

string - the string to convert to an instance of the value class, guaranteed to be not null and guaranteed to have been passed to Type.isValidValueImpl(String) without getting an exception.

Returns:

an instance of the value class, cannot be null.

Throws:

TypeValueException - if string is considered to be an invalid value for this type.

toString

public final String toString(Object value)
                      throws IllegalArgumentException,
                             ClassCastException,
                             TypeValueException

Description copied from class: Type

Generates a string representation of the specified value for this type. The specified value must be an instance of the value class for this type (see Type.getValueClass()). Also, it may have to fall within a certain range of valid values, depending on the type.

The default implementation of this method in class Type does the following:

• if value == null then it throws an IllegalArgumentException;
• if getValueClass().isInstance(value) == false then it throws a ClassCastException;
• otherwise it returns value.Object.toString().

Overrides:

toString in class Type

Parameters:

value - the value, cannot be null.

Returns:

the string representation of the specified value for this type, cannot be null.

Throws:

ClassCastException - if getValueClass().isInstance(value) == false.

IllegalArgumentException - if value == null.

TypeValueException - if the specified value is not in the allowed range.