本文为译文,原文链接https://loopj.com/android-async-http/

安卓异步httpclient

概述

这是一个异步的基于回调的Android http客户端,构建于Apache httpclient库上。全部的请求都是独立于UI线程的。与此同一时候回调会由handler在发起请求的线程中执行。你也能够在后台线程和服务中使用它,这个库会自己主动识别它的执行环境。

特点

异步请求,回调处理。

不会堵塞UI线程。

使用线程池来负担并发请求。

GET/POST參数构建。

文件分部上传(不须要其他库的支持)。

流化上传JSON(不须要其他库的支持)

处理循环和相关的重定向。

包大小仅仅有90kb

自己主动智能请求重试。对不稳定的移动链接而优化。

自己主动使用gzip响应编码,以支持超快请求。

二进制的通讯协议,使用BinaryHttpResponseHandler。

内建对应解析为JSOn的机制。使用JsonHttpResponseHandler。

直接保存对应。使用FileAsyncHttpResponseHandler。

持久的cookie存储,保存在SharedPreferences中。

集成 Jackson JSON,Gson以及其他JSON系列框架。通过使用BaseJsonHttpResponseHandler。

支持SAX解析。通过使用SaxAsyncHttpResponseHandler。

支持语言和内容的编码,不不过UTF-8。

使用本库的高端App和开发人员

Instagram

Pinterest

FrontlineCommando (Glu Games)

id=com.heyzap.android">Heyzap

id=com.pose">Pose

Thousandsmore apps…

安装和基本使用

加入maven依赖使用gradle构建。

dependencies {

compile 'com.loopj.android:android-async-http:1.4.8'

}

导入http包

import com.loopj.android.http.*;

创建一个新的AsyncHttpClient 实例,并发送请求:

AsyncHttpClient client = new AsyncHttpClient();
client.get("https://www.google.com", new AsyncHttpResponseHandler() {
 
    @Override
    public void onStart() {
        // called before request is started
    }
 
    @Override
    public void onSuccess(int statusCode, Header[] headers, byte[] response) {
        // called when response HTTP status is "200 OK"
    }
 
    @Override
    public void onFailure(int statusCode, Header[] headers, byte[] errorResponse, Throwable e) {
        // called when response HTTP status is "4XX" (eg. 401, 403, 404)
    }
 
    @Override
    public void onRetry(int retryNo) {
        // called when request is retried
          }
});

推荐使用方法:创建一个静态的httpclient

在这个样例中,我们将创建一个httpclient,使用静态的訪问器。使我们与Twitter的API的通信更easy。

import com.loopj.android.http.*;
 
public class TwitterRestClient {
  private static final String BASE_URL = "https://api.twitter.com/1/";
 
  private static AsyncHttpClient client = new AsyncHttpClient();
 
  public static void get(String url, RequestParams params, AsyncHttpResponseHandler responseHandler) {
      client.get(getAbsoluteUrl(url), params, responseHandler);
  }
 
  public static void post(String url, RequestParams params, AsyncHttpResponseHandler responseHandler) {
      client.post(getAbsoluteUrl(url), params, responseHandler);
  }
 
  private static String getAbsoluteUrl(String relativeUrl) {
      return BASE_URL + relativeUrl;
  }
}

这样话,你后面在使用Twitter的api就非常easy了:

import org.json.*;
import com.loopj.android.http.*;
 
class TwitterRestClientUsage {
    public void getPublicTimeline() throws JSONException {
        TwitterRestClient.get("statuses/public_timeline.json", null, new JsonHttpResponseHandler() {
            @Override
            public void onSuccess(int statusCode, Header[] headers, JSONObject response) {
                // If the response is JSONObject instead of expected JSONArray
            }
            
            @Override
            public void onSuccess(int statusCode, Header[] headers, JSONArray timeline) {
                // Pull out the first event on the public timeline
                JSONObject firstEvent = timeline.get(0);
                String tweetText = firstEvent.getString("text");
 
                // Do something with the response
                System.out.println(tweetText);
            }
        });
    }
}

查看AsyncHttpClientRequestParams 和AsyncHttpResponseHandler的java文档来了解很多其它。

持久的cookie存储,使用PersistentCookieStore

这个库也包括了一个持久的cookie存储功能,使用了apachehtpclient cookiestore接口。自己主动的存储cookies到sharedpreferences。

这个特别实用,当你想使用cookies来管理带你的鉴权会话。由于用户在退出或者又一次打开你的app时,都能够保持登录状态。

第一步,建立一个AsyncHttpClient的实例:

AsyncHttpClient myClient = new AsyncHttpClient();

使用activity的context或者application的context来构建这个client的cookies的PersistentCookieStore实例。

PersistentCookieStore myCookieStore = new PersistentCookieStore(this);
myClient.setCookieStore(myCookieStore);

如今,不论什么从服务端获得的cookies将会持久的存储。

加入你自己的cookies。仅仅要构建一个cookies然后调用addcookie。

