Persistenz
Persistierende Klassen in einer Anwendung implementieren die Entitäten des geschäftlichen Problems. In Java-SDK werden zwei persistierende Standardklassen mit ihren Implementierungen bereitgestellt. Benötigt ein Entwickler andererseits seine spezifische Implementierung, kann er seine kundenspezifische Implementierung durch eine Verbindung zum entsprechenden Datenbanksystem definieren.
Implementieren der OAuth-Persistenz
Sobald die Anwendung autorisiert ist, können OAuth-Zugriffs- und Aktualisierungs-Token für nachfolgende Benutzerdatenzugriffe auf Zoho CRM verwendet werden. Daher müssen sie von der Client-App beibehalten werden.
Die Persistenz wird durch Implementieren der integrierten Schnittstelle ZohoPersistenceHandler erreicht, die folgende Aufrufmethoden aufweist.
- saveOAuthData(ZohoOAuthTokens-Token) – aufgerufen beim Abruf von Zugriffs- und Aktualisierungs-Token von Zoho.
- deleteOAuthTokens() – aufgerufen vor dem Speichern der neu erhaltenen Token.
- getOAuthTokens() – aufgerufen vor dem Übermitteln einer Anforderung zum Abruf der gespeicherten Token. Diese Methode sollte das ZohoOAuthTokens-Objekt für die Bibliothek zur Verarbeitung zurückgeben.
Unser Java-SDK umfasst zwei Beispielimplementierungen der Schnittstelle ZohoPersistenceHandler mit der Client-Bibliothek (wie nachfolgend aufgeführt):
Sie können eine der zuvor erwähnten Schnittstellenimplementierungen aus der Bibliothek verwenden.
ZohoOAuthFilePersistence
ZohoOAuthFilePersistence verwendet eine lokale Eigenschaftendatei zum Schreiben und Lesen der OAuth-Token-Daten. Wenn Sie diesePersistenz verwenden, müssen Sie die folgenden Attribute und deren Werte in der Datei oauth_configuration.properties bereitstellen.
persistence_handler_class=com.zoho.oauth.clientapp.ZohoOAuthFilePersistence
oauth_tokens_file_path= relativer Pfad der Datei „oauthtokens.properties“ im Arbeitsbereich.
ZohoOAuthDBPersistence
ZohoOAuthDBPersistenceverwendet eine individuelle MySQL-Persistenz. Um dies zu verwenden, müssen Sie Folgendes sicherstellen:
- MySQLmuss auf dem gleichen System mit Standard-Port 3306 ausgeführt werden.
- Der Datenbankname muss „zohooauth“ lauten.
- Es muss eine Tabelle „oauthtokens“ muss mit den Spalten „useridentifier“ (varchar), „accesstoken“ (varchar), „refreshtoken“ (varchar) und „expirytime“ (bigint) existieren.
Wenn Sie ZohoOAuthDBPersistence verwenden, müssen Sie folgende Attribute und Werte in der Datei oauth_configuration.propertiesbereitstellen.
persistence_handler_class=com.zoho.oauth.clientapp.ZohoOAuthDBPersistence
mysql_username=root
mysql_password=
Hinweis:
- Die Implementierung von
- ZohoOAuthFilePersistenceunterstützt nur das Speichern und Aktualisieren eines einzigen Benutzer-Tokens. Daher muss dies verwendet werden, wenn Ihre App nur im Namen eines einzigen Benutzers auf Zoho-APIs zugreift.
- Falls Ihre App mehrere Benutzer unterstützt, verwenden SieZohoOAuthDBPersistence, oder schreiben Sie Ihre eigene Implementierung von ZohoPersistenceHandler.