使用HTTP訪问网络资源

前面介绍了 URLConnection己经能够很方便地与指定网站交换信息，URLConnection另一个子类：HttpURLConnection，HttpURLConnection 在 LIRLConnection的基础上做了进一步改进，添加了一些用于操作http资源的便捷方法。

1.使用HttpURLConnection

HttpURLConnection继承了URLConnection,因此也可用于向指定站点发送GET请求 POST请求。它在URLConnection的基础上提供了例如以下便捷的方法。

1) Int getResponseCode():获取server的响应代码。

2) String getResponseMessage():获取server的响应消息。

3) String getRequestMethod():获取发送请求的方法。

4) void setRequestMethod(String method):设置发送请求的方法。

以下通过个有用的演示样例来示范使用HttpURLConnection实现多线程下载。

1.1实例：多线程下载

使用多线程下载文件能够更快地完毕文件的下载，由于client启动多个线程进行下寒意味着server也须要为该client提供相应的服务。如果server同一时候最多服务100个用户，server中一条线程相应一个用户，100条线程在计算机内并发运行，也就是由CPU划分史 片轮流运行，如果A应用使用了 99条线程下载文件，那么相当于占用了 99个用户的资源自然就拥有了较快的下载速度。

提示：实际上并非client并发的下载线程越多，程序的下载速度就越快，由于当client开启太多的并发线程之后，应用程序须要维护每条线程的开销、线程同步的开销，这些开销反而会导致下载速度减少.

1.2为了实现多线程下载，程序可按例如以下步骤进行：

Ø 创建URL对象。

Ø 获取指定URL对象所指向资源的大小（由getContentLength()方法实现），此处用了 HttpURLConnection 类。

Ø 在本地磁盘上创建一个与网络资源同样大小的空文件。

Ø 计算每条线程应该下载网络资源的哪个部分（从哪个字节開始，到哪个字节结束，依次创建、启动多条线程来下载网络资源的指定部分。

1.2该程序提供的下载工具类代码例如以下。