BasicClientCookie newCookie = new BasicClientCookie("cookiesare", "awesome");
newCookie.setVersion(1);
newCookie.setDomain("mydomain.com");
newCookie.setPath("/");
myCookieStore.addCookie(newCookie);

PersistentCookieStoreJavadoc 获得很多其它信息。

加入GET/POST參数,使用RequestParams

你的GET或者POST请求都能够加入參数。

RequestParams 能够下面几种方式构建:

创建空的參数集并加入參数:

RequestParams params = new RequestParams();
params.put("key", "value");
params.put("more", "data");

创建单參数的RequestParams :

RequestParams params = new RequestParams("single", "value");

从已有的Map中创建參数集:

HashMap<String, String> paramMap = new HashMap<String, String>();
paramMap.put("key", "value");
RequestParams params = new RequestParams(paramMap);

RequestParamsJavadoc 了解很多其它。

使用參数上传文件

參数集支持分部上传文件,例如以下:

加入输入流到參数来上传:

InputStream myInputStream = blah;
RequestParams params = new RequestParams();
params.put("secret_passwords", myInputStream, "passwords.txt");

加入一个对象到參数来上传:

File myFile = new File("/path/to/file.png");
RequestParams params = new RequestParams();
try {
    params.put("profile_picture", myFile);
} catch(FileNotFoundException e) {}

加入一个比特数据到參数来上传:

byte[] myByteArray = blah;
RequestParams params = new RequestParams();
params.put("soundtrack", new ByteArrayInputStream(myByteArray), "she-wolf.mp3");

RequestParamsJavadoc 了解很多其它。

下载二进制数据使用FileAsyncHttpResponseHandler

FileAsyncHttpResponseHandler 能够用来下载二进制数据比方图片和其他文件。样例:

AsyncHttpClient client = new AsyncHttpClient();
client.get("https://example.com/file.png", new FileAsyncHttpResponseHandler(/* Context */ this) {
    @Override
    public void onSuccess(int statusCode, Header[] headers, File response) {
        // Do something with the file `response`
    }
});

FileAsyncHttpResponseHandlerJavadoc 了解很多其它。

加入HTTP基本鉴权证书

一些API服务可能要求HTTP基本訪问认证,因此可能须要给请求提供username/password来认证。使用setBasicAuth()来提供认证。

对特定请求设置 username/password对不论什么主机和域名。默认的,认证对不论什么主机域名和port都起作用。

AsyncHttpClient client = new AsyncHttpClient();
client.setBasicAuth("username","password/token");
client.get("https://example.com");

推荐,你也能够提供一个更具体的鉴权范围。

AsyncHttpClient client = new AsyncHttpClient();
client.setBasicAuth("username","password", new AuthScope("example.com", 80, AuthScope.ANY_REALM));
client.get("https://example.com");

看 RequestParams Javadoc 了解很多其它。

在设备上測试

你能够在真机或者模拟器上測试这个库。使用提供的样例程序。样例程序实现了全部的重要的库功能。

你能够把它们当作实际代码的灵感。

样例程序:https://github.com/loopj/android-async-http/tree/master/sample

为了执行样例,从android-async-http的github库上克隆项目。而且在root下执行例如以下命令:

gradle :sample:installDebug

这个命令会安装样例程序在链接的机器上,全部的样例都能够高速的执行,假设不行,请在https://github.com/loopj/android-async-http/issues提交问题。

从源代码构建

首先克隆项目,然后安装Android sdk 和 gradle。然后运行:

gradle :library:jarRelease

将会产生目标文件: {repository_root}/library/build/libs/library-1.4.8.jar.

报告bug和特性需求

https://github.com/loopj/android-async-http/issues

工作人员和贡献者

