Java URLConnection 类

java.net.URLConnection是一个抽象类，它的子类代表了各种类型的URL连接。这个类的实例既可以用于从URL指向的资源读取数据，也可以写入数据。

例如：

如果你连接到一个协议为HTTP的URL，那么URL.openConnection()方法将返回一个HttpURLConnection对象。
如果你连接到一个表示JAR文件的URL，那么URL.openConnection()方法将返回一个JarURLConnection对象等等。

建立连接到URL的步骤

以下是建立连接到URL并开始处理的步骤：

调用URL.openConnection()方法以获取连接对象。
使用连接对象的各种setter方法根据需要更新设置参数和通用请求属性。
使用连接对象的connect()方法创建对远程对象的连接。
一旦远程对象可用，就可以访问该对象的内容/头部信息。

`URLConnection`类声明

public abstract class URLConnection
   extends Object

`URLConnection`类字段

序号	字段	描述
1	`protected boolean allowUserInteraction`	如果为true，则表示这个URL在一个允许用户交互（如弹出身份验证对话框）的上下文中被检查。
2	`protected boolean connected`	如果为false，则表示这个连接对象尚未与指定的URL创建通信链接。
3	`protected boolean doInput`	该变量由`setDoInput`方法设置。
4	`protected boolean doOutput`	该变量由`setDoOutput`方法设置。
5	`protected long ifModifiedSince`	某些协议支持除非对象最近已被修改否则跳过对象的获取。
6	`protected URL url`	这个URL代表了在万维网上供此连接打开的远程对象。
7	`protected boolean useCaches`	如果为true，则允许协议尽可能地使用缓存。

`URLConnection`类方法

序号	方法	描述
1	`void addRequestProperty(String key, String value)`	添加由键值对指定的通用请求属性。
2	`boolean getAllowUserInteraction()`	返回此对象的`allowUserInteraction`字段的值。
3	`int getConnectTimeout()`	返回连接超时的设置。
4	`Object getContent()`	检索这个URL连接的内容。
5	`Object getContent(Class[] classes)`	检索这个URL连接的内容。
6	`String getContentEncoding()`	返回content-encoding头字段的值。
7	`int getContentLength()`	返回content-length头字段的值。
8	`long getContentLengthLong()`	以long类型返回content-length头字段的值。
9	`String getContentType()`	返回content-type头字段的值。
10	`long getDate()`	返回date头字段的值。
11	`static boolean getDefaultAllowUserInteraction()`	返回`allowUserInteraction`字段的默认值。
12	`boolean getDefaultUseCaches()`	返回`URLConnection`的`useCaches`标志的默认值。
13	`static boolean getDefaultUseCaches(String protocol)`	返回给定协议的`useCaches`标志的默认值。
14	`boolean getDoInput()`	返回此`URLConnection`的`doInput`标志的值。
15	`boolean getDoOutput()`	返回此`URLConnection`的`doOutput`标志的值。
16	`long getExpiration()`	返回expires头字段的值。
17	`static FileNameMap getFileNameMap()`	从数据文件加载文件名映射（mimetable）。
18	`String getHeaderField(int n)`	返回第n个头字段的值。
19	`String getHeaderField(String name)`	返回名为name的头字段的值。
20	`long getHeaderFieldDate(String name, long Default)`	返回名为name的字段作为日期解析后的值。
21	`int getHeaderFieldInt(String name, int Default)`	返回名为name的字段作为数字解析后的值。
22	`String getHeaderFieldKey(int n)`	返回第n个头字段的键。
23	`long getHeaderFieldLong(String name, long Default)`	返回名为name的字段作为数字解析后的值。
24	`Map<String,List<String>> getHeaderFields()`	返回头字段的不可修改的Map。
25	`long getIfModifiedSince()`	返回此对象的`ifModifiedSince`字段的值。
26	`InputStream getInputStream()`	返回从这个打开的连接读取的输入流。
27	`int getLastModified()`	返回last-modified头字段的值。
28	`OutputStream getOutputStream()`	返回写入这个连接的输出流。
29	`Permission getPermission()`	返回代表此对象所表示的连接所需的权限的对象。
30	`int getReadTimeout()`	返回读取超时的设置。0返回意味着选项已禁用（即无限期超时）。
31	`Map<String,List<String>> getRequestProperties()`	返回此连接的通用请求属性的不可修改的Map。
32	`String getRequestProperty(String key)`	返回此连接的名为key的通用请求属性的值。
33	`URL getURL()`	返回此`URLConnection`的URL字段的值。
34	`boolean getUseCaches()`	返回此`URLConnection`的`useCaches`字段的值。
35	`static String guessContentTypeFromName(String fname)`	尝试根据指定的URL的“文件”部分确定对象的内容类型。
36	`static String guessContentTypeFromStream(InputStream is)`	尝试根据输入流开头的字符确定输入流的类型。
37	`void setAllowUserInteraction(boolean allowuserinteraction)`	设置此`URLConnection`的`allowUserInteraction`字段的值。
38	`void setConnectTimeout(int timeout)`	设置当打开与此`URLConnection`引用的资源的通信链接时要使用的指定超时值（毫秒）。
39	`static void setContentHandlerFactory(ContentHandlerFactory fac)`	设置应用程序的`ContentHandlerFactory`。
40	`static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)`	设置所有未来`URLConnection`对象的`allowUserInteraction`字段的默认值。
41	`void setDefaultUseCaches(boolean defaultusecaches)`	设置`useCaches`字段的默认值。
42	`static void setDefaultUseCaches(String protocol, boolean defaultVal)`	设置给定协议的`useCaches`字段的默认值。
43	`void setDoInput(boolean doinput)`	设置此`URLConnection`的`doInput`字段的值。
44	`void setDoOutput(boolean dooutput)`	设置此`URLConnection`的`doOutput`字段的值。
45	`static void setFileNameMap(FileNameMap map)`	设置文件名映射。
46	`void setIfModifiedSince(long ifmodifiedsince)`	设置此`URLConnection`的`ifModifiedSince`字段的值。
47	`void setReadTimeout(int timeout)`	设置读取超时到指定的超时值（毫秒）。
48	`void setRequestProperty(String key, String value)`	设置通用请求属性。
49	`void setUseCaches(boolean usecaches)`	设置此`URLConnection`的`useCaches`字段的值。
50	`String toString()`	返回此URL连接的字符串表示形式。

`URLConnection`类示例

下面的URLConnectionDemo程序连接到从命令行输入的URL。

如果URL表示的是HTTP资源，连接将转换为HttpURLConnection，并且资源中的数据将逐行读取。

package com.tutorialspoint;

import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
import java.net.URLConnection;

public class URLConnectionDemo {
   public static void main(String [] args) {
      try {
         URL url = new URL("https://www.tutorialspoint.com");
         URLConnection urlConnection = url.openConnection();
         HttpURLConnection connection = null;
         if(urlConnection instanceof HttpURLConnection) {
            connection = (HttpURLConnection) urlConnection;
         } else {
            System.out.println("Please enter an HTTP URL.");
            return;
         }
         
         BufferedReader in = new BufferedReader(
            new InputStreamReader(connection.getInputStream()));
         String urlString = "";
         String current;
         
         while((current = in.readLine()) != null) {
            urlString += current;
         }
         System.out.println(urlString);
      } catch (IOException e) {
         e.printStackTrace();
      }
   }
}

此程序的一个样本运行结果如下：

输出

$ java URLConnectionDemo

.....a complete HTML content of home page of tutorialspoint.com.....