Persistencia
Las clases de persistencia de una aplicación permiten implementar las entidades del problema empresarial. En el SDK de Java, se proporcionan dos clases de persistencia predeterminadas con sus implementaciones. En cambio, si un desarrollador desea llevar a cabo su implementación específica, puede definir la implementación personalizada mediante la conexión con el sistema respectivo de base de datos.
Implementación de persistencias OAuth
Una vez que se autoriza la aplicación, los tokens de acceso y actualización OAuth se pueden utilizar en las solicitudes subsiguientes de datos de usuario de Zoho CRM. Por lo tanto, la aplicación del cliente debe hacerlos persistir.
La persistencia se logra mediante la escritura de una implementación de la interfaz ZohoPersistenceHandler integrada, que cuenta con los siguientes métodos para invocar solicitudes.
- saveOAuthData(ZohoOAuthTokens tokens): se invoca al capturar los tokens de acceso y actualización de Zoho.
- deleteOAuthTokens(): se invoca antes de guardar los tokens recientemente recibidos.
- getOAuthTokens(): se invoca antes de realizar una solicitud para capturar los tokens guardados. Con este método, se devuelve el objeto ZohoOAuthTokens para que la biblioteca lo procese.
Nuestro SDK de Java proporciona dos implementaciones de muestra de la interfaz ZohoPersistenceHandler dentro de la biblioteca del cliente, como se muestra a continuación:

Puede utilizar cualquier implementación de interfaz mencionada anteriormente y que se proporciona en la biblioteca.
ZohoOAuthFilePersistence
ZohoOAuthFilePersistence utiliza un archivo local de propiedades para escribir y leer los datos de tokens OAuth. Si utiliza estapersistencia, debe proporcionar los siguientes atributos y sus valores en el archivooauth_configuration.properties.
persistence_handler_class=com.zoho.oauth.clientapp.ZohoOAuthFilePersistence
oauth_tokens_file_path=ruta relativa del archivo "oauthtokens.properties" en el espacio de trabajo.
ZohoOAuthDBPersistence
ZohoOAuthDBPersistenceutiliza una persistencia MySQL personalizada. Para utilizarla, debe asegurarse de realizar lo siguiente:
- MySQLse debe ejecutar en el mismo equipo que utiliza el puerto predeterminado 3306.
- El nombre de la base de datos debe ser "zohooauth".
- Debe haber una tabla "oauthtokens" con las columnas"useridentifier" (varchar), "accesstoken" (varchar), "refreshtoken" (varchar) y "expirytime" (bigint).
Si utiliza ZohoOAuthDBPersistence, debe proporcionar los siguientes atributos y valores en el archivo oauth_configuration.properties
persistence_handler_class=com.zoho.oauth.clientapp.ZohoOAuthDBPersistence
mysql_username=root
mysql_password=
Nota:
- Con la implementación de
- ZohoOAuthFilePersistence, se admite el almacenamiento y la actualización del token de un solo usuario. Por lo tanto, esto se debe utilizar si la aplicación accede a las API de Zoho en nombre de un solo usuario.
- Si la aplicación puede admitir varios usuarios, utiliceZohoOAuthDBPersistenceo escriba su propia implementación de ZohoPersistenceHandler.