package com.jph.net;import java.io.InputStream;
import java.io.RandomAccessFile;
import java.net.HttpURLConnection;
import java.net.URL;/*** Description:* 创建ServerSocket监听的主类* @author  jph* Date：2014.08.27*/
public class DownUtil
{/**下载资源的路径**/ private String path;/**下载的文件的保存位置**/ private String targetFile;/**须要使用多少线程下载资源**/  private int threadNum;/**下载的线程对象**/  private DownThread[] threads;/**下载的文件的总大小**/ private int fileSize;public DownUtil(String path, String targetFile, int threadNum){this.path = path;this.threadNum = threadNum;// 初始化threads数组threads = new DownThread[threadNum];this.targetFile = targetFile;}public void download() throws Exception{URL url = new URL(path);HttpURLConnection conn = (HttpURLConnection) url.openConnection();conn.setConnectTimeout(5 * 1000);conn.setRequestMethod("GET");conn.setRequestProperty("Accept","image/gif, image/jpeg, image/pjpeg, image/pjpeg, "+ "application/x-shockwave-flash, application/xaml+xml, "+ "application/vnd.ms-xpsdocument, application/x-ms-xbap, "+ "application/x-ms-application, application/vnd.ms-excel, "+ "application/vnd.ms-powerpoint, application/msword, */*");conn.setRequestProperty("Accept-Language", "zh-CN");conn.setRequestProperty("Charset", "UTF-8");conn.setRequestProperty("Connection", "Keep-Alive");// 得到文件大小fileSize = conn.getContentLength();conn.disconnect();int currentPartSize = fileSize / threadNum + 1;RandomAccessFile file = new RandomAccessFile(targetFile, "rw");// 设置本地文件的大小file.setLength(fileSize);file.close();for (int i = 0; i < threadNum; i++){// 计算每条线程的下载的開始位置int startPos = i * currentPartSize;// 每一个线程使用一个RandomAccessFile进行下载RandomAccessFile currentPart = new RandomAccessFile(targetFile,"rw");// 定位该线程的下载位置currentPart.seek(startPos);// 创建下载线程threads[i] = new DownThread(startPos, currentPartSize,currentPart);// 启动下载线程threads[i].start();}}// 获取下载的完毕百分比public double getCompleteRate(){// 统计多条线程已经下载的总大小int sumSize = 0;for (int i = 0; i < threadNum; i++){sumSize += threads[i].length;}// 返回已经完毕的百分比return sumSize * 1.0 / fileSize;}private class DownThread extends Thread{/**当前线程的下载位置**/ private int startPos;/**定义当前线程负责下载的文件大小**/ private int currentPartSize;/**当前线程须要下载的文件块**/ private RandomAccessFile currentPart;/**定义该线程已下载的字节数**/ public int length;public DownThread(int startPos, int currentPartSize,RandomAccessFile currentPart){this.startPos = startPos;this.currentPartSize = currentPartSize;this.currentPart = currentPart;}@Overridepublic void run(){try{URL url = new URL(path);HttpURLConnection conn = (HttpURLConnection)url.openConnection();conn.setConnectTimeout(5 * 1000);conn.setRequestMethod("GET");conn.setRequestProperty("Accept","image/gif, image/jpeg, image/pjpeg, image/pjpeg, "+ "application/x-shockwave-flash, application/xaml+xml, "+ "application/vnd.ms-xpsdocument, application/x-ms-xbap, "+ "application/x-ms-application, application/vnd.ms-excel, "+ "application/vnd.ms-powerpoint, application/msword, */*");conn.setRequestProperty("Accept-Language", "zh-CN");conn.setRequestProperty("Charset", "UTF-8");InputStream inStream = conn.getInputStream();// 跳过startPos个字节，表明该线程仅仅下载自己负责哪部分文件。inStream.skip(this.startPos);byte[] buffer = new byte[1024];int hasRead = 0;// 读取网络数据，并写入本地文件while (length < currentPartSize&& (hasRead = inStream.read(buffer)) > 0){currentPart.write(buffer, 0, hasRead);// 累计该线程下载的总大小length += hasRead;}currentPart.close();inStream.close();}catch (Exception e){e.printStackTrace();}}}
}

上而的DownUtil工具类中包含一个DownloadThread内部类，该内部类的run()方法中负责打开远程资源的输入流，并调用inputStream的skip(int)方法跳过指定数量的字节，这样就让该线程读取由它自己负责下载的部分。

提供了上面的DownUtil工具类之后，接下来就能够在Activity中调用该DownUtil类来运行下载任务，该程序界面中包括两个文本框，一个用于输入网络文件的源路径，还有一个用于指定下载到本地的文件的文件名称，该程序的界面比較简单，故此处不再给出界面布局代码。该程序的Activity代码例如以下。

package com.jph.net;import java.util.Timer;
import java.util.TimerTask;
import android.app.Activity;
import android.content.Context;
import android.os.Bundle;
import android.os.Handler;
import android.os.Looper;
import android.os.Message;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.ProgressBar;
import android.widget.Toast;/*** Description:* 多线程下载* @author  jph* Date：2014.08.27*/
public class MultiThreadDown extends Activity
{EditText url;EditText target;Button downBn;ProgressBar bar;DownUtil downUtil;private int mDownStatus;@Overridepublic void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);// 获取程序界面中的三个界面控件url = (EditText) findViewById(R.id.url);target = (EditText) findViewById(R.id.target);downBn = (Button) findViewById(R.id.down);bar = (ProgressBar) findViewById(R.id.bar);// 创建一个Handler对象final Handler handler = new Handler(){@Overridepublic void handleMessage(Message msg){if (msg.what == 0x123){bar.setProgress(mDownStatus);}}};downBn.setOnClickListener(new OnClickListener(){@Overridepublic void onClick(View v){// 初始化DownUtil对象（最后一个參数指定线程数）downUtil = new DownUtil(url.getText().toString(),target.getText().toString(), 6);new Thread(){@Overridepublic void run(){try{// 開始下载downUtil.download();}catch (Exception e){e.printStackTrace();}// 定义每秒调度获取一次系统的完毕进度final Timer timer = new Timer();timer.schedule(new TimerTask(){@Overridepublic void run(){// 获取下载任务的完毕比率double completeRate = downUtil.getCompleteRate();mDownStatus = (int) (completeRate * 100);// 发送消息通知界面更新进度条handler.sendEmptyMessage(0x123);// 下载全然后取消任务调度if (mDownStatus >= 100){showToastByRunnable(MultiThreadDown.this, "下载完毕", 2000);timer.cancel();}}}, 0, 100);}}.start();}});}/*** 在非UI线程中使用Toast* @param context 上下文* @param text 用以显示的消息内容* @param duration 消息显示的时间* */private void showToastByRunnable(final Context context, final CharSequence text, final int duration) {Handler handler = new Handler(Looper.getMainLooper());handler.post(new Runnable() {@Overridepublic void run() {Toast.makeText(context, text, duration).show();}});}
}

上面的Activity不仅使用了 DownUtil来控制程序下载，并且程序还启动了一个定时器，该定时器控制每隔0.1秒査询一次下载进度，并通过程序中的进度条来显示任务的下载进度。