James Smith (https://github.com/loopj)

Creator and Maintainer

Marek Sebera (https://github.com/smarek)

Maintainer since 1.4.4 release

Noor Dawod (https://github.com/fineswap)

Maintainer since 1.4.5 release

Luciano Vitti (https://github.com/xAnubiSx)

Collaborated on Sample Application

Jason Choy (https://github.com/jjwchoy)

Added support for RequestHandle feature

Micah Fivecoate (https://github.com/m5)

Major Contributor,including the original RequestParams

The Droid FuProject (https://github.com/kaeppler/droid-fu)

Inspiration and code for better httpretries

Rafael Sanches (https://blog.rafaelsanches.com)

Original SimpleMultipartEntity code

Anthony Persaud (https://github.com/apersaud)

Added support for HTTP BasicAuthentication requests.

Linden Darling (https://github.com/coreform)

Added support for binary/image responses

许可证

ApacheLicense, Version 2.0.

https://www.apache.org/licenses/LICENSE-2.0

关于作者

James Smith, Britishentrepreneur and developer based in San Francisco.

I'm the co-founder of Bugsnag with Simon Maynard,
andfrom 2009 to 2012 I led up the product team as CTO of Heyzap.

Follow @loopj

本文下载

http://download.csdn.net/detail/zhounanzhaode/8924505

 

Android Asynchronous Http Client 中文教程的更多相关文章

  1. Android Asynchronous Http Client

    Features Make asynchronous HTTP requests, handle responses in anonymous callbacks HTTP requests happ ...

  2. 【转】Android Studio-1.2版本设置教程

    如果重新安装Android Studio的话要重新配置风格选项啥的,这篇是个很好的教程,原文链接:http://blog.csdn.net/skykingf/article/details/45485 ...

  3. Android Studio下载及使用教程(转载)

    (一)下载及相关问题解决: Android Studio 下载地址,目前最新可下载地址,尽量使用下载工具. Android Studio正式发布,给Android开发者带来了不小的惊喜.但是下载地址却 ...

  4. Android自动化压力测试图解教程——Monkey工具

    [置顶] Android自动化压力测试图解教程--Monkey工具 标签: 测试androidprofiling工具测试工具文档 2012-04-01 10:16 38185人阅读 评论(10) 收藏 ...

  5. PuTTY 中文教程

    PuTTY 中文教程 更新记录 2006-11-29初步完成想写的这些东西 2007-06-11PuTTY 的最新版本到了0.6:修改了一下 SSH 隧道:添加了 SSH 反向隧道:添加了用 SSH ...

  6. Netty4.x中文教程系列(二) Hello World !

    在中国程序界.我们都是学着Hello World !慢慢成长起来的.逐渐从一无所知到熟悉精通的. 第二章就从Hello World 开始讲述Netty的中文教程. 首先创建一个Java项目.引入一个N ...

  7. Netty4.x中文教程系列(四) 对象传输

    Netty4.x中文教程系列(四)  对象传输 我们在使用netty的过程中肯定会遇到传输对象的情况,Netty4通过ObjectEncoder和ObjectDecoder来支持. 首先我们定义一个U ...

  8. 【转】Android Studio安装配置学习教程指南 下载和安装--不错

    背景 相信大家对Android Studio已经不陌生了,Android Studio是Google于2013 I/O大会针对Android开发推出的新的开发工具,目前很多开源项目都已经在采用,Goo ...

  9. CEF中文教程(google chrome浏览器控件) -- Windows下编译Chromium

    CEF中文教程(google chrome浏览器控件) -- CEF简介 2013-04-10 16:48 42928人阅读 评论(4) 收藏 举报  分类: CEF(2)    目录(?)[+]   ...

随机推荐

  1. Spring的属性依赖检查

    spring支持4种依赖检查:默认的是none none – No dependency checking. simple – If any properties of primitive type ...

  2. 各版本Sql Server下载地址全

    SQL Server 2014简体中文企业版 文件名:cn_sql_server_2014_enterprise_edition 32位下载地址:ed2k://|file|cn_sql_server_ ...

  3. 创建型设计模式之原型模式(Prototype)

    结构   意图 用原型实例指定创建对象的种类,并且通过拷贝这些原型创建新的对象. 适用性 当要实例化的类是在运行时刻指定时,例如,通过动态装载:或者 为了避免创建一个与产品类层次平行的工厂类层次时:或 ...

  4. ZOJ 3820:Building Fire Stations(树的直径 Grade C)

    题意: n个点的树,边长全为1,求找出两个点,使得树上离这两个点距离最远的那个点,到这两个点(中某个点就行)的距离最小. 思路: 求树直径,找中点,删除中间那条边(如果直径上点数为奇数,则删任何一侧都 ...

  5. J.U.C并发框架源码阅读(十三)ThreadPoolExecutor

    基于版本jdk1.7.0_80 java.util.concurrent.ThreadPoolExecutor 代码如下 /* * ORACLE PROPRIETARY/CONFIDENTIAL. U ...

  6. 洛谷——P1403 [AHOI2005]约数研究

    P1403 [AHOI2005]约数研究 题目描述 科学家们在Samuel星球上的探险得到了丰富的能源储备,这使得空间站中大型计算机“Samuel II”的长时间运算成为了可能.由于在去年一年的辛苦工 ...

  7. Gmail进程信息转储分析工具pdgmail

    Gmail进程信息转储分析工具pdgmail   进程信息转储(Process Memory Dump)是数字取证的重要方式.通过分析对应进程的信息转储,可以获取大量的信息.Kali Linux提供一 ...

  8. [洛谷3808]【模板】AC自动机(简单版)

    题目大意: 给定$n$个模式串$p(\sum|p_i|\le10^6)$和一个$t(|t|\le10^6)$,求在$t$中被匹配的$p$的个数. 思路: AC自动机模板题,注意$t$中一个字符可能对应 ...

  9. LAMP----linux+apache+mysql+php详细安装步骤之一APACHE篇(openldap等)

    LAMP----linux+apache+mysql+php详细安装步骤之一APACHE篇(openldap等) linux详细版本为RHEL5.3 [root@localhost mail]# un ...

  10. pr_debug、dev_dbg等动态调试一

    内核版本:Linux-3.14 作者:彭东林 邮箱:pengdonglin137@163.com pr_debug: #if defined(CONFIG_DYNAMIC_DEBUG) /* dyna ...