TableOperation Clase

Paquete:

com.microsoft.azure.storage.table

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

public class TableOperation

Clase que representa una sola operación de tabla.

Use los métodos de fábrica estáticos para construir TableOperation instancias de operaciones en tablas que insertan, actualizan, combinan, eliminan, reemplazan o recuperan entidades de tabla. Para ejecutar una TableOperation instancia, llame al método en una CloudTableClient instancia de . Se TableOperation puede ejecutar directamente o como parte de .TableBatchOperation Si devuelve un TableOperation resultado de entidad, se almacena en el correspondiente TableResult devuelto por el método .

Resumen del constructor

Constructor	Description
TableOperation()	Constructor predeterminado nullary.
TableOperation(final TableEntity entity, final TableOperationType opType)	Reservado para uso interno. Construye con TableOperation la entidad de tabla y el tipo de operación especificados.
TableOperation(final TableEntity entity, final TableOperationType opType, final boolean echoContent)	Reservado para uso interno. Construye un TableOperation objeto con la entidad de tabla y el tipo de operación especificados.

Resumen del método

Modificador y tipo	Método y descripción
TableOperation	delete(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para eliminar la entidad especificada del almacenamiento de Microsoft Azure. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .
TableResult	execute(final CloudTableClient client, final String tableName, TableRequestOptions options, OperationContext opContext) Reservado para uso interno. Ejecute esta operación de tabla en la tabla especificada, utilizando los valores especificados TableRequestOptions y OperationContext. Este método invocará la API rest del servicio de almacenamiento para ejecutar esta operación de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento en el CloudTableClient objeto .
String	generateRequestIdentity(boolean isSingleIndexEntry, final String entryName) Reservado para uso interno. Genera la identidad de solicitud, que consta del nombre de entrada especificado, o el par PartitionKey y RowKey de la operación, para identificar el destino de la operación.
String	generateRequestIdentityWithTable(final String tableName) Reservado para uso interno. Genera la cadena de identidad de solicitud para la tabla especificada. La cadena de identidad de solicitud combina el nombre de tabla con PartitionKey y RowKey de la operación para identificar entidades de tabla específicas. Esta identidad de solicitud ya es UrlEncoded.
boolean	getEchoContent() Obtiene el valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.
synchronized final TableEntity	getEntity() Reservado para uso interno. Obtiene la entidad de tabla asociada a esta operación.
synchronized final TableOperationType	getOperationType() Reservado para uso interno. Obtiene el tipo de operación para esta operación.
TableOperation	insert(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para insertar la entidad especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .
TableOperation	insert(final TableEntity entity, boolean echoContent) Un método de generador estático que devuelve una TableOperation instancia para insertar la entidad especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .
TableOperation	insertOrMerge(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para combinar la entidad especificada en El almacenamiento de Microsoft Azure o insertarla si no existe. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.
TableOperation	insertOrReplace(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para reemplazar la entidad especificada en El almacenamiento de Microsoft Azure o insertarla si no existe. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.
TableOperation	merge(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para combinar la entidad de tabla especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .
TableResult	parseResponse(final InputStream inStream, final int httpStatusCode, String etagFromHeader, final OperationContext opContext, final TableRequestOptions options) Reservado para uso interno. Analiza la respuesta de la operación de tabla en un objeto TableResult que se va a devolver.
TableOperation	replace(final TableEntity entity) Un método de generador estático que devuelve una TableOperation instancia para reemplazar la entidad de tabla especificada. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método .
TableOperation	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) Método de generador estático que devuelve una TableOperation instancia para recuperar la entidad de tabla especificada y devolverla como el tipo especificado. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .
TableOperation	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) Un método de generador estático que devuelve una TableOperation instancia para recuperar la entidad de tabla especificada y devolver una proyección de ella mediante el solucionador especificado. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.
void	setEchoContent(boolean echoContent) Establece el valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.
synchronized final void	setEntity(final TableEntity entity) Reservado para uso interno. Establece la TableEntity instancia de para la operación de tabla.

Detalles del constructor

TableOperation

protected TableOperation()

Constructor predeterminado nullary.

TableOperation

protected TableOperation(final TableEntity entity, final TableOperationType opType)

Reservado para uso interno. Construye con TableOperation la entidad de tabla y el tipo de operación especificados.

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

opType - Valor TableOperationType de enumeración para el tipo de operación.

TableOperation

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

Reservado para uso interno. Construye un TableOperation objeto con la entidad de tabla y el tipo de operación especificados.

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

opType - Valor TableOperationType de enumeración del tipo de operación.

echoContent - Valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.

Detalles del método

delete

public static TableOperation delete(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para eliminar la entidad especificada del almacenamiento de Microsoft Azure. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia de para insertar la entidad de tabla.

execute

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

Reservado para uso interno. Ejecute esta operación de tabla en la tabla especificada, utilizando los valores especificados TableRequestOptions y OperationContext.

Este método invocará la API rest del servicio de almacenamiento para ejecutar esta operación de tabla mediante el punto de conexión de Table service y las credenciales de la cuenta de almacenamiento en el CloudTableClient objeto .

Parameters:

client - Instancia CloudTableClient de que especifica el punto de conexión de Table service, las credenciales de la cuenta de almacenamiento y los parámetros de consulta adicionales.

tableName - que String especifica el nombre de la tabla.

options - Objeto TableRequestOptions que especifica opciones de ejecución, como la directiva de reintento y la configuración de tiempo de espera de la operación.

opContext - Un objeto OperationContext para realizar un seguimiento de la operación actual.

Returns:

que TableResult representa los resultados de la ejecución de la operación.

Throws:

StorageException - si se produce un error en la operación de almacenamiento.

generateRequestIdentity

protected String generateRequestIdentity(boolean isSingleIndexEntry, final String entryName)

Reservado para uso interno. Genera la identidad de solicitud, que consta del nombre de entrada especificado, o el par PartitionKey y RowKey de la operación, para identificar el destino de la operación.

Parameters:

isSingleIndexEntry - Pase true para usar el parámetro especificado entryName o false para usar los valores PartitionKey y RowKey de la operación como identidad de solicitud.

entryName - Nombre de entrada que se va a usar como identidad de solicitud si el isSingleIndexEntry parámetro es true.

Returns:

que String representa la cadena de identidad de solicitud con formato.

Throws:

StorageException - Si se produjo un error en el servicio de almacenamiento.

generateRequestIdentityWithTable

protected String generateRequestIdentityWithTable(final String tableName)

Reservado para uso interno. Genera la cadena de identidad de solicitud para la tabla especificada. La cadena de identidad de solicitud combina el nombre de tabla con PartitionKey y RowKey de la operación para identificar entidades de tabla específicas. Esta identidad de solicitud ya es UrlEncoded.

Parameters:

tableName - que String especifica el nombre de la tabla.

Returns:

que String representa la cadena de identidad de solicitud con formato para la tabla especificada.

Throws:

StorageException

getEchoContent

protected boolean getEchoContent()

Obtiene el valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.

Returns:

true si la carga del mensaje debe devolverse en la respuesta; Lo contrario false

getEntity

protected synchronized final TableEntity getEntity()

Reservado para uso interno. Obtiene la entidad de tabla asociada a esta operación.

Returns:

Instancia TableEntity asociada a esta operación.

getOperationType

protected synchronized final TableOperationType getOperationType()

Reservado para uso interno. Obtiene el tipo de operación para esta operación.

Returns:

opType La TableOperationType instancia asociada a esta operación.

insert

public static TableOperation insert(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para insertar la entidad especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia de para insertar la entidad de tabla.

insert

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

Un método de generador estático que devuelve una TableOperation instancia para insertar la entidad especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

echoContent - Valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.

Returns:

TableOperation Nueva instancia de para insertar la entidad de tabla.

insertOrMerge

public static TableOperation insertOrMerge(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para combinar la entidad especificada en El almacenamiento de Microsoft Azure o insertarla si no existe. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia para insertar o combinar la entidad de tabla.

insertOrReplace

public static TableOperation insertOrReplace(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para reemplazar la entidad especificada en El almacenamiento de Microsoft Azure o insertarla si no existe. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia para insertar o reemplazar la entidad de tabla.

merge

public static TableOperation merge(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para combinar la entidad de tabla especificada en Microsoft Azure Storage. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia para combinar la entidad de tabla.

parseResponse

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

Reservado para uso interno. Analiza la respuesta de la operación de tabla en un objeto TableResult que se va a devolver.

Parameters:

inStream - que InputStream especifica la respuesta a una operación de inserción.

httpStatusCode - que int representa el código de estado HTTP devuelto de la solicitud de operación.

etagFromHeader - String que especifica la etiqueta Etag devuelta con la respuesta de la operación.

opContext - Objeto OperationContext que representa el contexto para la operación actual.

options

Returns:

que TableResult representa el resultado de la operación.

Throws:

InstantiationException - si se produce un error en la construcción del objeto.

IllegalAccessException - si se produce un error en la reflexión en un tipo de objeto.

StorageException - si se produce un error en la operación de almacenamiento.

IOException - si se produce un error al obtener acceso a InputStream con Json.

JsonParseException - si se produce un error al analizar el json, si se usa Json.

replace

public static TableOperation replace(final TableEntity entity)

Un método de generador estático que devuelve una TableOperation instancia para reemplazar la entidad de tabla especificada. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método .

Parameters:

entity - Instancia de objeto que se implementa TableEntity para asociarse a la operación.

Returns:

TableOperation Nueva instancia de para reemplazar la entidad de tabla.

retrieve

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

Método de generador estático que devuelve una TableOperation instancia para recuperar la entidad de tabla especificada y devolverla como el tipo especificado. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia de con .

Parameters:

partitionKey - que String especifica el valor PartitionKey de la entidad que se va a recuperar.

rowKey - que String especifica el valor RowKey de la entidad que se va a recuperar.

clazzType - Tipo de clase del objeto de entidad de tabla que se va a recuperar.

Returns:

TableOperation Nueva instancia para recuperar la entidad de tabla.

retrieve

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

Un método de generador estático que devuelve una TableOperation instancia para recuperar la entidad de tabla especificada y devolver una proyección de ella mediante el solucionador especificado. Para ejecutarlo TableOperation en una tabla determinada, llame al execute(final TableOperation operation) método en una CloudTableClient instancia con el nombre de la tabla y como TableOperation argumentos.

Parameters:

partitionKey - que String especifica el valor PartitionKey de la entidad que se va a recuperar.

rowKey - que String especifica el valor RowKey de la entidad que se va a recuperar.

resolver - Implementación de EntityResolver<T> que se va a usar para proyectar la entidad de resultado como tipo T.

Returns:

TableOperation Nueva instancia para recuperar la entidad de tabla.

setEchoContent

protected void setEchoContent(boolean echoContent)

Establece el valor booleano que representa si se debe devolver la carga del mensaje en la respuesta.

Parameters:

echoContent -

true si la carga del mensaje debe devolverse en la respuesta; de lo contrario, false.

setEntity

protected synchronized final void setEntity(final TableEntity entity)

Reservado para uso interno. Establece la TableEntity instancia de para la operación de tabla.

Parameters:

entity - Instancia de TableEntity que se va a establecer.