org.modeshape.jcr.value.basic
Class AbstractValueFactory<T>

java.lang.Object
  org.modeshape.jcr.value.basic.AbstractValueFactory<T>

Type Parameters:

T - the property type

All Implemented Interfaces:

ValueFactory<T>

Direct Known Subclasses:

BinaryStoreValueFactory, BooleanValueFactory, DecimalValueFactory, DoubleValueFactory, JodaDateTimeValueFactory, LongValueFactory, NameValueFactory, ObjectValueFactory, PathValueFactory, ReferenceValueFactory, StringValueFactory, UriValueFactory, UuidValueFactory

@Immutable
public abstract class AbstractValueFactory<T>
extends Object
implements ValueFactory<T>

Abstract ValueFactory.

Nested Class Summary

protected static class

AbstractValueFactory.ConvertingIterator<ValueType>

Field Summary

Fields inherited from interface org.modeshape.jcr.value.ValueFactory

DEFAULT_DECODER, DEFAULT_ENCODER

Constructor Summary

protected

AbstractValueFactory(PropertyType type, TextDecoder decoder, ValueFactory<String> stringValueFactory)

Method Summary

T[]	create(BigDecimal[] values) Create an array of values from an array of decimal values.
T[]	create(BinaryValue[] values) Create an array of values from the array of binary objects.
T[]	create(boolean[] values) Create an array of values from an array of booleans.
T[]	create(byte[][] values) Create an array of values from the array of binary content.
T[]	create(Calendar[] values) Create an array of values from an array of Calendar instances.
T[]	create(Date[] values) Create an array of values from an array of dates.
T[]	create(DateTime[] values) Create an array of values from an array of DateTime instants.
T[]	create(double[] values) Create an array of values from an array of doubles.
T[]	create(float[] values) Create an array of values from an array of floats.
T[]	create(int[] values) Create an array of values from an array of integers.
Iterable<T>	create(Iterable<?> valueIterable) Create an iterable with the values (of an unknown type).
Iterator<T>	create(Iterator<?> values) Create an iterator over the values (of an unknown type).
T[]	create(long[] values) Create an array of values from an array of longs.
T[]	create(Name[] values) Create an array of values from an array of names.
T[]	create(NodeKey[] values) Create an array of values from an array of NodeKey.
T	create(Object value) Create a value from the specified information by determining which other create method applies and delegating to that method.
T[]	create(Object[] values) Create an array of values from the specified information by determining which other create method applies for each object and then delegating to that method.
T[]	create(Path[] values) Create an array of values from an array of paths.
T[]	create(Reference[] values) Create an array of values from an array of references.
T[]	create(String[] values) Create an array of values from an array of string values, using no decoding.
T[]	create(String[] values, TextDecoder decoder) Create an array of values from an array of strings, using the supplied decoder.
T[]	create(URI[] values) Create an array of values from an array of URIs.
T[]	create(UUID[] values) Create an array of values from an array of UUIDs.
protected abstract T[]	createEmptyArray(int length)
TextDecoder	getDecoder() Get the text decoder.
protected TextDecoder	getDecoder(TextDecoder decoder) Utility method to obtain either the supplied decoder (if not null) or this factory's decoder.
PropertyType	getPropertyType() Get the type of values created by this factory.
protected ValueFactory<String>	getStringValueFactory()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.modeshape.jcr.value.ValueFactory

create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create, create

Constructor Detail

AbstractValueFactory

protected AbstractValueFactory(PropertyType type,
                               TextDecoder decoder,
                               ValueFactory<String> stringValueFactory)

Method Detail

getStringValueFactory

protected ValueFactory<String> getStringValueFactory()

Returns:

stringValueFactory

getDecoder

public TextDecoder getDecoder()

Get the text decoder.

Returns:

the decoder

getDecoder

protected TextDecoder getDecoder(TextDecoder decoder)

Utility method to obtain either the supplied decoder (if not null) or this factory's decoder.

Parameters:

decoder - the decoder, which may be null if this factory's is to be used

Returns:

the decoder; never null

getPropertyType

public PropertyType getPropertyType()

Description copied from interface: ValueFactory

Get the type of values created by this factory.

Specified by:

getPropertyType in interface ValueFactory<T>

Returns:

the value type; never null

create

public T create(Object value)

Description copied from interface: ValueFactory

Create a value from the specified information by determining which other create method applies and delegating to that method. Note that this method only will call create methods that take a single parameter; so this excludes ValueFactory.create(InputStream) and ValueFactory.create(String, TextDecoder).

Specified by:

