TableOperation Klasse

Paket:

com.microsoft.azure.storage.table

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

public class TableOperation

Eine Klasse, die einen einzelnen Tabellenvorgang darstellt.

Verwenden Sie die statischen Factorymethoden, um Instanzen für Vorgänge für Tabellen zu erstellen TableOperation , die Tabellenentitäten einfügen, aktualisieren, zusammenführen, löschen, ersetzen oder abrufen. Um eine TableOperation instance auszuführen, rufen Sie die -Methode auf einem CloudTableClient instance auf. Ein TableOperation kann direkt oder als Teil eines TableBatchOperationausgeführt werden. Wenn ein TableOperation ein Entitätsergebnis zurückgibt, wird es in dem entsprechenden TableResult von der -Methode zurückgegebenen gespeichert.

Zusammenfassung zum Konstruktor

Konstruktor	Beschreibung
TableOperation()	Nullary-Standardkonstruktor.
TableOperation(final TableEntity entity, final TableOperationType opType)	Für die interne Verwendung reserviert. Erstellt eine TableOperation mit der angegebenen Tabellenentität und dem angegebenen Vorgangstyp.
TableOperation(final TableEntity entity, final TableOperationType opType, final boolean echoContent)	Für die interne Verwendung reserviert. Erstellt eine TableOperation mit der angegebenen Tabellenentität und dem angegebenen Vorgangstyp.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
TableOperation	delete(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität aus Microsoft Azure-Speicher zu löschen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem
TableResult	execute(final CloudTableClient client, final String tableName, TableRequestOptions options, OperationContext opContext) Für die interne Verwendung reserviert. Führen Sie diesen Tabellenvorgang für die angegebene Tabelle mit dem angegebenen TableRequestOptions und aus OperationContext. Diese Methode ruft die Speicherdienst-REST-API auf, um diesen Tabellenvorgang unter Verwendung des Tabellenendpunkts und der Anmeldeinformationen des Speicherkontos CloudTableClient im Objekt auszuführen.
String	generateRequestIdentity(boolean isSingleIndexEntry, final String entryName) Für die interne Verwendung reserviert. Generiert die Anforderungsidentität, die aus dem angegebenen Eintragsnamen oder dem PartitionKey- und RowKey-Paar aus dem Vorgang besteht, um das Vorgangsziel zu identifizieren.
String	generateRequestIdentityWithTable(final String tableName) Für die interne Verwendung reserviert. Generiert die Anforderungsidentitätszeichenfolge für die angegebene Tabelle. Die Anforderungsidentitätszeichenfolge kombiniert den Tabellennamen mit partitionKey und RowKey aus dem Vorgang, um bestimmte Tabellenentitäten zu identifizieren. Diese Anforderungsidentität ist bereits UrlEncoded.
boolean	getEchoContent() Ruft den booleschen Wert ab, der darstellt, ob die Nachrichtennutzlast in der Antwort zurückgegeben werden soll.
synchronized final TableEntity	getEntity() Für die interne Verwendung reserviert. Ruft die diesem Vorgang zugeordnete Tabellenentität ab.
synchronized final TableOperationType	getOperationType() Für die interne Verwendung reserviert. Ruft den Vorgangstyp für diesen Vorgang ab.
TableOperation	insert(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher einzufügen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem
TableOperation	insert(final TableEntity entity, boolean echoContent) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher einzufügen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem
TableOperation	insertOrMerge(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher zusammenzuführen oder sie einzufügen, falls sie nicht vorhanden ist. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.
TableOperation	insertOrReplace(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher zu ersetzen oder sie einzufügen, falls sie nicht vorhanden ist. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.
TableOperation	merge(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität in Microsoft Azure Storage zusammenzuführen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem
TableResult	parseResponse(final InputStream inStream, final int httpStatusCode, String etagFromHeader, final OperationContext opContext, final TableRequestOptions options) Für die interne Verwendung reserviert. Analysiert die Antwort des Tabellenvorgangs in eine TableResult , um zurückzugeben.
TableOperation	replace(final TableEntity entity) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität zu ersetzen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die -Methode auf execute(final TableOperation operation) .
TableOperation	retrieve(final String partitionKey, final String rowKey, final Class<? extends TableEntity> clazzType) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität abzurufen und als angegebenen Typ zurückzugeben. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem
TableOperation	retrieve(final String partitionKey, final String rowKey, final EntityResolver<?> resolver) Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität abzurufen und eine Projektion davon mithilfe des angegebenen Resolvers zurückzugeben. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.
void	setEchoContent(boolean echoContent) Legt den booleschen Wert fest, der darstellt, ob die Nachrichtennutzlast in der Antwort zurückgegeben werden soll.
synchronized final void	setEntity(final TableEntity entity) Für die interne Verwendung reserviert. Legt die TableEntity instance für den Tabellenvorgang fest.

Details zum Konstruktor

TableOperation

protected TableOperation()

Nullary-Standardkonstruktor.

TableOperation

protected TableOperation(final TableEntity entity, final TableOperationType opType)

Für die interne Verwendung reserviert. Erstellt eine TableOperation mit der angegebenen Tabellenentität und dem angegebenen Vorgangstyp.

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

opType - Der TableOperationType Enumerationswert für den Vorgangstyp.

TableOperation

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

Für die interne Verwendung reserviert. Erstellt eine TableOperation mit der angegebenen Tabellenentität und dem angegebenen Vorgangstyp.

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

opType - Der TableOperationType Enumerationswert für den Vorgangstyp.

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

Details zur Methode

delete

public static TableOperation delete(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität aus Microsoft Azure-Speicher zu löschen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Ein neuer TableOperation instance zum Einfügen der Tabellenentität.

execute

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

Für die interne Verwendung reserviert. Führen Sie diesen Tabellenvorgang für die angegebene Tabelle mit dem angegebenen TableRequestOptions und aus OperationContext.

Diese Methode ruft die Speicherdienst-REST-API auf, um diesen Tabellenvorgang unter Verwendung des Tabellenendpunkts und der Anmeldeinformationen des Speicherkontos CloudTableClient im Objekt auszuführen.

Parameter:

client - Eine CloudTableClient instance, die den Tabellendienstendpunkt, die Anmeldeinformationen des Speicherkontos und alle zusätzlichen Abfrageparameter angibt.

tableName - Ein String , der den Namen der Tabelle angibt.

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.

Gibt zurück:

Ein TableResult , der die Ergebnisse der Ausführung des Vorgangs darstellt.

Löst aus:

StorageException - , wenn im Speichervorgang ein Fehler auftritt.

generateRequestIdentity

protected String generateRequestIdentity(boolean isSingleIndexEntry, final String entryName)

Für die interne Verwendung reserviert. Generiert die Anforderungsidentität, die aus dem angegebenen Eintragsnamen oder dem PartitionKey- und RowKey-Paar aus dem Vorgang besteht, um das Vorgangsziel zu identifizieren.

Parameter:

isSingleIndexEntry - Übergeben Sie true , um den angegebenen entryName Parameter zu verwenden, oder false um PartitionKey- und RowKey-Werte aus dem Vorgang als Anforderungsidentität zu verwenden.

entryName - Der Eintragsname, der als Anforderungsidentität verwendet werden soll, wenn der isSingleIndexEntry Parameter lautet true.

Gibt zurück:

Eine String , die die formatierte Anforderungsidentitätszeichenfolge darstellt.

Löst aus:

StorageException - Wenn ein Speicherdienstfehler aufgetreten ist.

generateRequestIdentityWithTable

protected String generateRequestIdentityWithTable(final String tableName)

Für die interne Verwendung reserviert. Generiert die Anforderungsidentitätszeichenfolge für die angegebene Tabelle. Die Anforderungsidentitätszeichenfolge kombiniert den Tabellennamen mit partitionKey und RowKey aus dem Vorgang, um bestimmte Tabellenentitäten zu identifizieren. Diese Anforderungsidentität ist bereits UrlEncoded.

Parameter:

tableName - Ein String , der den Namen der Tabelle angibt.

Gibt zurück:

Eine String , die die formatierte Anforderungsidentitätszeichenfolge für die angegebene Tabelle darstellt.

Löst aus:

StorageException

getEchoContent

protected boolean getEchoContent()

Ruft den booleschen Wert ab, der darstellt, ob die Nachrichtennutzlast in der Antwort zurückgegeben werden soll.

Gibt zurück:

true , wenn die Nachrichtennutzlast in der Antwort zurückgegeben werden soll; Andernfalls false

getEntity

protected synchronized final TableEntity getEntity()

Für die interne Verwendung reserviert. Ruft die diesem Vorgang zugeordnete Tabellenentität ab.

Gibt zurück:

Der TableEntity diesem Vorgang zugeordnete instance.

getOperationType

protected synchronized final TableOperationType getOperationType()

Für die interne Verwendung reserviert. Ruft den Vorgangstyp für diesen Vorgang ab.

Gibt zurück:

der diesem Vorgang zugeordnete opType The TableOperationType instance.

insert

public static TableOperation insert(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher einzufügen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Ein neuer TableOperation instance zum Einfügen der Tabellenentität.

insert

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

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher einzufügen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

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

Gibt zurück:

Ein neuer TableOperation instance zum Einfügen der Tabellenentität.

insertOrMerge

public static TableOperation insertOrMerge(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher zusammenzuführen oder sie einzufügen, falls sie nicht vorhanden ist. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Eine neue TableOperation instance zum Einfügen oder Zusammenführen der Tabellenentität.

insertOrReplace

public static TableOperation insertOrReplace(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Entität in Microsoft Azure-Speicher zu ersetzen oder sie einzufügen, falls sie nicht vorhanden ist. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Ein neuer TableOperation instance zum Einfügen oder Ersetzen der Tabellenentität.

merge

public static TableOperation merge(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität in Microsoft Azure Storage zusammenzuführen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Ein neuer TableOperation instance zum Zusammenführen der Tabellenentität.

parseResponse

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

Für die interne Verwendung reserviert. Analysiert die Antwort des Tabellenvorgangs in eine TableResult , um zurückzugeben.

Parameter:

inStream - Ein InputStream , der die Antwort auf einen Einfügevorgang angibt.

httpStatusCode - Ein int , der den http-status Code darstellt, der von der Vorgangsanforderung zurückgegeben wird.

etagFromHeader - Der String , der das mit der Vorgangsantwort zurückgegebene Etag angibt.

opContext - Ein OperationContext-Objekt, das den Kontext für den aktuellen Vorgang darstellt.

options

Gibt zurück:

Der TableResult , der das Ergebnis des Vorgangs darstellt.

Löst aus:

InstantiationException - , wenn bei der Objektkonstruktion ein Fehler auftritt.

IllegalAccessException - , wenn bei der Reflektion für einen Objekttyp ein Fehler auftritt.

StorageException - , wenn im Speichervorgang ein Fehler auftritt.

IOException - , wenn beim Zugriff auf mit InputStream JSON ein Fehler auftritt.

JsonParseException - , wenn beim Analysieren des Json-Objekts ein Fehler auftritt, wenn JSON verwendet wird.

replace

public static TableOperation replace(final TableEntity entity)

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität zu ersetzen. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die -Methode auf execute(final TableOperation operation) .

Parameter:

entity - Das Objekt instance implementierenTableEntity, um es dem Vorgang zuzuordnen.

Gibt zurück:

Ein neuer TableOperation instance zum Ersetzen der Tabellenentität.

retrieve

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

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität abzurufen und als angegebenen Typ zurückzugeben. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einem CloudTableClient instance mit dem

Parameter:

partitionKey - Ein String , der den PartitionKey-Wert für die abzurufende Entität angibt.

rowKey - Ein String , der den RowKey-Wert für die abzurufende Entität angibt.

clazzType - Der Klassentyp des abzurufenden Tabellenentitätsobjekts.

Gibt zurück:

Eine neue TableOperation instance zum Abrufen der Tabellenentität.

retrieve

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

Eine statische Factorymethode, die eine TableOperation instance zurückgibt, um die angegebene Tabellenentität abzurufen und eine Projektion davon mithilfe des angegebenen Resolvers zurückzugeben. Um dies TableOperation für eine bestimmte Tabelle auszuführen, rufen Sie die execute(final TableOperation operation) -Methode auf einer CloudTableClient instance mit dem Tabellennamen und den TableOperation als Argumenten auf.

Parameter:

partitionKey - Ein String , der den PartitionKey-Wert für die abzurufende Entität angibt.

rowKey - Ein String , der den RowKey-Wert für die abzurufende Entität angibt.

resolver - Die Implementierung von, EntityResolver<T> um die Ergebnisentität als Typ T zu projizieren.

Gibt zurück:

Eine neue TableOperation instance zum Abrufen der Tabellenentität.

setEchoContent

protected void setEchoContent(boolean echoContent)

Legt den booleschen Wert fest, der darstellt, ob die Nachrichtennutzlast in der Antwort zurückgegeben werden soll.

Parameter:

echoContent -

true , wenn die Nachrichtennutzlast in der Antwort zurückgegeben werden soll; andernfalls false.

setEntity

protected synchronized final void setEntity(final TableEntity entity)

Für die interne Verwendung reserviert. Legt die TableEntity instance für den Tabellenvorgang fest.

Parameter:

entity - Die festzulegende TableEntity-Instanz.