Android开发之使用URL访问网络资源
URL (UniformResource Locator)对象代表统一资源定位器,它是指向互联网“资源”的指针。资源可以是简单的文件或目录,也可以是对更复杂的对象的引用,例如对数据库或搜索引擎的查询。通常情况而言,URL可以由协议名、主机、端口和资源组成。即满足如下格式:
protocol://host:port/resourceName
URL类提供了多个构造方法用于创建URL对象,一旦获得了 URL对象之后,可以调用如下常用方法来访问该URL对应的资源:
1) StringgetFile():获取此URL的资源名。
2) StringgetHost():获取此URL的主机名。
3) StringgetPath():获取此URL的路径部分。
4) Int getPort():获取此URL的端口号。
5) StringgetProtocol():获取此 URL 的协议名称。
例如如下的URL地址:
http://blog.csdn.net/fengyuzhengfan/article/details/38830115
1) StringgetQuery():获取此URL的査询字符串部分。
2) URLConnectionopenConnection():返回一个URLConnection 对象,它表示到URL所引用的远程对象的连接。
3) InputStreamopenStream():打开与此URL的连接,并返回一个用于读取该URL 资源的 InputStream。
1.使用URL读取网络资源
URL对象中前而几个方法都非常容易理解,而该对象提供的openStream()可以读取该 URL资源的InputStream,通过该方法可以非常方便地读取远程资源。
下面的程序示范如何通过URL类读取远程资源:
publicclass URLDemo extends Activity { Bitmap bitmap; ImageView imgShow; Handler handler=new Handler(){ @Override publicvoid handleMessage(Message msg) { // TODO Auto-generated method stub if (msg.what==0x125) { //显示从网上下载的图片 imgShow.setImageBitmap(bitmap); } } }; @Override protectedvoid onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); imgShow=(ImageView)findViewById(R.id.imgShow); //创建并启动一个新线程用于从网络上下载图片 new Thread(){ @Override publicvoid run() { // TODO Auto-generated method stub try { //创建一个url对象 URL url=new URL("http://avatar.csdn.net/1/1/E/1_fengyuzhengfan.jpg"); //打开URL对应的资源输入流 InputStream is= url.openStream(); //把InputStream转化成ByteArrayOutputStream ByteArrayOutputStream baos =new ByteArrayOutputStream(); byte[] buffer =new byte[1024]; int len; while ((len = is.read(buffer)) > -1 ) { baos.write(buffer, 0, len); } baos.flush(); is.close();//关闭输入流 //将ByteArrayOutputStream转化成InputStream is = new ByteArrayInputStream(baos.toByteArray()); //将InputStream解析成Bitmap bitmap=BitmapFactory.decodeStream(is); //通知UI线程显示图片 handler.sendEmptyMessage(0x125); //再次将ByteArrayOutputStream转化成InputStream is=new ByteArrayInputStream(baos.toByteArray()); baos.close(); //打开手机文件对应的输出流 OutputStream os=openFileOutput("dw.jpg",MODE_PRIVATE); byte[]buff=newbyte[1024]; int count=0; //将URL对应的资源下载到本地 while ((count=is.read(buff))>0) { os.write(buff, 0, count); } os.flush(); //关闭输入输出流 is.close(); os.close();
} catch (Exception e) { // TODO Auto-generated catch block e.printStackTrace(); } } }.start(); } } |
上面的程序先将URL对应的图片资源转换成BitMap,然后将此资源下载到本地。为了不多次读取URL对应的图片资源,本应用将URL获取的资源输入流转换成了ByteArrayInputStream,当需要使用输入流时,再将ByteArrayInputStream转换成输入流即可。这样就可以做到一次访问网络资源多次使用的目的,从而避免了客户端不必要的流量开支。
注意: InputStream不可以重复读取,一个InputStream只能读一次,InputStream可以类比成一个杯子,杯子里的水就像InputStream里的数据,你把杯子里的水拿出来了,杯子的水就没有了。
因为程序需要访问互联网,所以需要授予该程序访问网络的权限,也就是需要在 AndroidManifest.xml文件中增加如下授权代码:
<!-- 授权访问网络-->
<uses-permissionandroid:name="android.permission.INTERNET"/>
程序运行结果:
上图显示的图片就是程序中URL对象所对应的图片,运行该程序不仅可以显示 该URL对象所对应的图片,而且还会在手机文件系统的 /data/data/com.jph.urldemo 目录下生成com.jph.urldemo图片,该图片就是通过URL从网络上下载的图片。
2.使用 URLConnection 提交请求
URL的openConnection()方法将返回一个URLConnection对象,该对象表示应用程序和URL之间的通信连接。程序可以通过URLConnection实例向URL发送请求,读取URL引用的资源。
1) 通常创建一个和URL的连接,并发送请求、读取此URL引用的资源需要如下几个步:通过调用URL对象openConnection()方法来创建URLConnection对象。
2) 设置URLConnection的参数和普通请求属性。
3) 如果只是发送GET方式请求,使用connect方法建立和远程资源之间的实际连接即可;如果需要发送POST方式的请求,需要获取URLConnection实例对应的输出流来发送请求参数。
4) 远程资源变为可用,程序可以访问远程资源的头字段,或通过输入流读取远程资源的数据。
在建立和远程资源的实际连接之前,程序可以通过如下方法来设置请求头字段。
? setAllowUserlnteraction:设置该URLConnection 的allowUserlnteraction 请求头字段的值。
? setDoInput:设置该URLConnection的dolnput请求头字段的值。
? setDoOutput:设置该 URLConnection 的doOutput请求头字段的值。
? setlfModifiedSince:设置该URLConnection 的ifModifiedSince 请求头字段的值。
? setUseCaches:设置该 URLConnection 的 useCaches 请求头字段的值。
除此之外,还可以使用如下方法来设置或增加通用头字段。
? setRequestProperty(String key, String value):设置该URLConnection 的 key 请求头字段的值为value。如以下代码所示:
conn.setRequestProperty("accept", "*/*")
? addRequestProperty(String key, String value):为该URLConnection 的 key 请求头字段的增加value值。该方法并不会播盖原请求头字段的值,而是将新值追加到原请求头字段中。
当远程资源可用之后,程序可以使用以下方法用于访问头字段和内容。
? Object getContent():获取该 URLConnection 的内容。
? String getHeaderField(String name):获取指定响应头字段的值。
? getlnputStream():返回该URLConnection对应的输入流,用于获取URLConnection响应的内容。
? getOutputStream():返回该URLConnection 对应的输出流,用于向URLConnection发送请求参数。
注意:如果既要使用输入流读取URLConnection响应的内容,也要使用输出流发送请求参数,一定要先使用输出流,再使用输入流。
getHeaderField()方法用于根据响应头字段来返回对应的值。而某些头字段由于经常需要访问,所以Java提供了以下方法来访问特定响应头字段的值。
? getContentEncoding:获取 content-encoding 响应头字段的值。
? getContentLength:获取 content-length 响应头字段的值。
? getContentType:获取 content-type 响应头字段的值。
? getDate():获取date响应头字段的值。
? getExpiration():获取expires响应头字段的值。
? getLastModified():获取 last-modified 响应头字段的值。
下面的程序示范了如何向Web站点发送GET请求、POST请求,并从Web站点取得响应,该程序中用到一个发送GET、POST请求的工具类,该工具类的代码如下:
publicclass GetPostUtil { /** * 向指定URL发送GET方法的请求 * @param url发送请求的URL * @param params请求参数,请求参数应该是name1=value1&name2=value2的形式。 * @return URL所代表远程资源的响应 */ publicstatic String sendGet(String url, String params) { String result = ""; BufferedReader in = null; try { String urlName = url + "?" + params; URL realUrl = new URL(urlName); // 打开和URL之间的连接 URLConnection conn = realUrl.openConnection(); // 设置通用的请求属性 conn.setRequestProperty("accept","*/*"); conn.setRequestProperty("connection","Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); // 建立实际的连接 conn.connect(); //① // 获取所有响应头字段 Map<String, List<String>> map = conn.getHeaderFields(); // 遍历所有的响应头字段 for (String key : map.keySet()) { System.out.println(key +"--->" + map.get(key)); } // 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream())); String line; while ((line = in.readLine()) !=null) { result += "\n" + line; } } catch (Exception e) { System.out.println("发送GET请求出现异常!" + e); e.printStackTrace(); } // 使用finally块来关闭输入流 finally { try { if (in !=null) { in.close(); } } catch (IOException ex) { ex.printStackTrace(); } } return result; }
/** * 向指定URL发送POST方法的请求 * @param url发送请求的URL * @param params请求参数,请求参数应该是name1=value1&name2=value2的形式。 * @return URL所代表远程资源的响应 */ publicstatic String sendPost(String url, String params) { PrintWriter out = null; BufferedReader in = null; String result = ""; try { URL realUrl = new URL(url); // 打开和URL之间的连接 URLConnection conn = realUrl.openConnection(); // 设置通用的请求属性 conn.setRequestProperty("accept","*/*"); conn.setRequestProperty("connection","Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); // 发送POST请求必须设置如下两行 conn.setDoOutput(true); conn.setDoInput(true); // 获取URLConnection对象对应的输出流 out = new PrintWriter(conn.getOutputStream()); // 发送请求参数 out.print(params); //② // flush输出流的缓冲 out.flush(); // 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream())); String line; while ((line = in.readLine()) !=null) { result += "\n" + line; } } catch (Exception e) { System.out.println("发送POST请求出现异常!" + e); e.printStackTrace(); } // 使用finally块来关闭输出流、输入流 finally { try { if (out !=null) { out.close(); } if (in !=null) { in.close(); } } catch (IOException ex) { ex.printStackTrace(); } } return result; } } |
从上面的程序可以看出,如果需要发送GET请求,只要调用URLConnection的connect() 方法去建立实际的连接即可,如以上程序中①号粗体字代码所示。如果需要发送POST 请求,则需要获取URLConnection的OutputStream,然后再向网络中输出请求参数,如以上程序中②号粗体宇代码所示。
提供了上面发送GET请求、POST请求的工具类之后,接下来就可以在Activity类中通过该工具类来发送请求。该程序的界面中包含两个按钮,一个按钮用于发送GET请求,一个按钮用于发送POST请求,程序还提供了一个TextView显示远程服务器的响应。
该程序的Activity代码如下:
publicclass GetPostUtil { /** * 向指定URL发送GET方法的请求 * @param url发送请求的URL * @param params请求参数,请求参数应该是name1=value1&name2=value2的形式。 * @return URL所代表远程资源的响应 */ publicstatic String sendGet(String url, String params) { String result = ""; BufferedReader in = null; try { String urlName = url +"?" + params; URL realUrl = new URL(urlName); // 打开和URL之间的连接 URLConnection conn = realUrl.openConnection(); // 设置通用的请求属性 conn.setRequestProperty("accept","*/*"); conn.setRequestProperty("connection","Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); // 建立实际的连接 conn.connect(); //① // 获取所有响应头字段 Map<String, List<String>> map = conn.getHeaderFields(); // 遍历所有的响应头字段 for (String key : map.keySet()) { System.out.println(key +"--->" + map.get(key)); } // 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream())); String line; while ((line = in.readLine()) !=null) { result += "\n" + line; } } catch (Exception e) { System.out.println("发送GET请求出现异常!" + e); e.printStackTrace(); } //使用finally块来关闭输入流 finally { try { if (in !=null) { in.close(); } } catch (IOException ex) { ex.printStackTrace(); } } return result; }
/** * 向指定URL发送POST方法的请求 * @param url发送请求的URL * @param params请求参数,请求参数应该是name1=value1&name2=value2的形式。 * @return URL所代表远程资源的响应 */ publicstatic String sendPost(String url, String params) { PrintWriter out = null; BufferedReader in = null; String result = ""; try { URL realUrl = new URL(url); // 打开和URL之间的连接 URLConnection conn = realUrl.openConnection(); // 设置通用的请求属性 conn.setRequestProperty("accept","*/*"); conn.setRequestProperty("connection","Keep-Alive"); conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; SV1)"); // 发送POST请求必须设置如下两行 conn.setDoOutput(true); conn.setDoInput(true); // 获取URLConnection对象对应的输出流 out = new PrintWriter(conn.getOutputStream()); // 发送请求参数 out.print(params); //② // flush输出流的缓冲 out.flush(); // 定义BufferedReader输入流来读取URL的响应 in = new BufferedReader( new InputStreamReader(conn.getInputStream())); String line; while ((line = in.readLine()) !=null) { result += "\n" + line; } } catch (Exception e) { System.out.println("发送POST请求出现异常!" + e); e.printStackTrace(); } //使用finally块来关闭输出流、输入流 finally { try { if (out !=null) { out.close(); } if (in !=null) { in.close(); } } catch (IOException ex) { ex.printStackTrace(); } } return result; } }
|
上面的程序中两行粗体代码分别用于发送GET请求、POST请求,该程序所发送的GET请求、POST请求都是向本地局域网内http://10.201.1.32:8080/simpleWeb/应用下两个页面发送,这个应用实际上是部署在tomcat上的Web应用。
在Web服务器中成功部署simpleWeb应用之后,运行上面的Android应用,单击“发送GET 请求”按钮将可以看到如下图所示的输出。
如果单击“发送POST请求”按钮,程序将会向simpleWeb应用下的login.jsp页面发送请求, 并提交name=jph&pass=123请求参数,此时将可以看到如下图所示的输出。
从上面的介绍可以发现,借助于URLConnection类的帮助,应用程序可以非常方便地与 指定站点交换信息:包括发送GET请求、POST请求,并获取网站的响应等。