[CONF] Apache Sling > Chunked File Upload Support

[confluence]

Chunked File Upload Support Page edited by Shashank Gupta Changes (4) ... h4. Upload of last chunk Client appends "/last" to upload url to signify that it would be last that needs to be uploaded. The last chunk upload request can optionally be multipart request if client requires to pass send additional parameters to sling. {code:title= Upload Last chunk request} Request: POST /content/dam/dam-folder/asset.pdf.chunkupload.html/parts/<part_number>/last /content/dam/dam-folder/asset.pdf.chunkupload.html/chunk/<chunk_number>/last HTTP/1.1 Host: localhost:4502 Date: <date> ... {code:title= Abort chunked upload Request} Request DELETE /content/dam/dam-folder/asset.pdf.multipartupload.html /content/dam/dam-folder/asset.pdf.chunkupload.html HTTP/1.1 Host: localhost:4502 Date: <date> {code} {code:title= Abort chunked Upload Response} upload response} Response HTTP/1.1 200/OK ... Full Content 1 Chunked File Upload 2 Use Cases: 3 Approach 4 Protocol Specification 4.1 Upload of first and intermediate chunks 4.2 Upload of last chunk 4.3 Query to retrieve last successful chunk upload 4.4 Abort chunked upload Chunked File Upload Status: DRAFT Created: 20. January 2013 Author: shgupta JIRA: SLING-2707 References: - http://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html Updated: - Use Cases: 1. Large file upload - With high speed internet connections, advent of cloud and HD going mainstream, Sling support large files (> 2GB) upload. 2. Fault tolerant uploads - Sling provides capability to resume upload from failure point. It doesn't require client to restart the complete upload process. Approach Sling provides an endpoint which accepts file chunks in accordance with a specified protocol. Sling client slices the file in chunks, and upload the chunks in serial manner to server. Each chunk is numbered serially and the last chunk has additional identifier to distinguish from the rest chunks. Sling endpoint upon receiving the last chunk, stitches all chunks into a single file. The file inputstream is passed to inner layers for further processing. In case of upload failures, sling provides support to query the last chunk uploaded till failure point. Client resumes chunk upload from last failure point. Protocol Specification Upload of first and intermediate chunks Upload the first/intermediate chunks Request: POST /content/dam/dam-folder/asset.pdf.chunkupload.html/chunk/<chunk_number> HTTP/1.1 Host: localhost:4502 Content-Type: Date: <date> Content-Length: 5242880 First/Intermediate chunkUpload Response Response: HTTP/1.1 200 OK Content-Length: 0 Connection: close Server: localhost:4502 Upload of last chunk Client appends "/last" to upload url to signify that it would be last that needs to be uploaded. The last chunk upload request can optionally be multipart request if client requires to send additional parameters to sling. Upload Last chunk request Request: POST /content/dam/dam-folder/asset.pdf.chunkupload.html/chunk/<chunk_number>/last HTTP/1.1 Host: localhost:4502 Date: <date> Content-type: multipart/form-data, boundary=AaB03x --AaB03x content-disposition: form-data; name="fileSize" 210000000 --AaB03x content-disposition: form-data; name="file"; fileName="asset.pdf" Content-Type: application/pdf Content-Transfer-Encoding: binary $binarydata --AaB03x-- Upload Last chunk Response Response: HTTP/1.1 201/CREATED Content-Length: 0 Content-MD5: <md5 checksum of the merged file> Connection: close Query to retrieve last successful chunk upload Returns the number of last chunk upload successfully on sling. Get last successful chunk upload request Request GET /content/dam/dam-folder/asset.pdf.chunkupload.html HTTP/1.1 Host: localhost:4502 Date: <date> Content-Length: 0 Get last successful upload chunk response Response: HTTP/1.1 200/OK Connection: close { "chunkNumber": 8 } If no broken/discontinued upload sling returns 500 error Get erroneous last successful upload chunk response Response: HTTP/1.1 404/Not Found Abort chunked upload Abort chunked upload Request Request DELETE /content/dam/dam-folder/asset.pdf.chunkupload.html HTTP/1.1 Host: localhost:4502 Date: <date> Abort chunked upload response Response HTTP/1.1 200/OK Connection: close Change Notification Preferences View Online | View Changes | Add Comment