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

TableBatchOperation 类

包:

com.microsoft.azure.storage.table

• java.lang.Object
• • java.util.ArrayList<TableOperation>
  • • com.microsoft.azure.storage.table.TableBatchOperation

public class TableBatchOperation

表示批处理操作的类。 批处理操作是表操作的集合，存储服务 REST API 通过调用 实体组事务作为单个原子操作执行这些操作。

一个批处理操作最多可以包含 100 个不同的表操作，但要求是每个操作实体必须具有相同的分区键。 包含检索操作的批处理不能包含任何其他操作。 请注意，批处理操作的总负载限制为 4MB。

方法摘要

修饰符和类型	方法和描述
void	add(final int index, final TableOperation element) 在批处理操作 的指定索引处添加表操作。
boolean	add(final TableOperation element) 将表操作添加到批处理操作 。
boolean	addAll(final int index, final java.util.Collection<? extends TableOperation> c) 从指定索引开始，将表操作的集合添加到批处理操作中。
boolean	addAll(final java.util.Collection<? extends TableOperation> c) 将表操作的集合添加到批处理操作 。
void	clear() 清除批处理操作中的所有表操作。
void	delete(final TableEntity entity) 添加表操作以删除批处理操作中的指定实体。
ArrayList<TableResult>	execute(final CloudTableClient client, final String tableName, final TableRequestOptions options, final OperationContext opContext) 保留以供内部使用。 使用 TableRequestOptions 指定的 和 OperationContext对指定的表执行此批处理操作。 此方法将使用 对象中的 CloudTableClient 表服务终结点和存储帐户凭据调用存储服务 REST API 来执行此批处理操作。
void	insert(final TableEntity entity) 添加表操作以将指定的实体插入批处理操作。
void	insert(final TableEntity entity, boolean echoContent) 添加表操作以将指定的实体插入批处理操作。
void	insertOrMerge(final TableEntity entity) 添加表操作，以将指定的实体插入或合并到批处理操作。
void	insertOrReplace(final TableEntity entity) 添加表操作以插入或替换指定实体到批处理操作。
void	merge(final TableEntity entity) 添加表操作，以将指定的实体合并到批处理操作。
TableOperation	remove(int index) 从批处理操作中删除指定索引处的表操作。
boolean	remove(Object o) 从批处理操作中删除指定的 。
boolean	removeAll(java.util.Collection<?> c) 从批处理操作中删除指定集合的所有元素。
void	removeRange(int fromIndex, int toIndex) 保留以供内部使用。 从批处理操作 中删除指定范围内索引处的所有表操作。
void	replace(final TableEntity entity) 添加表操作以将指定的实体替换为批处理操作。
void	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) 向批处理操作添加表操作以检索具有指定 PartitionKey 和 RowKey 的指定类类型的实体。
void	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) 向批处理操作添加表操作以检索具有指定 PartitionKey 和 RowKey 的指定类类型的实体。

方法详细信息

add

public void add(final int index, final TableOperation element)

在批处理操作 的指定索引处添加表操作。

参数:

index - 一个 int ，它表示批处理操作 ArrayList 中要添加表操作的索引。

element - TableOperation要添加到批处理操作的 。

add

public boolean add(final TableOperation element)

将表操作添加到批处理操作 。

参数:

element - TableOperation要添加到批处理操作的 。

返回:

true 如果已成功添加操作，则为 。

addAll

public boolean addAll(final int index, final java.util.Collection c)

从指定索引开始，将表操作的集合添加到批处理操作中。

参数:

index - 一个 int ，它表示批处理操作 ArrayList 中要添加表操作的索引。

c - java.util.Collection TableOperation要添加到批处理操作的 对象的 。

返回:

true 如果已成功添加操作，则为 。

addAll

public boolean addAll(final java.util.Collection c)

将表操作的集合添加到批处理操作 。

参数:

c - java.util.Collection TableOperation要添加到批处理操作的 对象的 。

返回:

true 如果已成功添加操作，则为 。

clear

public void clear()

清除批处理操作中的所有表操作。

delete

public void delete(final TableEntity entity)

添加表操作以删除批处理操作中的指定实体。

参数:

entity - TableEntity要删除的 。

execute

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

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

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

参数:

client - 指定 CloudTableClient 要使用的表服务终结点和存储帐户凭据的实例。

tableName - 包含 String 表名称的 。

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

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

返回:

一个 ArrayList ， TableResult 包含执行操作的结果。

引发:

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

insert

public void insert(final TableEntity entity)

添加表操作以将指定的实体插入批处理操作。

参数:

entity - 要插入的 TableEntity。

insert

public void insert(final TableEntity entity, boolean echoContent)

添加表操作以将指定的实体插入批处理操作。

参数:

entity - 要插入的 TableEntity。

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

insertOrMerge

public void insertOrMerge(final TableEntity entity)

添加表操作，以将指定的实体插入或合并到批处理操作。

参数:

entity - 要 TableEntity 插入（如果未找到）或合并（如果存在）。

insertOrReplace

public void insertOrReplace(final TableEntity entity)

添加表操作以插入或替换指定实体到批处理操作。

参数:

entity - TableEntity要插入（如果未找到）或替换（如果存在）。

merge

public void merge(final TableEntity entity)

添加表操作，以将指定的实体合并到批处理操作。

参数:

entity - 要合并的 TableEntity。

remove

public TableOperation remove(int index)

从批处理操作中删除指定索引处的表操作。

参数:

index - 一个 int ，它表示要从批处理操作中删除的表操作的 中的索引 ArrayList 。

remove

public boolean remove(Object o)

从批处理操作中删除指定的 。

参数:

o - Object要从批处理操作中删除的 。

返回:

true 如果已成功删除对象，则为 。

removeAll

public boolean removeAll(java.util.Collection c)

从批处理操作中删除指定集合的所有元素。

参数:

c - 要从批处理操作中删除的元素集合。

返回:

true 如果已成功删除集合中的对象，则为 。

removeRange

protected void removeRange(int fromIndex, int toIndex)

保留以供内部使用。 从批处理操作 中删除指定范围内索引处的所有表操作。

参数:

fromIndex - 一个 ，int它表示要从批处理操作 ArrayList中删除的对象TableOperation范围的非独占下限。

toIndex - 一个 int ，它表示要从批处理操作 ArrayList中删除的对象TableOperation范围的独占上限。

replace

public void replace(final TableEntity entity)

添加表操作以将指定的实体替换为批处理操作。

参数:

entity - 要替换的 TableEntity。

retrieve

public void retrieve(final String partitionKey, final String rowKey, final Class clazzType)

向批处理操作添加表操作以检索具有指定 PartitionKey 和 RowKey 的指定类类型的实体。

参数:

partitionKey - 包含 String 要检索的实体的 PartitionKey 的 。

rowKey - 包含 String 要检索的实体的 RowKey 的 。

clazzType - 要检索的 TableEntity 实体的 类型的类。

retrieve

public void retrieve(final String partitionKey, final String rowKey, final EntityResolver resolver)

向批处理操作添加表操作以检索具有指定 PartitionKey 和 RowKey 的指定类类型的实体。

参数:

partitionKey - 包含 String 要检索的实体的 PartitionKey 的 。

rowKey - 包含 String 要检索的实体的 RowKey 的 。

resolver - 实体要在结果中作为特定类型检索的项目的 EntityResolver<T> 实现。