TableBatchOperation Klasse

Paket:

com.microsoft.azure.storage.table

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

public class TableBatchOperation

Eine Klasse, die einen Batchvorgang darstellt. Ein Batchvorgang ist eine Sammlung von Tabellenvorgängen, die von der Speicherdienst-REST-API als einzelner atomarer Vorgang ausgeführt werden, indem eine Entitätsgruppentransaktion aufgerufen wird.

Ein Batchvorgang kann bis zu 100 einzelne Tabellenvorgänge umfassen, und zwar mit der Anforderung, dass jede Vorgangsentität über denselben Partitionsschlüssel verfügen muss. Ein Batch mit einem Abrufvorgang kann keine anderen Vorgänge umfassen. Beachten Sie, dass die Gesamtnutzlast eines Batchvorgangs auf 4 MB begrenzt ist.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
void	add(final int index, final TableOperation element) Fügt den Tabellenvorgang am angegebenen Index im Batchvorgang hinzu.
boolean	add(final TableOperation element) Fügt dem Batchvorgang den Tabellenvorgang hinzu.
boolean	addAll(final int index, final java.util.Collection<? extends TableOperation> c) Fügt die Auflistung von Tabellenvorgängen zum Batchvorgang ab dem angegebenen Index hinzu.
boolean	addAll(final java.util.Collection<? extends TableOperation> c) Fügt dem Batchvorgang die Auflistung von Tabellenvorgängen hinzu.
void	clear() Löscht alle Tabellenvorgänge aus dem Batchvorgang.
void	delete(final TableEntity entity) Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um die angegebene Entität zu löschen.
ArrayList<TableResult>	execute(final CloudTableClient client, final String tableName, final TableRequestOptions options, final OperationContext opContext) Für die interne Verwendung reserviert. Führt diesen Batchvorgang für die angegebene Tabelle unter Verwendung der angegebenen TableRequestOptions und aus OperationContext. Diese Methode ruft die Speicherdienst-REST-API auf, um diesen Batchvorgang auszuführen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos CloudTableClient im Objekt verwendet werden.
void	insert(final TableEntity entity) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen.
void	insert(final TableEntity entity, boolean echoContent) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen.
void	insertOrMerge(final TableEntity entity) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen oder zusammenzuführen.
void	insertOrReplace(final TableEntity entity) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität dem Batchvorgang einzufügen oder zu ersetzen.
void	merge(final TableEntity entity) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität mit dem Batchvorgang zusammenzuführen.
TableOperation	remove(int index) Entfernt den Tabellenvorgang am angegebenen Index aus dem Batchvorgang.
boolean	remove(Object o) Entfernt das angegebene aus dem Batchvorgang.
boolean	removeAll(java.util.Collection<?> c) Entfernt alle Elemente der angegebenen Auflistung aus dem Batchvorgang.
void	removeRange(int fromIndex, int toIndex) Für die interne Verwendung reserviert. Entfernt alle Tabellenvorgänge an Indizes im angegebenen Bereich aus dem Batchvorgang .
void	replace(final TableEntity entity) Fügt einen Tabellenvorgang hinzu, um die angegebene Entität zum Batchvorgang zu ersetzen.
void	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um eine Entität des angegebenen Klassentyps mit dem angegebenen PartitionKey und RowKey abzurufen.
void	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um eine Entität des angegebenen Klassentyps mit dem angegebenen PartitionKey und RowKey abzurufen.

Details zur Methode

add

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

Fügt den Tabellenvorgang am angegebenen Index im Batchvorgang hinzu.

Parameters:

index - Ein int , der den Index im Batchvorgang ArrayList darstellt, um den Tabellenvorgang hinzuzufügen.

element - Der TableOperation , der dem Batchvorgang hinzugefügt werden soll.

add

public boolean add(final TableOperation element)

Fügt dem Batchvorgang den Tabellenvorgang hinzu.

Parameters:

element - Der TableOperation , der dem Batchvorgang hinzugefügt werden soll.

Returns:

true , wenn der Vorgang erfolgreich hinzugefügt wurde.

addAll

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

Fügt die Auflistung von Tabellenvorgängen zum Batchvorgang ab dem angegebenen Index hinzu.

Parameters:

index - Ein int , der den Index im Batchvorgang ArrayList darstellt, um den Tabellenvorgang hinzuzufügen.

c - Eine java.util.Collection der TableOperation Objekte, die dem Batchvorgang hinzugefügt werden sollen.

Returns:

true , wenn die Vorgänge erfolgreich hinzugefügt wurden.

addAll

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

Fügt dem Batchvorgang die Auflistung von Tabellenvorgängen hinzu.

Parameters:

c - Eine java.util.Collection der TableOperation Objekte, die dem Batchvorgang hinzugefügt werden sollen.

Returns:

true , wenn die Vorgänge erfolgreich hinzugefügt wurden.

clear

public void clear()

Löscht alle Tabellenvorgänge aus dem Batchvorgang.

delete

