beccagaspard / killbill-client-java

Java client library for Kill Bill

Home Page:http://killbill.io

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

killbill-client-java

Java client library for Kill Bill.

Usage

The library is published in Maven Central:

<dependency>
    <groupId>org.kill-bill.billing</groupId>
    <artifactId>killbill-client-java</artifactId>
    <version>0.0.15</version>
</dependency>

The easiest way to get started is to look at some of our integration tests, which use this library.

When sending a body, if you are unsure which parameters to pass, take a look at the source code, which self-documents the required fields per call using preconditions.

Regarding error handling, if the server returns an error (400, 401, 409, 500, etc.), the code will throw KillBillClientException. If there is no response (204) or if an object cannot be found (404), the code will return null (for single objects) or an empty list (for collections of objects). Otherwise, you should never get null.

Build

To build the library:

mvn clean install

This will produce several jars:

  • killbill-client-java-x.y.z-SNAPSHOT.jar which contains only the library
  • killbill-client-java-x.y.z-SNAPSHOT-jar-with-dependencies.jar which is a self contained jar (library and dependencies)

About

Java client library for Kill Bill

http://killbill.io

License:Apache License 2.0


Languages

Language:Java 99.4%Language:Shell 0.6%