TableOperation Classe

Pacote:

com.microsoft.azure.storage.table

• java.lang.Object
• • com.microsoft.azure.storage.table.TableOperation

public class TableOperation

Uma classe que representa uma única operação de tabela.

Use os métodos de fábrica estáticos para construir TableOperation instâncias para operações em tabelas que inserem, atualizam, mesclam, excluem, substituam ou recuperam entidades de tabela. Para executar uma TableOperation instância, chame o método em uma CloudTableClient instância. Um TableOperation pode ser executado diretamente ou como parte de um TableBatchOperation. Se um TableOperation retornar um resultado de entidade, ele será armazenado no correspondente TableResult retornado pelo método .

Resumo do Construtor

Construtor	Description
TableOperation()	Construtor Padrão do Nullary.
TableOperation(final TableEntity entity, final TableOperationType opType)	Reservado para uso interno. Constrói um TableOperation com a entidade de tabela e o tipo de operação especificados.
TableOperation(final TableEntity entity, final TableOperationType opType, final boolean echoContent)	Reservado para uso interno. Constrói um TableOperation com a entidade de tabela especificada e o tipo de operação.

Resumo do método

Modificador e tipo	Método e descrição
TableOperation	delete(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para excluir a entidade especificada do armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o
TableResult	execute(final CloudTableClient client, final String tableName, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Execute esta operação de tabela na tabela especificada, usando o especificado TableRequestOptions e OperationContexto . Esse método invocará a API REST do Serviço de Armazenamento para executar essa operação de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento no CloudTableClient objeto .
String	generateRequestIdentity(boolean isSingleIndexEntry, final String entryName) Reservado para uso interno. Gera a identidade da solicitação, que consiste no nome de entrada especificado ou no par PartitionKey e RowKey da operação, para identificar o destino da operação.
String	generateRequestIdentityWithTable(final String tableName) Reservado para uso interno. Gera a cadeia de caracteres de identidade de solicitação para a tabela especificada. A cadeia de caracteres de identidade de solicitação combina o nome da tabela com PartitionKey e RowKey da operação para identificar entidades de tabela específicas. Essa identidade de solicitação já está urlEncoded.
boolean	getEchoContent() Obtém o booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.
synchronized final TableEntity	getEntity() Reservado para uso interno. Obtém a entidade de tabela associada a essa operação.
synchronized final TableOperationType	getOperationType() Reservado para uso interno. Obtém o tipo de operação para esta operação.
TableOperation	insert(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para inserir a entidade especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o
TableOperation	insert(final TableEntity entity, boolean echoContent) Um método de fábrica estático que retorna uma TableOperation instância para inserir a entidade especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o
TableOperation	insertOrMerge(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para mesclar a entidade especificada no armazenamento do Microsoft Azure ou inseri-la se ela não existir. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .
TableOperation	insertOrReplace(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para substituir a entidade especificada no armazenamento do Microsoft Azure ou inseri-la se ela não existir. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .
TableOperation	merge(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para mesclar a entidade de tabela especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o
TableResult	parseResponse(final InputStream inStream, final int httpStatusCode, String etagFromHeader, final OperationContext opContext, final TableRequestOptions options) Reservado para uso interno. Analisa a resposta da operação de tabela em um TableResult a ser retornado.
TableOperation	replace(final TableEntity entity) Um método de fábrica estático que retorna uma TableOperation instância para substituir a entidade de tabela especificada. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método .
TableOperation	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) Um método de fábrica estático que retorna uma TableOperation instância para recuperar a entidade de tabela especificada e a retorna como o tipo especificado. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o
TableOperation	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) Um método de fábrica estático que retorna uma TableOperation instância para recuperar a entidade de tabela especificada e retorna uma projeção dela usando o resolvedor especificado. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .
void	setEchoContent(boolean echoContent) Define o booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.
synchronized final void	setEntity(final TableEntity entity) Reservado para uso interno. Define a TableEntity instância da operação de tabela.

Detalhes do construtor

TableOperation

protected TableOperation()

Construtor Padrão do Nullary.

TableOperation

protected TableOperation(final TableEntity entity, final TableOperationType opType)

Reservado para uso interno. Constrói um TableOperation com a entidade de tabela e o tipo de operação especificados.

Parâmetros:

entity - A instância de objeto que implementa TableEntity para associar à operação.

opType - O TableOperationType valor de enumeração para o tipo de operação.

TableOperation

protected TableOperation(final TableEntity entity, final TableOperationType opType, final boolean echoContent)

Reservado para uso interno. Constrói um TableOperation com a entidade de tabela especificada e o tipo de operação.

Parâmetros:

entity - A instância de objeto que implementa TableEntity para associar à operação.

opType - O TableOperationType valor de enumeração para o tipo de operação.

echoContent - O booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.

Detalhes do método

delete

public static TableOperation delete(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para excluir a entidade especificada do armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para inserir a entidade de tabela.

execute

protected TableResult execute(final CloudTableClient client, final String tableName, TableRequestOptions options, OperationContext opContext)

Reservado para uso interno. Execute esta operação de tabela na tabela especificada, usando o especificado TableRequestOptions e OperationContexto .

Esse método invocará a API REST do Serviço de Armazenamento para executar essa operação de tabela, usando o ponto de extremidade de serviço tabela e as credenciais da conta de armazenamento no CloudTableClient objeto .

Parâmetros:

client - Uma CloudTableClient instância que especifica o ponto de extremidade de serviço tabela, as credenciais da conta de armazenamento e quaisquer parâmetros de consulta adicionais.

tableName - Um String que especifica o nome da tabela.

options - Um TableRequestOptions objeto que especifica opções de execução, como política de repetição e configurações de tempo limite para a operação.

opContext - Um objeto OperationContext para rastrear a operação atual.

Retornos:

Um TableResult que representa os resultados da execução da operação.

Gera:

StorageException - se ocorrer um erro na operação de armazenamento.

generateRequestIdentity

protected String generateRequestIdentity(boolean isSingleIndexEntry, final String entryName)

Reservado para uso interno. Gera a identidade da solicitação, que consiste no nome de entrada especificado ou no par PartitionKey e RowKey da operação, para identificar o destino da operação.

Parâmetros:

isSingleIndexEntry - Passe true para usar o parâmetro especificado entryName ou false para usar os valores PartitionKey e RowKey da operação como a identidade da solicitação.

entryName - O nome da entrada a ser usado como a identidade da solicitação se o isSingleIndexEntry parâmetro for true.

Retornos:

Um String que representa a cadeia de caracteres de identidade de solicitação formatada.

Gera:

StorageException - Se ocorreu um erro de serviço de armazenamento.

generateRequestIdentityWithTable

protected String generateRequestIdentityWithTable(final String tableName)

Reservado para uso interno. Gera a cadeia de caracteres de identidade de solicitação para a tabela especificada. A cadeia de caracteres de identidade de solicitação combina o nome da tabela com PartitionKey e RowKey da operação para identificar entidades de tabela específicas. Essa identidade de solicitação já está urlEncoded.

Parâmetros:

tableName - Um String que especifica o nome da tabela.

Retornos:

Um String que representa a cadeia de caracteres de identidade de solicitação formatada para a tabela especificada.

Gera:

StorageException

getEchoContent

protected boolean getEchoContent()

Obtém o booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.

Retornos:

true se o conteúdo da mensagem deve ser retornado na resposta; Caso contrário false

getEntity

protected synchronized final TableEntity getEntity()

Reservado para uso interno. Obtém a entidade de tabela associada a essa operação.

Retornos:

A TableEntity instância associada a essa operação.

getOperationType

protected synchronized final TableOperationType getOperationType()

Reservado para uso interno. Obtém o tipo de operação para esta operação.

Retornos:

o opType A TableOperationType instância associada a essa operação.

insert

public static TableOperation insert(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para inserir a entidade especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para inserir a entidade de tabela.

insert

public static TableOperation insert(final TableEntity entity, boolean echoContent)

Um método de fábrica estático que retorna uma TableOperation instância para inserir a entidade especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

echoContent - O booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.

Retornos:

Uma nova TableOperation instância para inserir a entidade de tabela.

insertOrMerge

public static TableOperation insertOrMerge(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para mesclar a entidade especificada no armazenamento do Microsoft Azure ou inseri-la se ela não existir. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para inserir ou mesclar a entidade de tabela.

insertOrReplace

public static TableOperation insertOrReplace(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para substituir a entidade especificada no armazenamento do Microsoft Azure ou inseri-la se ela não existir. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para inserir ou substituir a entidade de tabela.

merge

public static TableOperation merge(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para mesclar a entidade de tabela especificada no armazenamento do Microsoft Azure. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para mesclar a entidade de tabela.

parseResponse

protected TableResult parseResponse(final InputStream inStream, final int httpStatusCode, String etagFromHeader, final OperationContext opContext, final TableRequestOptions options)

Reservado para uso interno. Analisa a resposta da operação de tabela em um TableResult a ser retornado.

Parâmetros:

inStream - Um InputStream que especifica a resposta a uma operação de inserção.

httpStatusCode - Um int que representa o código http status retornado da solicitação de operação.

etagFromHeader - O String que especifica a Etag retornada com a resposta da operação.

opContext - Um objeto OperationContext que representa o contexto da operação atual.

options

Retornos:

O TableResult que representa o resultado da operação.

Gera:

InstantiationException - se ocorrer um erro na construção do objeto.

IllegalAccessException - se ocorrer um erro na reflexão sobre um tipo de objeto.

StorageException - se ocorrer um erro na operação de armazenamento.

IOException - se ocorrer um erro ao acessar o InputStream com Json.

JsonParseException - se ocorrer um erro ao analisar o Json, se Json for usado.

replace

public static TableOperation replace(final TableEntity entity)

Um método de fábrica estático que retorna uma TableOperation instância para substituir a entidade de tabela especificada. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método .

Parâmetros:

entity - A instância de objeto que está implementando TableEntity para associar à operação.

Retornos:

Uma nova TableOperation instância para substituir a entidade de tabela.

retrieve

public static TableOperation retrieve(final String partitionKey, final String rowKey, final Class clazzType)

Um método de fábrica estático que retorna uma TableOperation instância para recuperar a entidade de tabela especificada e a retorna como o tipo especificado. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o

Parâmetros:

partitionKey - Um String que especifica o valor PartitionKey para a entidade recuperar.

rowKey - Um String que especifica o valor RowKey para a entidade recuperar.

clazzType - O tipo de classe do objeto de entidade de tabela a ser recuperado.

Retornos:

Uma nova TableOperation instância para recuperar a entidade de tabela.

retrieve

public static TableOperation retrieve(final String partitionKey, final String rowKey, final EntityResolver resolver)

Um método de fábrica estático que retorna uma TableOperation instância para recuperar a entidade de tabela especificada e retorna uma projeção dela usando o resolvedor especificado. Para executar isso TableOperation em uma determinada tabela, chame o execute(final TableOperation operation) método em uma CloudTableClient instância com o nome da tabela e os TableOperation argumentos como .

Parâmetros:

partitionKey - Um String que especifica o valor PartitionKey para a entidade recuperar.

rowKey - Um String que especifica o valor RowKey para a entidade recuperar.

resolver - A implementação de EntityResolver<T> a ser usada para projetar a entidade de resultado como o tipo T.

Retornos:

Uma nova TableOperation instância para recuperar a entidade de tabela.

setEchoContent

protected void setEchoContent(boolean echoContent)

Define o booliano que representa se o conteúdo da mensagem deve ser retornado na resposta.

Parâmetros:

echoContent -

true se o conteúdo da mensagem deve ser retornado na resposta; caso contrário false, .

setEntity

protected synchronized final void setEntity(final TableEntity entity)

Reservado para uso interno. Define a TableEntity instância da operação de tabela.

Parâmetros:

entity - A instância TableEntity a ser definida.