[Jackrabbit Wiki] Update of "Direct Binary Access" by AlexanderKlimetschek

[Apache Wiki <wi...@apache.org>]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Jackrabbit Wiki" for change notification.

The "Direct Binary Access" page has been changed by AlexanderKlimetschek:
https://wiki.apache.org/jackrabbit/Direct%20Binary%20Access?action=diff&rev1=1&rev2=2

Comment:
add block diagram

  
  === Direct Binary Upload ===
  This feature allows a client application to upload a binary directly to a supported storage location via one or more URLs.  This is done in a three-step process.  First, the application calls a new JCR API, ''initiateHttpUpload(String, long, int)'', passing three arguments:  the path to the property where the users wishes to add the binary, the maximum expected or known size of the binary, and the maximum number of upload URLs that the client can support.  If the user has permission to add a property at the specified path, an object will be returned containing instructions to aid in completing the upload, including one or more URLs to use and an upload token that is required later.  Second, the client application may then use one or more of the provided URLs to upload the binary directly to the storage.  Multi-part uploads are supported and handled automatically if desired - all the client need do is upload chunks of the binary using the provided URLs in sequence.  When all the uploads are complete, the client then calls a new JCR API, ''completeHttpUpload(String)'', providing a signed upload token that was received in the original call to ''initiateHttpUpload()' and returning a ''Binary''.  Calling ''completeHttpUpload()'' notifies the storage provider of the upload parts to be assembled into a single binary object, and also allows that the corresponding property need not be created until after the binary upload is complete, at which point the returned ''Binary'' can be associated to the property.
+ 
+ {{attachment:oak-direct-binary-upload-block-diagram.png}}
  
  == Motivation ==