AsyncHttpClient

An android AsyncHttpClient based on RESTful methods

License	The Apache Software License, Version 2.0
Categories	Net CLI User Interface
GroupId	net.callumtaylor
ArtifactId	asynchttpclient
Last Version	2.1.1
Release Date	May 31, 2018
Type	aar
Description	AsyncHttpClient An android AsyncHttpClient based on RESTful methods
Project URL	https://github.com/scruffyfox/AsyncHttpClient
Source Code Management	https://github.com/scruffyfox/AsyncHttpClient

Download asynchttpclient

Filename	Size
asynchttpclient-2.1.1.pom
asynchttpclient-2.1.1.aar	48 KB
asynchttpclient-2.1.1-sources.jar	33 KB
asynchttpclient-2.1.1-javadoc.jar	159 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/net.callumtaylor/asynchttpclient/ -->
<dependency>
    <groupId>net.callumtaylor</groupId>
    <artifactId>asynchttpclient</artifactId>
    <version>2.1.1</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/net.callumtaylor/asynchttpclient/
implementation 'net.callumtaylor:asynchttpclient:2.1.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.callumtaylor/asynchttpclient/
implementation ("net.callumtaylor:asynchttpclient:2.1.1")

Apache Buildr

'net.callumtaylor:asynchttpclient:aar:2.1.1'

Apache Ivy

<dependency org="net.callumtaylor" name="asynchttpclient" rev="2.1.1">
  <artifact name="asynchttpclient" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.callumtaylor', module='asynchttpclient', version='2.1.1')
)

Scala SBT

libraryDependencies += "net.callumtaylor" % "asynchttpclient" % "2.1.1"

Leiningen

[net.callumtaylor/asynchttpclient "2.1.1"]

Dependencies

compile (3)

Group / Artifact	Type	Version
com.squareup.okhttp3 : okhttp	jar	3.2.0
com.google.code.gson : gson	jar	2.6.2
com.android.support » support-annotations	jar	23.3.0

Project Modules

There are no modules declared in this project.

AsyncHttpClient by Callum Taylor

Follow me on Twitter | Website

This is the new and improved version of AsyncHttpClient taken from X-Library. It was long due a re-write.

In this version it allows a more flexible usage of posting files, http entities and GZIP handling.

The library uses Square's OKHTTP library.

It consists of 2 different classes, AsyncHttpClient and SyncHttpClient. Obviously by the name, AsyncHttpClient is for asynchronous requests which uses the AsyncTask paradigm, and SyncHttpClient is for synchronous requests which should be handled by yourself in a thread outside of the UI thread.

Usage

Simply import the gradle file into Android Studio and reference the dependancy in your settings.gradle and project's build.gradle

Alternatively you can add the maven dependancy net.callumtaylor:asynchttpclient:2.1.1 N.B. Do NOT use net.callumtaylor.asynchttp for the group ID. This is an old ID and will NOT be updated

Table of contents

• AsyncHttpClient

  1. Example GET
  2. Example POST
  3. Example PUT
  4. Example DELETE
  5. Example custom handler

• SyncHttpClient

  1. Example GET
  2. Example POST
  3. Example PUT
  4. Example DELETE
  5. Example custom handler

Other notes

Downloading large files

In order to download large files, you will need to subclass AsyncHttpResponseHandler and override the onByteChunkReceived() method to write directly to cache instead of appending to a ByteArrayOutputStream which is what the standard BinaryResponseHandler does. This is to stop OOM due to a over-sized output stream.

AsyncHttpClient

Note: Because AsyncHttpClient uses AsyncTask, only one instance can be created at a time. If one client makes 2 requests, the first request is canceled for the new request. You can either wait for the first to finish before making the second, or you can create two seperate instances. See: Example custom handler for more.

SyncHttpClient

SyncHttpClient is a paramitized class which means the type you infer to it, is the type that gets returned when calling the method. When supplying a ResponseHandler, that ResponseHandler must also paramitized with the same type as the SyncHttpClient instance.

You can also get the info of the request by calling your SyncHttpClient instance and getConnectionInfo(). This can only be called after the response has been completed.

Note: Because Android requires all network requests to be performed outside the UI thread, you must use SyncHttpClient sparingly and make sure you handle the operaion OFF the UI thread.

Because of the nature of REST, GET and DELETE requests behave in the same way, POST and PUT requests also behave in the same way.

License

See library/LICENSE

Versions

Version
2.1.1 May 31, 2018
2.1 Sep 16, 2016
2.0.1 May 10, 2016
2.0 May 5, 2016
1.5.1 Feb 19, 2016
1.5 Sep 22, 2014