Compartir a través de


BlobRequestOptions Clase

  • java.lang.Object

public class BlobRequestOptions extends RequestOptions

Representa un conjunto de opciones que se pueden especificar en una solicitud.

Resumen del constructor

Constructor Description
BlobRequestOptions()

Cree una instancia de la clase.

BlobRequestOptions(final BlobRequestOptions other)

Crea una instancia de la clase copiando valores de otra instancia.

Resumen del método

Modificador y tipo Método y descripción
void applyDefaults(final BlobRequestOptions modifiedOptions, final BlobType blobtype)

Aplica los valores predeterminados a las opciones pasadas.

void assertNoEncryptionPolicyOrStrictMode()

Confirme que si la validación está activada, no se especifica una directiva de cifrado.

void assertPolicyIfRequired()

Aserte que, si el modo strict está activado, se especifica una directiva de cifrado.

Boolean getAbsorbConditionalErrorsOnRetry()

Indica si se debe absorber un error condicional en un reintento para la solicitud. Para obtener más información sobre la absorción de errores de conditinal en los valores predeterminados de reintento, vea setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).

boolean getCommitWriteOnInputStreamException()

que define el comportamiento para controlar las excepciones al leer desde y mediante . Si los datos leídos desde la secuencia hasta el punto de la excepción se vaciarán y se confirmará un nuevo blob con esos datos. De lo contrario, se anulará la carga y no se confirmará ningún dato.

Para obtener más información sobre los valores predeterminados, vea setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).

Integer getConcurrentRequestCount()

Obtiene el número simultáneo de solicitudes simultáneas por operación. Para obtener más información sobre los valores predeterminados de recuento de solicitudes simultáneas, vea setConcurrentRequestCount(final Integer concurrentRequestCount).

BlobCustomerProvidedKey getCustomerProvidedKey()

Obtiene la clave proporcionada por el cliente que se usará para esta solicitud.

Boolean getDisableContentMD5Validation()

Obtiene si los métodos y BlobInputStream de descarga deben omitir el encabezado ContentMD5 del blob. Para obtener más información sobre cómo deshabilitar los valores predeterminados de validación md5 de contenido, consulte setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

BlobEncryptionPolicy getEncryptionPolicy()

Obtiene la directiva de cifrado que se va a usar para esta solicitud. Para obtener más información sobre los valores predeterminados de la directiva de cifrado, vea setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).

Integer getSingleBlobPutThresholdInBytes()

Obtiene el tamaño de umbral utilizado para escribir un único blob. Para obtener más información sobre los valores predeterminados de tamaño de umbral, vea setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).

boolean getSkipEtagLocking()

ADVERTENCIA: el bloqueo de etag se usa automáticamente en descargas de blobs para asegurarse de que el blob no cambia la descarga intermedia. Omita esta validación en su propio riesgo.

Obtiene si se debe omitir el bloqueo de etag y la validación en las descargas de blobs.

Boolean getStoreBlobContentMD5()

Obtiene si el encabezado ContentMD5 del blob debe establecerse en las cargas. Este campo no se admite para blobs en páginas. Para obtener más información sobre cómo almacenar los valores predeterminados de MD5 de contenido de blobs, consulte setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Boolean getUseTransactionalContentMD5()

Obtiene si una operación PUT o GET de rango usará el encabezado Content-MD5 para aplicar la seguridad transaccional. Todas las cargas o descargas de blobs parciales se restringirán a 4 MB. Para obtener más información sobre los valores predeterminados md5 de contenido transaccional, vea setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).

boolean getValidateEncryptionPolicy()

Obtiene la clave proporcionada por el cliente que se usará en el origen de una solicitud de copia.

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

Usa el recuento de solicitudes simultáneas del cliente especificado si , establece un valor predeterminado para todo lo demás y establece los valores predeterminados según se define en la clase primaria.

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

Usa el recuento de solicitudes simultáneas del cliente especificado si , establece un valor predeterminado para todo lo demás y establece los valores predeterminados según se define en la clase primaria.

void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)

