com.microsoft.azure.storage.table

Klassen

CloudTable	Stellt eine Tabelle im Microsoft Azure Table-Dienst dar.
CloudTableClient	Stellt einen Dienstclient für den Zugriff auf den Microsoft Azure Table-Dienst bereit. Die CloudTableClient -Klasse kapselt den Basis-URI für den Tabellendienstendpunkt und die Anmeldeinformationen für den Zugriff auf das Speicherkonto und stellt Methoden zum Erstellen, Löschen, Auflisten und Abfragen von Tabellen sowie Methoden zum Ausführen von Vorgängen und Abfragen für Tabellenentitäten bereit. Diese Methoden rufen Speicherdienst-REST-API-Vorgänge auf, um die Anforderungen zu stellen und die zurückgegebenen Ergebnisse abzurufen. Ein Tabellendienstendpunkt ist der Basis-URI für Tabellendienstressourcen, einschließlich des DNS-Namens des Speicherkontos: Weitere Informationen finden Sie im MSDN-Thema Adressierung von Tabellendienstressourcen. Bei den Anmeldeinformationen kann es sich um eine Kombination aus dem Namen des Speicherkontos und einem Schlüssel oder um eine gemeinsame Zugriffssignatur handeln. Weitere Informationen finden Sie im MSDN-Thema Authentifizieren des Zugriffs auf Ihr Speicherkonto.
DynamicTableEntity	Ein TableEntity-Typ, der Aufrufern den direkten Zugriff auf die Eigenschaftszuordnung der Entität ermöglicht. Diese Klasse wird erweitert TableServiceEntity , um die Verwendung von Reflektion für Serialisierung und Deserialisierung zu beseitigen.
EntityProperty	Eine Klasse, die einen einzelnen typisierten Eigenschaftswert in einer Tabellenentität darstellt. Ein EntityProperty speichert den Datentyp als .EdmType Der Wert, der für Objekttypen, aber nicht für primitive Typen sein kann, wird serialisiert und als gespeichert. EntityProperty stellt überladene Konstruktoren und Überladungen der -Methode für unterstützte Werttypen bereit. Jeder überladene Konstruktor oder jede Methode legt den EdmType wert fest und serialisiert den Wert entsprechend auf dem Parametertyp. Verwenden Sie eine der Type-Methoden , um einen EntityProperty als geeigneten Java-Typ zu deserialisieren. Die -Methode löst ein oder IllegalArgumentException ausParseException, wenn der EntityProperty nicht als Java-Typ deserialisiert werden kann.
QueryTableOperation	Eine Klasse, die erweitert TableOperation , um eine Abfrage zum Abrufen einer einzelnen Tabellenentität zu implementieren. Um eine QueryTableOperation instance auszuführen, rufen Sie die -Methode auf einem CloudTableClient instance auf. Dieser Vorgang kann direkt oder als Teil eines TableBatchOperationausgeführt werden. Wenn die QueryTableOperation ein Entitätsergebnis zurückgibt, wird es in dem entsprechenden TableResult von der -Methode zurückgegebenen gespeichert.
SharedAccessTablePolicy	Stellt eine Richtlinie für den gemeinsamen Zugriff dar, die die Startzeit, Ablaufzeit und Berechtigungen für eine SAS angibt.
TableBatchOperation	Eine Klasse, die einen Batchvorgang darstellt. Ein Batchvorgang ist eine Auflistung 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.
TableEncryptionPolicy	Stellt eine Tabellenverschlüsselungsrichtlinie dar, die zum Durchführen der Verschlüsselung/Entschlüsselung von Azure-Tabellenentitäten verwendet wird.
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.
TablePermissions	Stellt die Berechtigungen für eine Tabelle dar.
TableQuery<T>	Eine Klasse, die eine Abfrage für eine angegebene Tabelle darstellt. Ein TableQuery<T> instance aggregiert die Abfrageparameter, die beim Ausführen der Abfrage verwendet werden sollen. Eine der Methoden oder von CloudTableClient muss aufgerufen werden, um die Abfrage auszuführen. Die Parameter werden codiert und an den Server übergeben, wenn die Tabellenabfrage ausgeführt wird. Um eine Tabellenabfrage mit fluent-Syntax zu erstellen, geben die from(final Class<T> clazzType) statische Factory-Methode und die where(final String filter)Methoden , select(final String[] columns)und take(final Integer take) Mutator jeweils einen Verweis auf das -Objekt zurück, der in einem einzelnen Ausdruck verkettet werden kann. Verwenden Sie die factory-Methode der from(Class) statischen Klasse, um eine instance zu erstellen, die für die benannte Tabelle mit Entitäten des angegebenen TableEntity Implementierungstyps ausgeführt wird. Verwenden Sie die where(final String filter) -Methode, um einen Filterausdruck für die zurückgegebenen Entitäten anzugeben. Verwenden Sie die select(final String[] columns) -Methode, um die zurückzugebenden Tabellenentitätseigenschaften anzugeben. Verwenden Sie die take(final Integer take) -Methode, um die Anzahl der von der Abfrage zurückgegebenen Entitäten zu begrenzen. Beachten Sie, dass nichts verhindert, dass diese Methoden mehrmals auf einem aufgerufen werden, sodass die in gespeicherten Werte die zuletzt in der Reihenfolge der Ausführung gefundene sind. Als Beispiel könnten Sie eine Tabellenabfrage mit fluent-Syntax erstellen: In diesem Beispiel wird eine Abfrage für die Tabelle "Products" für alle Entitäten erstellt, bei denen der PartitionKey-Wert "ProductsMNO" und der RowKey-Wert größer oder gleich "Napkin" ist, und fordert die ersten 25 übereinstimmenden Entitäten an, wobei nur die allgemeinen Eigenschaften und die Eigenschaft mit dem Namen "InventoryCount" ausgewählt und als DynamicTableEntity Objekte zurückgegeben werden. Filterausdrücke für die Verwendung mit der -Methode oder setFilterString(final String filterString) -Methode können mithilfe der where(final String filter) fluent-Syntax mit den überladenen generateFilterCondition(String propertyName, String operation, final boolean value) Methoden und combineFilters(String filterA, String operator, String filterB) -Methoden erstellt werden, wobei die in QueryComparisons definierten Vergleichsoperatoren und die in Operatorsdefinierten logischen Operatoren verwendet werden. Beachten Sie, dass der erste Operand in einem Filtervergleich ein Eigenschaftsname und der zweite Operand als Konstante ausgewertet werden muss. Die PartitionKey- und RowKey-Eigenschaftswerte sind Typen zu Vergleichszwecken. Die Werte, die in Tabellenabfragen verwendet werden können, werden im MSDN-Thema Abfragen von Tabellen und Entitäten ausführlicher erläutert. Beachten Sie jedoch, dass die Leerzeichen innerhalb von Werten nicht URL-codiert werden müssen, da dies beim Ausführen der Abfrage geschieht. Die TableQuery#TableQuery(Class) Konstruktor- und TableQuery#from(Class) statischen Factorymethoden erfordern einen Klassentyp, der einen Nullary-Konstruktor implementiert TableEntity und enthält. Wenn die Abfrage mit einem EntityResolver<T>ausgeführt wird, kann der Aufrufer als Klassentyp angeben TableServiceEntity .
TableRequestOptions	Stellt einen Satz von Timeout-, Nutzlastformat- und Wiederholungsrichtlinienoptionen dar, die für eine Tabellenvorgangsanforderung angegeben werden können.
TableResult	Eine Klasse, die das Ergebnis eines Tabellenvorgangs darstellt. Die TableResult -Klasse kapselt die HTTP-Antwort und alle Tabellenentitätsergebnisse, die vom Rest-API-Vorgang des Speicherdiensts zurückgegeben werden, der für eine bestimmte TableOperationaufgerufen wird.
TableServiceEntity	Die TableServiceEntity -Klasse stellt den Basisobjekttyp für eine Tabellenentität im Speicherdienst dar. TableServiceEntity stellt eine Basisimplementierung für die Schnittstelle bereit, die TableEntity Methoden bereitstellt, die standardmäßig alle Eigenschaften per Reflektion serialisieren und deserialisieren. Eine Tabellenentitätsklasse kann diese Klasse erweitern und die Methoden und überschreiben, um eine angepasste oder leistungsfähigere Serialisierungslogik bereitzustellen. Durch die Verwendung von Reflektion können Unterklassen von TableServiceEntity serialisiert und deserialisiert werden, ohne dass der Serialisierungscode selbst implementiert werden muss. Wenn sowohl eine Getter-Methode als auch eine Setter-Methode für einen angegebenen Eigenschaftennamen und Datentyp gefunden werden, wird die entsprechende Methode automatisch aufgerufen, um die Daten zu serialisieren oder zu deserialisieren. Um den Automatischen Serialisierungscode nutzen zu können, sollten Ihre Tabellenentitätsklassen Getter- und Settermethoden für jede Eigenschaft in der entsprechenden Tabellenentität im Microsoft Azure-Tabellenspeicher bereitstellen. Der Spiegelungscode sucht nach Getter- und Settermethoden in Paaren des Formulars. und wobei PropertyName ein Eigenschaftsname für die Tabellenentität ist und type ein Java-Typ ist, der mit dem EDM-Datentyp der Eigenschaft kompatibel ist. Eine Zuordnung der Eigenschaftentypen zu ihren Java-Entsprechungen finden Sie in der folgenden Tabelle. Die StoreAs Anmerkung kann mit einem Attribut angewendet werden, um einen Eigenschaftsnamen für die Reflexion in Getter- und Settermethoden anzugeben, die nicht der Eigenschaftsnamenkonvention entsprechen. Bei Methodennamen und beim Attribut von StoreAs Anmerkungen wird die Groß-/Kleinschreibung für übereinstimmende Eigenschaftsnamen mit Reflektion beachtet. Verwenden Sie die Ignore Anmerkung, um zu verhindern, dass Methoden für die automatische Serialisierung und Deserialisierung von Reflektionen verwendet werden. Beachten Sie, dass die Namen "PartitionKey", "RowKey", "Timestamp" und "Etag" reserviert sind und ignoriert werden, wenn die StoreAs Anmerkung in einer Unterklasse festgelegt ist. Die folgende Tabelle zeigt die unterstützten Eigenschaftsdatentypen in Microsoft Azure-Speicher und die entsprechenden Java-Typen, wenn sie deserialisiert werden. Unterstützte Eigenschaftsdatentypen in Microsoft Azure-Speicher Im MSDN-Thema Grundlegendes zum Tabellendienstdatenmodell finden Sie eine Übersicht über Tabellen, Entitäten und Eigenschaften, die im Microsoft Azure Storage-Dienst verwendet werden. Eine Übersicht über die verfügbaren primitiven EDM-Datentypen und -namen finden Sie unter Abschnitt Primitive Datentypen der Übersicht über das OData-Protokoll.
TableServiceException	Eine Ausnahme, die sich ergibt, wenn ein Tabellenspeicherdienstvorgang nicht erfolgreich abgeschlossen werden kann.
TableQuery.Operators	Eine statische Klasse, die Bezeichnern Filterausdruckoperatoren zuordnet.
TableQuery.QueryComparisons	Eine statische Klasse, die Bezeichnern Filtereigenschaftenvergleichsoperatoren zuordnet.

