JSONStore in iOS-Anwendungen

improve this page | report issue

Voraussetzungen

Fahren Sie mit folgenden Abschnitten fort:

JSONStore hinzufügen

  1. Fügen Sie zu der vorhandenen Podfile im Stammverzeichnis des Xcode-Projekts Folgendes hinzu:

    pod 'IBMMobileFirstPlatformFoundationJSONStore'
    
  2. Navigieren Sie in einem Befehlszeilenfenster zum Stammverzeichnis des Xcode-Projekts und führen Sie den Befehl pod install aus. Diese Aktion kann eine Weile dauern.

Wenn Sie JSONStore verwenden möchten, müssen Sie den JSONStore-Header importieren:
Objective-C:

   #import <IBMMobileFirstPlatformFoundationJSONStore/IBMMobileFirstPlatformFoundationJSONStore.h>

Swift:

import IBMMobileFirstPlatformFoundationJSONStore    

Grundlegende Verwendung

Open

Öffnen Sie mit openCollections mindestens ene JSONStore-Sammlung.

Sammlungen zu starten oder bereitzustellen bedeutet, dass der persistente Speicher für die Sammlung und für Dokumente erstellt wird, wenn er nicht vorhanden ist.
Wenn der Speicher verschlüsselt ist und das richtige Kennwort übergeben wird, werden die erforderlichen Sicherheitsprozeduren ausgeführt, um die Daten zugänglich zu machen.

Informationen zu optionalen Features, die Sie während der Initialisierung aktivieren können, finden Sie im zweiten Teil dieses Lernprogramms unter Sicherheit, Unterstützung für mehrere Benutzer und MobileFirst-Adapter integrieren.

let collection:JSONStoreCollection = JSONStoreCollection(name: "people")

collection.setSearchField("name", withType: JSONStore_String)
collection.setSearchField("age", withType: JSONStore_Integer)

do {
  try JSONStore.sharedInstance().openCollections([collection], withOptions: nil)
} catch let error as NSError {
  // Fehler behandeln
}

Get

Mit getCollectionWithName können Sie einen Mechanismus für den Zugriff auf die Sammlung erstellen. Sie müssen openCollections vor getCollectionWithName aufrufen.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

Die Variable collection kann jetzt verwendet werden, um Operationen für die Sammlung people auszuführen (z. B. add, find und replace).

Add

Verwenden Sie addData, um Daten als Dokumente innerhalb einer Sammlung zu speichern.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

let data = ["name" : "yoel", "age" : 23]

do  {
  try collection.addData([data], andMarkDirty: true, withOptions: nil)
} catch let error as NSError {
  // Fehler behandeln
}

Find

Verwenden Sie findWithQueryParts, um mit einer Abfrage ein Dokument in einer Sammlung zu finden. Verwenden Sie findAllWithOptions, um alle Dokumente aus einer Sammlung abzurufen. Verwenden Sie findWithIds, um mit der eindeutigen Dokument-ID nach einem Dokument zu suchen.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

let options:JSONStoreQueryOptions = JSONStoreQueryOptions()
// Rückgabe von maximal 10 Dokumenten. Standardeinstellung: Rückgabe aller Dokumente
options.limit = 10

let query:JSONStoreQueryPart = JSONStoreQueryPart()
query.searchField("name", like: "yoel")

do  {
  let results:NSArray = try collection.findWithQueryParts([query], andOptions: options)
} catch let error as NSError {
  // Fehler behandeln
}

Ersetzen Sie die folgenden Zeilen:

Verwenden Sie replaceDocuments, um Dokumente in einer Sammlung zu modifizieren. Das Feld für die Ersetzung ist die eindeutige ID des Dokuments (_id).

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

var document:Dictionary<String,AnyObject> = Dictionary()
document["name"] = "chevy"
document["age"] = 23

var replacement:Dictionary<String, AnyObject> = Dictionary()
replacement["_id"] = 1
replacement["json"] = document

do {
  try collection.replaceDocuments([replacement], andMarkDirty: true)
} catch let error as NSError {
  // Fehler behandeln
}

In den vorliegenden Beispielen wird davon ausgegangen, dass das Dokument ({_id: 1, json: {name: 'yoel', age: 23} }) in der Sammlung enthalten ist.

Remove

