Java SDK - Overview

Java SDK - Overview

Java SDK offers a way to create client java applications that can be integrated with Zoho CRM. This SDK makes the access and use of necessary CRM APIs with ease. In other words, it serves as a wrapper for the REST APIs, making it easier to use the services of Zoho CRM.


A point to note would be that the developer of the client application should create programming code elements along with configuration-related properties files, interface implementations, instances or objects. Authentication to access Zoho CRM APIs is through Oauth authentication mechanism. Invariably, HTTP requests and responses are taken care by SDK.

A sample of how an SDK acts a middle ware or interface between Zoho CRM and a client java application.


Java SDK allows you to:

  1. Exchange data between Zoho CRM and the client application where the CRM entities are modelled as classes.
  2. CRM API equivalents are declared and defined as simple member methods in your java application.
  3. Push data into Zoho CRM, by accessing appropriate APIs of the CRM Service.
Note

For the sake of better explanation, we have used Eclipse to describe how to get started on using the SDK.

Environmental Setup

Java SDK requires the following dependencies to be setup in your development environment:
  • Java (Version 7).
  • A Java programming IDE (Eclipse or IntelliJ with Java 7 version).

Including the SDK in your project

Java SDK is available through Maven distribution. You can include the SDK to your project using:
  • Maven
  • Gradle
  • Downloadable JARs (by Zoho)

Maven Distribution

Maven is a build automation tool used primarily for Java projects. Maven addresses two aspects of building software: first, it describes how software is built, and second, it describes its dependencies.

If you are using Maven to build your project, we already have the dependencies set up.

You just need to include the following in your pom.xml file, which will get created once your Java project is created using Maven.

  1. <repositories>
  2.       <repository>
  3.             <url>https://maven.zohodl.com/</url>
  4.       </repository>
  5. </repositories>

  6. <dependencies>
  7.       <dependency>
  8.             <groupId>com.zoho.crm</groupId>
  9.             <artifactId>java-sdk</artifactId>
  10.             <version>1.0.3</version>
  11.       </dependency>
  12. </dependencies>

Gradle

  1. repositories {
  2.             maven { url "https://maven.zohodl.com/" }
  3. }

  4. dependencies {
  5.             implementation 'com.zoho.crm:java-sdk:1.0.3'
  6. }

Downloadable JAR file


This version downloads simply the SDK without dependent jars. In this case, the following jars are to be made available by adding them in the referenced libraries of your java application. The jars can be downloaded from here.

The list of dependency JARs that you need are:
    • Related Articles

    • Configuration - Java SDK

      Setting up the configuration is a system engineering process, for establishing and maintaining the consistency of the application's performance, functional and physical attributes with its requirements, design and operational information throughout ...
    • Persistence - Java SDK

      Persistent classes in an application implement the entities of the business problem. In Java SDK, two default persistence classes with their implementations are provided. On the other hand, if a developer wants his specific implementation, he can ...
    • Initialization - Java SDK

      Now the app is ready to be initialized after defining OAuth configuration file and OAuth persistence handler class for your app. Generating grant tokens For a Single User The developer console has an option to generate grant token for a user ...
    • File Structure Hierarchy - Java SDK

      In your Java IDE setup, create and arrange the packages containing resource files, properties files, and required jars (ZCRMSDK.jar) as displayed in the image. The numbered items shown in the image are the files to be created in a step wise manner.   ...
    • Responses & Exceptions - Java SDK

      APIResponse, BulkAPIResponse and FileAPIResponse are the wrapper objects for Zoho CRM APIs’ responses. All API calling methods would return one of these three objects. A method-seeking entity would return APIResponse object, whereas a method-seeking ...