Schnittstellen

Encrypt	Stellt ein benutzerdefiniertes Attribut dar, das verwendet werden kann, um anzugeben, ob eine Entitätseigenschaft verschlüsselt werden soll. Verwenden Sie diese Anmerkung, um anzugeben, ob die von einer Settermethode gespeicherten Daten verschlüsselt oder die von einer Getter-Methode abgerufenen Daten in einer Klasse entschlüsselt werden sollen, die implementiert TableEntity.
EntityResolver<T>	Eine Schnittstelle zum Ausführen einer clientseitigen Projektion für eine abgerufene Entität. Ein EntityResolver<T> instance muss eine Methode implementieren, die die Entitätsdaten projiziert, die durch die Parameter dargestellt werden, die als neue instance des vom Typparameter angegebenen Typs übergeben werden. Diese Schnittstelle eignet sich zum direkten Konvertieren von Tabellenentitätsdaten in einen Clientobjekttyp, ohne dass ein separater Tabellenentitätsklassentyp erforderlich ist, der jede Eigenschaft einzeln deserialisiert. Ein Client kann beispielsweise eine clientseitige Projektion einer Customer-Entität ausführen, indem einfach die für die CustomerName-Eigenschaft jeder Entität zurückgegeben wird. Das Ergebnis dieser Projektion ist eine Sammlung von s, die jeden Kundennamen enthält.
Ignore	Eine Anmerkung, die für eine Methode festgelegt ist, um deren Verwendung beim Serialisieren oder Deserialisieren einer Eigenschaft durch Reflektion zu verhindern. Wenden Sie die Anmerkung auf Methoden in einer Klasse an, die implementieren, TableEntity um zu erzwingen, dass sie während der reflektionsbasierten Serialisierung und Deserialisierung ignoriert werden. Weitere Informationen zur TableServiceEntity Verwendung der reflexionsbasierten Serialisierung und Deserialisierung finden Sie in der Dokumentation.
StoreAs	Eine Anmerkung, die verwendet wird, um den Namen einer Eigenschaft zu überschreiben, wird serialisiert und mithilfe von Reflektion deserialisiert. Verwenden Sie diese Anmerkung, um den Eigenschaftennamen anzugeben, der den Daten zugeordnet werden soll, die von einer Settermethode gespeichert oder von einer Getter-Methode in einer Klasse abgerufen TableEntity werden, die die reflektionsbasierte Serialisierung und Deserialisierung verwendet. Beachten Sie, dass die Namen "PartitionKey", "RowKey", "Timestamp" und "Etag" reserviert sind und ignoriert werden, wenn sie mit der Anmerkung festgelegt werden. Beispiel: Dieses Beispiel zeigt, wie die Methoden, die eine Entitätseigenschaft mit dem Namen ObjectPropertyName im Standardfall abrufen und festlegen, mit Anmerkungen versehen werden können, um eine Entitätseigenschaft namens EntityPropertyName abzurufen und festzulegen. Weitere Informationen zur TableServiceEntity Verwendung der reflexionsbasierten Serialisierung und Deserialisierung finden Sie in der Dokumentation.
TableEntity	Eine Schnittstelle, die für Tabellenentitätstypen erforderlich ist. Die TableEntity Schnittstelle deklariert Getter- und Settermethoden für die allgemeinen Entitätseigenschaften sowie methoden für die Serialisierung und Deserialisierung aller Entitätseigenschaften mithilfe einer Eigenschaftenzuordnung. Erstellen Sie Klassen, die implementieren TableEntity , um Eigenschaftenspeicherung, Abruf, Serialisierung und Deserialisierung anzupassen und zusätzliche benutzerdefinierte Logik für eine Tabellenentität bereitzustellen. Die Speicherclientbibliothek umfasst zwei Implementierungen von TableEntity , die einfachen Zugriff auf Eigenschaften und Serialisierung ermöglichen: DynamicTableEntity TableEntity implementiert und stellt eine einfache Eigenschaftenzuordnung zum Speichern und Abrufen von Eigenschaften bereit. Verwenden Sie einen DynamicTableEntity für den einfachen Zugriff auf Entitätseigenschaften, wenn nur eine Teilmenge von Eigenschaften zurückgegeben wird (z. B. durch eine Select-Klausel in einer Abfrage), oder wenn Ihre Abfrage mehrere Entitätstypen mit unterschiedlichen Eigenschaften zurückgeben kann. Dieser Typ kann auch verwendet werden, um Massentabellenaktualisierungen von heterogenen Entitäten ohne Verlust von Eigenschaftsinformationen durchzuführen. TableServiceEntity ist eine Implementierung von TableEntity , die reflektionsbasierte Serialisierungs- und Deserialisierungsverhalten in ihren Methoden und verwendet. TableServiceEntity-abgeleitete Klassen mit Methoden, die einer Konvention für Typen und Benennungen folgen, werden automatisch serialisiert und deserialisiert. Jede Klasse, die implementiert, kann das automatische reflexionsbasierte Serialisierungs- und Deserialisierungsverhalten TableEntity in TableServiceEntity nutzen, indem die statischen Methoden in und in aufgerufen werden. Die -Klasse muss Methoden bereitstellen, die der Typ- und Benennungskonvention folgen, um automatisch serialisiert und deserialisiert zu werden. Wenn sowohl eine Getter-Methode als auch eine Setter-Methode für einen angegebenen Eigenschaftennamen und Datentyp gefunden werden, wird die entsprechende Methode automatisch aufgerufen, um die Daten zu serialisieren oder zu deserialisieren. Der Spiegelungscode sucht nach Getter- und Settermethoden in Paaren des Formulars. und wobei PropertyName ein Eigenschaftsname für die Tabellenentität ist und type ein Java-Typ ist, der mit dem EDM-Datentyp der Eigenschaft kompatibel ist. Eine Zuordnung der Eigenschaftentypen zu ihren Java-Entsprechungen finden Sie in der Tabelle in der Klassenbeschreibung TableServiceEntity . Die StoreAs Anmerkung kann mit einem Attribut angewendet werden, um einen Eigenschaftsnamen für die Reflexion in Getter- und Settermethoden anzugeben, die nicht der Eigenschaftsnamenkonvention entsprechen. Bei Methodennamen und beim Attribut von StoreAs Anmerkungen wird die Groß-/Kleinschreibung für übereinstimmende Eigenschaftsnamen mit Reflektion beachtet. Verwenden Sie die Ignore Anmerkung, um zu verhindern, dass Methoden für die automatische Serialisierung und Deserialisierung von Reflektionen verwendet werden. Beachten Sie, dass die Namen "PartitionKey", "RowKey", "Timestamp" und "Etag" reserviert sind und ignoriert werden, wenn die StoreAs Anmerkung in einer Unterklasse festgelegt wird, die die Reflexionsmethoden verwendet.
TableRequestOptions.EncryptionResolver	Die Schnittstelle, deren Funktion verwendet wird, um den Wert abzurufen, der angibt, ob eine Eigenschaft verschlüsselt werden soll, wenn der Partitionsschlüssel, der Zeilenschlüssel und der Eigenschaftenname angegeben werden soll.
TableRequestOptions.PropertyResolver	Die Schnittstelle, deren Funktion verwendet wird, um die EdmType für eine Entitätseigenschaft unter Angabe des Partitionsschlüssels, der Zeile, des Schlüssels und des Eigenschaftennamens abzurufen, wenn die Schnittstelle implementiert ist

Enumerationen

EdmType	Eine Enumeration, die verwendet wird, um die primitiven Typen des Entity Data Model (EDM) im Open Data Protocol (OData) darzustellen. Das EDM ist das zugrunde liegende abstrakte Datenmodell, das von OData-Diensten verwendet wird. Die EdmType Enumeration enthält eine parse(final String value) Methode zum Konvertieren von EDM-Datentypnamen in den Enumerationstyp und überschreibt die toString() Methode, um einen EDM-Datentypnamen zu erzeugen. Weitere Informationen zu OData finden Sie auf der Open Data Protocol-Website . Eine Übersicht über die verfügbaren primitiven EDM-Datentypen und -Namen finden Sie im Abschnitt Primitive Datentypen der OData-Protokollübersicht. Das abstrakte Typsystem, das zum Definieren der von OData unterstützten primitiven Typen verwendet wird, wird in [MC-CSDL] (Abschnitt 2.2.1) ausführlich definiert.
SharedAccessTablePermissions	Gibt den Satz von möglichen Berechtigungen für eine Richtlinie zum gemeinsamen Tabellenzugriff an.
TablePayloadFormat	Beschreibt die für Tabellen unterstützten Nutzlastformate.