Android开发之使用URL访问网络资源

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请求，并获取网站的响应等。