Network Request and JSON with AsyncHttpClient

While Android has its own mechanisms to make network requests, the process is a bit cumbersome and verbose. More than a few 3rd party libraries have been created to help this such as OkHttp and Volley. However, the fine folks at CodePath recommend Asynchronous Http Client by James Smith, used by Pinterest, Instagram, and lots others.

To get started, simply import the library into your project by adding a few lines to your build.grade file:

repositories {
  maven {
    mavenCentral()
  }
}

dependencies {
  compile 'com.loopj.android:android-async-http:1.4.9'
}

Next, create a new class for your http client. This approach, as opposed to setting things up in your activity, will keep your code much cleaner and more compact, especially when (not if) you decide to add more features to your app.

public class DataClient {

    private static final String API_URL = "http://www.mydomain.com/api/";
    private static final String API_KEY = "841kas90GvepScwKJrb j190da";

    private final int TIMEOUT = 20 * 1000;

    // Constructor - can set timeout, basic auth, and other features here
    public DataClient() {
        client = new AsyncHttpClient();
        client.setTimeout(TIMEOUT);
    }

    // The actual request, this one with params. This library also supports 
    // headers, even in API 23
    public void getData(JsonHttpResponseHandler handler) {
        String url = API_URL;
        RequestParams params = new RequestParams("key", API_KEY);
        client.get(url, params, handler);
    }

}

Back in your activity, you can now create a new instance of your DataClient and call your  getData() method.  Since the JSON object is already created for you in the callback, it is ready for parsing.

DataClient client = new DataClient();
client.getLeagueEventData(new JsonHttpResponseHandler() {

    @Override
    public void onSuccess(int statusCode, Header[] headers, JSONObject body) {
        // Response is already in JSON format and ready for parsing

        parseJsonResponse(body);
    }

    @Override
    public void onFailure(int statusCode, Header[] headers, Throwable throwable, JSONObject errorResponse) {
        // Handle errors here

        super.onFailure(statusCode, headers, throwable, errorResponse);
        Log.d(TAG, "Error: " + errorResponse);
    }
});

AsyncHttpClient also offers the ability to return JSON arrays, binary and file response handlers, and lots of other cool features that make life easy.