org.apache.jackrabbit.spi

Interface QValueFactory

All Known Implementing Classes:

AbstractQValueFactory, QValueFactoryImpl, QValueFactoryLogger

public interface QValueFactory

QValueFactory defines methods to create QValue instances.

Method Summary

Modifier and Type	Method and Description
QValue[]	computeAutoValues(QPropertyDefinition propertyDefinition) Given the QPropertyDefinition of an autocreated property, compute suitable values to be used in transient space until the newly created node gets saved.
QValue	create(java.math.BigDecimal value) Create a new QValue with type javax.jcr.PropertyType#DECIMAL.
QValue	create(boolean value) Create a new QValue with type javax.jcr.PropertyType#BOOLEAN.
QValue	create(byte[] value) Create a new QValue with type javax.jcr.PropertyType#BINARY.
QValue	create(java.util.Calendar value) Create a new QValue with type javax.jcr.PropertyType#DATE.
QValue	create(double value) Create a new QValue with type javax.jcr.PropertyType#DOUBLE.
QValue	create(java.io.File value) Create a new QValue with type javax.jcr.PropertyType#BINARY.
QValue	create(java.io.InputStream value) Creates a QValue that contains the given binary stream.
QValue	create(long value) Create a new QValue with type javax.jcr.PropertyType#LONG.
QValue	create(Name value) Create a new QValue with type javax.jcr.PropertyType#NAME.
QValue	create(Path value) Create a new QValue with type javax.jcr.PropertyType#PATH.
QValue	create(java.lang.String value, int type) Create a new QValue using the given String representation of the value and its type.
QValue	create(java.net.URI value) Create a new QValue with type javax.jcr.PropertyType#URI.

Method Detail

create

QValue create(java.lang.String value,
              int type)
       throws ValueFormatException,
              RepositoryException

Create a new QValue using the given String representation of the value and its type.

Parameters:

value - String representation of the new QValue. Note, that the given String must never be null.

type - A valid type.

Returns:

a new QValue.

Throws:

ValueFormatException - If the given value cannot be converted to the specified type.

RepositoryException - If another error occurs.

See Also:

QValue.getType()

create

QValue create(java.util.Calendar value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#DATE.

Parameters:

value - A non-null Calendar object acting as value of the new QValue.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(double value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#DOUBLE.

Parameters:

value - A double containing the value of the new QValue.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(long value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#LONG.

Parameters:

value - A long containing the value of the new QValue.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(boolean value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#BOOLEAN.

Parameters:

value - A boolean containing the value of the new QValue.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(Name value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#NAME.

Parameters:

value - A non-null Name.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(Path value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#PATH.

Parameters:

value - A non-null Path.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(java.math.BigDecimal value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#DECIMAL.

Parameters:

value - A non-null BigDecimal.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(java.net.URI value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#URI.

Parameters:

value - A non-null URI.

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(byte[] value)
       throws RepositoryException

Create a new QValue with type javax.jcr.PropertyType#BINARY.

Parameters:

value -

Returns:

a new QValue.

Throws:

RepositoryException

create

QValue create(java.io.InputStream value)
       throws RepositoryException,
              java.io.IOException

Creates a QValue that contains the given binary stream. The given stream is consumed and closed by this method. The type of the resulting QValue will be javax.jcr.PropertyType#BINARY.

Parameters:

value - binary stream

Returns:

a new binary QValue.

Throws:

RepositoryException - if the value could not be created

java.io.IOException - if the stream can not be consumed

create

QValue create(java.io.File value)
       throws RepositoryException,
              java.io.IOException

Create a new QValue with type javax.jcr.PropertyType#BINARY.

Parameters:

value -

Returns:

a new binary QValue.

Throws:

java.io.IOException

RepositoryException

computeAutoValues

QValue[] computeAutoValues(QPropertyDefinition propertyDefinition)
                    throws RepositoryException

Given the QPropertyDefinition of an autocreated property, compute suitable values to be used in transient space until the newly created node gets saved.

Parameters:

propertyDefinition - definition of property for which values should be created

Returns:

computed value

Throws:

RepositoryException