BlobRequestOptions Classe

Pacote:

com.microsoft.azure.storage.blob

• java.lang.Object
• • RequestOptions
  • • com.microsoft.azure.storage.blob.BlobRequestOptions

public class BlobRequestOptions extends RequestOptions

Representa um conjunto de opções que podem ser especificadas em uma solicitação.

Resumo do Construtor

Construtor	Description
BlobRequestOptions()	Cria uma instância da classe .
BlobRequestOptions(final BlobRequestOptions other)	Cria uma instância da classe copiando valores de outra instância.

Resumo do método

Modificador e tipo	Método e descrição
void	applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype) Aplica padrões às opções passadas.
void	assertNoEncryptionPolicyOrStrictMode() Afirme que, se a validação estiver ativada, uma política de criptografia não será especificada.
void	assertPolicyIfRequired() Afirme que, se o modo estrito estiver ativado, uma política de criptografia será especificada.
Boolean	getAbsorbConditionalErrorsOnRetry() Indica se uma falha condicional deve ser absorvida em uma tentativa de repetição para a solicitação. Para obter mais informações sobre como absorver erros conditinais em padrões de repetição, consulte setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).
boolean	getCommitWriteOnInputStreamException() Um que define o comportamento para lidar com exceções ao ler do e usando . Se os dados que foram lidos do fluxo até o ponto da exceção forem liberados e um novo blob for confirmado com esses dados. Caso contrário, o upload será anulado e nenhum dado será confirmado. Para obter mais informações sobre padrões, consulte setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).
Integer	getConcurrentRequestCount() Obtém o número simultâneo de solicitações simultâneas por operação. Para obter mais informações sobre os padrões de contagem de solicitações simultâneas, consulte setConcurrentRequestCount(final Integer concurrentRequestCount).
BlobCustomerProvidedKey	getCustomerProvidedKey() Obtém a chave fornecida pelo cliente a ser usada para essa solicitação.
Boolean	getDisableContentMD5Validation() Obtém se os métodos e BlobInputStream download devem ignorar o cabeçalho ContentMD5 do blob. Para obter mais informações sobre como desabilitar os padrões de validação MD5 de conteúdo, consulte setDisableContentMD5Validation(final Boolean disableContentMD5Validation)
BlobEncryptionPolicy	getEncryptionPolicy() Obtém a política de criptografia a ser usada para essa solicitação. Para obter mais informações sobre os padrões da política de criptografia, consulte setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).
Integer	getSingleBlobPutThresholdInBytes() Obtém o tamanho do limite usado para gravar um único blob. Para obter mais informações sobre os padrões de tamanho de limite, consulte setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).
boolean	getSkipEtagLocking() AVISO: o bloqueio de etag é usado automaticamente em downloads de blob para garantir que o blob não mude no meio do download. Ignore essa validação por sua conta e risco. Obtém se o bloqueio de etag e a validação em downloads de blob devem ser ignorados.
Boolean	getStoreBlobContentMD5() Obtém se o cabeçalho ContentMD5 do blob deve ser definido em uploads. Este campo não tem suporte para blobs de páginas. Para obter mais informações sobre como armazenar os padrões MD5 de conteúdo de blob, consulte setStoreBlobContentMD5(final Boolean storeBlobContentMD5)
Boolean	getUseTransactionalContentMD5() Obtém se uma operação PUT ou GET de intervalo usará o cabeçalho Content-MD5 para impor a segurança transacional. Todos os uploads ou downloads parciais de blob serão restritos a 4 MB. Para obter mais informações sobre os padrões MD5 de conteúdo transacional, consulte setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).
boolean	getValidateEncryptionPolicy() Obtém a chave fornecida pelo cliente a ser usada na origem para uma solicitação de cópia.
final BlobRequestOptions	populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client) Usa a contagem de solicitações simultâneas do cliente especificado se , define um valor padrão para todo o resto e define os padrões conforme definido na classe pai.
final BlobRequestOptions	populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime) Usa a contagem de solicitações simultâneas do cliente especificado se , define um valor padrão para todo o resto e define os padrões conforme definido na classe pai.
void	setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry) Define se uma falha condicional deve ser absorvida em uma tentativa de repetição para a solicitação. Essa opção só é usada pelos CloudAppendBlob métodos upload e openWrite. Por padrão, ele é definido como . Defina isso como apenas para o cenário de gravador único. Você pode alterar o valor absorbConditionalErrorsOnRetry nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor absorbConditionalErrorsOnRetry.
void	setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException) Um que define o comportamento para lidar com exceções ao ler do e usando . Se os dados que foram lidos do fluxo até o ponto da exceção forem liberados e um novo blob for confirmado com esses dados. Caso contrário, o upload será anulado e nenhum dado será confirmado. O valor padrão é .
void	setConcurrentRequestCount(final Integer concurrentRequestCount) Define o número simultâneo de solicitações simultâneas por operação. A contagem de solicitações simultâneas padrão é definida no cliente e é, por padrão, 1, indicando que não há simultaneidade. Você pode alterar a contagem de solicitações simultâneas nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem essa contagem de solicitações simultâneas.
void	setCustomerProvidedKey(BlobCustomerProvidedKey key) Define o objeto BlobCustomerProvidedKey a ser usado para essa solicitação. A criptografia de chave fornecida pelo cliente tem suporte para a maioria das solicitações de upload, download e cópia para o armazenamento de blobs, bem como busca de propriedades e metadados.
void	setDisableContentMD5Validation(final Boolean disableContentMD5Validation) Define se o download e BlobInputStream os métodos devem ignorar o cabeçalho ContentMD5 do blob. O valor padrão disableContentMD5Validation é definido no cliente e é por padrão . Você pode alterar o valor disableContentMD5Validation nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor disableContentMD5Validation.
void	setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy) Define o objeto BlobEncryptionPolicy a ser usado para essa solicitação. O BlobEncryptionPolicy padrão é definido no cliente e é nulo por padrão, indicando que não há criptografia. Você pode alterar o BlobEncryptionPolicy nesta solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse BlobEncryptionPolicy.
void	setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes) Define o tamanho do limite usado para gravar um único blob a ser usado. O tamanho do limite padrão é definido no cliente e é, por padrão, 32 MB. Você pode alterar o tamanho do limite nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse tamanho de limite.
void	setSkipEtagLocking(boolean skipEtagLocking) AVISO: o bloqueio de etag é usado automaticamente em downloads de blob para garantir que o blob não mude no meio do download. Ignore essa validação por sua conta e risco. Define se o bloqueio de etag e a validação em downloads de blob devem ser ignorados.
void	setStoreBlobContentMD5(final Boolean storeBlobContentMD5) Define se o cabeçalho ContentMD5 do blob deve ser definido em uploads. Este campo não tem suporte para blobs de páginas. O valor padrão storeBlobContentMD5 é definido no cliente e é, por padrão, para blobs de blocos. Você pode alterar o valor storeBlobContentMD5 nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor storeBlobContentMD5.
void	setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5) Define se uma operação PUT ou GET de intervalo usará o cabeçalho Content-MD5 para impor a segurança transacional. Todos os uploads ou downloads parciais de blob serão restritos a 4 MB. O valor padrão useTransactionalContentMD5 é definido no cliente e é por padrão . Você pode alterar o valor useTransactionalContentMD5 nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor useTransactionalContentMD5.
void	setValidateEncryptionPolicy(boolean validateEncryptionPolicy) Define o objeto BlobCustomerProvidedKey a ser usado para um blob de origem. A criptografia de chave fornecida pelo cliente tem suporte para a maioria das solicitações de upload, download e cópia para o armazenamento de blobs, bem como busca de propriedades e metadados.