Verwenden Sie removeWithIds, um ein Dokument aus einer Sammlung zu löschen. Dokumente werden erst aus der Sammlung entfernt, wenn Sie markDocumentClean aufgerufen haben. Weitere Informationen finden Sie im Abschnitt MobileFirst-Adapter integrieren weiter unten in diesem Lernprogramm.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

do {
  try collection.removeWithIds([1], andMarkDirty: true)
} catch let error as NSError {
  // Fehler behandeln
}

removeCollection

Verwenden Sie removeCollection, um alle Dokumente aus einer Sammlung zu löschen. Diese Operation ist mit dem Löschen einer Datenbanktabelle vergleichbar.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

do {
  try collection.removeCollection()
} catch let error as NSError {
  // Fehler behandeln
}

Destroy

Mit destroyData können Sie die folgenden Daten entfernen:

  • Alle Dokumente
  • Alle Sammlungen
  • Alle Stores (siehe Unterstützung für mehrere Benutzer weiter unten in diesem Lernprogramm)
  • Alle JSONStore-Metadaten und -Sicherheitsartefakte (siehe Sicherheit weiter unten in diesem Lernprogramm)
do {
  try JSONStore.sharedInstance().destroyData()
} catch let error as NSError {
  // Fehler behandeln
}

Erweiterte Verwendung

Sicherheit

Sie können alle Sammlungen in einem Store schützen, indem Sie an die Funktion openCollections ein Objekt JSONStoreOpenOptions mit einem Kennwort übergeben. Wenn kein Kennwort übergeben wird, wird keines der Dokumente in den Sammlungen des Store verschlüsselt.

Einige Sicherheitsmetadaten werden in der Keychain (iOS) gespeichert.
Der Store wird mit einem 256-Bit-Schlüssel gemäß Advanced Encryption Standard (AES) verschlüsselt. Alle Schlüssel werden durch die Funktion PBKDF2 (Password-Based Key Derivation Function 2) verstärkt.

Verwenden Sie closeAllCollections, um den Zugriff auf alle Sammlungen bis zum erneuten Aufruf von openCollections zu sperren. Wenn Sie sich openCollections als eine Art Anmeldefunktion vorstellen, wäre closeAllCollections die entsprechende Abmeldefunktion.

Verwenden Sie changeCurrentPassword, um das Kennwort zu ändern.

let collection:JSONStoreCollection = JSONStoreCollection(name: "people")
collection.setSearchField("name", withType: JSONStore_String)
collection.setSearchField("age", withType: JSONStore_Integer)

let options:JSONStoreOpenOptions = JSONStoreOpenOptions()
options.password = "123"

do {
  try JSONStore.sharedInstance().openCollections([collection], withOptions: options)
} catch let error as NSError {
  // Fehler behandeln
}

Unterstützung für mehrere Benutzer

Sie können mehrere Stores erstellen, die verschiedene Sammlungen in nur einer MobileFirst-Anwendung enthalten. Die Funktion openCollections kann mit einem Optionsobjekt mit einem Benutzernamen verwendet werden. Wenn kein Benutzername angegeben wird, wird der Standardbenutzername jsonstore verwendet.

let collection:JSONStoreCollection = JSONStoreCollection(name: "people")
collection.setSearchField("name", withType: JSONStore_String)
collection.setSearchField("age", withType: JSONStore_Integer)

let options:JSONStoreOpenOptions = JSONStoreOpenOptions()
options.username = "yoel"

do {
  try JSONStore.sharedInstance().openCollections([collection], withOptions: options)
} catch let error as NSError {
  // Fehler behandeln
}

MobileFirst-Adapter integrieren

In diesem Abschnitt wird vorausgesetzt, dass Sie sich mit Adaptern auskennen. Die Adapterintegration ist optional. Sie ermöglicht das Senden von Daten einer Sammlung an einen Adapter und das Abrufen von Daten eines Adapters in eine Sammlung.

Sie können diese Ziele mit Funktionen wie WLResourceRequest erreichen.

Adapterimplementierung

Erstellen Sie einen Adapter mit dem Namen People.Definieren Sie für den Adapter die Prozeduren addPerson, getPeople, pushPeople, removePerson und replacePerson.

