structr Android Client

The classes in this repository enable your Android App to connect to a REST web service built with structr. You can use structr-core and structr-rest to build a domain-specific REST API. structr is backed by the Neo4j graph database.

Features

Asynchronous connectors to keep the user interface responsive while loading data in the background
SSL support
Fully automatic serialization and deserialization with GSON
Use POJOs in your android code
Use @Expose annotation to map POJO fields to structr REST output
...

Please note that this software is early alpha status. Use carefully at your own risk.

Step 1: Build structr-android-client

Clone this repository
mvn package
mvn generate-sources javadoc:javadoc

Step 2: Integrate structr-android-client in your Android app

Copy target/structr-android-client-0.1-SNAPSHOT from step 1 into the libs/ directory of your android app
Call StructrConnector.initialize() in the onCreate() method of your main activity

Step 3: Map your structr entities to POJOs

public class MyEntitiy extends StructrObject {
    @Expose private String id;
    @Expose private String name;
    @Expose private Date timestamp;
    @Expose private String location;
}

Step 4: Use one of the various connectors to access the REST server

new IdEntityLoader(new EntityHandler() {

    public void handleProgress(Progress... progress) {
        // handle progress / exception
    }
    
    public void handleResults(StructrObject result) {
        // handle result
    }
    
}).execute(MyEntity.class, id");

Tips

Use a common base class for all your entities that contains the ID property; that way you don't have to expose the ID field in each of your entities.