你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TableOperation 类

包:

com.microsoft.azure.storage.table

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

public class TableOperation

表示单个表操作的类。

使用静态工厂方法为插入、更新、合并、删除、替换或检索表实体的表的操作构造 TableOperation 实例。 若要执行 TableOperation 实例，请在 实例上 CloudTableClient 调用 方法。 TableOperation可以直接执行，也可以作为 的一TableBatchOperation部分执行。 TableOperation如果 返回实体结果，则它存储在 方法返回的相应 TableResult 中。

构造函数摘要

构造函数	说明
TableOperation()	空默认构造函数。
TableOperation(final TableEntity entity, final TableOperationType opType)	保留以供内部使用。 TableOperation使用指定的表实体和操作类型构造 。
TableOperation(final TableEntity entity, final TableOperationType opType, final boolean echoContent)	保留以供内部使用。 TableOperation使用指定的表实体和操作类型构造 。

方法摘要

修饰符和类型	方法和描述
TableOperation	delete(final TableEntity entity) 一种静态工厂方法，返回 TableOperation 实例以从 Microsoft Azure 存储中删除指定实体。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient
TableResult	execute(final CloudTableClient client, final String tableName, TableRequestOptions options, OperationContext opContext) 保留以供内部使用。 使用 TableRequestOptions 指定的 和 OperationContext对指定的表执行此表操作。 此方法将使用 对象中的 CloudTableClient 表服务终结点和存储帐户凭据调用存储服务 REST API 来执行此表操作。
String	generateRequestIdentity(boolean isSingleIndexEntry, final String entryName) 保留以供内部使用。 生成请求标识，由指定的条目名称或操作中的 PartitionKey 和 RowKey 对组成，以标识操作目标。
String	generateRequestIdentityWithTable(final String tableName) 保留以供内部使用。 为指定表生成请求标识字符串。 请求标识字符串将表名与操作中的 PartitionKey 和 RowKey 组合在一起，以标识特定的表实体。 此请求标识已为 UrlEncoded。
boolean	getEchoContent() 获取表示是否应在响应中返回消息有效负载的布尔值。
synchronized final TableEntity	getEntity() 保留以供内部使用。 获取与此操作关联的表实体。
synchronized final TableOperationType	getOperationType() 保留以供内部使用。 获取此操作的操作类型。
TableOperation	insert(final TableEntity entity) 一种静态工厂方法，返回实例 TableOperation 以将指定的实体插入 Microsoft Azure 存储。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient
TableOperation	insert(final TableEntity entity, boolean echoContent) 一种静态工厂方法，返回实例 TableOperation 以将指定的实体插入 Microsoft Azure 存储。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient
TableOperation	insertOrMerge(final TableEntity entity) 一种静态工厂方法，用于 TableOperation 返回实例以将指定的实体合并到 Microsoft Azure 存储中，或将其插入（如果不存在）。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。
TableOperation	insertOrReplace(final TableEntity entity) 静态工厂方法，返回 TableOperation 实例以替换 Microsoft Azure 存储中的指定实体，或插入该实体（如果不存在）。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。
TableOperation	merge(final TableEntity entity) 一种静态工厂方法，返回实例 TableOperation 以将指定的表实体合并到 Microsoft Azure 存储中。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient
TableResult	parseResponse(final InputStream inStream, final int httpStatusCode, String etagFromHeader, final OperationContext opContext, final TableRequestOptions options) 保留以供内部使用。 将表操作响应分析为 TableResult 要返回的 。
TableOperation	replace(final TableEntity entity) 一种静态工厂方法，返回 TableOperation 实例以替换指定的表实体。 若要在给定表上执行此操作 TableOperation ，请 execute(final TableOperation operation) 调用 方法。
TableOperation	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) 一种静态工厂方法，返回 TableOperation 实例以检索指定的表实体并将其作为指定类型返回。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient
TableOperation	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) 一种静态工厂方法，返回 TableOperation 实例以检索指定的表实体，并使用指定的冲突解决程序返回该实体的投影。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。
void	setEchoContent(boolean echoContent) 设置一个布尔值，该值表示是否应在响应中返回消息有效负载。
synchronized final void	setEntity(final TableEntity entity) 保留以供内部使用。 TableEntity设置表操作的 实例。

