URLConnection概述

URLConnection是一个抽象类,表示指向URL指定资源的活动连接。

URLConnection类本身依赖于Socket类实现网络连接。一般认为,URLConnection类提供了比Socket类更易于使用、更高级的网络连接抽象。但实际上,大多数程序员都会忽略它。因为URLConnection太贴近HTTP协议。它假定传输的内容前面都有MIME首部或类似的东西。但大多数协议(如FTP和SMTP)并不使用MIME首部。

在Android开发中网络请求是最常用的操作之一, Android SDK中对HTTP(超文本传输协议)也提供了很好的支持,这里包括两种接口:
1、标准Java接口(java.NET) —-HttpURLConnection,可以实现简单的基于URL请求、响应功能;
2、Apache接口(org.appache.http)—-HttpClient,使用起来更方面更强大。

但在android API23的SDK中Google将HttpClient移除了。Google建议使用httpURLconnection进行网络访问操作。

所以下面来介绍一下URLConnection中的常用API

URLConnection读取首部

 @Test
    public void test(){
        try {
            //构造一个到指定 URL 的 URL 连接
            URL url = new URL("http://www.baidu.com");
            URLConnection uc = url.openConnection();
            //返回 Content-type 头字段的值。即数据的MIME内容类型。若类型不可用,则返回null。
            String contentType = uc.getContentType();
            //返回 Content-length 头字段的值。该方法获取内容的字节数。许多服务器只有在传输二进制文件才发送Content-length首部,在传输文本文件时并不发送。若没有该首部,则返回-1。
            int contentLength = uc.getContentLength();
            //返回 Content-encoding 头字段的值。获取内容的编码方式。若内容无编码,则该方法返回null。
            String contentEncoding = uc.getContentEncoding();
            //返回 date 头字段的值。获取请求的发送时间。即自1900年1月1日子夜后过去的毫秒数。
            long date = uc.getDate();
            //返回 expires 头字段的值。获取Expires的值。若无该字段,则返回0。0即表示不过期,永远缓存。
            long expiration = uc.getExpiration();
            //返回 last-modified 头字段的值。该值是自1900年1月1日子夜后过去的毫秒数。若无该字段,则返回0。
            long lastModified = uc.getLastModified();
            System.out.println(contentType);
            System.out.println(contentLength);
            System.out.println(contentEncoding);
            System.out.println(date);
            System.out.println(expiration);
            System.out.println(lastModified);
        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

这里写图片描述

URLConnection获取任意首部字段

  @Test
    public void test2(){
        try {
            //构造一个到指定 URL 的 URL 连接
            URL url = new URL("http://www.baidu.com");
            URLConnection uc = url.openConnection();
            //返回指定的头字段的值。
            String contentType = uc.getHeaderField("Content-Type");
            // 返回头字段的不可修改的 Map
            Map<String,List<String>> fields = uc.getHeaderFields();
            // 返回第 n 个头字段的键
            String headerFieldKey = uc.getHeaderFieldKey(1);
            //  返回第 n 个头字段的值
            String headerField = uc.getHeaderField(1);
            System.out.println(contentType);
            System.out.println(fields);
            System.out.println(headerFieldKey);
            System.out.println(headerField);
            //  返回解析为日期的指定字段的值。
            //long getHeaderFieldDate(String name, long Default)
            //   返回解析为数字的指定字段的值。
            //int getHeaderFieldInt(String name, int Default)

        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

这里写图片描述

配置连接

URLConnection类的保护类型字段如下:

protected URL url
该字段指定URLConnection连接的URL。构造函数会在创建URLConnection时设置,此后就不能再改变。


protected boolean connected

  当连接打开时,该字段为true。若连接关闭,则为false。没有直接读取或改变connected值的方法。任何导致URLConnection连接的方法都会将此变量设为true,包括connect(),getInputStream(),和getOutputStream()。

  任何导致URLConnection断开的方法都会将此字段设为false。

  java.net.URLConnection没有断开方法,但一些子类,如java.net.HttpURLConnection中存在这样的方法。


protected boolean allowUserInteraction

  该字段表示是否允许与用户交互。默认为false,即不允许交互。该值只能在URLConnection连接前设置。

例:Web浏览器可能需要访问用户名和口令。


protected boolean doInput

  该字段在URLConnection可用于输入时为true,否则为false。默认为true。


protected boolean doOutput

  该字段在URLConnection可用于输出时为true,否则为false。默认为false。


protected long ifModifiedSince

  该字段指示了将放置If-Modified-Since首部字段中的日期(格林威治标准时间1970年1月1日子夜后的毫秒数)。


protected boolean useCaches

  该字段指定了是否可以在缓存可用时使用缓存。默认为true,表示缓存将被使用;false表示缓存不被使用。


每个字段都有一些相应的方法。

URL getURL()
void setDoInput(boolean doinput)
boolean getDoInput()
void setDoOutput(boolean dooutput)
boolean getDoOutput()
void setUseCaches(boolean usecaches)
boolean getUseCaches()
void setAllowUserInteraction(boolean allowuserinteraction)
boolean getAllowUserInteraction()
void setIfModifiedSince(long ifmodifiedsince)
long getIfModifiedSince()

还有一些方法,这些方法用于定义和获取URLConnection对象的默认行为:

static boolean getDefaultAllowUserInteraction()
boolean getDefaultUseCaches()
void setDefaultUseCaches(boolean defaultusecaches)
static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)
static void setFileNameMap(FileNameMap map)
static FileNameMap getFileNameMap()

关于超时

Java 1.5增加了如下4个方法,允许查询和修改连接的超时值。即底层socket在抛出SocketTimeoutException异常前等待远端响应时间。
设置获取读取的超时值,单位为毫秒。

int getReadTimeout()
void setReadTimeout(int timeout)
设置获取连接的超时值,单位为毫秒。

int getConnectTimeout()
void setConnectTimeout(int timeout)
这四个方法将0解释为永不超时。如果超时值为负数。两个设置方法都会抛出IllegalArgumentException异常。


配置HTTP首部

客户端向服务器发送请求,不仅会发送请求行,还发送首部。Web服务器可以根据此信息向不同客户端提供不同的页面,获取和设置cookie,通过口令设置用户等等。通过在客户端发送和服务器响应的首部中放置不同的字段,就可以完成这些工作。

每个URLConnection的具体子类都在首部中设置一些默认的键值对(实际上只有HttpURLConnection这样做,因为HTTP是唯一以这种方式使用首部的主要协议。)

通过以下方法可以设置URLConnection在打开连接增加HTTP首部:

void setRequestProperty(String key, String value)

此方法只在连接打开之前打开,将会抛出IllegalStateException异常。但该方法仅支持对一个首部设置一个值。

HTTP允许一个熟悉有多个值。各个值之间用逗号隔开。

例:cookie:username=sjq; session=hdfu23asdjf901j;


使用如下方法为首部增加值:

void addRequestProperty(String key, String value)

该方法用于添加某个指定首部字段的值。


使用如下方法获取首部字段:

String getRequestProperty(String key)

Map<String,List<String>> getRequestProperties()

以上方法用于获取URLConneciton所拥有HTTP首部。

使用URLConnection与服务器交互

InputStream getInputStream():返回从此打开的连接读取的输入流。

OutputStream getOutputStream():返回写入到此连接的输出流。

若只是向服务器请求数据,则为HTTP请求方法为GET。

若需要向服务器提交数据,必须在先调用setDoOutput(true)。当doOutput属性为true时,请求方法将由GET变为POST。


    @Test
    public void test3(){
        InputStream in = null;
        try {
            //连接
            URL url = new URL("http://www.baidu.com");
            URLConnection uc = url.openConnection();
            //获取读入流
            in = uc.getInputStream();
            //放入缓存流
            InputStream raw = new BufferedInputStream(in);
            //最后使用Reader接收
            Reader r = new InputStreamReader(raw);
            //打印输出
            int c;
            while((c = r.read())>0){
                System.out.print((char)c);
            }

        } catch (MalformedURLException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        } finally{
            try {
                if(in!=null){
                    in.close();
                }
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }

这里写图片描述

获得内容

Object getContent()
该方法实质上与URL类的getContent()方法相同。使用该方法JVM需要识别和理解该内容类型。该方法只用于支持类似HTTP的协议,协议需要对MIME内容类型有较清楚的了解。若内容未知,或协议无法理解内容类型,getContent()会抛出一个UnknowServiceException异常。


Object getContent(Class[] classes)

该方法可以选择将内容转换为哪个类对象,以提供数据的不同对象表示。该方法尝试以classes数组中某个类的形式返回内容。优先顺序就是数组的顺序。若任何一种请求类型都不可用,此方法会返回null。


ContentHandlerFactory

URLConnection类包括一个静态的ContentHandler。即内容处理器。通过以下方法设置内容处理器工厂。

static void setContentHandlerFactory(ContentHandlerFactory fac)

URLConnection的安全

建立网络连接、读写文件等等存在一些安全限制,URLConnection对象会受到这些安全限制的约束。

Permission getPermission()

该方法返回Permission对象,指出连接此URL所需的许可权。如果没有所需的许可权(即没有适当的安全管理器),它就会返回null。

猜测MIME内容类型

static String guessContentTypeFromName(String fname)
根据 URL 的指定 “file” 部分尝试确定对象的内容类型。

static String guessContentTypeFromStream(InputStream is)
根据输入流的开始字符尝试确定输入流的类型。

HttpURLConnection

java.net.HttpURLConnection类是URLConnection的抽象子类;它提供了一些有助于专门操作http URL的额外方法。

sun.net.www.protocol.http包中也提供了一个HttpURLConnection类。该类实现了抽象的connect()方法。但一般很少直接访问该类。

获取HttpURLConnection对象

@Test
void testHttpURLConnection(){
    try {
        URL url = new URL("http:www.baidu.com");
        URLConnection urlConnection = url.openConnection();
        HttpURLConnection httpURLConnection = (HttpURLConnection)urlConnection;
    } catch (MalformedURLException e) {
        e.printStackTrace();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

请求方法

HTTP协议提供了7中请求方法:

GET
POST
HEAD
PUT
OPTIONS
DELETE
TRACE
通过以下方法设置请求方法:

void setRequestMethod(String method)

若请求不是7个方法的字符串,则会抛出java.net.ProtocolException异常。一般只设置请求方法是不够的,还需要调整HTTP首部,还要提供消息体。

以下方法获取HTTP请求方法

String getRequestMethod()

断开与服务器的连接

HTTP的Keep-Alive对Web连接的性能有所提升,允许多个请求和响应通过一个TCP连接连续发送。

客户端通过HTTP请求首部包含Connection字段及Keep-Alive,表示客户端愿意使用Keep-Alive:

  Connection: Keep-Alive

但当使用Keep-Alive时,服务器不再因为向客户端发送最后一个字节数据就关闭连接。毕竟客户端还可能发送另一个请求。因此客户端需要复杂关闭连接。

Java提供如下方法关闭连接,实际上很少使用该方法:

abstract void disconnect()

获取请求

如果HTTP响应状态为4xx(客户端错误)或者5xx(服务器错误),你可以通过HttpUrlConnection.getErrorStream()来查看服务器发送过来的信息。

InputStream getErrorStream()

例:

InputStream error = ((HttpURLConnection) connection).getErrorStream();

如果HTTP响应状态为-1,就是出现了连接错误。HttpURLConnection会保持连接一直可用,如果你想关闭这个特性,需要把http.keepAlive设置为false:

System.setProperty("http.keepAlive", "false");

Http响应码

HTTP响应的第一行被称为消息响应。该信息不会被URLConnection的getHeaderFiled()方法读取。

String getResponseMessage()
返回消息响应。如:HTTP/1.1 404 Not Found

int getResponseCode()
返回消息响应码。如:404。

HttpURLConnection类提供了常见响应码常量。具体请参考JDK文档。

重定向

默认情况下,HttpURLConnection类会跟踪重定向。但HttpURLConnection有两个静态方法,可以确定是否跟随重定向。

static void setFollowRedirects(boolean set)
static boolean getFollowRedirects()

  若跟随,则为true,否则为false。

这两个是静态方法,它们会改变该方法后构造的所有HttpURLConnection对象的行为。若安全管理器不允许其改变,则会抛出SecurityException异常。

也可以对某个HttpURLConnection实例设置是否重定向。

void setInstanceFollowRedirects(boolean followRedirects)

boolean getInstanceFollowRedirects()

流模式

每个发送给HTTP服务器的请求都有HTTP首部。首部中有一个Content-type字段;即请求体中的字节数。首部位于主体的前面。但是,为了写入首部,需要知道主体的长度,而在写首部的时候可能还不知道主题的长度。一般情况下Java对此两难境地的解决办法是,对于从HttpURLConnection获取的OutputStream,缓存写入到此OutputStream中的所有内容,直到流被关闭。到这时,它就知道了主题中有多少字节,

在请求发送之前,HttpURLConnetion会把所有需要发送的数据放到缓冲区里,不管你是否使用connection.setRequestProperty(“Content-Length”, contentLength);设置了contentLength,当你并行发送大量的POST请求时,这可能会引起OutOfMemoryExceptions 异常,为了避免这个问题,需要使用如下方法:

void setFixedLengthStreamingMode(int contentLength)

  此方法用于在预先已知内容长度时启用没有进行内部缓冲的 HTTP 请求正文的流。

例:

httpConnection.setFixedLengthStreamingMode(contentLength);

但是如果不能事先知道内容的长度,可以使用HttpURLConnection.setChunkedStreamingMode()方法设置为块状流模式。在块状流模式的情况下,放在块里的内容将会被强行发送出去。下边的例子将会把发送的内容按照每块1KB的大小发送出去。

void setChunkedStreamingMode(int chunklen)

  此方法用于在预先不知道内容长度时启用没有进行内部缓冲的 HTTP 请求正文的流。

例:

httpConnection.setChunkedStreamingMode(1024);

缓存

默认情况下,Java 1.5不返回任何数据。但通过派生java.net.ResponseCache类的子类,并安装为系统默认值,就可以创建自己的缓存。无论系统合适尝试通过协议处理器加载新的URL,它将首先在缓存中查找,若缓存找到了所需的内容,就不需要连接远程服务器了。若缓存数据不存在,则下载相应数据,并将其放入缓存中。

转载文章出处:LaplaceDemon/SJQ。
http://www.cnblogs.com/shijiaqi1066/p/3753224.html

猜你喜欢

转载自blog.csdn.net/cckevincyh/article/details/81022399