Package org.trellisldp.spi

Interface BinaryService.Resolver

Enclosing interface:

BinaryService

public static interface BinaryService.Resolver

A blob resolver, used by the BinaryService

Method Summary

Modifier and Type	Method	Description
void	abortUpload(java.lang.String identifier)	Abort the upload for the given identifier
BinaryService.MultipartUpload	completeUpload(java.lang.String identifier, java.util.Map<java.lang.Integer,java.lang.String> partDigests)	Complete a multi-part upload
java.lang.Boolean	exists(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier)	Check whether the binary object exists
java.util.Optional<java.io.InputStream>	getContent(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier)	Get the content of the binary object
java.util.List<java.lang.String>	getUriSchemes()
java.lang.String	initiateUpload(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier, java.lang.String mimeType)	Initiate a multi-part upload
java.util.stream.Stream<java.util.Map.Entry<java.lang.Integer,java.lang.String>>	listParts(java.lang.String identifier)	List the uploaded parts
void	purgeContent(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier)	Remove the content from the datastore
default void	setContent(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier, java.io.InputStream stream)	Set the content of the binary object
void	setContent(java.lang.String partition, org.apache.commons.rdf.api.IRI identifier, java.io.InputStream stream, java.util.Map<java.lang.String,java.lang.String> metadata)	Set the content of the binary object
java.lang.Boolean	supportsMultipartUpload()	Test whether the resolver supports multipart uploads
java.lang.String	uploadPart(java.lang.String identifier, java.lang.Integer partNumber, java.io.InputStream content)	Upload a part
java.lang.Boolean	uploadSessionExists(java.lang.String identifier)	Test whether the provided identifier exists

Method Detail

getUriSchemes

java.util.List<java.lang.String> getUriSchemes()

Returns:

the uri schemes supported by this resolver

getContent

java.util.Optional<java.io.InputStream> getContent(java.lang.String partition,
                                                   org.apache.commons.rdf.api.IRI identifier)

Get the content of the binary object

Parameters:

partition - the partition to use

identifier - the identifier

Returns:

the content of the binary object

exists

java.lang.Boolean exists(java.lang.String partition,
                         org.apache.commons.rdf.api.IRI identifier)

Check whether the binary object exists

Parameters:

partition - the partition to use

identifier - the identifier

Returns:

whether the binary object exists

setContent

default void setContent(java.lang.String partition,
                        org.apache.commons.rdf.api.IRI identifier,
                        java.io.InputStream stream)

Set the content of the binary object

Parameters:

partition - the partition to use

identifier - the identifier

stream - the stream

setContent

void setContent(java.lang.String partition,
                org.apache.commons.rdf.api.IRI identifier,
                java.io.InputStream stream,
                java.util.Map<java.lang.String,java.lang.String> metadata)

Set the content of the binary object

Parameters:

partition - the partition to use

identifier - the identifier

stream - the content

metadata - any user metadata

purgeContent

void purgeContent(java.lang.String partition,
                  org.apache.commons.rdf.api.IRI identifier)

Remove the content from the datastore

Parameters:

partition - the partition to use

identifier - the identifier

supportsMultipartUpload

java.lang.Boolean supportsMultipartUpload()

Test whether the resolver supports multipart uploads

Returns:

true if the resolver supports multipart uploads; false otherwise

initiateUpload

java.lang.String initiateUpload(java.lang.String partition,
                                org.apache.commons.rdf.api.IRI identifier,
                                java.lang.String mimeType)

Initiate a multi-part upload

Parameters:

partition - the partition

identifier - the object identifier

mimeType - the mimeType of the object

Returns:

an upload session identifier

uploadPart

java.lang.String uploadPart(java.lang.String identifier,
                            java.lang.Integer partNumber,
                            java.io.InputStream content)

Upload a part

Parameters:

identifier - the upload identifier

partNumber - the part number

content - the content to upload

Returns:

a digest value returned for each part; this value is used later wich completeUpload()

completeUpload

BinaryService.MultipartUpload completeUpload(java.lang.String identifier,
                                             java.util.Map<java.lang.Integer,java.lang.String> partDigests)

Complete a multi-part upload

Parameters:

identifier - the upload identifier

partDigests - digest values for each part

Returns:

a multipart upload object

abortUpload

void abortUpload(java.lang.String identifier)

Abort the upload for the given identifier

Parameters:

identifier - the upload identifier

uploadSessionExists

java.lang.Boolean uploadSessionExists(java.lang.String identifier)

Test whether the provided identifier exists

Parameters:

identifier - the upload identifier

Returns:

true if the session exists; false otherwise

listParts

java.util.stream.Stream<java.util.Map.Entry<java.lang.Integer,java.lang.String>> listParts(java.lang.String identifier)

List the uploaded parts

Parameters:

identifier - the upload identifier

Returns:

a list of uploaded parts and their digests