Membros herdados

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.setLocationMode(final LocationMode locationMode) RequestOptions.setMaximumExecutionTimeInMs(Integer maximumExecutionTimeInMs) RequestOptions.setRequireEncryption(Boolean requireEncryption) RequestOptions.setRetryPolicyFactory(final RetryPolicyFactory retryPolicyFactory) RequestOptions.setTimeoutIntervalInMs(final Integer timeoutIntervalInMs)

Detalhes do construtor

BlobRequestOptions

public BlobRequestOptions()

Cria uma instância da classe .

BlobRequestOptions

public BlobRequestOptions(final BlobRequestOptions other)

Cria uma instância da classe copiando valores de outra instância.

Parâmetros:

other - Um BlobRequestOptions objeto que representa as opções de solicitação de blob a serem copiadas.

Detalhes do método

applyDefaults

protected static void applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)

Aplica padrões às opções passadas.

Parâmetros:

modifiedOptions - As opções a serem aplicadas por padrão.

blobtype

assertNoEncryptionPolicyOrStrictMode

protected void assertNoEncryptionPolicyOrStrictMode()

Afirme que, se a validação estiver ativada, uma política de criptografia não será especificada.

assertPolicyIfRequired

protected void assertPolicyIfRequired()

Afirme que, se o modo estrito estiver ativado, uma política de criptografia será especificada.