Establece si se debe absorber un error condicional en un reintento para la solicitud. Esta opción solo se usa en CloudAppendBlob los métodos upload y openWrite. De forma predeterminada, se establece en . Establézcalo en solo para un escenario de escritura único.

Puede cambiar el valor absorbConditionalErrorsOnRetry en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor absorbConditionalErrorsOnRetry.

void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)

que define el comportamiento para controlar las excepciones al leer desde y mediante . Si los datos leídos desde la secuencia hasta el punto de la excepción se vaciarán y se confirmará un nuevo blob con esos datos. De lo contrario, se anulará la carga y no se confirmará ningún dato.

El valor predeterminado es .

void setConcurrentRequestCount(final Integer concurrentRequestCount)

Establece el número simultáneo de solicitudes simultáneas por operación.

El número de solicitudes simultáneas predeterminado se establece en el cliente y es 1 de forma predeterminada, lo que indica que no hay simultaneidad. Puede cambiar el número de solicitudes simultáneas en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese recuento de solicitudes simultáneas.

void setCustomerProvidedKey(BlobCustomerProvidedKey key)

Establece el objeto BlobCustomerProvidedKey que se usará para esta solicitud. El cifrado de claves proporcionado por el cliente es compatible con la mayoría de las solicitudes de carga, descarga y copia en Blob Storage, así como la captura de propiedades y metadatos.

void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Establece si los métodos y BlobInputStream de descarga deben omitir el encabezado ContentMD5 del blob.

El valor predeterminado disableContentMD5Validation se establece en el cliente y es de forma predeterminada . Puede cambiar el valor disableContentMD5Validation en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor disableContentMD5Validation.

void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)

Establece el objeto BlobEncryptionPolicy que se va a usar para esta solicitud.

El valor predeterminado BlobEncryptionPolicy se establece en el cliente y es null de forma predeterminada, lo que indica que no hay cifrado. Puede cambiar BlobEncryptionPolicy en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen blobEncryptionPolicy.

void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)

Establece el tamaño de umbral usado para escribir un único blob que se va a usar.

El tamaño de umbral predeterminado se establece en el cliente y es de forma predeterminada de 32 MB. Puede cambiar el tamaño del umbral en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese tamaño de umbral.

void setSkipEtagLocking(boolean skipEtagLocking)

ADVERTENCIA: el bloqueo de etag se usa automáticamente en descargas de blobs para asegurarse de que el blob no cambia la descarga intermedia. Omita esta validación en su propio riesgo.

Establece si se debe omitir el bloqueo y la validación de etag en las descargas de blobs.

void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Establece si el encabezado ContentMD5 del blob debe establecerse en las cargas. Este campo no se admite para blobs en páginas.

El valor predeterminado storeBlobContentMD5 se establece en el cliente y es de forma predeterminada para blobs en bloques. Puedes cambiar el valor storeBlobContentMD5 en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor storeBlobContentMD5.

void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

Establece si una operación PUT o GET de rango usará el encabezado Content-MD5 para aplicar la seguridad transaccional. Todas las cargas o descargas de blobs parciales se restringirán a 4 MB.

El valor predeterminado useTransactionalContentMD5 se establece en el cliente y es de forma predeterminada . Puede cambiar el valor useTransactionalContentMD5 en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor useTransactionalContentMD5.

void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)

Establece el objeto BlobCustomerProvidedKey que se va a usar para un blob de origen. El cifrado de claves proporcionado por el cliente es compatible con la mayoría de las solicitudes de carga, descarga y copia en Blob Storage, así como la captura de propiedades y metadatos.

Miembros heredados

Detalles del constructor

BlobRequestOptions

public BlobRequestOptions()

Cree una instancia de la clase.

BlobRequestOptions

public BlobRequestOptions(final BlobRequestOptions other)

Crea una instancia de la clase copiando valores de otra instancia.

Parámetros:

other - Objeto BlobRequestOptions que representa las opciones de solicitud de blob que se van a copiar.

Detalles del método

applyDefaults

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

Aplica los valores predeterminados a las opciones pasadas.

Parámetros:

