AndroidRestClient
Asynchronous JSON REST client for Android.
Just took a look at this project 10/3/2013, not everything works correctly. Not sure how the code went bad, but I recommend using Google's Volley library, it's what I use now. https://android.googlesource.com/platform/frameworks/volley/
Example Usage
new Builder("http://bclymer.com/json", RestClient.RequestType.GET)
.setCastClass(Stuff.class)
.setRestClientCallback(new RestClientCallback<Stuff>() {
@Override
public void onPreExecute() {
// Update UI to show we're loading something.
}
@Override
public void onSuccess(RestClientResponse<Stuff> response) {
Log.e("YAY", response.response.cityName);
}
@Override
public void onFailure(RestClientResponse<Stuff> response) {
Log.e("YAY", response.response.cityName);
}
@Override
onPostExecute() {
// Change UI back, we're done loading. This is method just exists
// so you don't need the same code in onFailure and onSuccess
}
})
.executeAsync();
With Stuff being any Java bean.
You can override any, all, or none of the methods in the callback. If you're just POSTing and don't care about the response you can not set a callback and call executeAsync and then not worry.
If the user doesn't set the CastClass the RestClientResponse.response object will be null be RestClientResponse.rawResponse will still exist.
The library can also return RestClientResponse directly if executeSync is called instead of executeAsync.
You can also POST or PUT with the client (DELETE too) with
Stuff f = new Stuff();
f.cityName = "Test";
new Builder("http://bclymer.com/post.php", RestClient.RequestType.POST)
.setObjectBody(f)
.setRestClientCallback(new RestClientCallback<Void>() {
@Override
public void onSuccess(RestClientResponse<Void> response) {
Log.e("YAY", response.rawResponse);
}
@Override
public void onFailure(RestClientResponse<Void> response) {
Log.e("YAY", response.rawResponse);
}
})
.executeAsync();
The encode style is JSON using GSON. You simply throw any object (a Java bean probably) into the setObjectBody method and it will be encoded and written to the POST or PUT body.
It can also be used syncronously, in it's simplest form like
String htmlAndStuff = new Builder("http://www.google.com", RestClient.RequestType.GET).executeSync().rawResponse;
Managing async requests
Any async method call will return a unique int id that will let the user call
public Status getStatus(int id);
Which will return a android.os.AsyncTask.Status enum giving the status of the request.
You may also call
public boolean cancel(int id);
To cancel a pending or current request, returning whether the request was cancelled or not.
Dependancies
You will need GSON for serialization and deserialization to work. https://code.google.com/p/google-gson/