public void delete(final TableEntity entity)

Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um die angegebene Entität zu löschen.

Parameters:

entity - Der TableEntity zu löschende.

execute

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

Für die interne Verwendung reserviert. Führt diesen Batchvorgang für die angegebene Tabelle unter Verwendung der angegebenen TableRequestOptions und aus OperationContext.

Diese Methode ruft die Speicherdienst-REST-API auf, um diesen Batchvorgang auszuführen, wobei der Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos CloudTableClient im Objekt verwendet werden.

Parameters:

client - Eine CloudTableClient instance, die den zu verwendenden Tabellendienstendpunkt und die Anmeldeinformationen des Speicherkontos angibt.

tableName - Ein String , der den Namen der Tabelle enthält.

options - Ein TableRequestOptions -Objekt, das Ausführungsoptionen wie Wiederholungsrichtlinie und Timeouteinstellungen für den Vorgang angibt.

opContext - Ein OperationContext-Objekt für die Nachverfolgung des aktuellen Vorgangs.

Returns:

Ein ArrayList von TableResult , das die Ergebnisse der Ausführung des Vorgangs enthält.

Throws:

StorageException - , wenn im Speichervorgang ein Fehler auftritt.

insert

public void insert(final TableEntity entity)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen.

Parameters:

entity - Der einzufügende TableEntity.

insert

public void insert(final TableEntity entity, boolean echoContent)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen.

Parameters:

entity - Der einzufügende TableEntity.

echoContent - Der boolesche Wert, der angibt, ob die Nachrichtennutzlast in der Antwort zurückgegeben werden soll.

insertOrMerge

public void insertOrMerge(final TableEntity entity)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität in den Batchvorgang einzufügen oder zusammenzuführen.

Parameters:

entity - Der TableEntity , der eingefügt werden soll, wenn er nicht gefunden wird, oder zum Zusammenführen, wenn es vorhanden ist.

insertOrReplace

public void insertOrReplace(final TableEntity entity)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität dem Batchvorgang einzufügen oder zu ersetzen.

Parameters:

entity - Der TableEntity , der eingefügt werden soll, wenn nicht gefunden oder ersetzt werden soll, wenn er vorhanden ist.

merge

public void merge(final TableEntity entity)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität mit dem Batchvorgang zusammenzuführen.

Parameters:

entity - Die zusammenzuführende TableEntity.

remove

public TableOperation remove(int index)

Entfernt den Tabellenvorgang am angegebenen Index aus dem Batchvorgang.

Parameters:

index - Ein int , der den Index im ArrayList Tabellenvorgang darstellt, der aus dem Batchvorgang entfernt werden soll.

remove

public boolean remove(Object o)

Entfernt das angegebene aus dem Batchvorgang.

Parameters:

o - Der Object , der aus dem Batchvorgang entfernt werden soll.

Returns:

true , wenn das Objekt erfolgreich entfernt wurde.

removeAll

public boolean removeAll(java.util.Collection c)

Entfernt alle Elemente der angegebenen Auflistung aus dem Batchvorgang.

Parameters:

c - Die Auflistung der Elemente, die aus dem Batchvorgang entfernt werden sollen.

Returns:

true , wenn die Objekte in der Auflistung erfolgreich entfernt wurden.

removeRange

protected void removeRange(int fromIndex, int toIndex)

Für die interne Verwendung reserviert. Entfernt alle Tabellenvorgänge an Indizes im angegebenen Bereich aus dem Batchvorgang .

Parameters:

fromIndex - Eine int , die die inklusive Untergrenze des Bereichs von TableOperation Objekten darstellt, die aus dem Batchvorgang ArrayListentfernt werden sollen.

toIndex - Eine int , die die exklusive Obergrenze des Bereichs von TableOperation Objekten darstellt, die aus dem Batchvorgang ArrayListentfernt werden sollen.

replace

public void replace(final TableEntity entity)

Fügt einen Tabellenvorgang hinzu, um die angegebene Entität zum Batchvorgang zu ersetzen.

Parameters:

entity - Der zu ersetzende TableEntity.

retrieve

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

Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um eine Entität des angegebenen Klassentyps mit dem angegebenen PartitionKey und RowKey abzurufen.

Parameters:

partitionKey - Ein String , der den PartitionKey der abzurufenden Entität enthält.

rowKey - Ein String , der den RowKey der abzurufenden Entität enthält.

clazzType - Die -Klasse des TableEntity Typs für die abzurufende Entität.

retrieve

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

Fügt dem Batchvorgang einen Tabellenvorgang hinzu, um eine Entität des angegebenen Klassentyps mit dem angegebenen PartitionKey und RowKey abzurufen.

Parameters:

partitionKey - Ein String , der den PartitionKey der abzurufenden Entität enthält.

rowKey - Ein String , der den RowKey der abzurufenden Entität enthält.

resolver - Die EntityResolver<T>-Implementierung zum Projizieren der Entität als einen bestimmten Typ im Ergebnis.