Partilhar via


AccessCondition Classe

  • java.lang.Object
    • com.microsoft.azure.storage.AccessCondition

public class AccessCondition

Representa um conjunto de condições de acesso a ser usado para operações nos serviços de armazenamento.

Resumo do Construtor

Construtor Description
AccessCondition()

Cria uma instância da classe .

Resumo do método

Modificador e tipo Método e descrição
void applyAppendConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica a condição de acesso à solicitação.

void applyConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso à solicitação.

void applyLeaseConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica a condição de acesso de concessão à solicitação.

void applySequenceConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso de número de sequência à solicitação.

void applySourceConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso de origem à solicitação.

AccessCondition generateEmptyCondition()

Gera um novo AccessCondition vazio.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfExistsCondition()

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso existir no serviço.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Match .

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfMatchCondition(final String etag)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o valor de ETag do recurso corresponder ao valor ETag especificado.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Match . Se essa condição de acesso for definida, a operação será executada somente se a ETag do recurso corresponder à ETag especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfModifiedSinceCondition(final Date lastMotified)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso tiver sido modificado desde a hora especificada.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Modified-Since . Se essa condição de acesso for definida, a operação será executada somente se o recurso tiver sido modificado desde a hora especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfNoneMatchCondition(final String etag)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o valor de ETag do recurso não corresponder ao valor de ETag especificado.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-None-Match . Se essa condição de acesso for definida, a operação será executada somente se a ETag do recurso não corresponder à ETag especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfNotExistsCondition()

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso não existir no serviço.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-None-Match .

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfNotModifiedSinceCondition(final Date lastMotified)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso não tiver sido modificado desde a hora especificada.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Unmodified-Since . Se essa condição de acesso for definida, a operação será executada somente se o recurso não tiver sido modificado desde a hora especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

AccessCondition generateIfSequenceNumberEqualCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for igual ao valor especificado. Essa condição só se aplica a blobs de páginas.

AccessCondition generateIfSequenceNumberLessThanCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for menor que o valor especificado. Essa condição só se aplica a blobs de páginas.

AccessCondition generateIfSequenceNumberLessThanOrEqualCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for menor ou igual ao valor especificado. Essa condição só se aplica a blobs de páginas.

AccessCondition generateLeaseCondition(final String leaseID)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso estiver acessível sob a ID de concessão especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Long getIfAppendPositionEqual()

Obtém o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o deslocamento de bytes para marcar. O acréscimo terá êxito somente se a posição final for igual a esse número.

String getIfMatch()

Obtém a ETag quando a condição If-Match está definida.

Long getIfMaxSizeLessThanOrEqual()

Obtém o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o comprimento máximo em bytes para restringir o blob ao confirmar o bloco.

Date getIfModifiedSinceDate()

Obtém a data If-Modified-Since .

String getIfNoneMatch()

Obtém a ETag quando a condição If-None-Match está definida.

Long getIfSequenceNumberEqual()

Obtém o número de sequência quando a condição de igual número de sequência é definida. Essa condição só é aplicável a blobs de páginas.

Long getIfSequenceNumberLessThan()

Obtém o número de sequência quando o número de sequência menor que a condição é definido. Essa condição só é aplicável a blobs de páginas.

Long getIfSequenceNumberLessThanOrEqual()

Obtém o número de sequência quando o número de sequência menor ou igual a condição é definido. Essa condição só é aplicável a blobs de páginas.

Date getIfUnmodifiedSinceDate()

Obtém a data If-Unmodified-Since .

String getLeaseID()

Obtém a ID de concessão.

void setIfAppendPositionEqual(Long ifAppendPositionEqual)

Define o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o deslocamento de bytes para marcar. O acréscimo terá êxito somente se a posição final for igual a esse número.

void setIfMatch(String etag)

Define a ETag para a condição If-Match .

void setIfMaxSizeLessThanOrEqual(Long ifMaxSizeLessThanOrEqual)

Define o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o comprimento máximo em bytes para restringir o blob ao confirmar o bloco.

