Package org.trellisldp.http

Class MultipartUploader

java.lang.Object

org.trellisldp.http.MultipartUploader

All Implemented Interfaces:

javax.ws.rs.container.ContainerRequestFilter, javax.ws.rs.container.ContainerResponseFilter

@PreMatching
@Provider
@Priority(2010)
@Singleton
@Path("upload/{partition}/{id}")
public class MultipartUploader
extends java.lang.Object
implements javax.ws.rs.container.ContainerRequestFilter, javax.ws.rs.container.ContainerResponseFilter

Constructor Summary

Constructors

Constructor	Description
MultipartUploader(org.trellisldp.api.ResourceService resourceService, org.trellisldp.api.BinaryService binaryService, java.util.Map<java.lang.String,java.lang.String> partitions)	Create a multipart uploader object

Method Summary

Modifier and Type	Method	Description
void	abortUpload(java.lang.String partition, java.lang.String id)	Abort an upload process
javax.ws.rs.core.Response	createBinary(java.lang.String partition, java.lang.String id, java.io.InputStream input)	Create a binary from a collection of uploaded parts
void	filter(javax.ws.rs.container.ContainerRequestContext ctx)
void	filter(javax.ws.rs.container.ContainerRequestContext req, javax.ws.rs.container.ContainerResponseContext res)
java.lang.String	listUploads(java.lang.String partition, java.lang.String id)	Get a list of the uploads
java.lang.String	uploadPart(java.lang.String partition, java.lang.String id, java.lang.Integer partNumber, java.io.InputStream part)	Add a segment of a binary

Methods inherited from class java.lang.Object

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

Constructor Detail

MultipartUploader

public MultipartUploader(org.trellisldp.api.ResourceService resourceService,
                         org.trellisldp.api.BinaryService binaryService,
                         java.util.Map<java.lang.String,java.lang.String> partitions)

Create a multipart uploader object

Parameters:

resourceService - the resource service

binaryService - the binary service

partitions - the partition base URLs

Method Detail

filter

public void filter(javax.ws.rs.container.ContainerRequestContext ctx)
            throws java.io.IOException

Specified by:

filter in interface javax.ws.rs.container.ContainerRequestFilter

Throws:

java.io.IOException

filter

public void filter(javax.ws.rs.container.ContainerRequestContext req,
                   javax.ws.rs.container.ContainerResponseContext res)
            throws java.io.IOException

Specified by:

filter in interface javax.ws.rs.container.ContainerResponseFilter

Throws:

java.io.IOException

listUploads

@GET
@Timed
@Produces("application/json")
public java.lang.String listUploads(@PathParam("partition")
                                    java.lang.String partition,
                                    @PathParam("id")
                                    java.lang.String id)

Get a list of the uploads

Parameters:

partition - the partition

id - the upload id

Returns:

a response

Note: the response structure will be like this:

{
   "1": "somehash",
   "2": "otherhash",
   "3": "anotherhash"
 }

createBinary

@POST
@Timed
@Consumes("application/json")
public javax.ws.rs.core.Response createBinary(@PathParam("partition")
                                              java.lang.String partition,
                                              @PathParam("id")
                                              java.lang.String id,
                                              java.io.InputStream input)

Create a binary from a collection of uploaded parts

Parameters:

partition - the partition

id - the identifier

input - the input value

Returns:

a response

Note: The structure should be like this:

{
   "1": "somehash",
   "2": "otherhash",
   "3": "anotherhash"
 }

uploadPart

@PUT
@Timed
@Path("{partNumber}")
@Produces("application/json")
public java.lang.String uploadPart(@PathParam("partition")
                                   java.lang.String partition,
                                   @PathParam("id")
                                   java.lang.String id,
                                   @PathParam("partNumber")
                                   java.lang.Integer partNumber,
                                   java.io.InputStream part)

Add a segment of a binary

Parameters:

partition - the partition

id - the upload session identifier

partNumber - the part number

part - the input stream

Returns:

a response

Note: the response will be a json structure, such as:

{
    "digest": "a-hash"
  }

abortUpload

@DELETE
@Timed
public void abortUpload(@PathParam("partition")
                        java.lang.String partition,
                        @PathParam("id")
                        java.lang.String id)

Abort an upload process

Parameters:

partition - the partition

id - the upload identifier