大多数Android的app都会使用HTTP协议来发送和接收数据。在Android开发中,通常使用两种http客户端:一个是Apache的HttpClient,另一个是HttpURLConnection。这两种HTTP客户端API都支持HTTPS协议,流数据上传和下载,配置超时,IPV6协议以及连接池等等。
Apache HttpClient
HttpClient的API众多,并且bug少比较稳定。但是,HttpClient的API比较大,很难在保证兼容性的前提下去对其进行扩展。所以很多Android团队并不太喜欢使用它。HttpClient是一个接口,里面封装了需要执行的http请求,身份验证,连接管理等等,有三个主要的实现类:AbstractHttpClient, AndroidHttpClient, DefaultHttpClient。下面我们来看一下AndroidHttpClient,它对DefaultHttpClient进行了改进使之更适合于Android开发。于是,AndroidHttpClient进行请求发送和响应接收步骤如下:
- 创建HttpClient对象,通过静态方法newInstance()方法来获得AndroidHttpClient对象。
- 创建对应的发送请求的对象,如果需要发送GET请求,则创建HttpGet对象,如果需要发送POST请求,则创建HttpPost对象。
- 对于发送请求的参数,GET和POST使用的方式不同,GET方式可以使用拼接字符串的方式,把参数拼接在URL结尾;POST方式需要使用setEntity(HttpEntity entity)方法来设置请求参数。
- 调用HttpClient对象的execute(HttpUriRequest request)发送请求,执行该方法返回一个HttpResponse对象。
- 调用HttpResponse的对应方法获取服务器的响应头、响应内容等。
通常情况下,我们并不在主线程中进行网络请求操作,而是新开一个子线程来进行网络操作,下面的代码展示了如何利用AndroidHttpClient完成网络登录验证的任务:
public class LoginTask implements Runnable { private String username; private String password; public LoginTask(String username, String password) { // 初始化用户名和密码 this.username = username; this.password = password; } @Override public void run() { // 设置访问的Web站点 String path = "http://xxxx/loginas.aspx"; //设置Http请求参数 Map<String, String> params = new HashMap<String, String>(); params.put("username", username); params.put("password", password); String result = sendHttpClientPost(path, params, "utf-8"); //把返回的接口输出 System.out.println(result); } /** * 发送Http请求到Web站点 * @param path Web站点请求地址 * @param map Http请求参数 * @param encode 编码格式 * @return Web站点响应的字符串 */ private String sendHttpClientPost(String path,Map<String, String> map,String encode) { List<NameValuePair> list=new ArrayList<NameValuePair>(); if(map!=null&&!map.isEmpty()) { for(Map.Entry<String, String> entry:map.entrySet()) { //解析Map传递的参数,使用一个键值对对象BasicNameValuePair保存。 list.add(new BasicNameValuePair(entry.getKey(), entry.getValue())); } } try { //实现将请求 的参数封装封装到HttpEntity中。 UrlEncodedFormEntity entity=new UrlEncodedFormEntity(list, encode); //使用HttpPost请求方式 HttpPost httpPost=new HttpPost(path); //设置请求参数到Form中。 httpPost.setEntity(entity); //实例化一个默认的Http客户端,使用的是AndroidHttpClient HttpClient client=AndroidHttpClient.newInstance(""); //执行请求,并获得响应数据 HttpResponse httpResponse= client.execute(httpPost); //判断是否请求成功,为200时表示成功,其他均问有问题。 if(httpResponse.getStatusLine().getStatusCode()==200) { //通过HttpEntity获得响应流 InputStream inputStream=httpResponse.getEntity().getContent(); return changeInputStream(inputStream,encode); } } catch (UnsupportedEncodingException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (ClientProtocolException e) { // TODO Auto-generated catch block e.printStackTrace(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } return ""; } /** * 把Web站点返回的响应流转换为字符串格式 * @param inputStream 响应流 * @param encode 编码格式 * @return 转换后的字符串 */ private String changeInputStream(InputStream inputStream, String encode) { ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); byte[] data = new byte[1024]; int len = 0; String result=""; if (inputStream != null) { try { while ((len = inputStream.read(data)) != -1) { outputStream.write(data,0,len); } result=new String(outputStream.toByteArray(),encode); } catch (IOException e) { e.printStackTrace(); } } return result; } }
HttpURLConnection
相比之下,HttpURLConnection就显得更通用一些。它是一款多用途,轻量级的HTTP客户端,适用于大多数的app客户端。同时,HttpURLConnection简单,便于扩展。但是坑爹的是,在Android2.2之前,HttpURLConnection有一些bug,例如在试图关闭InputStream的时候会导致连接池失效。所以,推荐在2.3之后的版本中使用HttpURLConnection。
下面以请求百度首页的logo为例子,演示使用HttpURLConnection的GET方法完成网络请求的任务:
public class getImageTask{ private static String URL_PATH = http://www.baidu.com/img/bd_logo1.png; /** * @param args */ public static void main(String[] args) { // 调用方法获取图片并保存 saveImageToDisk(); } /** * 通过URL_PATH的地址访问图片并保存到本地 */ public static void saveImageToDisk() { InputStream inputStream= getInputStream(); byte[] data=new byte[1024]; int len=0; FileOutputStream fileOutputStream=null; try { //把图片文件保存在本地F盘下 fileOutputStream=new FileOutputStream("F:\test.png"); while((len=inputStream.read(data))!=-1) { //向本地文件中写入图片流 fileOutputStream.write(data,0,len); } } catch (IOException e) { e.printStackTrace(); } finally { //最后关闭流 if(inputStream!=null) { try { inputStream.close(); } catch (IOException e) { e.printStackTrace(); } } if(fileOutputStream!=null) { try { fileOutputStream.close(); } catch (IOException e) { e.printStackTrace(); } } } } /** * 通过URL获取图片 * @return URL地址图片的输入流。 */ public static InputStream getInputStream() { InputStream inputStream = null; HttpURLConnection httpURLConnection = null; try { //根据URL地址实例化一个URL对象,用于创建HttpURLConnection对象。 URL url = new URL(URL_PATH); if (url != null) { //openConnection获得当前URL的连接 httpURLConnection = (HttpURLConnection) url.openConnection(); //设置3秒的响应超时 httpURLConnection.setConnectTimeout(3000); //设置允许输入 httpURLConnection.setDoInput(true); //设置为GET方式请求数据 httpURLConnection.setRequestMethod("GET"); //获取连接响应码,200为成功,如果为其他,均表示有问题 int responseCode=httpURLConnection.getResponseCode(); if(responseCode==200) { //getInputStream获取服务端返回的数据流。 inputStream=httpURLConnection.getInputStream(); } } } catch (MalformedURLException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } return inputStream; } }
如果使用POST方法,则需要设置请求参数。下面我们使用POST方式,利用HttpURLConnection完成和上面一样的登录验证功能:
public class LoginTask implements Runnable{ private static String PATH = "http://xxxxx/loginas.aspx"; private static URL url; private String username;
private String password;
public LoginTask(String username, String password) {
// 初始化用户名和密码
this.username = username;
this.password = password;
} /** * 通过给定的请求参数和编码格式,获取服务器返回的数据 * @param params 请求参数 * @param encode 编码格式 * @return 获得的字符串 */ public static String sendPostMessage(Map<String, String> params, String encode) { StringBuffer buffer = new StringBuffer(); if (params != null && !params.isEmpty()) { for (Map.Entry<String, String> entry : params.entrySet()) { try { buffer.append(entry.getKey()) .append("=") .append(URLEncoder.encode(entry.getValue(), encode)) .append("&");//请求的参数之间使用&分割。 } catch (UnsupportedEncodingException e) { e.printStackTrace(); } } buffer.deleteCharAt(buffer.length() - 1); System.out.println(buffer.toString()); try { HttpURLConnection urlConnection = (HttpURLConnection) url .openConnection(); urlConnection.setConnectTimeout(3000); //设置允许输入输出 urlConnection.setDoInput(true); urlConnection.setDoOutput(true); byte[] mydata = buffer.toString().getBytes(); //设置请求报文头,设定请求数据类型 urlConnection.setRequestProperty("Content-Type", "application/x-www-form-urlencoded"); //设置请求数据长度 urlConnection.setRequestProperty("Content-Length", String.valueOf(mydata.length)); //设置POST方式请求数据 urlConnection.setRequestMethod("POST"); OutputStream outputStream = urlConnection.getOutputStream(); outputStream.write(mydata); int responseCode = urlConnection.getResponseCode(); if (responseCode == 200) { return changeInputStream(urlConnection.getInputStream(), encode); } } catch (IOException e) { e.printStackTrace(); } } return ""; } /** * 把服务端返回的输入流转换成字符串格式 * @param inputStream 服务器返回的输入流 * @param encode 编码格式 * @return 解析后的字符串 */ private static String changeInputStream(InputStream inputStream, String encode) { ByteArrayOutputStream outputStream = new ByteArrayOutputStream(); byte[] data = new byte[1024]; int len = 0; String result=""; if (inputStream != null) { try { while ((len = inputStream.read(data)) != -1) { outputStream.write(data,0,len); } result=new String(outputStream.toByteArray(),encode); } catch (IOException e) { e.printStackTrace(); } } return result; } @Override public void run() { //通过Map设置请求字符串。
try {
url = new URL(PATH);
} catch (Exception e) {
e.printStackTrace();
}
Map<String, String> params = new HashMap<String, String>(); params.put("username", "admin"); params.put("password", "123"); String result=sendPostMessage(params, "utf-8"); System.out.println(result); } }
总结
那么哪个客户端更好些呢?在2.2之前使用httpClient可以避免一些bug。而在2.3之后的版本中使用HttpURLConnection是最好的选择,简单的API适合于Android开发。透明压缩和应答数据的捕获,减少了网络的使用,提升了性能并且减少了电池的消耗。
在随后我们介绍的开源库中,volley在2.3之前的版本中使用了HttpClient,而在2.3之后使用了HttpURLConnection;android-async-http中封装了HttpClient。