URL (UniformResource Locator)对象代表统一资源定位器,它是指向互联网“资源”的指针。
资源能够是简单的文件或文件夹,也能够是对更复杂的对象的引用。比如对数据库或搜索引擎的查询。
通常情况而言,URL能够由协议名、主机、port和资源组成。即满足例如以下格式:
protocol://host:port/resourceName
URL类提供了多个构造方法用于创建URL对象,一旦获得了 URL对象之后。能够调用例如以下经常用法来訪问该URL相应的资源:
1) StringgetFile():获取此URL的资源名。
2) StringgetHost():获取此URL的主机名。
3) StringgetPath():获取此URL的路径部分。
4) Int getPort():获取此URL的port号。
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对象中前而几个方法都很easy理解。而该对象提供的openStream()能够读取该 URL资源的InputStream,通过该方法能够很方便地读取远程资源。
以下的程序示范怎样通过URL类读取远程资源:
publicclass URLDemo extends Activity { Bitmap ImageView 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 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转换成输入流就可以。这样就能够做到一次訪问网络资源多次使用的目的,从而避免了client不必要的流量开支。
注意: 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 { /** * * * * */ publicstatic String sendGet(String url, String params) { String result = BufferedReader in = try { String urlName = url + 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 += } } 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; } /** * * * * */ publicstatic String sendPost(String url, String params) { PrintWriter out = null; BufferedReader in = 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 += } } 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类中通过该工具类来发送请求。该程序的界面中包括两个button。一个button用于发送GET请求,一个button用于发送POST请求。程序还提供了一个TextView显示远程server的响应。
该程序的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 = // 打开和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 += } } catch (Exception e) { System.out.println("发送GET请求出现异常!" 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 = // 打开和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 += } } catch (Exception e) { System.out.println("发送POST请求出现异常!" 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应用。
在Webserver中成功部署simpleWeb应用之后,执行上面的Android应用,单击“发送GET 请求”button将能够看到例如以下图所看到的的输出。
假设单击“发送POST请求”button,程序将会向simpleWeb应用下的login.jsp页面发送请求, 并提交name=jph&pass=123请求參数,此时将能够看到例如以下图所看到的的输出。
从上面的介绍能够发现,借助于URLConnection类的帮助,应用程序能够很方便地与 指定站点交换信息:包含发送GET请求、POST请求,并获取站点的响应等。