getAbsorbConditionalErrorsOnRetry

public Boolean getAbsorbConditionalErrorsOnRetry()

Indica se uma falha condicional deve ser absorvida em uma tentativa de repetição para a solicitação. Para obter mais informações sobre como absorver erros conditinais em padrões de repetição, consulte setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).

Retornos:

o absorbConditionalErrorsOnRetry

getCommitWriteOnInputStreamException

public boolean getCommitWriteOnInputStreamException()

Um que define o comportamento para lidar com exceções ao ler do e usando . Se os dados que foram lidos do fluxo até o ponto da exceção forem liberados e um novo blob for confirmado com esses dados. Caso contrário, o upload será anulado e nenhum dado será confirmado.

Para obter mais informações sobre padrões, consulte setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).

Retornos:

true se os dados serão confirmados após uma exceção; caso contrário, false.

getConcurrentRequestCount

public Integer getConcurrentRequestCount()

Obtém o número simultâneo de solicitações simultâneas por operação. Para obter mais informações sobre os padrões de contagem de solicitações simultâneas, consulte setConcurrentRequestCount(final Integer concurrentRequestCount).

Retornos:

o concurrentRequestCount

getCustomerProvidedKey

public BlobCustomerProvidedKey getCustomerProvidedKey()

Obtém a chave fornecida pelo cliente a ser usada para essa solicitação.

Retornos:

Um BlobCustomerProvidedKey objeto que representa a chave atual fornecida pelo cliente.

getDisableContentMD5Validation

public Boolean getDisableContentMD5Validation()

Obtém se os métodos e BlobInputStream download devem ignorar o cabeçalho ContentMD5 do blob. Para obter mais informações sobre como desabilitar os padrões de validação MD5 de conteúdo, consulte setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Retornos:

disableContentMD5Validation

getEncryptionPolicy

public BlobEncryptionPolicy getEncryptionPolicy()

Obtém a política de criptografia a ser usada para essa solicitação. Para obter mais informações sobre os padrões da política de criptografia, consulte setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).

Retornos:

Um BlobEncryptionPolicy objeto que representa a política de criptografia atual.

getSingleBlobPutThresholdInBytes

public Integer getSingleBlobPutThresholdInBytes()

Obtém o tamanho do limite usado para gravar um único blob. Para obter mais informações sobre os padrões de tamanho de limite, consulte setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).

Retornos:

O tamanho máximo, em bytes, de um blob que pode ser carregado como um único blob, variando de 1 a 64 MB, inclusive. Se um tamanho de blob estiver acima do limite, ele será carregado como blocos.

getSkipEtagLocking

public boolean getSkipEtagLocking()

AVISO: o bloqueio de etag é usado automaticamente em downloads de blob para garantir que o blob não mude no meio do download. Ignore essa validação por sua conta e risco.

Obtém se o bloqueio de etag e a validação em downloads de blob devem ser ignorados.