void setIfModifiedSinceDate(Date ifModifiedSinceDate)

Define a data If-Modified-Since .

void setIfNoneMatch(String etag)

Define a ETag para a condição If-None-Match .

void setIfSequenceNumberEqual(Long sequenceNumber)

Define o número de sequência para o número de sequência igual à condição. Essa condição só é aplicável a blobs de páginas.

void setIfSequenceNumberLessThan(Long sequenceNumber)

Define o número de sequência para o número de sequência menor que a condição. Essa condição só é aplicável a blobs de páginas.

void setIfSequenceNumberLessThanOrEqual(Long sequenceNumber)

Define o número de sequência para o número de sequência menor ou igual à condição. Essa condição só é aplicável a blobs de páginas.

void setIfUnmodifiedSinceDate(Date ifUnmodifiedSinceDate)

Define a data If-Unmodified-Since .

void setLeaseID(String leaseID)

Obtém a ID de concessão.

boolean verifyConditional(final String etag, final Date lastModified)

RESERVADO PARA USO INTERNO. Verifica se a condição está satisfeita.

Detalhes do construtor

AccessCondition

public AccessCondition()

Cria uma instância da classe .

Detalhes do método

applyAppendConditionToRequest

public void applyAppendConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica a condição de acesso à solicitação.

Parameters:

request - Um java.net.HttpURLConnection objeto que representa a solicitação à qual a condição está sendo aplicada.

applyConditionToRequest

public void applyConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso à solicitação.

Parameters:

request - Um java.net.HttpURLConnection objeto que representa a solicitação à qual a condição está sendo aplicada.

applyLeaseConditionToRequest

public void applyLeaseConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica a condição de acesso de concessão à solicitação.

Parameters:

request - Um java.net.HttpURLConnection objeto que representa a solicitação à qual a condição está sendo aplicada.

applySequenceConditionToRequest

public void applySequenceConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso de número de sequência à solicitação.

Parameters:

request - Um java.net.HttpURLConnection objeto que representa a solicitação à qual a condição está sendo aplicada.

applySourceConditionToRequest

public void applySourceConditionToRequest(final HttpURLConnection request)

RESERVADO PARA USO INTERNO. Aplica as condições de acesso de origem à solicitação.

Parameters:

request - Um java.net.HttpURLConnection objeto que representa a solicitação à qual a condição está sendo aplicada.

generateEmptyCondition

public static AccessCondition generateEmptyCondition()

Gera um novo AccessCondition vazio.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Returns:

Um AccessCondition objeto que não tem condições definidas.

generateIfExistsCondition

public static AccessCondition generateIfExistsCondition()

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso existir no serviço.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Match .

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Returns:

Um AccessCondition objeto que representa a condição if exists.

generateIfMatchCondition

public static AccessCondition generateIfMatchCondition(final String etag)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o valor de ETag do recurso corresponder ao valor ETag especificado.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Match . Se essa condição de acesso for definida, a operação será executada somente se a ETag do recurso corresponder à ETag especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Parameters:

etag - Um String que representa o valor de ETag a ser marcar.

Returns:

Um AccessCondition objeto que representa a condição If-Match .

generateIfModifiedSinceCondition

public static AccessCondition generateIfModifiedSinceCondition(final Date lastMotified)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso tiver sido modificado desde a hora especificada.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Modified-Since . Se essa condição de acesso for definida, a operação será executada somente se o recurso tiver sido modificado desde a hora especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Parameters:

lastMotified - Um java.util.Date objeto que representa a hora da última modificação para marcar para o recurso.

Returns:

Um AccessCondition objeto que representa a condição If-Modified-Since .

generateIfNoneMatchCondition

public static AccessCondition generateIfNoneMatchCondition(final String etag)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o valor de ETag do recurso não corresponder ao valor de ETag especificado.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-None-Match . Se essa condição de acesso for definida, a operação será executada somente se a ETag do recurso não corresponder à ETag especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Parameters:

etag - Um String que representa o valor de ETag a ser marcar.

Returns:

Um AccessCondition objeto que representa a condição If-None-Match .

