org.apache.jackrabbit.value

Class ValueHelper

java.lang.Object

org.apache.jackrabbit.value.ValueHelper

public class ValueHelper
extends java.lang.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 javax.jcr.Value[]	convert(java.io.InputStream[] srcValues, int targetType, javax.jcr.ValueFactory factory)
static javax.jcr.Value	convert(java.io.InputStream srcValue, int targetType, javax.jcr.ValueFactory factory)
static javax.jcr.Value[]	convert(java.lang.String[] srcValues, int targetType, javax.jcr.ValueFactory factory) Same as convert(String[], int, ValueFactory) using ValueFactoryImpl.
static javax.jcr.Value	convert(java.lang.String srcValue, int targetType, javax.jcr.ValueFactory factory)
static javax.jcr.Value[]	convert(javax.jcr.Value[] srcValues, int targetType, javax.jcr.ValueFactory factory)
static javax.jcr.Value	convert(javax.jcr.Value srcValue, int targetType, javax.jcr.ValueFactory factory) Converts the given value to a value of the specified target type.
static javax.jcr.Value[]	copy(javax.jcr.Value[] srcValues, javax.jcr.ValueFactory factory)
static javax.jcr.Value	copy(javax.jcr.Value srcValue, javax.jcr.ValueFactory factory)
static javax.jcr.Value	deserialize(java.io.Reader reader, int type, boolean decodeBlanks, javax.jcr.ValueFactory factory) Deserializes the string data read from the given reader to a Value of the given type.
static javax.jcr.Value	deserialize(java.lang.String value, int type, boolean decodeBlanks, javax.jcr.ValueFactory factory) Deserializes the given string to a Value of the given type.
static int	getType(javax.jcr.Value[] values) Determine the PropertyType of the passed values if all are of the same type.
static boolean	isSupportedConversion(int fromType, int toType)
static java.lang.String	serialize(javax.jcr.Value value, boolean encodeBlanks) Serializes the given value to a String.
static void	serialize(javax.jcr.Value value, boolean encodeBlanks, boolean enforceBase64, java.io.Writer writer) Outputs the serialized value to a Writer.

Methods inherited from class java.lang.Object

equals, 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 javax.jcr.ValueFormatException

Throws:

javax.jcr.ValueFormatException

convert

public static javax.jcr.Value convert(java.lang.String srcValue,
                                      int targetType,
                                      javax.jcr.ValueFactory factory)
                               throws javax.jcr.ValueFormatException,
                                      java.lang.IllegalArgumentException

Parameters:

srcValue -

targetType -

factory -

Throws:

javax.jcr.ValueFormatException

java.lang.IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static javax.jcr.Value convert(java.io.InputStream srcValue,
                                      int targetType,
                                      javax.jcr.ValueFactory factory)
                               throws javax.jcr.ValueFormatException,
                                      java.lang.IllegalArgumentException

Parameters:

srcValue -

targetType -

factory -

Throws:

javax.jcr.ValueFormatException

java.lang.IllegalArgumentException

convert

public static javax.jcr.Value[] convert(java.lang.String[] srcValues,
                                        int targetType,
                                        javax.jcr.ValueFactory factory)
                                 throws javax.jcr.ValueFormatException,
                                        java.lang.IllegalArgumentException

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

Parameters:

srcValues -

targetType -

Throws:

javax.jcr.ValueFormatException

java.lang.IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static javax.jcr.Value[] convert(java.io.InputStream[] srcValues,
                                        int targetType,
                                        javax.jcr.ValueFactory factory)
                                 throws javax.jcr.ValueFormatException,
                                        java.lang.IllegalArgumentException

Parameters:

srcValues -

targetType -

Throws:

javax.jcr.ValueFormatException

java.lang.IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static javax.jcr.Value[] convert(javax.jcr.Value[] srcValues,
                                        int targetType,
                                        javax.jcr.ValueFactory factory)
                                 throws javax.jcr.ValueFormatException,
                                        java.lang.IllegalArgumentException

Parameters:

srcValues -

targetType -

factory -

Throws:

javax.jcr.ValueFormatException

java.lang.IllegalArgumentException

See Also:

convert(Value, int, ValueFactory)

convert

public static javax.jcr.Value convert(javax.jcr.Value srcValue,
                                      int targetType,
                                      javax.jcr.ValueFactory factory)
                               throws javax.jcr.ValueFormatException,
                                      java.lang.IllegalStateException,
                                      java.lang.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:

javax.jcr.ValueFormatException

java.lang.IllegalStateException

java.lang.IllegalArgumentException

copy

public static javax.jcr.Value copy(javax.jcr.Value srcValue,
                                   javax.jcr.ValueFactory factory)
                            throws java.lang.IllegalStateException

Parameters:

srcValue -

factory -

Throws:

java.lang.IllegalStateException

copy

public static javax.jcr.Value[] copy(javax.jcr.Value[] srcValues,
                                     javax.jcr.ValueFactory factory)
                              throws java.lang.IllegalStateException

Parameters:

srcValues -

factory -

Throws:

java.lang.IllegalStateException

serialize

public static java.lang.String serialize(javax.jcr.Value value,
                                         boolean encodeBlanks)
                                  throws java.lang.IllegalStateException,
                                         javax.jcr.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:

java.lang.IllegalStateException - if the given value is in an illegal state

javax.jcr.RepositoryException - if an error occured during the serialization.

serialize

public static void serialize(javax.jcr.Value value,
                             boolean encodeBlanks,
                             boolean enforceBase64,
                             java.io.Writer writer)
                      throws java.lang.IllegalStateException,
                             java.io.IOException,
                             javax.jcr.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:

java.lang.IllegalStateException - if the given value is in an illegal state

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

javax.jcr.RepositoryException - if an error occured during the serialization.

deserialize

public static javax.jcr.Value deserialize(java.lang.String value,
                                          int type,
                                          boolean decodeBlanks,
                                          javax.jcr.ValueFactory factory)
                                   throws javax.jcr.ValueFormatException,
                                          javax.jcr.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:

javax.jcr.ValueFormatException - if the string data is not of the required format

javax.jcr.RepositoryException - if an error occured during the deserialization.

deserialize

public static javax.jcr.Value deserialize(java.io.Reader reader,
                                          int type,
                                          boolean decodeBlanks,
                                          javax.jcr.ValueFactory factory)
                                   throws java.io.IOException,
                                          javax.jcr.ValueFormatException,
                                          javax.jcr.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:

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

javax.jcr.ValueFormatException - if the string data is not of the required format

javax.jcr.RepositoryException - if an error occured during the deserialization.

getType

public static int getType(javax.jcr.Value[] values)
                   throws javax.jcr.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:

javax.jcr.ValueFormatException - if not all values are of the same type