Retornos:

true se ignorar estiver habilitado; caso contrário, false.

getStoreBlobContentMD5

public Boolean getStoreBlobContentMD5()

Obtém se o cabeçalho ContentMD5 do blob deve ser definido em uploads. Este campo não tem suporte para blobs de páginas. Para obter mais informações sobre como armazenar os padrões MD5 de conteúdo de blob, consulte setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Retornos:

o storeBlobContentMD5

getUseTransactionalContentMD5

public Boolean getUseTransactionalContentMD5()

Obtém se uma operação PUT ou GET de intervalo usará o cabeçalho Content-MD5 para impor a segurança transacional. Todos os uploads ou downloads parciais de blob serão restritos a 4 MB. Para obter mais informações sobre os padrões MD5 de conteúdo transacional, consulte setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).

Retornos:

o useTransactionalContentMD5

getValidateEncryptionPolicy

protected boolean getValidateEncryptionPolicy()

Obtém a chave fornecida pelo cliente a ser usada na origem para uma solicitação de cópia.

Retornos:

Um BlobCustomerProvidedKey objeto que representa a chave fornecida pelo cliente da origem. Obtém um valor para indicar se a presença da política de criptografia deve ser validada.

populateAndApplyDefaults

protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client)

Usa a contagem de solicitações simultâneas do cliente especificado se , define um valor padrão para todo o resto e define os padrões conforme definido na classe pai.

Parâmetros:

options - As opções de entrada a serem copiadas ao aplicar padrões

blobType - BlobType da operação atual

client - Um CloudBlobClient objeto que representa o cliente de serviço usado para definir o intervalo de tempo limite padrão e a política de repetição, se eles forem null. Além disso, o valor padrão de concurrentRequestCount é 1.

populateAndApplyDefaults

protected static final BlobRequestOptions populateAndApplyDefaults(final BlobRequestOptions options, final BlobType blobType, final CloudBlobClient client, final boolean setStartTime)

Usa a contagem de solicitações simultâneas do cliente especificado se , define um valor padrão para todo o resto e define os padrões conforme definido na classe pai.

Parâmetros:

options - As opções de entrada a serem copiadas ao aplicar padrões

blobType - BlobType da operação atual

client - Um CloudBlobClient objeto que representa o cliente de serviço usado para definir o intervalo de tempo limite padrão e a política de repetição, se eles forem null. Além disso, o valor padrão de concurrentRequestCount é 1.

setStartTime - se o campo startTimeInMs deve ser inicializado ou não

setAbsorbConditionalErrorsOnRetry

public void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)

Define se uma falha condicional deve ser absorvida em uma tentativa de repetição para a solicitação. Essa opção só é usada pelos CloudAppendBlob métodos upload e openWrite. Por padrão, ele é definido como . Defina isso como apenas para o cenário de gravador único.

Você pode alterar o valor absorbConditionalErrorsOnRetry nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor absorbConditionalErrorsOnRetry.

Parâmetros:

absorbConditionalErrorsOnRetry - o absorbConditionalErrorsOnRetry a ser definido

setCommitWriteOnInputStreamException

public void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)

Um que define o comportamento para lidar com exceções ao ler do e usando . Se os dados que foram lidos do fluxo até o ponto da exceção forem liberados e um novo blob for confirmado com esses dados. Caso contrário, o upload será anulado e nenhum dado será confirmado.

O valor padrão é .

Parâmetros:

commitWriteOnInputStreamException - Use true se os dados forem confirmados em uma exceção; caso contrário, false.

setConcurrentRequestCount

public void setConcurrentRequestCount(final Integer concurrentRequestCount)

Define o número simultâneo de solicitações simultâneas por operação.

A contagem de solicitações simultâneas padrão é definida no cliente e é, por padrão, 1, indicando que não há simultaneidade. Você pode alterar a contagem de solicitações simultâneas nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem essa contagem de solicitações simultâneas.

Parâmetros:

concurrentRequestCount - o concurrentRequestCount a ser definido

setCustomerProvidedKey