构造函数详细信息

TableOperation

protected TableOperation()

空默认构造函数。

TableOperation

protected TableOperation(final TableEntity entity, final TableOperationType opType)

保留以供内部使用。 TableOperation使用指定的表实体和操作类型构造 。

参数:

entity - 实现 TableEntity 以与操作关联的对象实例。

opType - TableOperationType操作类型的枚举值。

TableOperation

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

保留以供内部使用。 TableOperation使用指定的表实体和操作类型构造 。

参数:

entity - 实现 TableEntity 以与操作关联的对象实例。

opType - TableOperationType操作类型的枚举值。

echoContent - 表示是否应在响应中返回消息有效负载的布尔值。

方法详细信息

delete

public static TableOperation delete(final TableEntity entity)

一种静态工厂方法，返回 TableOperation 实例以从 Microsoft Azure 存储中删除指定实体。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

要插入表实体的新 TableOperation 实例。

execute

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

保留以供内部使用。 使用 TableRequestOptions 指定的 和 OperationContext对指定的表执行此表操作。

此方法将使用 对象中的 CloudTableClient 表服务终结点和存储帐户凭据调用存储服务 REST API 来执行此表操作。

参数:

client - 指定 CloudTableClient 表服务终结点、存储帐户凭据和任何其他查询参数的实例。

tableName - 一个 String 指定表名称的 。

options - 一个 TableRequestOptions 对象，该对象指定执行选项，例如操作的重试策略和超时设置。

opContext - 用于跟踪当前操作的 OperationContext 对象。

返回:

， TableResult 它表示执行操作的结果。

引发:

StorageException - 如果存储操作中发生错误，则为 。

generateRequestIdentity

protected String generateRequestIdentity(boolean isSingleIndexEntry, final String entryName)

保留以供内部使用。 生成请求标识，由指定的条目名称或操作中的 PartitionKey 和 RowKey 对组成，以标识操作目标。

参数:

isSingleIndexEntry - 传递 true 以使用指定的 entryName 参数，或 false 将操作中的 PartitionKey 和 RowKey 值用作请求标识。

entryName - 如果 参数为 true，则用作请求标识的isSingleIndexEntry条目名称。

返回:

一个 String ，它表示格式化的请求标识字符串。

引发:

StorageException - 如果发生存储服务错误。

generateRequestIdentityWithTable

protected String generateRequestIdentityWithTable(final String tableName)

保留以供内部使用。 为指定表生成请求标识字符串。 请求标识字符串将表名与操作中的 PartitionKey 和 RowKey 组合在一起，以标识特定的表实体。 此请求标识已为 UrlEncoded。

参数:

tableName - 一个 String 指定表名称的 。

返回:

一个 ， String 表示指定表的格式化请求标识字符串。

引发:

StorageException

getEchoContent

protected boolean getEchoContent()

获取表示是否应在响应中返回消息有效负载的布尔值。

返回:

true 如果应在响应中返回消息有效负载，则为 ;否则 false

getEntity

protected synchronized final TableEntity getEntity()

保留以供内部使用。 获取与此操作关联的表实体。

返回:

与 TableEntity 此操作关联的实例。

getOperationType

protected synchronized final TableOperationType getOperationType()

保留以供内部使用。 获取此操作的操作类型。

返回:

opType 与 TableOperationType 此操作关联的实例。

insert

public static TableOperation insert(final TableEntity entity)

一种静态工厂方法，返回实例 TableOperation 以将指定的实体插入 Microsoft Azure 存储。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

要插入表实体的新 TableOperation 实例。

insert

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

