JarCastingXfers Java Bindings
You can sign up for a Xfers account at https://xfers.com.
Requirements
Java 1.6 and later.
Installation
Maven users
Add this dependency to your project's POM:
<dependency>
<groupId>com.xfers</groupId>
<artifactId>xfers-java</artifactId>
<version>1.19.0</version>
</dependency>
Non-Maven users
You'll need to manually install the following JARs:
- The Xfers JAR from https://github.com/Xfers/xfers-java/releases/latest.
- Google Gson from http://google-gson.googlecode.com/.
- Google Guava from https://github.com/google/guava.
- Unirest for Java from http://unirest.io/java.html.
- JUnit from http://junit.org/junit4/.
Documentation
Please see the API docs for the most up-to-date documentation.
Usage
XfersExample.java
import com.xfers.Xfers;
import com.xfers.model.Charge;
import com.xfers.model.Item;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
public class XfersExample {
public static void main(String[] args) {
Xfers.apiKey = "pXcfdAKNorDe_o1eou1NSp4mwssiEzem_6sg8fwnZWs";
Xfers.setSGSandbox();
try {
System.out.println("Listing charges without filter");
List<Charge> charges = Charge.listAll();
for (Charge charge : charges) {
System.out.println(charge.toString());
List<Item> items = charge.getItems();
for (Item item : items) {
System.out.println(item.toString());
}
}
System.out.println("Listing charges with filter");
Map<String, Object> params = new HashMap<String, Object>();
params.put("limit", "1");
charges = Charge.listAll(params);
for (Charge charge : charges) {
System.out.println(charge.toString());
}
} catch (Exception e) {
e.printStackTrace();
}
}
Exceptions
AuthenticationException -> given 401 by Xfers. These are usually xfers_api_token related bug.
InvalidRequestException, -> given 400 error by Xfers. Most Expected Error will belong in this categort
APIException -> status non 400, 401, 200. (usually indicates 500 error/ unexpected error, please escalate to Xfers when this happens)
APIConnectionException -> Happens if the HTTP method used is not in (POST, GET, PUT, PATCH). Should not happen in your client app.
UnirestException -> Happens if xfers URL given is unreachable (wrong URL). Should not happen in your client app.