public void setCustomerProvidedKey(BlobCustomerProvidedKey key)

Define o objeto BlobCustomerProvidedKey a ser usado para essa solicitação. A criptografia de chave fornecida pelo cliente tem suporte para a maioria das solicitações de upload, download e cópia para o armazenamento de blobs, bem como busca de propriedades e metadados.

Parâmetros:

key - o objeto BlobCustomerProvidedKey a ser usado ao fazer solicitações de serviço.

setDisableContentMD5Validation

public void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Define se o download e BlobInputStream os métodos devem ignorar o cabeçalho ContentMD5 do blob.

O valor padrão disableContentMD5Validation é definido no cliente e é por padrão . Você pode alterar o valor disableContentMD5Validation nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor disableContentMD5Validation.

Parâmetros:

disableContentMD5Validation - o disableContentMD5Validation a ser definido

setEncryptionPolicy

public void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)

Define o objeto BlobEncryptionPolicy a ser usado para essa solicitação.

O BlobEncryptionPolicy padrão é definido no cliente e é nulo por padrão, indicando que não há criptografia. Você pode alterar o BlobEncryptionPolicy nesta solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse BlobEncryptionPolicy.

Parâmetros:

encryptionPolicy - o objeto BlobEncryptionPolicy a ser usado ao fazer solicitações de serviço.

setSingleBlobPutThresholdInBytes

public void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)

Define o tamanho do limite usado para gravar um único blob a ser usado.

O tamanho do limite padrão é definido no cliente e é, por padrão, 32 MB. Você pode alterar o tamanho do limite nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse tamanho de limite.

Parâmetros:

singleBlobPutThresholdInBytes - O tamanho máximo, em bytes, de um blob que pode ser carregado como um único blob, variando de 1 MB a 64 MB, inclusive. Se um tamanho de blob estiver acima do limite, ele será carregado como blocos.

Gera:

IllegalArgumentException - Se minimumReadSize for menor que 1 MB ou maior que 64 MB.

setSkipEtagLocking

public void setSkipEtagLocking(boolean skipEtagLocking)

AVISO: o bloqueio de etag é usado automaticamente em downloads de blob para garantir que o blob não mude no meio do download. Ignore essa validação por sua conta e risco.

Define se o bloqueio de etag e a validação em downloads de blob devem ser ignorados.

Parâmetros:

skipEtagLocking - Use true para ignorar o bloqueio e a validação de etag; caso contrário, false.

setStoreBlobContentMD5

public void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Define se o cabeçalho ContentMD5 do blob deve ser definido em uploads. Este campo não tem suporte para blobs de páginas.

O valor padrão storeBlobContentMD5 é definido no cliente e é, por padrão, para blobs de blocos. Você pode alterar o valor storeBlobContentMD5 nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem esse valor storeBlobContentMD5.

Parâmetros:

storeBlobContentMD5 - o storeBlobContentMD5 a ser definido

setUseTransactionalContentMD5

public void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

Define se uma operação PUT ou GET de intervalo usará o cabeçalho Content-MD5 para impor a segurança transacional. Todos os uploads ou downloads parciais de blob serão restritos a 4 MB.

O valor padrão useTransactionalContentMD5 é definido no cliente e é por padrão . Você pode alterar o valor useTransactionalContentMD5 nessa solicitação definindo essa propriedade. Você também pode alterar o valor no getDefaultRequestOptions() objeto para que todas as solicitações subsequentes feitas por meio do cliente de serviço usem o valor useTransactionalContentMD5.

Parâmetros:

useTransactionalContentMD5 - o useTransactionalContentMD5 para definir

setValidateEncryptionPolicy

protected void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)

Define o objeto BlobCustomerProvidedKey a ser usado para um blob de origem. A criptografia de chave fornecida pelo cliente tem suporte para a maioria das solicitações de upload, download e cópia para o armazenamento de blobs, bem como busca de propriedades e metadados.

Parâmetros:

validateEncryptionPolicy - Use true para exigir validação; caso contrário, false.