generateIfNotExistsCondition

public static AccessCondition generateIfNotExistsCondition()

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso não existir no serviço.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-None-Match .

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Returns:

Um AccessCondition objeto que representa a condição if not exists.

generateIfNotModifiedSinceCondition

public static AccessCondition generateIfNotModifiedSinceCondition(final Date lastMotified)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso não tiver sido modificado desde a hora especificada.

Definir essa condição de acesso modifica a solicitação para incluir o cabeçalho condicional HTTP If-Unmodified-Since . Se essa condição de acesso for definida, a operação será executada somente se o recurso não tiver sido modificado desde a hora especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Parameters:

lastMotified - Um java.util.Date objeto que representa a hora da última modificação para marcar para o recurso.

Returns:

Um AccessCondition objeto que representa a condição If-Unmodified-Since .

generateIfSequenceNumberEqualCondition

public static AccessCondition generateIfSequenceNumberEqualCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for igual ao valor especificado. Essa condição só se aplica a blobs de páginas.

Parameters:

sequenceNumber - O valor a ser comparado com o número de sequência atual.

Returns:

Um AccessCondition objeto que representa a condição If-Sequence-Number-EQ .

generateIfSequenceNumberLessThanCondition

public static AccessCondition generateIfSequenceNumberLessThanCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for menor que o valor especificado. Essa condição só se aplica a blobs de páginas.

Parameters:

sequenceNumber - O valor a ser comparado com o número de sequência atual.

Returns:

Um AccessCondition objeto que representa a condição If-Sequence-Number-LT .

generateIfSequenceNumberLessThanOrEqualCondition

public static AccessCondition generateIfSequenceNumberLessThanOrEqualCondition(long sequenceNumber)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o número de sequência atual do recurso for menor ou igual ao valor especificado. Essa condição só se aplica a blobs de páginas.

Parameters:

sequenceNumber - O valor a ser comparado com o número de sequência atual.

Returns:

Um AccessCondition objeto que representa a condição If-Sequence-Number-LE .

generateLeaseCondition

public static AccessCondition generateLeaseCondition(final String leaseID)

Retorna uma condição de acesso de modo que uma operação seja executada somente se o recurso estiver acessível sob a ID de concessão especificada.

Para obter mais informações, confira Como especificar cabeçalhos condicionais para operações de serviço Blob.

Parameters:

leaseID - A ID de concessão a ser especificada.

Returns:

Um objeto AccessCondition que representa a condição de concessão.

getIfAppendPositionEqual

public Long getIfAppendPositionEqual()

Obtém o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o deslocamento de bytes para marcar. O acréscimo terá êxito somente se a posição final for igual a esse número.

Returns:

O número da posição de acréscimo ou null se nenhuma condição existir.

getIfMatch

public String getIfMatch()

Obtém a ETag quando a condição If-Match está definida.

Returns:

A ETag quando a condição If-Match está definida; caso contrário, nulo.

getIfMaxSizeLessThanOrEqual

public Long getIfMaxSizeLessThanOrEqual()

Obtém o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o comprimento máximo em bytes para restringir o blob ao confirmar o bloco.

Returns:

O tamanho máximo ou null se nenhuma condição existir.

getIfModifiedSinceDate

public Date getIfModifiedSinceDate()

Obtém a data If-Modified-Since .

Returns:

Um java.util.Date objeto que representa a data If-Modified-Since .

getIfNoneMatch

public String getIfNoneMatch()

Obtém a ETag quando a condição If-None-Match está definida.

Returns:

A ETag quando a condição If-None-Match estiver definida; caso contrário, nulo.

getIfSequenceNumberEqual

public Long getIfSequenceNumberEqual()

Obtém o número de sequência quando a condição de igual número de sequência é definida. Essa condição só é aplicável a blobs de páginas.

Returns:

O número de sequência quando a condição ifSequenceNumberEqual é definida; Caso contrário null

getIfSequenceNumberLessThan

public Long getIfSequenceNumberLessThan()

Obtém o número de sequência quando o número de sequência menor que a condição é definido. Essa condição só é aplicável a blobs de páginas.

