org.apache.jackrabbit.value

Class ValueHelper

java.lang.Object

org.apache.jackrabbit.value.ValueHelper

public class ValueHelper
extends Object

The ValueHelper class provides several Value related utility methods.

Method Summary

Modifier and Type	Method and Description
static void	checkSupportedConversion(int fromType, int toType)
static Value[]	convert(InputStream[] srcValues, int targetType, ValueFactory factory)
static Value	convert(InputStream srcValue, int targetType, ValueFactory factory)
static Value[]	convert(String[] srcValues, int targetType, ValueFactory factory) Same as convert(String[], int, ValueFactory) using ValueFactoryImpl.
static Value	convert(String srcValue, int targetType, ValueFactory factory)
static Value[]	convert(Value[] srcValues, int targetType, ValueFactory factory)
static Value	convert(Value srcValue, int targetType, ValueFactory factory) Converts the given value to a value of the specified target type.
static Value[]	copy(Value[] srcValues, ValueFactory factory)
static Value	copy(Value srcValue, ValueFactory factory)
static Value	deserialize(Reader reader, int type, boolean decodeBlanks, ValueFactory factory) Deserializes the string data read from the given reader to a Value of the given type.
static Value	deserialize(String value, int type, boolean decodeBlanks, ValueFactory factory) Deserializes the given string to a Value of the given type.
static int	getType(Value[] values) Determine the PropertyType of the passed values if all are of the same type.
static boolean	isSupportedConversion(int fromType, int toType)
static String	serialize(Value value, boolean encodeBlanks) Serializes the given value to a String.
static void	serialize(Value value, boolean encodeBlanks, boolean enforceBase64, Writer writer) Outputs the serialized value to a Writer.

Methods inherited from class java.lang.Object

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

Method Detail

isSupportedConversion

public static boolean isSupportedConversion(int fromType,
                                            int toType)

checkSupportedConversion

public static void checkSupportedConversion(int fromType,
                                            int toType)
                                     throws ValueFormatException

Throws:

ValueFormatException

convert

public static Value convert(String srcValue,
                            int targetType,
                            ValueFactory factory)
                     throws ValueFormatException,
                            IllegalArgumentException

Parameters:

srcValue -

targetType -

factory -

Throws:

ValueFormatException

IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static Value convert(InputStream srcValue,
                            int targetType,
                            ValueFactory factory)
                     throws ValueFormatException,
                            IllegalArgumentException

Parameters:

srcValue -

targetType -

factory -

Throws:

ValueFormatException

IllegalArgumentException

convert

public static Value[] convert(String[] srcValues,
                              int targetType,
                              ValueFactory factory)
                       throws ValueFormatException,
                              IllegalArgumentException

Same as convert(String[], int, ValueFactory) using ValueFactoryImpl.

Parameters:

srcValues -

targetType -

Throws:

ValueFormatException

IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static Value[] convert(InputStream[] srcValues,
                              int targetType,
                              ValueFactory factory)
                       throws ValueFormatException,
                              IllegalArgumentException

Parameters:

srcValues -

targetType -

Throws:

ValueFormatException

IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static Value[] convert(Value[] srcValues,
                              int targetType,
                              ValueFactory factory)
                       throws ValueFormatException,
                              IllegalArgumentException

Parameters:

srcValues -

targetType -

factory -

Throws:

ValueFormatException

IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static Value convert(Value srcValue,
                            int targetType,
                            ValueFactory factory)
                     throws ValueFormatException,
                            IllegalStateException,
                            IllegalArgumentException

Converts the given value to a value of the specified target type. The conversion is performed according to the rules described in "3.6.4 Property Type Conversion" in the JSR 283 specification.

Parameters:

srcValue -

targetType -

factory -

Throws:

ValueFormatException

IllegalStateException

IllegalArgumentException

copy

public static Value copy(Value srcValue,
                         ValueFactory factory)
                  throws IllegalStateException

Parameters:

srcValue -

factory -

Throws:

IllegalStateException

copy

public static Value[] copy(Value[] srcValues,
                           ValueFactory factory)
                    throws IllegalStateException

Parameters:

srcValues -

factory -

Throws:

IllegalStateException

serialize

public static String serialize(Value value,
                               boolean encodeBlanks)
                        throws IllegalStateException,
                               RepositoryException

Serializes the given value to a String. The serialization format is the same as used by Document & System View XML, i.e. binary values will be Base64-encoded whereas for all others Value.getString() will be used.

Parameters:

value - the value to be serialized

encodeBlanks - if true space characters will be encoded as "_x0020_" within he output string.

Returns:

a string representation of the given value.

Throws:

IllegalStateException - if the given value is in an illegal state

RepositoryException - if an error occured during the serialization.

serialize

public static void serialize(Value value,
                             boolean encodeBlanks,
                             boolean enforceBase64,
                             Writer writer)
                      throws IllegalStateException,
                             IOException,
                             RepositoryException

Outputs the serialized value to a Writer. The serialization format is the same as used by Document & System View XML, i.e. binary values will be Base64-encoded whereas for all others Value.getString() will be used for serialization.

Parameters:

value - the value to be serialized

encodeBlanks - if true space characters will be encoded as "_x0020_" within he output string.

enforceBase64 - if true, base64 encoding will always be used

writer - writer to output the encoded data

Throws:

IllegalStateException - if the given value is in an illegal state

IOException - if an i/o error occured during the serialization

RepositoryException - if an error occured during the serialization.

deserialize

public static Value deserialize(String value,
                                int type,
                                boolean decodeBlanks,
                                ValueFactory factory)
                         throws ValueFormatException,
                                RepositoryException

Deserializes the given string to a Value of the given type.

Parameters:

value - string to be deserialized

type - type of value

decodeBlanks - if true "_x0020_" character sequences will be decoded to single space characters each.

factory - ValueFactory used to build the Value object.

Returns:

the deserialized Value

Throws:

ValueFormatException - if the string data is not of the required format

RepositoryException - if an error occured during the deserialization.

deserialize

public static Value deserialize(Reader reader,
                                int type,
                                boolean decodeBlanks,
                                ValueFactory factory)
                         throws IOException,
                                ValueFormatException,
                                RepositoryException

Deserializes the string data read from the given reader to a Value of the given type.

Parameters:

reader - reader for the string data to be deserialized

type - type of value

decodeBlanks - if true "_x0020_" character sequences will be decoded to single space characters each.

factory - ValueFactory used to build the Value object.

Returns:

the deserialized Value

Throws:

IOException - if an i/o error occured during the serialization

ValueFormatException - if the string data is not of the required format

RepositoryException - if an error occured during the deserialization.

getType

public static int getType(Value[] values)
                   throws ValueFormatException

Determine the PropertyType of the passed values if all are of the same type.

Parameters:

values - array of values of the same type

Returns:

PropertyType.UNDEFINED if values is empty, values[0].getType() otherwise.

Throws:

ValueFormatException - if not all values are of the same type