该程序不仅须要訪问网络，还须要訪问系统SD卡，在SD卡中创建文件，因此必须授予该程序訪问网络、訪问SD卡文件的权限：

<!-- 在SD卡中创建与删除文件权限 -->
<uses-permission android:name="android.permission.MOUNT_UNMOUNT_FILESYSTEMS"/>
<!-- 向SD卡写入数据权限 -->
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<!-- 授权訪问网络 -->
<uses-permission android:name="android.permission.INTERNET"/>

程序执行效果图：

提示：上面的程序已经实现了多线程下载的核心代码，假设要实现断点下载，则还须要额外添加一个配置文件（大家能够发现全部断点下载工具都会在下载開始生成两个文件：一个是与网络资源同样大小的空文件，一个是配置文件），该配置文件分别记录每一个线程已经下载到了哪个字节，当网络断开后再次開始下载时，每一个线程依据配置文件中记录的位置向后下载就可以。

2 使用ApacheHttpClient

在普通情况下，假设仅仅是须要向Web网站的某个简单页面提交请求并获取server响应， 全然能够使用前面所介绍的HttpURLConnection来完毕。但在绝大部分情况下，Web网站的网页可能没这么简单，这些页面并非通过一个简单的URL就可訪问的，可能须要用户登录并且具有对应的权限才可訪问该页面。在这样的情况下，就须要涉及Session、Cookie的处理了，假设打算使用HttpURLConnection来处理这些细节，当然也是可能实现的，仅仅是处理起来难度就大了。

为了更好地处理向Web网站请求，包含处理Session、Cookie等细节问题，Apache开源组织提供了一个HttpClient项目，看它的名称就知道，它是一个简单的HTTPclient（并非浏览器），能够用于发送HTTP请求，接收HTTP响应。但不会缓存server的响应，不能运行HTML页面中嵌入的JavaScript代码；也不会对页面内容进行不论什么解析、处理。

提示：简单来说，HttpClient就是一个增强版的HttpURLConnection ,HttpURLConnection能够做的事情 HttpClient所有能够做；HttpURLConnection没有提供的有些功能，HttpClient也提供了，但它仅仅是关注于怎样发送请求、接收响应，以及管理HTTP连接。|

Android集成了HttpClient，开发者能够直接在Android应用中使用HttpCHent来訪问提交请求、接收响应。

2.1使用HttpClient发送清求、接收响应非常easy，仅仅要例如以下几步就可以：

1) 创建HttpClient对象。

2) 假设须要发送GET请求，创建HttpGet对象；假设须要发送POST 求，创建HttpPost对象。

3) 假设须要发送请求參数，可调用HttpGet、HttpPost共同的setParams(HttpParams params)方法来加入请求參数；对于HttpPost对象而言，也可调用setEntity(HttpEntityentity)方法来设置请求參数。

4) 调用HttpClient对象的execute(HttpUriRequestrequest)发送请求，运行该方法返回一 个 HttpResponse。

5) 调用HttpResponse的getAllHeaders()、getHeaders(String name)等方法可获取server的响应头；调用HttpResponse的getEntity()方法可获取HttpEntity对象，该对象包装了server的响应内容。程序可通过该对象获取server的响应内容。

2.2实例：訪问被保护资源

     以下的Android应用须要向指定页面发送请求，但该页面并非一个简单的页面，仅仅有 当用户已经登录，并且登录用户的username是jph时才可訪问该页面。假设使用HttpUrlConnection来訪问该页面，那么须要处理的细节就太复杂了。以下将会借助于 HttpClient来訪问被保护的页面。

訪问Web应用中被保护的页面，假设使用浏览器则十分简单，用户通过系统提供的登录页面登录系统，浏览器会负责维护与server之间的Session,假设用户登录的username、password符合要求，就能够訪问被保护资源了。

为了通过HttpClient来訪问被保护页面，程序相同须要使用HttpClient来登录系统，仅仅要应用程序使用同一个HttpClient发送请求，HttpClient会自己主动维护与server之间的Session状态，也就是说程序第一次使用HttpCHent登录系统后，接下来使用HttpCHent就可以訪问被保护页面了。

提示:尽管此处给出的实例仅仅是訪问被保护的页面，但訪问其它被保护的资源也与此类似，程序仅仅要第一次通过HttpClient登录系统，接下来就可以通过该HttpClient訪问被保护资源了。

2.3程序代码：

