org.apache.jackrabbit.oak.plugins.value.jcr

Class ValueFactoryImpl

java.lang.Object

org.apache.jackrabbit.oak.plugins.value.jcr.PartialValueFactory

org.apache.jackrabbit.oak.plugins.value.jcr.ValueFactoryImpl

All Implemented Interfaces:

ValueFactory, JackrabbitValueFactory

public class ValueFactoryImpl
extends PartialValueFactory
implements JackrabbitValueFactory

Implementation of ValueFactory interface.

Field Summary

Fields inherited from class org.apache.jackrabbit.oak.plugins.value.jcr.PartialValueFactory

DEFAULT_BLOB_ACCESS_PROVIDER

Constructor Summary

Constructors

Constructor and Description
ValueFactoryImpl(@NotNull Root root, @NotNull NamePathMapper namePathMapper) Creates a new instance of ValueFactory.
ValueFactoryImpl(@NotNull Root root, @NotNull NamePathMapper namePathMapper, @NotNull org.apache.jackrabbit.oak.api.blob.BlobAccessProvider blobAccessProvider) Creates a new instance of ValueFactory.

Method Summary

Modifier and Type	Method and Description
@Nullable Binary	completeBinaryUpload(@NotNull java.lang.String uploadToken) Complete the transaction of uploading a binary directly to a storage location and return a Binary to set as value for a binary JCR property.
@Nullable Binary	createBinary(Blob blob)
@NotNull Binary	createBinary(@NotNull java.io.InputStream stream)
@NotNull Value	createValue(@NotNull Binary value)
@NotNull Value	createValue(@NotNull java.io.InputStream value)
static @NotNull Value	createValue(@NotNull PropertyState property, @NotNull NamePathMapper namePathMapper) Deprecated. use PartialValueFactory.createValue(PropertyState) instead.
static @NotNull Value	createValue(@NotNull PropertyValue property, @NotNull NamePathMapper namePathMapper) Deprecated. use PartialValueFactory.createValue(PropertyState) instead.
static @NotNull java.util.List<Value>	createValues(@NotNull PropertyState property, @NotNull NamePathMapper namePathMapper) Deprecated. use PartialValueFactory.createValues(PropertyState) instead.
@Nullable Blob	getBlob(Binary binary)
@Nullable BinaryUpload	initiateBinaryUpload(long maxSize, int maxParts) Initiate a transaction to upload a binary directly to a storage location and return BinaryUpload instructions for a remote client.

Methods inherited from class org.apache.jackrabbit.oak.plugins.value.jcr.PartialValueFactory

createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValues, getNamePathMapper

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.jcr.ValueFactory

createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValue, createValue

Constructor Detail

ValueFactoryImpl

public ValueFactoryImpl(@NotNull
                        @NotNull Root root,
                        @NotNull
                        @NotNull NamePathMapper namePathMapper,
                        @NotNull
                        @NotNull org.apache.jackrabbit.oak.api.blob.BlobAccessProvider blobAccessProvider)

Creates a new instance of ValueFactory.

Parameters:

root - the root instance for creating binary values

namePathMapper - The name/path mapping used for converting JCR names/paths to

blobAccessProvider - The blob access provider the internal representation.

ValueFactoryImpl

public ValueFactoryImpl(@NotNull
                        @NotNull Root root,
                        @NotNull
                        @NotNull NamePathMapper namePathMapper)

Creates a new instance of ValueFactory. The Values created by this value factory instance will not be backed by a blob access provider and never return a download URI for a binary value.

Parameters:

root - the root instance for creating binary values

namePathMapper - The name/path mapping used for converting JCR names/paths to the internal representation.

Method Detail

createValue

@Deprecated
 @NotNull
public static @NotNull Value createValue(@NotNull
                                                               @NotNull PropertyState property,
                                                               @NotNull
                                                               @NotNull NamePathMapper namePathMapper)

Deprecated. use PartialValueFactory.createValue(PropertyState) instead.

Utility method for creating a Value based on a PropertyState. The Value instance created by this factory method will not be backed with a BlobAccessProvider and the Binary retrieved from the Value does not provide a download URI, even if the underlying blob store supports it.

Parameters:

property - The property state

namePathMapper - The name/path mapping used for converting JCR names/paths to the internal representation.

Returns:

New Value instance

Throws:

java.lang.IllegalArgumentException - if property.isArray() is true.

