org.apache.jackrabbit.rmi.value
Class SerialValueFactory

java.lang.Object
  org.apache.jackrabbit.rmi.value.SerialValueFactory

All Implemented Interfaces:

javax.jcr.ValueFactory

public class SerialValueFactory
extends java.lang.Object
implements javax.jcr.ValueFactory

The SerialValueFactory class is used in the RMI infrastructure to create serializable Value instances on the client side.

This class works in conjunction with the implementations of the javax.jcr.Value interface found in this package.

This class may be extended to overwrite any of the createXXXValue methods to create instances of the respective type of org.apache.jackrabbit.rmi.value.StatefullValueimplementation. The methods of the ValueFactory interface are declared final to guard against breaking the rules.

Constructor Summary

protected

SerialValueFactory() Default constructor only visible to extensions of this class.

Method Summary

protected BinaryValue	createBinaryValue(java.io.InputStream value) Creates an instance of the BinaryValue class or an extension thereof.
protected BinaryValue	createBinaryValue(java.lang.String value) Creates an instance of the BinaryValue class or an extension thereof from the string whose UTF-8 representation is used as the binary data.
protected BooleanValue	createBooleanValue(boolean value) Creates an instance of the BooleanValue class or an extension thereof.
protected BooleanValue	createBooleanValue(java.lang.String value) Creates an instance of the BooleanValue class or an extension thereof from the string representation of the boolean.
protected DateValue	createDateValue(java.util.Calendar value) Creates an instance of the DateValue class or an extension thereof.
protected DateValue	createDateValue(java.lang.String value) Creates an instance of the DateValue class or an extension thereof from the string representation of Calendar instance formatted as specified in the JCR specification.
protected DoubleValue	createDoubleValue(double value) Creates an instance of the DoubleValue class or an extension thereof.
protected DoubleValue	createDoubleValue(java.lang.String value) Creates an instance of the DoubleValue class or an extension thereof from the string representation of the double number.
protected LongValue	createLongValue(long value) Creates an instance of the LongValue class or an extension thereof.
protected LongValue	createLongValue(java.lang.String value) Creates an instance of the LongValue class or an extension thereof from the string representation of the long number.
protected NameValue	createNameValue(java.lang.String value) Creates an instance of the NameValue class or an extension thereof.
protected PathValue	createPathValue(java.lang.String value) Creates an instance of the PathValue class or an extension thereof.
protected ReferenceValue	createReferenceValue(java.lang.String value) Creates an instance of the ReferenceValue class or an extension thereof.
protected StringValue	createStringValue(java.lang.String value) Creates an instance of the StringValue class or an extension thereof.
javax.jcr.Value	createValue(boolean value)
javax.jcr.Value	createValue(java.util.Calendar value)
javax.jcr.Value	createValue(double value)
javax.jcr.Value	createValue(java.io.InputStream value)
javax.jcr.Value	createValue(long value)
javax.jcr.Value	createValue(javax.jcr.Node value)
javax.jcr.Value	createValue(java.lang.String value)
javax.jcr.Value	createValue(java.lang.String value, int type)
static SerialValueFactory	getInstance() Returns the ValueFactory instance, which currently is a singleton instance of this class.
static javax.jcr.Value	makeSerialValue(javax.jcr.Value value) Utility method for decorating a value.
static javax.jcr.Value[]	makeSerialValueArray(javax.jcr.Value[] values) Utility method for decorating an array of values.

Methods inherited from class java.lang.Object

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

Constructor Detail

SerialValueFactory

protected SerialValueFactory()

Default constructor only visible to extensions of this class. See class comments for details.

Method Detail

getInstance

public static final SerialValueFactory getInstance()

Returns the ValueFactory instance, which currently is a singleton instance of this class.

Future revisions will support some kind of configuration to specify which concrete class should be used.

makeSerialValueArray

public static javax.jcr.Value[] makeSerialValueArray(javax.jcr.Value[] values)

Utility method for decorating an array of values. The returned array will contain serializable value decorators for all the given values. Note that the contents of the original values will only be copied when the decorators are serialized.

If the given array is null, then an empty array is returned.

Parameters:

values - the values to be decorated

Returns:

array of decorated values

makeSerialValue

public static javax.jcr.Value makeSerialValue(javax.jcr.Value value)

Utility method for decorating a value. Note that the contents of the original values will only be copied when the decorators are serialized. Null referenced and already serializable values are passed as-is.

Parameters:

value - the value to be decorated, or null

Returns:

the decorated value, or null

createValue