package com.jph.net;import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.util.ArrayList;
import java.util.List;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.HttpClient;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpGet;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.protocol.HTTP;
import org.apache.http.util.EntityUtils;
import android.app.Activity;
import android.app.AlertDialog;
import android.content.DialogInterface;
import android.os.Bundle;
import android.os.Handler;
import android.os.Looper;
import android.os.Message;
import android.text.Html;
import android.view.View;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
/*** Description:* 使用HttpClient訪问受保护的网络资源* @author  jph* Date：2014.08.28*/
public class HttpClientDemo extends Activity
{TextView response;HttpClient httpClient;Handler handler = new Handler(){public void handleMessage(Message msg){if(msg.what == 0x123){// 使用response文本框显示server响应response.append(Html.fromHtml(msg.obj.toString()) + "\n");}}};@Overridepublic void onCreate(Bundle savedInstanceState){super.onCreate(savedInstanceState);setContentView(R.layout.main);// 创建DefaultHttpClient对象httpClient = new DefaultHttpClient();response = (TextView) findViewById(R.id.response);}/*** 此方法用于响应“訪问页面”button* */public void accessSecret(View v){response.setText("");new Thread(){@Overridepublic void run(){// 创建一个HttpGet对象HttpGet get = new HttpGet("http://10.201.1.32:8080/HttpClientTest_Web/secret.jsp");  //①try{// 发送GET请求HttpResponse httpResponse = httpClient.execute(get);//②HttpEntity entity = httpResponse.getEntity();if (entity != null){// 读取server响应BufferedReader br = new BufferedReader(new InputStreamReader(entity.getContent()));String line = null;while ((line = br.readLine()) != null){Message msg = new Message();msg.what = 0x123;msg.obj = line;handler.sendMessage(msg);}}}catch (Exception e){e.printStackTrace();}}}.start();}/*** 此方法用于响应“登陆系统”button* */public void showLogin(View v){// 载入登录界面final View loginDialog = getLayoutInflater().inflate(R.layout.login, null);// 使用对话框供用户登录系统new AlertDialog.Builder(HttpClientDemo.this).setTitle("登录系统").setView(loginDialog).setPositiveButton("登录",new DialogInterface.OnClickListener(){@Overridepublic void onClick(DialogInterface dialog,int which){// 获取用户输入的username、passwordfinal String name = ((EditText) loginDialog.findViewById(R.id.name)).getText().toString();final String pass = ((EditText) loginDialog.findViewById(R.id.pass)).getText().toString();new Thread(){@Overridepublic void run(){try{HttpPost post = new HttpPost("http://10.201.1.32:8080/" +"HttpClientTest_Web/login.jsp");//③// 假设传递參数个数比較多的话能够对传递的參数进行封装List<NameValuePair> params = newArrayList<NameValuePair>();params.add(new BasicNameValuePair("name", name));params.add(new BasicNameValuePair("pass", pass));                                // 设置请求參数post.setEntity(new UrlEncodedFormEntity(params, HTTP.UTF_8));// 发送POST请求HttpResponse response = httpClient.execute(post);  //④// 假设server成功地返回响应if (response.getStatusLine().getStatusCode() == 200){String msg = EntityUtils.toString(response.getEntity());Looper.prepare();// 提示登录成功Toast.makeText(HttpClientDemo.this,msg, Toast.LENGTH_SHORT).show();Looper.loop();}}catch (Exception e){e.printStackTrace();}}}.start();}}).setNegativeButton("取消", null).show();}
}

上面的程序中①、②号粗体字代码先创建了一个HttpGet对象，接下来程序调用HttpClient的execute()方法发送GET请求；程序中③、④号粗体字代码先创建了一个HttpPost对象，接下来程序调用了HttpClient的execute()方法发送POST请求。上面的GET请求用于获取server上的被保护页面，POST请求用于登录系统。

执行该程序，单击“訪问页面”button将可看到例如以下图所看到的的页面。

从上图能够看出，程序直接向指定Web应用的被保护页面secret.jsp发送请求，程序将无法訪问被保护页面，于是看到下图所看到的的页面。单击下图所看到的页面中的“登录”button，系统将会显演示样例如以下图所看到的的登录对话框。

在上图所看到的对话框的两个输入框中分别输入“jph”、“123”，然后单击“登录”button，系统将会向Web网站的login.jsp页面发送POST请求，并将用户输入的username、password作为请求參数。假设username、password正确，就可以看到登录成功的提示。

登录成功后，HttpClient将会自己主动维护与server之间的连接，并维护与server之间的Session状态，再次单击程序中的“訪问页面”button，就可以看到例如以下图所看到的的输出。

从上图能够看出，此时使用HttpClient发送GET请求就可以正常訪问被保护资源，这就是由于前面使用了HttpClient登录了系统，并且HttpClient能够维护与server之间的Session连接。

从上面的编程过程不难看出，使用Apache的HttpClient更加简单，并且它比HttpURLConnection提供了很多其它的功能。