modifiedOptions - Las opciones a las que se aplicarán los valores predeterminados.
blobtype

assertNoEncryptionPolicyOrStrictMode

protected void assertNoEncryptionPolicyOrStrictMode()

Confirme que si la validación está activada, no se especifica una directiva de cifrado.

assertPolicyIfRequired

protected void assertPolicyIfRequired()

Aserte que, si el modo strict está activado, se especifica una directiva de cifrado.

getAbsorbConditionalErrorsOnRetry

public Boolean getAbsorbConditionalErrorsOnRetry()

Indica si se debe absorber un error condicional en un reintento para la solicitud. Para obtener más información sobre la absorción de errores de conditinal en los valores predeterminados de reintento, vea setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry).

Devoluciones:

absorbConditionalErrorsOnRetry

getCommitWriteOnInputStreamException

public boolean getCommitWriteOnInputStreamException()

que define el comportamiento para controlar las excepciones al leer desde y mediante . Si los datos leídos desde la secuencia hasta el punto de la excepción se vaciarán y se confirmará un nuevo blob con esos datos. De lo contrario, se anulará la carga y no se confirmará ningún dato.

Para obtener más información sobre los valores predeterminados, vea setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException).

Devoluciones:

true si los datos se confirmarán en una excepción; de lo contrario, false.

getConcurrentRequestCount

public Integer getConcurrentRequestCount()

Obtiene el número simultáneo de solicitudes simultáneas por operación. Para obtener más información sobre los valores predeterminados de recuento de solicitudes simultáneas, vea setConcurrentRequestCount(final Integer concurrentRequestCount).

Devoluciones:

concurrentRequestCount

getCustomerProvidedKey

public BlobCustomerProvidedKey getCustomerProvidedKey()

Obtiene la clave proporcionada por el cliente que se usará para esta solicitud.

Devoluciones:

Objeto BlobCustomerProvidedKey que representa la clave proporcionada por el cliente actual.

getDisableContentMD5Validation

public Boolean getDisableContentMD5Validation()

Obtiene si los métodos y BlobInputStream de descarga deben omitir el encabezado ContentMD5 del blob. Para obtener más información sobre cómo deshabilitar los valores predeterminados de validación md5 de contenido, consulte setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Devoluciones:

disableContentMD5Validation

getEncryptionPolicy

public BlobEncryptionPolicy getEncryptionPolicy()

Obtiene la directiva de cifrado que se va a usar para esta solicitud. Para obtener más información sobre los valores predeterminados de la directiva de cifrado, vea setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy).

Devoluciones:

Objeto BlobEncryptionPolicy que representa la directiva de cifrado actual.

getSingleBlobPutThresholdInBytes

public Integer getSingleBlobPutThresholdInBytes()

Obtiene el tamaño de umbral utilizado para escribir un único blob. Para obtener más información sobre los valores predeterminados de tamaño de umbral, vea setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes).

Devoluciones:

Tamaño máximo, en bytes, de un blob que se puede cargar como un único blob, que va de 1 a 64 MB, ambos incluidos. Si un tamaño de blob está por encima del umbral, se cargará como bloques.

getSkipEtagLocking

public boolean getSkipEtagLocking()

ADVERTENCIA: el bloqueo de etag se usa automáticamente en descargas de blobs para asegurarse de que el blob no cambia la descarga intermedia. Omita esta validación en su propio riesgo.

Obtiene si se debe omitir el bloqueo de etag y la validación en las descargas de blobs.

Devoluciones:

true si se habilita la omisión; de lo contrario, false.

getStoreBlobContentMD5

public Boolean getStoreBlobContentMD5()

Obtiene si el encabezado ContentMD5 del blob debe establecerse en las cargas. Este campo no se admite para blobs en páginas. Para obtener más información sobre cómo almacenar los valores predeterminados de MD5 de contenido de blobs, consulte setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Devoluciones:

storeBlobContentMD5

getUseTransactionalContentMD5

public Boolean getUseTransactionalContentMD5()