function getPeople () {
var data = { peopleList : [{name: 'chevy', age: 23}, {name: 'yoel', age: 23}] };
	WL.Logger.debug('Adapter: people, procedure: getPeople called.');
	WL.Logger.debug('Sending data: ' + JSON.stringify(data));
	return data;
}
function pushPeople(data) {
	WL.Logger.debug('Adapter: people, procedure: pushPeople called.');
	WL.Logger.debug('Got data from JSONStore to ADD: ' + data);
	return;
}
function addPerson(data) {
	WL.Logger.debug('Adapter: people, procedure: addPerson called.');
	WL.Logger.debug('Got data from JSONStore to ADD: ' + data);
	return;
}
function removePerson(data) {
	WL.Logger.debug('Adapter: people, procedure: removePerson called.');
	WL.Logger.debug('Got data from JSONStore to REMOVE: ' + data);
	return;
}
function replacePerson(data) {
	WL.Logger.debug('Adapter: people, procedure: replacePerson called.');
	WL.Logger.debug('Got data from JSONStore to REPLACE: ' + data);
	return;
}

Daten von einem MobileFirst-Adapter laden

Verwenden Sie WLResourceRequest, um Daten von einem MobileFirst-Adapter zu laden.

// LoadFromAdapter - Beginn
class LoadFromAdapter: NSObject, WLDelegate {
  func onSuccess(response: WLResponse!) {
    let responsePayload:NSDictionary = response.getResponseJson()
    let people:NSArray = responsePayload.objectForKey("peopleList") as! NSArray
    // Erfolg behandeln
  }

  func onFailure(response: WLFailResponse!) {
    // Fehler behandeln
  }
}
// LoadFromAdapter - Ende

let pull = WLResourceRequest(URL: NSURL(string: "/adapters/People/getPeople"), method: "GET")

let loadDelegate:LoadFromAdapter = LoadFromAdapter()
pull.sendWithDelegate(loadDelegate)

getPushRequired (vorläufige Dokumente)

Wenn Sie allDirty aufrufen, wird ein Array mit vorläufigen Dokumenten (dirty documents) zurückgegeben. Diese Dokumente enthalten lokale Modifikationen, die es auf dem Back-End-System noch nicht gibt.

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

do {
  let dirtyDocs:NSArray = try collection.allDirty()
} catch let error as NSError {
  // Fehler behandeln
}

Wenn Sie JSONStore daran hindern möchten, Dokumente als vorläufig zu markieren, übergeben Sie die Option andMarkDirty:false an add, replace und remove.

Änderungen mit Push übertragen

Wenn Sie Änderungen mit Push an einen Adapter senden möchten, rufen Sie allDirty auf, um eine Liste der Dokumente mit Modifikationen abzurufen. Verwnden Sie dann WLResourceRequest. Nach dem Senden der Daten und einer Bestätung des erfolgreichen Sendens müssen Sie markDocumentsClean aufrufen.

// PushToAdapter - Beginn
class PushToAdapter: NSObject, WLDelegate {
  func onSuccess(response: WLResponse!) {
    // Erfolg behandeln
  }

  func onFailure(response: WLFailResponse!) {
    // Fehler behandeln
  }
}
// PushToAdapter - Ende

let collectionName:String = "people"
let collection:JSONStoreCollection = JSONStore.sharedInstance().getCollectionWithName(collectionName)

do {
  let dirtyDocs:NSArray = try collection.allDirty()
  let pushData:NSData = NSKeyedArchiver.archivedDataWithRootObject(dirtyDocs)

  let push = WLResourceRequest(URL: NSURL(string: "/adapters/People/pushPeople"), method: "POST")

  let pushDelegate:PushToAdapter = PushToAdapter()
  push.sendWithData(pushData, delegate: pushDelegate)

} catch let error as NSError {
  // Fehler behandeln
}

Beispielanwendung

Beispielanwendung

Das JSONStoreSwift-Projekt enthält eine native iOS-Swift-Anwendung, die die JSONStore-APIs verwendet.
Darüber hinaus ist ein JavaScript-Adapter-Maven-Projekt verfügbar.

Klicken Sie hier, um das native iOS-Projekt herunterzuladen.
Klicken Sie hier, um das Adapter-Maven-Projekt herunterzuladen.

Verwendung des Beispiels

Anweisungen finden Sie in der Datei README.md zum Beispiel.

Inclusive terminology note: The Mobile First Platform team is making changes to support the IBM® initiative to replace racially biased and other discriminatory language in our code and content with more inclusive language. While IBM values the use of inclusive language, terms that are outside of IBM's direct influence are sometimes required for the sake of maintaining user understanding. As other industry leaders join IBM in embracing the use of inclusive language, IBM will continue to update the documentation to reflect those changes.
Last modified on July 02, 2019