public final javax.jcr.Value createValue(java.lang.String value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(java.lang.String value,
                                         int type)
                                  throws javax.jcr.ValueFormatException

Specified by:

createValue in interface javax.jcr.ValueFactory

Throws:

javax.jcr.ValueFormatException

createValue

public final javax.jcr.Value createValue(long value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(double value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(boolean value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(java.util.Calendar value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(java.io.InputStream value)

Specified by:

createValue in interface javax.jcr.ValueFactory

createValue

public final javax.jcr.Value createValue(javax.jcr.Node value)
                                  throws javax.jcr.RepositoryException

Specified by:

createValue in interface javax.jcr.ValueFactory

Throws:

javax.jcr.RepositoryException

createStringValue

protected StringValue createStringValue(java.lang.String value)

Creates an instance of the StringValue class or an extension thereof.

This implementation just calls StringValue.StringValue(String) with the string value.

Parameters:

value - The string making up the value itself.

createNameValue

protected NameValue createNameValue(java.lang.String value)
                             throws javax.jcr.ValueFormatException

Creates an instance of the NameValue class or an extension thereof.

This implementation just calls NameValue.NameValue(String) with the string value.

Parameters:

value - The string making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string is not a synthactically correct JCR name.

createPathValue

protected PathValue createPathValue(java.lang.String value)
                             throws javax.jcr.ValueFormatException

Creates an instance of the PathValue class or an extension thereof.

This implementation just calls PathValue.PathValue(String) with the string value.

Parameters:

value - The string making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string is not a synthactically correct JCR path.

createReferenceValue

protected ReferenceValue createReferenceValue(java.lang.String value)
                                       throws javax.jcr.ValueFormatException

Creates an instance of the ReferenceValue class or an extension thereof.

This implementation just calls ReferenceValue.ReferenceValue(String) with the string value.

Parameters:

value - The string making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string is not a synthactically correct JCR reference.

createLongValue

protected LongValue createLongValue(long value)

Creates an instance of the LongValue class or an extension thereof.

This implementation just calls LongValue.LongValue(long) with the long value.

Parameters:

value - The long making up the value itself.

createLongValue

protected LongValue createLongValue(java.lang.String value)
                             throws javax.jcr.ValueFormatException

Creates an instance of the LongValue class or an extension thereof from the string representation of the long number.

This implementation just calls LongValue.LongValue(String) with the string value.

Parameters:

value - The string representation of the long number making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string cannot be converted to a long number.

createDoubleValue

protected DoubleValue createDoubleValue(double value)

Creates an instance of the DoubleValue class or an extension thereof.

This implementation just calls DoubleValue.DoubleValue(double) with the double value.

Parameters:

value - The double making up the value itself.

createDoubleValue

protected DoubleValue createDoubleValue(java.lang.String value)
                                 throws javax.jcr.ValueFormatException

Creates an instance of the DoubleValue class or an extension thereof from the string representation of the double number.

This implementation just calls DoubleValue.DoubleValue(String) with the string value.

Parameters:

value - The string representation of the long number making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string cannot be converted to a double number.

createDateValue

protected DateValue createDateValue(java.util.Calendar value)

Creates an instance of the DateValue class or an extension thereof.

This implementation just calls DateValue.DateValue(Calendar) with the Calendar value.

Parameters:

value - The Calendar making up the value itself.

createDateValue

protected DateValue createDateValue(java.lang.String value)
                             throws javax.jcr.ValueFormatException

Creates an instance of the DateValue class or an extension thereof from the string representation of Calendar instance formatted as specified in the JCR specification.

This implementation just calls DateValue.DateValue(String) with the string value.

Parameters:

value - The string representation of the Calendar instance making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string cannot be converted to a Calendar instance.

createBooleanValue

protected BooleanValue createBooleanValue(boolean value)

Creates an instance of the BooleanValue class or an extension thereof.

This implementation just calls BooleanValue.BooleanValue(boolean) with the boolean value.

Parameters:

value - The boolean making up the value itself.

createBooleanValue

protected BooleanValue createBooleanValue(java.lang.String value)

Creates an instance of the BooleanValue class or an extension thereof from the string representation of the boolean.

This implementation just calls BooleanValue.BooleanValue(String) with the string value.

Parameters:

value - The string representation of the boolean making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the string cannot be converted to a long number.

createBinaryValue

protected BinaryValue createBinaryValue(java.io.InputStream value)

Creates an instance of the BinaryValue class or an extension thereof.

This implementation just calls BinaryValue.BinaryValue(InputStream) with the InputStream value.

Parameters:

value - The InputStream making up the value itself.

createBinaryValue

protected BinaryValue createBinaryValue(java.lang.String value)
                                 throws javax.jcr.ValueFormatException

Creates an instance of the BinaryValue class or an extension thereof from the string whose UTF-8 representation is used as the binary data.

This implementation just calls BinaryValue.BinaryValue(String) with the string value.

Parameters:

value - The string whose UTF-8 representation is making up the value itself.

Throws:

javax.jcr.ValueFormatException - if the UTF-8 representation of the string cannot be created.