Automatically exported from
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.

[JavaDoc] ( | Blog post

#Basic HTTP Client for Java (including App Engine and Android)#

A minimal HTTP client that uses to make requests. It features a simple interface for making Web requests. There is also an AsyncHttpClient which supports making asynchronous requests with retries and exponential backoff, and AndroidHttpClient which wraps requests in an Android AsyncTask so that requests can be safely initiated from the UI thread.

##Lightning Start##

  1. Download one of the jars at left and add it to your lib or libs (Android) folder
  2. (Android only) Add <uses-permission android:name="android.permission.INTERNET" /> to !AndroidManifest.xml

##Quick Start##

  1. git clone
  2. In Eclipse, Import | Existing Projects into Workspace and point it to the basic-http-client dir
  3. To include the library in another project, add the basic-http-client project to the build path OR
  4. For Android projects, create a linked source folder named httpclient-src that points to basic-http-client/src


In your Java project (including App Engine for Java), add this to your pom.xml:


Gradle (Android)

If your Android project builds with Gradle, add this to your app's

dependencies {
    compile 'com.turbomanage.basic-http-client:http-client-android:0.89'

##Basic Usage##

// Example code to login to App Engine dev server
public void loginDev(String userEmail) {
    BasicHttpClient httpClient = new BasicHttpClient("http://localhost:8888");
    ParameterMap params = httpClient.newParams()
            .add("continue", "/")
            .add("email", userEmail)
            .add("action", "Log In");
    httpClient.addHeader("name", "value");
    HttpResponse httpResponse ="/_ah/login", params);

// Example code to log in to App Engine production app
public void loginProd(String authToken) {
    BasicHttpClient httpClient = new BasicHttpClient("http://localhost:8888");
    ParameterMap params = httpClient.newParams()
            .add("auth", authToken);
    HttpResponse httpResponse = httpClient.get("/_ah/login", params);

##Making Asynchronous Requests## The project includes an !AsyncTask wrapper for Android so that requests can be safely initiated on the UI thread with a callback. Example:

AndroidHttpClient httpClient = new AndroidHttpClient("");
ParameterMap params = httpClient.newParams()
        .add("continue", "/")
        .add("email", "")
        .add("action", "Log In");"/_ah/login", params, new AsyncCallback() {
    public void onSuccess(HttpResponse httpResponse) {
    public void onError(Exception e) {

App Engine for Java

The basic-http-client project simply wraps On App Engine, this in turn wraps the App Engine URLFetch API. The net result is that you can use version 0.89 or later to make outbound requests from your server application.


In AndroidHttpClient, is enabled by default above API version 8 (when it was introduced) in order to save cookies between requests and resend them just like a browser does.

Prior to version 0.89, BasicHttpClient would also automatically enable However, this is not supported on App Engine, so in version 0.89 and later, you must explicitly enable cookie support. Before making the first request, simply call the static method


##Understanding the Code## The key method is AbstractHttpClient.doHttpMethod(String path, HttpMethod httpMethod, String contentType, byte[] content). This is the method that actually drives each request, catches any exceptions, and rethrows them wrapped in an HttpRequestException. It delegates most of the request lifecycle to a RequestHandler instance. To override the default behaviors (say, to provide your own error handler or custom stream reader/writer), simply extend the BasicRequestHandler like this:

        BasicHttpClient client = new BasicHttpClient(baseUrl, new BasicRequestHandler() {
            public boolean onError(HttpResponse res, Exception e) {
                return true; // if recoverable

##Advanced Usage## To create an async client for another platform, simply subclass AsyncHttpClient and provide it with an instance of a AsyncRequestExecutorFactory suitable for your platform. See the package for the Android implementation which uses AsyncTask.