Z-Java

Simple Java quickstart for playing with the Zuora API and simplify your java project(s). You can either:

• git clone or fork this project and add your customer-specific code to it
• or better you can git clone this repository then declare it as a dependency in your other project

Extract from the pom.xml file of your other project:

<dependency>
    <groupId>com.zuora</groupId>
    <artifactId>z-java</artifactId>
    <version>0.1</version>
</dependency>

If you find bugs and/or add functionalities, please create a pull request.

Overview

This is a sample project to build the stub classes for using the Zuora SOAP API. Based on the WSDL downloaded from your Zuora tenant, you can then generate a JAR file to include in your projects and/or add this whole project as a Maven Dependency in your other projects.

Installation

First, clone the github repository on your computer

git clone https://github.com/mpham-zuora/z-java.git
cd z-java

Copy the sample properties files and edit it to add your credentials

cp src/main/resources/config.sample.properties src/main/resources/config.properties

Build the JAR file

mvn package

Using a custom/different WSDL

1. Add your WSDL to the src/main/wsdl folder
2. Edit the pom.xml file line 123 and change the value for your WSDL name
3. mvn package and that's it!

Installing it locally

mvn install

Usage

ZApi zapi = new ZApi();

// This should be called before any other call
zapi.zLogin();

// Example on how to do a query
QueryResult result = zapi.zQuery("SELECT AccountNumber, Name FROM Account");

Note(s)

• This works perfectly with the Heroku Java Quickstart as long as you define z-java as an unmanaged dependency
• Unfortunately, z-java is not working when embedded in an Android application, as Apache Axis 2 relies on core libraries (javax.xml.*) which are not part of the Dalvik virtual machine