你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

FileRequestOptions 类

包:

com.microsoft.azure.storage.file

• java.lang.Object
• • RequestOptions
  • • com.microsoft.azure.storage.file.FileRequestOptions

public class FileRequestOptions extends RequestOptions

表示可在请求上指定的一组选项。

构造函数摘要

构造函数	说明
FileRequestOptions()	创建 类的实例。
FileRequestOptions(final FileRequestOptions other)	通过从另一个实例复制值来创建 类的实例。

方法摘要

修饰符和类型	方法和描述
void	applyDefaults(final FileRequestOptions modifiedOptions) 将默认值应用于传入的选项。
Integer	getConcurrentRequestCount() 获取每个操作同时请求的并发数。 有关并发请求计数默认值的详细信息，请参阅 setConcurrentRequestCount(final Integer concurrentRequestCount)。
Boolean	getDisableContentMD5Validation() 获取下载 和 FileInputStream 方法是否应忽略文件的 ContentMD5 标头。 有关禁用内容 MD5 验证默认值的详细信息，请参阅 setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
Boolean	getStoreFileContentMD5() 获取是否应在上传时设置文件的 ContentMD5 标头。 有关存储文件内容 MD5 默认值的详细信息，请参阅 setStoreFileContentMD5(final Boolean storeFileContentMD5) 。
Boolean	getUseTransactionalContentMD5() 获取范围 PUT 或 GET 操作是否将使用 Content-MD5 标头来强制实施事务安全性。 所有部分文件上传或下载将限制为 4 MB。 有关事务性内容 MD5 默认值的详细信息，请参阅 setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)。
final FileRequestOptions	populateAndApplyDefaults(final FileRequestOptions options, final CloudFileClient client) 如果 ，则使用来自指定客户端的并发请求计数，为其他所有内容设置默认值，并按父类中的定义设置默认值。
final FileRequestOptions	populateAndApplyDefaults(final FileRequestOptions options, final CloudFileClient client, final boolean setStartTime) 如果 ，则使用来自指定客户端的并发请求计数，为其他所有内容设置默认值，并按父类中的定义设置默认值。
void	setConcurrentRequestCount(final Integer concurrentRequestCount) 设置每个操作的并发请求数。 默认并发请求计数在客户端中设置，默认为 1，表示不并发。 可以通过设置此属性更改此请求的并发请求计数。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该并发请求计数。
void	setDisableContentMD5Validation(final Boolean disableContentMD5Validation) 设置下载 和 FileInputStream 方法是否应忽略文件的 ContentMD5 标头。 默认 disableContentMD5Validation 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 disableContentMD5Validation 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 disableContentMD5Validation 值。
final void	setLocationMode(final LocationMode locationMode) LocationMode设置此请求的 。 默认 LocationMode 在客户端中设置，默认为 PRIMARY_ONLY。 可以通过设置此属性来更改 LocationMode 此请求的 。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 LocationMode。
void	setRequireEncryption(Boolean requireEncryption) 文件不支持加密。
void	setStoreFileContentMD5(final Boolean storeFileContentMD5) 设置是否应在上传时设置文件的 ContentMD5 标头。 默认 storeFileContentMD5 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 storeFileContentMD5 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 storeFileContentMD5 值。
void	setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5) 设置范围 PUT 或 GET 操作是使用 Content-MD5 标头来强制实施事务安全性。 默认 useTransactionalContentMD5 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 useTransactionalContentMD5 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用使用TransactionalContentMD5 值。

继承成员

RequestOptions.applyBaseDefaultsInternal(final RequestOptions modifiedOptions) RequestOptions.disableHttpsSocketKeepAlive() RequestOptions.getLocationMode() RequestOptions.getMaximumExecutionTimeInMs() RequestOptions.getOperationExpiryTimeInMs() RequestOptions.getRetryPolicyFactory() RequestOptions.getTimeoutIntervalInMs() RequestOptions.populateRequestOptions(RequestOptions modifiedOptions, final RequestOptions clientOptions, final boolean setStartTime) RequestOptions.RequestOptions() RequestOptions.RequestOptions(final RequestOptions other) RequestOptions.requireEncryption() RequestOptions.setDisableHttpsSocketKeepAlive(Boolean disableHttpsSocketKeepAlive) RequestOptions.setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs) RequestOptions.setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory) RequestOptions.setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)

构造函数详细信息

FileRequestOptions

public FileRequestOptions()

创建 类的实例。

FileRequestOptions

public FileRequestOptions(final FileRequestOptions other)

通过从另一个实例复制值来创建 类的实例。

参数:

other - 一个 FileRequestOptions 对象，表示要复制的文件请求选项。

方法详细信息

applyDefaults

