HttpClient的使用案例-图片下载

HttpClient 简介 

HttpClient 是 Apache Jakarta common 下的子项目，用来提供高效的、最新的、功能丰富的支持 HTTP 协议的客户端编程工具包，并且它支持 HTTP 协议最新的版本和建议。 HttpClient 已经应用在很多的项目中，比如 Apache Jakarta 上很著名的另外两个开源项目 Cactus 和 HTMLLUnit 都使用了 HttpClient 。

1.HttpClient的特性

(1）基于标准、纯净的 Java 语言。实现了HTTP1.0和HTTP1.1。

(2）以可扩展的面向对象的结构实现了 HTTP 全部的方法（ GET 、 POST 、 PUT 、 DELETE , HEADOPTIONS 和 TRACE )。

(3）支持 HTTPS 协议。

(4）通过 HTTP 代理建立透明的连接。
(5）利用 CONNECT 方法通过 HTTP 代理建立隧道的 HTTPS 连接。

 2. HttpClient 的使用方法使用 

HttpClient 发送请求、接收响应很简单。具体步骤如下所示：

(1）创建 HttpClient 对象。

(2）创建请求方法的实例，并指定请求 URL 。

(3）发送请求参数时，调用 HttpGet 、 HttpPost 的 setParams ( HetpParams params ）方法来添加请求参数；对于 HttpPost 对象而言，也可调用 setEntity ( HttpEntity entity ）方法来设置请求参数。

(4）调用 HttpClient 对象的 execute ( HttpUriRequest request ）方法发送请求，该方法返回一个 HttpResponse 对象。

(5）调用 HttpResponse 的 getAllHeaders ()、 getHeaders ( String name ）等方法可获取服务器的响应斗，调用 HttnResponse getEnity()方法可获取 HttpEntity 对象，该对象包装了服务器的响应内容，程序可通过该对象获取服务器的响应内容。

（6）释放连接。无论执行方法是否成功，都必须释放连接。

 HttpClient的使用案例-图片下载

1.创建新项目

修改 activity _ main . xml 布局界面的代码，整体采用线性垂直布局的方式，放置一个 ImageView 组件、一个 EditText 组件、一个 Button 组件，分别用来显示图片、输人网址、单击显示图片。

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity"
    android:orientation="vertical">

    <EditText
        android:id="@+id/addream"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="http://m.imeitou.com/uploads/allimg/2016060813/lauy1mbqugw.jpg"/>

    <Button
        android:id="@+id/show"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="获取并显示图片" />

    <ImageView
        android:id="@+id/image"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />
</LinearLayout>

 2.编写 MainActivity 代码

MainActivity 中编写实现HttpClient访问网络图片并在界面显示的逻辑代码。具体的代码如下所示：

public class MainActivity extends AppCompatActivity {
    private ImageView imageView;
    private Button button;
    private EditText editText;
//定义获取到图片和失败的状态码
    protected static final int SUCCESS = 1;
    protected static final int ERROR = 2;
//创建消息处理器
    private Handler handler = new Handler(Looper.getMainLooper()) {
        public void handleMessage(android.os.Message msg) {
            if (msg.what == SUCCESS) {
                Bitmap bitmap = (Bitmap) msg.obj;
                imageView.setImageBitmap(bitmap);
            } else if (msg.what == ERROR) {
                Toast.makeText(MainActivity.this, "显示图片错误", Toast.LENGTH_SHORT).show();
            }
        }
    };

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.layout);
        init();
    }
//初始化组件
    private void init() {
        imageView = (ImageView) findViewById(R.id.image);
        button = (Button) findViewById(R.id.show);
        editText = (EditText) findViewById(R.id.addream);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {
//获取输入的网络图片地址
                final String path = editText.getText().toString().trim();
                if (TextUtils.isEmpty(path)) {
                    Toast.makeText(MainActivity.this, "图片路径不为空", Toast.LENGTH_SHORT).show();
                } else {
//子线程访问网络
                    new Thread() {
                        private HttpURLConnection conn;
                        private Bitmap bitmap;

                        public void run() {
                            getImageByHttpClient(path);
                        }
                    }.start();
                }
            }
        });
    }
//获取图片方法
    private void getImageByHttpClient(String path){
//获取HttpClient对象
        HttpClient Client=new DefaultHttpClient();
        HttpGet get=new HttpGet(path);
        try{
//获取返回HttpResponse对象
            HttpResponse response=Client.execute(get);
//查看状态码是否为200
            if(response.getStatusLine().getStatusCode()==200){
//请求成功，获取HttpEntity对象
                HttpEntity entity=response.getEntity();
//获取输入流
                InputStream in=entity.getContent();
//获取Bitmap对象
                Bitmap bitmap=BitmapFactory.decodeStream(in);
//通知消息处理器显示图片
                Message msg=new Message();
                msg.what=SUCCESS;
                msg.obj=bitmap;
                handler.sendMessage(msg);
            }
            else{
                Message msg=new Message();
                msg.what=ERROR;
                handler.sendMessage(msg);
            }
        }catch(Exception e){
            Message msg=new Message();
            msg.what=ERROR;
            handler.sendMessage(msg);
        }
    }
}

3.上述代码中，只有在 getImageByHttpClient ( String path ）方法中的代码与使用 HttpURLConnection 不同。此处方法中采用的是 HttpGet 方式请求获取网络图片资源，访问成功后会返回200的状态码，然后使用 HttpResponse 的 getEntity (）方法获得 HttpEntity 对象，然后通过 HttpEntity 对象的 getContent（）方法得到输人流，最后转换为 Bitmap 对象显示出来。

需要注意的是， Google 公司从 Android 6.0( API 23）以后，就不建议再用 HttpClient 了，取而代之的是 HttpUrIConnection ，所以要使用 HttpClient ，需要在 build . gradle 中加人如下语句：

    android{
         useLibrary'org.apache.http.legacy'
    }

选择第二个打开，添加至最下面也可添加在中间并导入。

 

 

 

 4.成果显示

为了方便，此处就提前在 EditText 中输人了网络图片的地址，图片地址为​​​​​​http://m.imeitou.com/uploads/allimg/2016060813/lauy1mbqugw.jpg，单击“获取并显示图片”按钮。