createValue

@Deprecated
 @NotNull
public static @NotNull Value createValue(@NotNull
                                                               @NotNull PropertyValue property,
                                                               @NotNull
                                                               @NotNull NamePathMapper namePathMapper)

Deprecated. use PartialValueFactory.createValue(PropertyState) instead.

Utility method for creating a Value based on a PropertyValue. The Value instance created by this factory method will not be backed with a BlobAccessProvider and the Binary retrieved from the Value does not provide a download URI, even if the underlying blob store supports it. Utility method for creating a Value based on a PropertyValue.

Parameters:

property - The property value

namePathMapper - The name/path mapping used for converting JCR names/paths to the internal representation.

Returns:

New Value instance

Throws:

java.lang.IllegalArgumentException - if property.isArray() is true.

createValues

@Deprecated
 @NotNull
public static @NotNull java.util.List<Value> createValues(@NotNull
                                                                                @NotNull PropertyState property,
                                                                                @NotNull
                                                                                @NotNull NamePathMapper namePathMapper)

Deprecated. use PartialValueFactory.createValues(PropertyState) instead.

Utility method for creating Values based on a PropertyState. The Value instances created by this factory method will not be backed with a BlobAccessProvider and the Binary retrieved from the Value does not provide a download URI, even if the underlying blob store supports it.

Parameters:

property - The property state

namePathMapper - The name/path mapping used for converting JCR names/paths to the internal representation.

Returns:

A list of new Value instances

createValue

@NotNull
public @NotNull Value createValue(@NotNull
                                           @NotNull java.io.InputStream value)

Specified by:

createValue in interface ValueFactory

createValue

@NotNull
public @NotNull Value createValue(@NotNull
                                           @NotNull Binary value)

Specified by:

createValue in interface ValueFactory

createBinary

@NotNull
public @NotNull Binary createBinary(@NotNull
                                             @NotNull java.io.InputStream stream)
                                      throws RepositoryException

Specified by:

createBinary in interface ValueFactory

Throws:

RepositoryException

initiateBinaryUpload

@Nullable
public @Nullable BinaryUpload initiateBinaryUpload(long maxSize,
                                                             int maxParts)

Description copied from interface: JackrabbitValueFactory

Initiate a transaction to upload a binary directly to a storage location and return BinaryUpload instructions for a remote client. Returns null if the feature is not available.

IllegalArgumentException will be thrown if an upload cannot be supported for the required parameters, or if the parameters are otherwise invalid. Each service provider has specific limitations.

Specified by:

initiateBinaryUpload in interface JackrabbitValueFactory

Parameters:

maxSize - The exact size of the binary to be uploaded or the estimated maximum size if the exact size is unknown. If the estimation was too small, the transaction should be restarted by invoking this method again using the correct size.

maxParts - The maximum number of upload URIs that the client can accept, for example due to message size limitations. A value of -1 indicates no limit. Upon a successful return, it is ensured that an upload of maxSize can be completed by splitting the binary into maxURIs parts, otherwise IllegalArgumentException will be thrown.

Returns:

A BinaryUpload providing the upload instructions, or null if the implementation does not support the direct upload feature.

completeBinaryUpload

@Nullable
public @Nullable Binary completeBinaryUpload(@NotNull
                                                       @NotNull java.lang.String uploadToken)
                                                throws RepositoryException

Description copied from interface: JackrabbitValueFactory

Complete the transaction of uploading a binary directly to a storage location and return a Binary to set as value for a binary JCR property. The binary is not automatically associated with any location in the JCR.

The client must provide a valid upload token, obtained from BinaryUpload.getUploadToken() when this transaction was initialized using JackrabbitValueFactory.initiateBinaryUpload(long, int). If the uploadToken is unreadable or invalid, an IllegalArgumentException will be thrown.

Specified by:

completeBinaryUpload in interface JackrabbitValueFactory

Parameters:

uploadToken - A String identifying the upload transaction.

Returns:

The uploaded Binary, or null if the implementation does not support the direct upload feature.

Throws:

RepositoryException - if another error occurs.

createBinary

@Nullable
public @Nullable Binary createBinary(Blob blob)
                                        throws RepositoryException

Throws:

RepositoryException

getBlob

@Nullable
public @Nullable Blob getBlob(Binary binary)
                                 throws RepositoryException

Throws:

RepositoryException