protected static void applyDefaults(final FileRequestOptions modifiedOptions)

将默认值应用于传入的选项。

参数:

modifiedOptions - 要应用的选项默认为 。

getConcurrentRequestCount

public Integer getConcurrentRequestCount()

获取每个操作同时请求的并发数。 有关并发请求计数默认值的详细信息，请参阅 setConcurrentRequestCount(final Integer concurrentRequestCount)。

返回:

concurrentRequestCount

getDisableContentMD5Validation

public Boolean getDisableContentMD5Validation()

获取下载 和 FileInputStream 方法是否应忽略文件的 ContentMD5 标头。 有关禁用内容 MD5 验证默认值的详细信息，请参阅 setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

返回:

disableContentMD5Validation

getStoreFileContentMD5

public Boolean getStoreFileContentMD5()

获取是否应在上传时设置文件的 ContentMD5 标头。 有关存储文件内容 MD5 默认值的详细信息，请参阅 setStoreFileContentMD5(final Boolean storeFileContentMD5) 。

返回:

storeFileContentMD5

getUseTransactionalContentMD5

public Boolean getUseTransactionalContentMD5()

获取范围 PUT 或 GET 操作是否将使用 Content-MD5 标头来强制实施事务安全性。 所有部分文件上传或下载将限制为 4 MB。 有关事务性内容 MD5 默认值的详细信息，请参阅 setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)。

返回:

useTransactionalContentMD5

populateAndApplyDefaults

protected static final FileRequestOptions populateAndApplyDefaults(final FileRequestOptions options, final CloudFileClient client)

如果 ，则使用来自指定客户端的并发请求计数，为其他所有内容设置默认值，并按父类中的定义设置默认值。

参数:

options - 应用默认值时要从中复制的输入选项

client - 一个 CloudFileClient 对象，表示用于设置默认超时间隔和重试策略的服务客户端（如果为 null）。 此外， 的 concurrentRequestCount 默认值为 1。

populateAndApplyDefaults

protected static final FileRequestOptions populateAndApplyDefaults(final FileRequestOptions options, final CloudFileClient client, final boolean setStartTime)

如果 ，则使用来自指定客户端的并发请求计数，为其他所有内容设置默认值，并按父类中的定义设置默认值。

参数:

options - 应用默认值时要从中复制的输入选项

client - 一个 CloudFileClient 对象，表示用于设置默认超时间隔和重试策略的服务客户端（如果为 null）。 此外， 的 concurrentRequestCount 默认值为 1。

setStartTime - 是否初始化 startTimeInMs 字段

setConcurrentRequestCount

public void setConcurrentRequestCount(final Integer concurrentRequestCount)

设置每个操作的并发请求数。

默认并发请求计数在客户端中设置，默认为 1，表示不并发。 可以通过设置此属性更改此请求的并发请求计数。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该并发请求计数。

参数:

concurrentRequestCount - 要设置的 concurrentRequestCount

setDisableContentMD5Validation

public void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

设置下载 和 FileInputStream 方法是否应忽略文件的 ContentMD5 标头。

默认 disableContentMD5Validation 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 disableContentMD5Validation 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 disableContentMD5Validation 值。

参数:

disableContentMD5Validation - 要设置的 disableContentMD5Validation

setLocationMode

public final void setLocationMode(final LocationMode locationMode)

LocationMode设置此请求的 。

默认 LocationMode 在客户端中设置，默认为 PRIMARY_ONLY。 可以通过设置此属性来更改 LocationMode 此请求的 。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 LocationMode。

参数:

locationMode - 要设置的 locationMode

setRequireEncryption

public void setRequireEncryption(Boolean requireEncryption)

文件不支持加密。

参数:

requireEncryption - 一个 值，该值指示是否必须加密写入和读取的所有数据。

setStoreFileContentMD5

public void setStoreFileContentMD5(final Boolean storeFileContentMD5)

设置是否应在上传时设置文件的 ContentMD5 标头。

默认 storeFileContentMD5 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 storeFileContentMD5 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用该 storeFileContentMD5 值。

参数:

storeFileContentMD5 - 要设置的 storeFileContentMD5

setUseTransactionalContentMD5

public void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

设置范围 PUT 或 GET 操作是使用 Content-MD5 标头来强制实施事务安全性。

默认 useTransactionalContentMD5 值在客户端中设置，默认情况下为 。 可以通过设置此属性更改此请求的 useTransactionalContentMD5 值。 还可以更改 对象上的 getDefaultRequestOptions() 值，以便通过服务客户端发出的所有后续请求都将使用使用TransactionalContentMD5 值。

参数:

useTransactionalContentMD5 - 使用TransactionalContentMD5 设置