Obtiene si una operación PUT o GET de rango usará el encabezado Content-MD5 para aplicar la seguridad transaccional. Todas las cargas o descargas de blobs parciales se restringirán a 4 MB. Para obtener más información sobre los valores predeterminados md5 de contenido transaccional, vea setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5).

Devoluciones:

useTransactionalContentMD5

getValidateEncryptionPolicy

protected boolean getValidateEncryptionPolicy()

Obtiene la clave proporcionada por el cliente que se usará en el origen de una solicitud de copia.

Devoluciones:

Objeto BlobCustomerProvidedKey que representa la clave proporcionada por el cliente del origen. Obtiene un valor que indica si se debe validar la presencia de la directiva de cifrado.

populateAndApplyDefaults

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

Usa el recuento de solicitudes simultáneas del cliente especificado si , establece un valor predeterminado para todo lo demás y establece los valores predeterminados según se define en la clase primaria.

Parámetros:

options - Opciones de entrada desde las que se va a copiar al aplicar los valores predeterminados
blobType - BlobType de la operación actual
client - Objeto CloudBlobClient que representa el cliente de servicio usado para establecer el intervalo de tiempo de espera predeterminado y la directiva de reintento, si son null. Además, el valor predeterminado de concurrentRequestCount es 1.

populateAndApplyDefaults

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

Usa el recuento de solicitudes simultáneas del cliente especificado si , establece un valor predeterminado para todo lo demás y establece los valores predeterminados según se define en la clase primaria.

Parámetros:

options - Opciones de entrada desde las que se va a copiar al aplicar los valores predeterminados
blobType - BlobType de la operación actual
client - Objeto CloudBlobClient que representa el cliente de servicio usado para establecer el intervalo de tiempo de espera predeterminado y la directiva de reintento, si son null. Además, el valor predeterminado de concurrentRequestCount es 1.
setStartTime - si se va a inicializar el campo startTimeInMs o no

setAbsorbConditionalErrorsOnRetry

public void setAbsorbConditionalErrorsOnRetry(final Boolean absorbConditionalErrorsOnRetry)

Establece si se debe absorber un error condicional en un reintento para la solicitud. Esta opción solo se usa en CloudAppendBlob los métodos upload y openWrite. De forma predeterminada, se establece en . Establézcalo en solo para un escenario de escritura único.

Puede cambiar el valor absorbConditionalErrorsOnRetry en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor absorbConditionalErrorsOnRetry.

Parámetros:

absorbConditionalErrorsOnRetry - absorbConditionalErrorsOnRetry que se va a establecer

setCommitWriteOnInputStreamException

public void setCommitWriteOnInputStreamException(boolean commitWriteOnInputStreamException)

que define el comportamiento para controlar las excepciones al leer desde y mediante . Si los datos leídos desde la secuencia hasta el punto de la excepción se vaciarán y se confirmará un nuevo blob con esos datos. De lo contrario, se anulará la carga y no se confirmará ningún dato.

El valor predeterminado es .

Parámetros:

commitWriteOnInputStreamException - Use true si los datos se confirmarán en una excepción; de lo contrario, false.

setConcurrentRequestCount

public void setConcurrentRequestCount(final Integer concurrentRequestCount)

Establece el número simultáneo de solicitudes simultáneas por operación.

El número de solicitudes simultáneas predeterminado se establece en el cliente y es 1 de forma predeterminada, lo que indica que no hay simultaneidad. Puede cambiar el número de solicitudes simultáneas en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese recuento de solicitudes simultáneas.

Parámetros:

concurrentRequestCount - concurrentRequestCount que se va a establecer

setCustomerProvidedKey

public void setCustomerProvidedKey(BlobCustomerProvidedKey key)

Establece el objeto BlobCustomerProvidedKey que se usará para esta solicitud. El cifrado de claves proporcionado por el cliente es compatible con la mayoría de las solicitudes de carga, descarga y copia en Blob Storage, así como la captura de propiedades y metadatos.

Parámetros:

key - El objeto BlobCustomerProvidedKey que se va a usar al realizar solicitudes de servicio.

setDisableContentMD5Validation

