Android网络编程之使用HTTP訪问网络资源
使用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;
}
@Override
public 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;
@Override
public 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()
{
@Override
public void handleMessage(Message msg)
{
if (msg.what == 0x123)
{
bar.setProgress(mDownStatus);
}
}
};
downBn.setOnClickListener(new OnClickListener()
{
@Override
public void onClick(View v)
{
// 初始化DownUtil对象（最后一个參数指定线程数）
downUtil = new DownUtil(url.getText().toString(),
target.getText().toString(), 6);
new Thread()
{
@Override
public void run()
{
try
{
// 開始下载
downUtil.download();
}
catch (Exception e)
{
e.printStackTrace();
}
// 定义每秒调度获取一次系统的完毕进度
final Timer timer = new Timer();
timer.schedule(new TimerTask()
{
@Override
public 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() {
@Override
public 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");
}
}
};
@Override
public 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()
{
@Override
public 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()
{
@Override
public void onClick(DialogInterface dialog,
int which)
{
// 获取用户输入的username、password
final String name = ((EditText) loginDialog
.findViewById(R.id.name)).getText()
.toString();
final String pass = ((EditText) loginDialog
.findViewById(R.id.pass)).getText()
.toString();
new Thread()
{
@Override
public void run()
{
try
{
HttpPost post = new HttpPost("http://10.201.1.32:8080/" +
"HttpClientTest_Web/login.jsp");//③
// 假设传递參数个数比較多的话能够对传递的參数进行封装
List<NameValuePair> params = new
ArrayList<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提供了很多其它的功能。