安卓AsyncHttpClient网络开源框架
来源:互联网 发布:知乎沙发挑选 编辑:程序博客网 时间:2024/05/21 23:48
地址一个:http://loopj.com/android-async-http/
Android Asynchronous Http Client
A Callback-Based Http Client Library for Android
or fork me on github
Overview
An asynchronous callback-based Http client for Android built on top of Apache’s HttpClient libraries. All requests are made outside of your app’s main UI thread, but any callback logic will be executed on the same thread as the callback was created using Android’s Handler message passing. You can also use it in Service or background thread, library will automatically recognize in which context is ran.
Features
- Make asynchronous HTTP requests, handle responses in anonymous callbacks
- HTTP requests happen outside the UI thread
- Requests use a threadpool to cap concurrent resource usage
- GET/POST params builder (RequestParams)
- Multipart file uploads with no additional third party libraries
- Streamed JSON uploads with no additional libraries
- Handling circular and relative redirects
- Tiny size overhead to your application, only 90kb for everything
- Automatic smart request retries optimized for spotty mobile connections
- Automatic gzip response decoding support for super-fast requests
- Binary protocol communication with
BinaryHttpResponseHandler
- Built-in response parsing into JSON with
JsonHttpResponseHandler
- Saving response directly into file with
FileAsyncHttpResponseHandler
- Persistent cookie store, saves cookies into your app’s SharedPreferences
- Integration with Jackson JSON, Gson or other JSON (de)serializing libraries with
BaseJsonHttpResponseHandler
- Support for SAX parser with
SaxAsyncHttpResponseHandler
- Support for languages and content encodings, not just UTF-8
Used in Production By Top Apps and Developers
- Instagram is the #1 photo app on android, with over 10million users
- Popular online pinboard. Organize and share things you love.
- Frontline Commando (Glu Games)
- #1 first person shooting game on Android, by Glu Games.
- Heyzap
- Social game discovery app with millions of users
- Pose
- Pose is the #1 fashion app for sharing and discovering new styles
- Thousands more apps…
- Async HTTP is used in production by thousands of top apps.
Installation & Basic Usage
Add maven dependency using Gradle buildscript in format
Import the http package.
Create a new AsyncHttpClient
instance and make a request:
Recommended Usage: Make a Static Http Client
In this example, we’ll make a http client class with static accessors to make it easy to communicate with Twitter’s API.
This then makes it very easy to work with the Twitter API in your code:
Check out the AsyncHttpClient, RequestParams and AsyncHttpResponseHandlerJavadocs for more details.
Persistent Cookie Storage with PersistentCookieStore
This library also includes a PersistentCookieStore
which is an implementation of the Apache HttpClient CookieStore
interface that automatically saves cookies to SharedPreferences
storage on the Android device.
This is extremely useful if you want to use cookies to manage authentication sessions, since the user will remain logged in even after closing and re-opening your app.
First, create an instance of AsyncHttpClient
:
Now set this client’s cookie store to be a new instance of PersistentCookieStore
, constructed with an activity or application context (usually this
will suffice):
Any cookies received from servers will now be stored in the persistent cookie store.
To add your own cookies to the store, simply construct a new cookie and call addCookie
:
See the PersistentCookieStore Javadoc for more information.
Adding GET/POST Parameters with RequestParams
The RequestParams
class is used to add optional GET or POST parameters to your requests.RequestParams
can be built and constructed in various ways:
Create empty RequestParams
and immediately add some parameters:
Create RequestParams
for a single parameter:
Create RequestParams
from an existing Map
of key/value strings:
See the RequestParams Javadoc for more information.
Uploading Files with RequestParams
The RequestParams
class additionally supports multipart file uploads as follows:
Add an InputStream
to the RequestParams
to upload:
Add a File
object to the RequestParams
to upload:
Add a byte array to the RequestParams
to upload:
See the RequestParams Javadoc for more information.
Downloading Binary Data with FileAsyncHttpResponseHandler
The FileAsyncHttpResponseHandler
class can be used to fetch binary data such as images and other files. For example:
See the FileAsyncHttpResponseHandler Javadoc for more information.
Adding HTTP Basic Auth credentials
Some requests may need username/password credentials when dealing with API services that use HTTP Basic Access Authentication requests. You can use the methodsetBasicAuth()
to provide your credentials.
Set username/password for any host and realm for a particular request. By default the Authentication Scope is for any host, port and realm.
You can also provide a more specific Authentication Scope (recommended)
See the RequestParams Javadoc for more information.
Testing on device
You can test the library on real device or emulator using provided Sample Application. Sample application implements all important functions of library, you can use it as source of inspiration.
Source code of sample application: https://github.com/loopj/android-async-http/tree/master/sample
To run sample application, clone the android-async-http github repository and run command in it’s root:
Which will install Sample application on connected device, all examples do work immediately, if not please file bug report on https://github.com/loopj/android-async-http/issues
Building from Source
To build a .jar
file from source, first make a clone of the android-async-http github repository. Then you have to have installed Android SDK and Gradle buildscript, then just run:
This will generate a file in path {repository_root}/library/build/libs/library-1.4.6.jar
.
Reporting Bugs or Feature Requests
Please report any bugs or feature requests on the github issues page for this project here:
https://github.com/loopj/android-async-http/issues
Credits & Contributors
- James Smith (http://github.com/loopj)
- Creator and Maintainer
- Marek Sebera (http://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 (http://github.com/m5)
- Major Contributor, including the original
RequestParams
- The Droid Fu Project (https://github.com/kaeppler/droid-fu)
- Inspiration and code for better http retries
- Rafael Sanches (http://blog.rafaelsanches.com)
- Original
SimpleMultipartEntity
code - Anthony Persaud (http://github.com/apersaud)
- Added support for HTTP Basic Authentication requests.
- Linden Darling (http://github.com/coreform)
- Added support for binary/image responses
And many others, contributions are listed in each file in license header. You can also find contributors by looking on project commits, issues and pull-requests on Github
License
The Android Asynchronous Http Client is released under the Android-friendly Apache License, Version 2.0. Read the full license here:
http://www.apache.org/licenses/LICENSE-2.0
About the Author
James Smith, British entrepreneur and developer based in San Francisco.
I'm the co-founder of Bugsnag with Simon Maynard, and from 2009 to 2012 I led up the product team as CTO of Heyzap.
- 安卓AsyncHttpClient网络开源框架
- 开源框架 Asynchttpclient
- Android-AsyncHttpClient网络框架
- Android网络请求框架--AsyncHttpClient
- 网络请求框架(一):AsyncHttpClient
- http请求开源框架: AsyncHttpClient
- AsyncHttpClient 开源框架學習研究
- AsyncHttpClient 开源框架學習研究
- 开源框架AsyncHttpClient的使用
- Android开源框架之AsyncHttpClient
- 赵雅智_引用开源框架通过AsyncHttpClient实现网络图片查看器
- 引用开源框架通过AsyncHttpClient实现网络图片查看器
- 网络请求框架AsyncHttpclient的简单使用
- Android网络框架AsyncHttpClient的二次封装
- android网络框架asyncHttpClient 的二次封装
- Android网络请求框架AsyncHttpClient详解
- Android网络请求框架AsyncHttpClient详解
- 部分网络框架的讲解 如:AsyncHttpClient.....
- C# 并行编程 之 ThreadPool的基本使用
- ocx 中处理回车相应的问题
- NoSQL数据库-MongoDB和Redis
- 一个有关程序运行时间的小测试
- 同步数据
- 安卓AsyncHttpClient网络开源框架
- SSH级联操作报错:org.hibernate.exception.ConstraintViolationException: Could not execute
- SwipeRefreshLayout完美添加及完善上拉加载功能
- spring aop 基于注解
- Android 开源框架 DataDroid
- hdu 5249 KPI (动态中位数,两个set)
- 黑马程序员——Foundation框架——常用结构体以及NSString相关
- Qt的model中一裤衩函数的总结
- Goroutine + Channel 实践