ParseClient

A Parse Java Client.

Ths is a non-official Parse library that wrap JAX-RS to offer a high level client to Parse REST API.

This library should be considered experimental, but I will try to follow Semantic Versioning.

Summary

This library offer a flexible application perspective system that let one interact with Parse anonymously, as a logged in user or as the master, in one or more application, concurrently in the same code. So this library is NOT a clone of the Parse Android client.

This flexibility comes at the expense of a more complex way to interact with the library (ie: no magic static singleton everywhere).

If you are looking for something easier to use, have a look at the excellent also non-official parse4j library.

Getting Started

With Spring Boot

If you are using Spring Boot, have a look at parse-spring-boot to get started real quick!

Without Spring Boot

First include this library into the <dependencies/> section of you pom.xml:

<dependency>
    <groupId>ca.pjer</groupId>
    <artifactId>parseclient</artifactId>
    <version>1.1.2</version>
</dependency>

Dependencies

This library do not requires a specific JAX-RS implementation. But to be able to use it, you will need at least a JAX-RS implementation that have support for JSON.

The easiest way to get started is to include Jersey client library, with its Jackson media plugin, because doing so will enable you to use the out-of-the-box zero configuration utility class to get started quickly.

Again in the <dependencies/> section of your pom.xml:

<dependency>
    <groupId>javax.ws.rs</groupId>
    <artifactId>javax.ws.rs-api</artifactId>
    <version>2.0.1</version>
</dependency>

<dependency>
    <groupId>org.glassfish.jersey.core</groupId>
    <artifactId>jersey-client</artifactId>
    <version>2.25.1</version>
    <scope>runtime</scope>
</dependency>

<dependency>
    <groupId>org.glassfish.jersey.media</groupId>
    <artifactId>jersey-media-json-jackson</artifactId>
    <version>2.25.1</version>
    <scope>runtime</scope>
</dependency>

First steps

Create a JAX-RS client, fully configured with the conveniently included SimpleConfigurations class:

Client client = ClientBuilder.newClient(SimpleConfigurations.jerseyWithJackson());

Create a ParseClient that wrap this JAX-RS client and point where your Parse Server is:

ParseClient parseClient = ParseClient.create(client, URI.create("http://localhost:1337/parse"));

From the parseClient, create an object to access an application by providing your Application ID and REST API Key:

Application application = parseClient.application("...").usingRestApiKey("...");

From this application, get an anonymous perspective (ie: see and operate on your data only in a way an anonymous user can do):

Perspective anonymousPerspective = application.asAnonymous();

From this anonymousPerspective, get an ObjectResources, a kind of DAO, to operate on the GameScore class:

ObjectResources<ParseObject> gameScores = anonymousPerspective.withObjects("GameScore");

From the gameScores DAO, perform a query operation to find all objects and print their IDs:

Iterable<ParseObject> parseObjects = gameScores.query().find();
for (ParseObject parseObject : parseObjects)
    System.out.println(parseObject.getObjectId());

Here the completed example:

import ca.pjer.parseclient.*;
import ca.pjer.parseclient.support.SimpleConfigurations;

import javax.ws.rs.client.Client;
import javax.ws.rs.client.ClientBuilder;

public class Main {

	public static void main(String[] args) {

		Client client = ClientBuilder.newClient(SimpleConfigurations.jerseyWithJackson());

		ParseClient parseClient = ParseClient.create(client, URI.create("http://localhost:1337/parse"));

		Application application = parseClient.application("...").usingRestApiKey("...");

		Perspective anonymousPerspective = application.asAnonymous();

		ObjectResources<ParseObject> gameScores = anonymousPerspective.withObjects("GameScore");

		Iterable<ParseObject> parseObjects = gameScores.query().find();
		for (ParseObject parseObject : parseObjects)
			System.out.println(parseObject.getObjectId());
	}
}

Going further

There is more than that. This library already supports aynchrounous operations, replayable operations, CloudCode Functions, signup, login, users and sessions management, ACL, batch operations, Pointer, GeoPoint, File, Queries, custom POJO mapping.