|Modifier and Type||Method and Description|
Completes the transaction to perform a direct binary upload.
Return a URI for directly reading the binary associated with the provided
Begin a transaction to perform a direct binary upload to the storage location.
@Nullable @Nullable URI getDownloadURI(@NotNull @NotNull DataIdentifier identifier, @NotNull @NotNull DataRecordDownloadOptions downloadOptions)
The caller must provide a
DataRecordDownloadOptions instance that
will be used by the implementation to specify options on the download.
This can be obtained from a
BlobDownloadOptions instance by
or to accept the service provider default behavior a caller can simply
DataRecordcontaining the binary to be read via direct download.
DataRecordDownloadOptionsinstance used to specify any download options that should be set on this download.
nullif the URI cannot be generated, for example if the capability is disabled by configuration or if a service provider error occurs.
@Nullable @Nullable DataRecordUpload initiateDataRecordUpload(long maxUploadSizeInBytes, int maxNumberOfURIs) throws IllegalArgumentException, DataRecordUploadException
maxUploadSizeInBytes- - the largest size of the binary to be uploaded, in bytes, based on the caller's best guess. If the actual size of the file to be uploaded is known, that value should be used.
maxNumberOfURIs- - the maximum number of URIs the client is able to accept. If the caller does not support multi-part uploading, this value should be 1. Note that the implementing class is not required to support multi-part uploading so it may return only a single upload URI regardless of the value passed in for this parameter. A caller may also pass in -1 to indicate that it is able to accept any number of URIs. Any other negative number or 0 may result in
DataRecordUploadreferencing this direct upload, or
nullif the implementation does not support direct upload.
IllegalArgumentException- if the service provider or implementation cannot support the requested upload.
DataRecordUploadException- if the upload cannot be completed as requested.
@NotNull @NotNull DataRecord completeDataRecordUpload(@NotNull @NotNull String uploadToken) throws IllegalArgumentException, DataRecordUploadException, DataStoreException
uploadToken- The upload token identifying this direct upload transaction, as returned in the
DataRecordUploadobject resulting from a call to
DataRecordfor the uploaded binary.
IllegalArgumentException- if the
uploadTokenis null, empty, or otherwise invalid.
DataRecordUploadException- if the object written can't be found by the service provider.
DataStoreException- if the object written can't be found by the DataStore.
Copyright © 2012–2019 The Apache Software Foundation. All rights reserved.