FileReadHeaders Class
- java.
lang. Object - com.
azure. storage. file. datalake. models. FileReadHeaders
- com.
public final class FileReadHeaders
Defines headers for Read operation.
Constructor Summary
Constructor | Description | |
---|---|---|
FileReadHeaders() |
Method Summary
Modifier and Type | Method and Description |
---|---|
String |
getAcceptRanges()
Get the accept |
List<Path |
getAccessControlList()
Optional. |
String |
getCacheControl()
Get the cache |
String |
getClientRequestId()
Get the client |
byte[] |
getContentCrc64()
Get the content |
String |
getContentDisposition()
Get the content |
String |
getContentEncoding()
Get the content |
String |
getContentLanguage()
Get the content |
Long |
getContentLength()
Get the content |
byte[] |
getContentMd5()
Get the content |
String |
getContentRange()
Get the content |
String |
getContentType()
Get the content |
Offset |
getCopyCompletionTime()
Get the copy |
String |
getCopyId()
Get the copy |
String |
getCopyProgress()
Get the copy |
String |
getCopySource()
Get the copy |
Copy |
getCopyStatus()
Get the copy |
String |
getCopyStatusDescription()
Get the copy |
Offset |
getCreationTime()
Get the creation |
Offset |
getDateProperty()
Get the date |
String |
getETag()
Get the e |
String |
getEncryptionContext()
Get the encryption |
String |
getEncryptionKeySha256()
Get the encryption |
String |
getErrorCode()
Get the error |
byte[] |
getFileContentMd5()
Get the file |
Offset |
getLastModified()
Get the last |
Lease |
getLeaseDuration()
Get the lease |
Lease |
getLeaseState()
Get the lease |
Lease |
getLeaseStatus()
Get the lease |
Map<String,String> |
getMetadata()
Get the metadata property: The metadata property. |
String |
getRequestId()
Get the request |
String |
getVersion()
Get the version property: Indicates the version of the Blob service used to execute the request. |
Boolean |
isServerEncrypted()
Get the is |
File |
setAcceptRanges(String acceptRanges)
Set the accept |
File |
setAccessControlList(List<PathAccessControlEntry> accessControlList)
Optional. |
File |
setCacheControl(String cacheControl)
Set the cache |
File |
setClientRequestId(String clientRequestId)
Set the client |
File |
setContentCrc64(byte[] contentCrc64)
Set the content |
File |
setContentDisposition(String contentDisposition)
Set the content |
File |
setContentEncoding(String contentEncoding)
Set the content |
File |
setContentLanguage(String contentLanguage)
Set the content |
File |
setContentLength(Long contentLength)
Set the content |
File |
setContentMd5(byte[] contentMd5)
Set the content |
File |
setContentRange(String contentRange)
Set the content |
File |
setContentType(String contentType)
Set the content |
File |
setCopyCompletionTime(OffsetDateTime copyCompletionTime)
Set the copy |
File |
setCopyId(String copyId)
Set the copy |
File |
setCopyProgress(String copyProgress)
Set the copy |
File |
setCopySource(String copySource)
Set the copy |
File |
setCopyStatus(CopyStatusType copyStatus)
Set the copy |
File |
setCopyStatusDescription(String copyStatusDescription)
Set the copy |
File |
setCreationTime(OffsetDateTime creationTime)
Set the creation |
File |
setDateProperty(OffsetDateTime dateProperty)
Set the date |
File |
setETag(String eTag)
Set the e |
File |
setEncryptionContext(String encryptionContext)
Encryption context that can be set on the file. |
File |
setEncryptionKeySha256(String encryptionKeySha256)
Set the encryption |
File |
setErrorCode(String errorCode)
Set the error |
File |
setFileContentMd5(byte[] fileContentMd5)
Set the file |
File |
setLastModified(OffsetDateTime lastModified)
Set the last |
File |
setLeaseDuration(LeaseDurationType leaseDuration)
Set the lease |
File |
setLeaseState(LeaseStateType leaseState)
Set the lease |
File |
setLeaseStatus(LeaseStatusType leaseStatus)
Set the lease |
File |
setMetadata(Map<String,String> metadata)
Set the metadata property: The metadata property. |
File |
setRequestId(String requestId)
Set the request |
File |
setServerEncrypted(Boolean serverEncrypted)
Set the is |
File |
setVersion(String version)
Set the version property: Indicates the version of the Blob service used to execute the request. |
Methods inherited from java.lang.Object
Constructor Details
FileReadHeaders
public FileReadHeaders()
Method Details
getAcceptRanges
public String getAcceptRanges()
Get the acceptRanges property: Indicates that the service supports requests for partial file content.
Returns:
getAccessControlList
public List
Optional. The POSIX access control list for the file or directory.
Returns:
getCacheControl
public String getCacheControl()
Get the cacheControl property: This header is returned if it was previously specified for the file.
Returns:
getClientRequestId
public String getClientRequestId()
Get the clientRequestId property: If a client request id header is sent in the request, this header will be present in the response with the same value.
Returns:
getContentCrc64
public byte[] getContentCrc64()
Get the contentCrc64 property: If the request is to read a specified range and the x-ms-range-get-content-crc64 is set to true, then the request returns a crc64 for the range, as long as the range size is less than or equal to 4 MB. If both x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is specified in the same request, it will fail with 400(Bad Request).
Returns:
getContentDisposition
public String getContentDisposition()
Get the contentDisposition property: This header returns the value that was specified for the 'x-ms-blob-content-disposition' header. The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the file name specified.
Returns:
getContentEncoding
public String getContentEncoding()
Get the contentEncoding property: This header returns the value that was specified for the Content-Encoding request header.
Returns:
getContentLanguage
public String getContentLanguage()
Get the contentLanguage property: This header returns the value that was specified for the Content-Language request header.
Returns:
getContentLength
public Long getContentLength()
Get the contentLength property: The number of bytes present in the response body.
Returns:
getContentMd5
public byte[] getContentMd5()
Get the contentMd5 property: If the file has an MD5 hash and this operation is to read the full file, this response header is returned so that the client can check for message content integrity.
Returns:
getContentRange
public String getContentRange()
Get the contentRange property: Indicates the range of bytes returned in the event that the client requested a subset of the file by setting the 'Range' request header.
Returns:
getContentType
public String getContentType()
Get the contentType property: The media type of the body of the response. For Download Blob this is 'application/octet-stream'.
Returns:
getCopyCompletionTime
public OffsetDateTime getCopyCompletionTime()
Get the copyCompletionTime property: Conclusion time of the last attempted Copy Blob operation where this file was the destination file. This value can specify the time of a completed, aborted, or failed copy attempt. This header does not appear if a copy is pending, if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Returns:
getCopyId
public String getCopyId()
Get the copyId property: String identifier for this copy operation. Use with Get Blob Properties to check the status of this copy operation, or pass to Abort Copy Blob to abort a pending copy.
Returns:
getCopyProgress
public String getCopyProgress()
Get the copyProgress property: Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this file was the destination file. Can show between 0 and Content-Length bytes copied. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Returns:
getCopySource
public String getCopySource()
Get the copySource property: URL up to 2 KB in length that specifies the source file or file used in the last attempted Copy Blob operation where this file was the destination file. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Returns:
getCopyStatus
public CopyStatusType getCopyStatus()
Get the copyStatus property: State of the copy operation identified by x-ms-copy-id. Possible values include: 'pending', 'success', 'aborted', 'failed'.
Returns:
getCopyStatusDescription
public String getCopyStatusDescription()
Get the copyStatusDescription property: Only appears when x-ms-copy-status is failed or pending. Describes the cause of the last fatal or non-fatal copy operation failure. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Returns:
getCreationTime
public OffsetDateTime getCreationTime()
Get the creationTime property: The x-ms-creation-time property.
Returns:
getDateProperty
public OffsetDateTime getDateProperty()
Get the dateProperty property: UTC date/time value generated by the service that indicates the time at which the response was initiated.
Returns:
getETag
public String getETag()
Get the eTag property: The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Returns:
getEncryptionContext
public String getEncryptionContext()
Get the encryptionContext property: Encryption context for this path.
Returns:
getEncryptionKeySha256
public String getEncryptionKeySha256()
Get the encryptionKeySha256 property: The SHA-256 hash of the encryption key used to encrypt the file. This header is only returned when the file was encrypted with a customer-provided key.
Returns:
getErrorCode
public String getErrorCode()
Get the errorCode property: The errorCode property.
Returns:
getFileContentMd5
public byte[] getFileContentMd5()
Get the fileContentMD5 property: If the file has a MD5 hash, and if request contains range header (Range or x-ms-range), this response header is returned with the value of the whole file's MD5 value. This value may or may not be equal to the value returned in Content-MD5 header, with the latter calculated from the requested range.
Returns:
getLastModified
public OffsetDateTime getLastModified()
Get the lastModified property: Returns the date and time the container was last modified. Any operation that modifies the file, including an update of the file's metadata or properties, changes the last-modified time of the file.
Returns:
getLeaseDuration
public LeaseDurationType getLeaseDuration()
Get the leaseDuration property: When a file is leased, specifies whether the lease is of infinite or fixed duration. Possible values include: 'infinite', 'fixed'.
Returns:
getLeaseState
public LeaseStateType getLeaseState()
Get the leaseState property: Lease state of the file. Possible values include: 'available', 'leased', 'expired', 'breaking', 'broken'.
Returns:
getLeaseStatus
public LeaseStatusType getLeaseStatus()
Get the leaseStatus property: The current lease status of the file. Possible values include: 'locked', 'unlocked'.
Returns:
getMetadata
public Map
Get the metadata property: The metadata property.
Returns:
getRequestId
public String getRequestId()
Get the requestId property: This header uniquely identifies the request that was made and can be used for troubleshooting the request.
Returns:
getVersion
public String getVersion()
Get the version property: Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
Returns:
isServerEncrypted
public Boolean isServerEncrypted()
Get the isServerEncrypted property: The value of this header is set to true if the file data and application metadata are completely encrypted using the specified algorithm. Otherwise, the value is set to false (when the file is unencrypted, or if only parts of the file/application metadata are encrypted).
Returns:
setAcceptRanges
public FileReadHeaders setAcceptRanges(String acceptRanges)
Set the acceptRanges property: Indicates that the service supports requests for partial file content.
Parameters:
Returns:
setAccessControlList
public FileReadHeaders setAccessControlList(List
Optional. The POSIX access control list for the file or directory.
Parameters:
Returns:
setCacheControl
public FileReadHeaders setCacheControl(String cacheControl)
Set the cacheControl property: This header is returned if it was previously specified for the file.
Parameters:
Returns:
setClientRequestId
public FileReadHeaders setClientRequestId(String clientRequestId)
Set the clientRequestId property: If a client request id header is sent in the request, this header will be present in the response with the same value.
Parameters:
Returns:
setContentCrc64
public FileReadHeaders setContentCrc64(byte[] contentCrc64)
Set the contentCrc64 property: If the request is to read a specified range and the x-ms-range-get-content-crc64 is set to true, then the request returns a crc64 for the range, as long as the range size is less than or equal to 4 MB. If both x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 is specified in the same request, it will fail with 400(Bad Request).
Parameters:
Returns:
setContentDisposition
public FileReadHeaders setContentDisposition(String contentDisposition)
Set the contentDisposition property: This header returns the value that was specified for the 'x-ms-blob-content-disposition' header. The Content-Disposition response header field conveys additional information about how to process the response payload, and also can be used to attach additional metadata. For example, if set to attachment, it indicates that the user-agent should not display the response, but instead show a Save As dialog with a filename other than the file name specified.
Parameters:
Returns:
setContentEncoding
public FileReadHeaders setContentEncoding(String contentEncoding)
Set the contentEncoding property: This header returns the value that was specified for the Content-Encoding request header.
Parameters:
Returns:
setContentLanguage
public FileReadHeaders setContentLanguage(String contentLanguage)
Set the contentLanguage property: This header returns the value that was specified for the Content-Language request header.
Parameters:
Returns:
setContentLength
public FileReadHeaders setContentLength(Long contentLength)
Set the contentLength property: The number of bytes present in the response body.
Parameters:
Returns:
setContentMd5
public FileReadHeaders setContentMd5(byte[] contentMd5)
Set the contentMd5 property: If the file has an MD5 hash and this operation is to read the full file, this response header is returned so that the client can check for message content integrity.
Parameters:
Returns:
setContentRange
public FileReadHeaders setContentRange(String contentRange)
Set the contentRange property: Indicates the range of bytes returned in the event that the client requested a subset of the file by setting the 'Range' request header.
Parameters:
Returns:
setContentType
public FileReadHeaders setContentType(String contentType)
Set the contentType property: The media type of the body of the response. For Download Blob this is 'application/octet-stream'.
Parameters:
Returns:
setCopyCompletionTime
public FileReadHeaders setCopyCompletionTime(OffsetDateTime copyCompletionTime)
Set the copyCompletionTime property: Conclusion time of the last attempted Copy Blob operation where this file was the destination file. This value can specify the time of a completed, aborted, or failed copy attempt. This header does not appear if a copy is pending, if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Parameters:
Returns:
setCopyId
public FileReadHeaders setCopyId(String copyId)
Set the copyId property: String identifier for this copy operation. Use with Get Blob Properties to check the status of this copy operation, or pass to Abort Copy Blob to abort a pending copy.
Parameters:
Returns:
setCopyProgress
public FileReadHeaders setCopyProgress(String copyProgress)
Set the copyProgress property: Contains the number of bytes copied and the total bytes in the source in the last attempted Copy Blob operation where this file was the destination file. Can show between 0 and Content-Length bytes copied. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Parameters:
Returns:
setCopySource
public FileReadHeaders setCopySource(String copySource)
Set the copySource property: URL up to 2 KB in length that specifies the source file or file used in the last attempted Copy Blob operation where this file was the destination file. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Parameters:
Returns:
setCopyStatus
public FileReadHeaders setCopyStatus(CopyStatusType copyStatus)
Set the copyStatus property: State of the copy operation identified by x-ms-copy-id. Possible values include: 'pending', 'success', 'aborted', 'failed'.
Parameters:
Returns:
setCopyStatusDescription
public FileReadHeaders setCopyStatusDescription(String copyStatusDescription)
Set the copyStatusDescription property: Only appears when x-ms-copy-status is failed or pending. Describes the cause of the last fatal or non-fatal copy operation failure. This header does not appear if this file has never been the destination in a Copy Blob operation, or if this file has been modified after a concluded Copy Blob operation using Set Blob Properties, Put Blob, or Put Block List.
Parameters:
Returns:
setCreationTime
public FileReadHeaders setCreationTime(OffsetDateTime creationTime)
Set the creationTime property: The x-ms-creation-time property.
Parameters:
Returns:
setDateProperty
public FileReadHeaders setDateProperty(OffsetDateTime dateProperty)
Set the dateProperty property: UTC date/time value generated by the service that indicates the time at which the response was initiated.
Parameters:
Returns:
setETag
public FileReadHeaders setETag(String eTag)
Set the eTag property: The ETag contains a value that you can use to perform operations conditionally. If the request version is 2011-08-18 or newer, the ETag value will be in quotes.
Parameters:
Returns:
setEncryptionContext
public FileReadHeaders setEncryptionContext(String encryptionContext)
Encryption context that can be set on the file. Encryption context is intended to store metadata that can be used to decrypt the blob.
Parameters:
Returns:
setEncryptionKeySha256
public FileReadHeaders setEncryptionKeySha256(String encryptionKeySha256)
Set the encryptionKeySha256 property: The SHA-256 hash of the encryption key used to encrypt the file. This header is only returned when the file was encrypted with a customer-provided key.
Parameters:
Returns:
setErrorCode
public FileReadHeaders setErrorCode(String errorCode)
Set the errorCode property: The errorCode property.
Parameters:
Returns:
setFileContentMd5
public FileReadHeaders setFileContentMd5(byte[] fileContentMd5)
Set the fileContentMD5 property: If the file has a MD5 hash, and if request contains range header (Range or x-ms-range), this response header is returned with the value of the whole file's MD5 value. This value may or may not be equal to the value returned in Content-MD5 header, with the latter calculated from the requested range.
Parameters:
Returns:
setLastModified
public FileReadHeaders setLastModified(OffsetDateTime lastModified)
Set the lastModified property: Returns the date and time the container was last modified. Any operation that modifies the file, including an update of the file's metadata or properties, changes the last-modified time of the file.
Parameters:
Returns:
setLeaseDuration
public FileReadHeaders setLeaseDuration(LeaseDurationType leaseDuration)
Set the leaseDuration property: When a file is leased, specifies whether the lease is of infinite or fixed duration. Possible values include: 'infinite', 'fixed'.
Parameters:
Returns:
setLeaseState
public FileReadHeaders setLeaseState(LeaseStateType leaseState)
Set the leaseState property: Lease state of the file. Possible values include: 'available', 'leased', 'expired', 'breaking', 'broken'.
Parameters:
Returns:
setLeaseStatus
public FileReadHeaders setLeaseStatus(LeaseStatusType leaseStatus)
Set the leaseStatus property: The current lease status of the file. Possible values include: 'locked', 'unlocked'.
Parameters:
Returns:
setMetadata
public FileReadHeaders setMetadata(Map
Set the metadata property: The metadata property.
Parameters:
Returns:
setRequestId
public FileReadHeaders setRequestId(String requestId)
Set the requestId property: This header uniquely identifies the request that was made and can be used for troubleshooting the request.
Parameters:
Returns:
setServerEncrypted
public FileReadHeaders setServerEncrypted(Boolean serverEncrypted)
Set the isServerEncrypted property: The value of this header is set to true if the file data and application metadata are completely encrypted using the specified algorithm. Otherwise, the value is set to false (when the file is unencrypted, or if only parts of the file/application metadata are encrypted).
Parameters:
Returns:
setVersion
public FileReadHeaders setVersion(String version)
Set the version property: Indicates the version of the Blob service used to execute the request. This header is returned for requests made against version 2009-09-19 and above.
Parameters:
Returns:
Applies to
Azure SDK for Java