一种静态工厂方法，返回实例 TableOperation 以将指定的实体插入 Microsoft Azure 存储。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

echoContent - 表示是否应在响应中返回消息有效负载的布尔值。

返回:

要插入表实体的新 TableOperation 实例。

insertOrMerge

public static TableOperation insertOrMerge(final TableEntity entity)

一种静态工厂方法，用于 TableOperation 返回实例以将指定的实体合并到 Microsoft Azure 存储中，或将其插入（如果不存在）。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

用于插入或合并表实体的新 TableOperation 实例。

insertOrReplace

public static TableOperation insertOrReplace(final TableEntity entity)

静态工厂方法，返回 TableOperation 实例以替换 Microsoft Azure 存储中的指定实体，或插入该实体（如果不存在）。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

用于插入或替换表实体的新 TableOperation 实例。

merge

public static TableOperation merge(final TableEntity entity)

一种静态工厂方法，返回实例 TableOperation 以将指定的表实体合并到 Microsoft Azure 存储中。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

用于合并表实体的新 TableOperation 实例。

parseResponse

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

保留以供内部使用。 将表操作响应分析为 TableResult 要返回的 。

参数:

inStream - 一个 InputStream ，指定对插入操作的响应。

httpStatusCode - 一个 int ，表示从操作请求返回的 HTTP 状态代码。

etagFromHeader - 指定 String 随操作响应一起返回的 Etag 的 。

opContext - 一个 OperationContext 对象，它一个表示当前操作的上下文。

options

返回:

表示 TableResult 操作结果的 。

引发:

InstantiationException - 如果对象构造中发生错误，则为 。

IllegalAccessException - 如果在对象类型上的反射中发生错误，则为 。

StorageException - 如果存储操作中发生错误，则为 。

IOException - 如果使用 Json 访问 时 InputStream 发生错误，则为 。

JsonParseException - 如果分析 Json 时发生错误，则为 ;如果使用 Json，则为 。

replace

public static TableOperation replace(final TableEntity entity)

一种静态工厂方法，返回 TableOperation 实例以替换指定的表实体。 若要在给定表上执行此操作 TableOperation ，请 execute(final TableOperation operation) 调用 方法。

参数:

entity - 要与操作关联的实现 TableEntity 的对象实例。

返回:

用于替换表实体的新 TableOperation 实例。

retrieve

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

一种静态工厂方法，返回 TableOperation 实例以检索指定的表实体并将其作为指定类型返回。 若要在给定表上执行此操作TableOperation，请使用 对 实例调用 execute(final TableOperation operation) 方法CloudTableClient

参数:

partitionKey - 一个 ， String 它指定要检索的实体的 PartitionKey 值。

rowKey - 一个 ， String 它指定要检索的实体的 RowKey 值。

clazzType - 要检索的表实体对象的类类型。

返回:

用于检索表实体的新 TableOperation 实例。

retrieve

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

一种静态工厂方法，返回 TableOperation 实例以检索指定的表实体，并使用指定的冲突解决程序返回该实体的投影。 若要对给定表执行此方法TableOperation，请在具有表名称和 TableOperation 作为参数的 实例上CloudTableClient调用 execute(final TableOperation operation) 方法。

参数:

partitionKey - 一个 ， String 它指定要检索的实体的 PartitionKey 值。

rowKey - 一个 ， String 它指定要检索的实体的 RowKey 值。

resolver - 要用于将结果实体投影为 T 类型的 的实现 EntityResolver<T> 。

返回:

用于检索表实体的新 TableOperation 实例。

setEchoContent

protected void setEchoContent(boolean echoContent)

设置一个布尔值，该值表示是否应在响应中返回消息有效负载。

参数:

echoContent -

true 如果应在响应中返回消息有效负载，则为 ;否则为 false。

setEntity

protected synchronized final void setEntity(final TableEntity entity)

保留以供内部使用。 TableEntity设置表操作的 实例。

参数:

entity - 要设置的 TableEntity 实例。