Returns:

O número de sequência quando a condição ifSequenceNumberLessThan é definida; Caso contrário null

getIfSequenceNumberLessThanOrEqual

public Long getIfSequenceNumberLessThanOrEqual()

Obtém o número de sequência quando o número de sequência menor ou igual a condição é definido. Essa condição só é aplicável a blobs de páginas.

Returns:

O número de sequência quando a condição ifSequenceNumberLessThanOrEqual está definida; Caso contrário null

getIfUnmodifiedSinceDate

public Date getIfUnmodifiedSinceDate()

Obtém a data If-Unmodified-Since .

Returns:

Um java.util.Date objeto que representa a data If-Unmodified-Since .

getLeaseID

public String getLeaseID()

Obtém a ID de concessão.

Returns:

A ID de concessão.

setIfAppendPositionEqual

public void setIfAppendPositionEqual(Long ifAppendPositionEqual)

Define o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o deslocamento de bytes para marcar. O acréscimo terá êxito somente se a posição final for igual a esse número.

Parameters:

ifAppendPositionEqual - O número da posição de acréscimo ou null se nenhuma condição existir.

setIfMatch

public void setIfMatch(String etag)

Define a ETag para a condição If-Match .

Parameters:

etag - A ETag a ser definida para a condição If-Match .

setIfMaxSizeLessThanOrEqual

public void setIfMaxSizeLessThanOrEqual(Long ifMaxSizeLessThanOrEqual)

Define o valor de um cabeçalho condicional usado apenas para operações de acréscimo. Um número que indica o comprimento máximo em bytes para restringir o blob ao confirmar o bloco.

Parameters:

ifMaxSizeLessThanOrEqual - O tamanho máximo ou null se nenhuma condição existir.

setIfModifiedSinceDate

public void setIfModifiedSinceDate(Date ifModifiedSinceDate)

Define a data If-Modified-Since .

Parameters:

ifModifiedSinceDate - Um java.util.Date objeto que representa o If-Modified-Since a ser definido.

setIfNoneMatch

public void setIfNoneMatch(String etag)

Define a ETag para a condição If-None-Match .

Parameters:

etag - A ETag a ser definida para a condição If-None-Match .

setIfSequenceNumberEqual

public void setIfSequenceNumberEqual(Long sequenceNumber)

Define o número de sequência para o número de sequência igual à condição. Essa condição só é aplicável a blobs de páginas.

Parameters:

sequenceNumber - O número de sequência para o qual definir a condição if sequence number equal.

setIfSequenceNumberLessThan

public void setIfSequenceNumberLessThan(Long sequenceNumber)

Define o número de sequência para o número de sequência menor que a condição. Essa condição só é aplicável a blobs de páginas.

Parameters:

sequenceNumber - O número de sequência para o qual definir o número de sequência if menor que a condição.

setIfSequenceNumberLessThanOrEqual

public void setIfSequenceNumberLessThanOrEqual(Long sequenceNumber)

Define o número de sequência para o número de sequência menor ou igual à condição. Essa condição só é aplicável a blobs de páginas.

Parameters:

sequenceNumber - O número de sequência para definir o número de sequência if menor ou igual a.

setIfUnmodifiedSinceDate

public void setIfUnmodifiedSinceDate(Date ifUnmodifiedSinceDate)

Define a data If-Unmodified-Since .

Parameters:

ifUnmodifiedSinceDate - Um java.util.Date objeto que representa If-Unmodified-Since a ser definido.

setLeaseID

public void setLeaseID(String leaseID)

Obtém a ID de concessão.

Parameters:

leaseID - A ID de concessão a ser definida.

verifyConditional

public boolean verifyConditional(final String etag, final Date lastModified)

RESERVADO PARA USO INTERNO. Verifica se a condição está satisfeita.

Parameters:

etag - Um String que representa a ETag a ser marcar.
lastModified - Um java.util.Date objeto que representa a data/hora da última modificação.

Returns:

true se a condição for atendida; caso contrário, false.

Aplica-se a