create in interface ValueFactory<T>

Parameters:

value - the value

Returns:

the new value, or null if the supplied parameter is null

createEmptyArray

protected abstract T[] createEmptyArray(int length)

create

public T[] create(BigDecimal[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of decimal values.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the decimals from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(boolean[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of booleans.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the booleans from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(byte[][] values)

Description copied from interface: ValueFactory

Create an array of values from the array of binary content.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the array of content to be used to create the values

Returns:

the value, or null if the supplied array is null

create

public T[] create(Calendar[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of Calendar instances.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the Calendar instances from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(Date[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of dates.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the dates from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(DateTime[] values)
           throws ValueFormatException

Description copied from interface: ValueFactory

Create an array of values from an array of DateTime instants.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the instants from which the values are to be created

Returns:

the values, or null if the supplied array is null

Throws:

ValueFormatException - if the conversion from an array of date values could not be performed

create

public T[] create(double[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of doubles.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the doubles from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(float[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of floats.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the floats from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(int[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of integers.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the integers from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(long[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of longs.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the longs from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(Name[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of names.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the names from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(Object[] values)

Description copied from interface: ValueFactory

Create an array of values from the specified information by determining which other create method applies for each object and then delegating to that method. Note that this method will not consider ValueFactory.create(InputStream) and ValueFactory.create(String, TextDecoder).

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the values

Returns:

the new value, or null if the supplied parameter is null

create

public T[] create(Path[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of paths.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the paths from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(Reference[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of references.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the references from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(String[] values,
                  TextDecoder decoder)

Description copied from interface: ValueFactory

Create an array of values from an array of strings, using the supplied decoder.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the string values from which the values are to be created

decoder - the decoder that should be used; if null, the default decoder is used

Returns:

the value, or null if the supplied string is null

See Also:

ValueFactory.create(String)

create

public T[] create(String[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of string values, using no decoding.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the values

Returns:

the values, or null if the supplied string is null

See Also:

ValueFactory.create(String[], TextDecoder)

create

public T[] create(URI[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of URIs.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the URIs from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(UUID[] values)

Description copied from interface: ValueFactory

Create an array of values from an array of UUIDs.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the UUIDs from which the values are to be created

Returns:

the values, or null if the supplied array is null

create

public T[] create(NodeKey[] values)
           throws ValueFormatException

Description copied from interface: ValueFactory

Create an array of values from an array of NodeKey.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the node key from which the value is to be created

Returns:

the value, or null if the supplied URI is null

Throws:

ValueFormatException - if the conversion from a NodeKey could not be performed

create

public T[] create(BinaryValue[] values)
           throws ValueFormatException,
                  IoException

Description copied from interface: ValueFactory

Create an array of values from the array of binary objects.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the values

Returns:

the new value, or null if the supplied parameter is null

Throws:

ValueFormatException - if the conversion from an array of objects could not be performed

IoException - If an unexpected problem occurs during the conversion.

create

public Iterator<T> create(Iterator<?> values)
                   throws ValueFormatException,
                          IoException

Description copied from interface: ValueFactory

Create an iterator over the values (of an unknown type). The factory converts any values as required. Note that this method will not consider ValueFactory.create(InputStream) and ValueFactory.create(String, TextDecoder).

This is useful to use when iterating over the values of a Property.

Specified by:

create in interface ValueFactory<T>

Parameters:

values - the values

Returns:

the iterator of type T over the values, or null if the supplied parameter is null

Throws:

ValueFormatException - if the conversion from an iterator of objects could not be performed

IoException - If an unexpected problem occurs during the conversion.

See Also:

Property.getValues()

create

public Iterable<T> create(Iterable<?> valueIterable)
                   throws ValueFormatException,
                          IoException

Description copied from interface: ValueFactory

Create an iterable with the values (of an unknown type). The factory converts any values as required. Note that this method will not consider ValueFactory.create(InputStream) and ValueFactory.create(String, TextDecoder).

This is useful to use when converting all the values of a Property.

Example:

      Property property = ...
      ExecutionContext executionContext = ...
      ValueFactory<String> stringFactory = executionContext.getValueFactories().getStringFactory();
      for (String token : stringFactory.create(property)) {
          ...
      }
 

Specified by:

create in interface ValueFactory<T>

Parameters:

valueIterable - the values

Returns:

the iterator of type T over the values, or null if the supplied parameter is null

Throws:

ValueFormatException - if the conversion from an iterator of objects could not be performed

IoException - If an unexpected problem occurs during the conversion.

See Also:

Property.getValues()