public void setDisableContentMD5Validation(final Boolean disableContentMD5Validation)

Establece si los métodos y BlobInputStream de descarga deben omitir el encabezado ContentMD5 del blob.

El valor predeterminado disableContentMD5Validation se establece en el cliente y es de forma predeterminada . Puede cambiar el valor disableContentMD5Validation en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor disableContentMD5Validation.

Parámetros:

disableContentMD5Validation - disableContentMD5Validation que se va a establecer

setEncryptionPolicy

public void setEncryptionPolicy(BlobEncryptionPolicy encryptionPolicy)

Establece el objeto BlobEncryptionPolicy que se va a usar para esta solicitud.

El valor predeterminado BlobEncryptionPolicy se establece en el cliente y es null de forma predeterminada, lo que indica que no hay cifrado. Puede cambiar BlobEncryptionPolicy en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen blobEncryptionPolicy.

Parámetros:

encryptionPolicy - El objeto BlobEncryptionPolicy que se va a usar al realizar solicitudes de servicio.

setSingleBlobPutThresholdInBytes

public void setSingleBlobPutThresholdInBytes(final Integer singleBlobPutThresholdInBytes)

Establece el tamaño de umbral usado para escribir un único blob que se va a usar.

El tamaño de umbral predeterminado se establece en el cliente y es de forma predeterminada de 32 MB. Puede cambiar el tamaño del umbral en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese tamaño de umbral.

Parámetros:

singleBlobPutThresholdInBytes - Tamaño máximo, en bytes, de un blob que se puede cargar como un único blob, que va de 1 MB a 64 MB inclusive. Si un tamaño de blob está por encima del umbral, se cargará como bloques.

Produce:

IllegalArgumentException - Si minimumReadSize es menor que 1 MB o superior a 64 MB.

setSkipEtagLocking

public void setSkipEtagLocking(boolean skipEtagLocking)

ADVERTENCIA: el bloqueo de etag se usa automáticamente en descargas de blobs para asegurarse de que el blob no cambia la descarga intermedia. Omita esta validación en su propio riesgo.

Establece si se debe omitir el bloqueo y la validación de etag en las descargas de blobs.

Parámetros:

skipEtagLocking - Use true para omitir el bloqueo y la validación de etag; en caso contrario, false.

setStoreBlobContentMD5

public void setStoreBlobContentMD5(final Boolean storeBlobContentMD5)

Establece si el encabezado ContentMD5 del blob debe establecerse en las cargas. Este campo no se admite para blobs en páginas.

El valor predeterminado storeBlobContentMD5 se establece en el cliente y es de forma predeterminada para blobs en bloques. Puedes cambiar el valor storeBlobContentMD5 en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor storeBlobContentMD5.

Parámetros:

storeBlobContentMD5 - storeBlobContentMD5 que se va a establecer

setUseTransactionalContentMD5

public void setUseTransactionalContentMD5(final Boolean useTransactionalContentMD5)

Establece si una operación PUT o GET de rango usará el encabezado Content-MD5 para aplicar la seguridad transaccional. Todas las cargas o descargas de blobs parciales se restringirán a 4 MB.

El valor predeterminado useTransactionalContentMD5 se establece en el cliente y es de forma predeterminada . Puede cambiar el valor useTransactionalContentMD5 en esta solicitud estableciendo esta propiedad. También puede cambiar el valor del getDefaultRequestOptions() objeto para que todas las solicitudes posteriores realizadas a través del cliente de servicio usen ese valor useTransactionalContentMD5.

Parámetros:

useTransactionalContentMD5 - useTransactionalContentMD5 para establecer

setValidateEncryptionPolicy

protected void setValidateEncryptionPolicy(boolean validateEncryptionPolicy)

Establece el objeto BlobCustomerProvidedKey que se va a usar para un blob de origen. El cifrado de claves proporcionado por el cliente es compatible con la mayoría de las solicitudes de carga, descarga y copia en Blob Storage, así como la captura de propiedades y metadatos.

Parámetros:

validateEncryptionPolicy - Use true para requerir validación; en caso contrario, false.

Se aplica a