URLConnection (Java Platform SE 8 )

java.lang.Object
- java.net.URLConnection

已知直接子类：

HttpURLConnection ， JarURLConnection
```
public abstract class URLConnection
extends Object
```
抽象类URLConnection是表示应用程序和URL之间的通信链接的所有类的超类。该类的实例可以用于从URL引用的资源中读取和写入。通常，创建与URL的连接是一个多步骤过程： openConnection() connect() Manipulate parameters that affect the connection to the remote resource. Interact with the resource; query header fields and contents.

---------------------------->
时间
1. 通过在URL上调用openConnection方法创建连接对象。
2. 设置参数和一般请求属性被操纵。
3. 使用connect方法实现与远程对象的实际连接。
4. 远程对象变得可用。可以访问头字段和远程对象的内容。
使用以下方法修改设置参数：
- setAllowUserInteraction
- setDoInput
- setDoOutput
- setIfModifiedSince
- setUseCaches
并且使用以下方法修改一般请求属性：
- setRequestProperty
可以使用方法setDefaultAllowUserInteraction和setDefaultUseCaches设置AllowUserInteraction和UseCaches参数的默认值。

上述set方法中的每一个都具有相应的get方法来检索参数或一般请求属性的值。适用的具体参数和一般请求属性是特定于协议的。

使用以下方法访问头域和连接远程对象后的内容：
- getContent
- getHeaderField
- getInputStream
- getOutputStream
某些头字段经常被访问。方法：
- getContentEncoding
- getContentLength
- getContentType
- getDate
- getExpiration
- getLastModifed
提供方便的访问这些领域。 getContentType方法由getContent方法用于确定远程对象的类型; 子类可能会方便地覆盖getContentType方法。

在常见情况下，所有预连接参数和一般请求属性都可以忽略：预连接参数和请求属性默认为明智的值。对于这个界面的大多数客户端，只有两个有趣的方法： getInputStream和getContent ，它们通过方便的方法镜像在URL类中。

在请求属性和报头字段的更多信息http连接可以被发现在：
```
 http://www.ietf.org/rfc/rfc2616.txt
 
```
调用close()上方法InputStream或OutputStream一个的URLConnection的请求后，可能释放与此实例相关联的网络资源，除非特定的协议规范为其指定不同的行为。
从以下版本开始：

JDK1.0

另请参见：

URL.openConnection() ， connect() ， getContent() ， getContentEncoding() ， getContentLength() ， getContentType() ， getDate() ， getExpiration() ， getHeaderField(int) ， getHeaderField(java.lang.String) ， getInputStream() ， getLastModified() ， getOutputStream() ， setAllowUserInteraction(boolean) ， setDefaultUseCaches(boolean) ， setDoInput(boolean) ， setDoOutput(boolean) ， setIfModifiedSince(long) ， setRequestProperty(java.lang.String, java.lang.String) ， setUseCaches(boolean)

Field Summary

Fields
Modifier and Type	Field and Description
`protected boolean`	`allowUserInteraction` 如果 `true` ，则在上下文中检查该 `URL` ，其中允许用户交互（例如弹出认证对话）是有意义的。
`protected boolean`	`connected` 如果 `false` ，此连接对象尚未创建指定URL的通信链接。
`protected boolean`	`doInput` 该变量由 `setDoInput`方法设置。
`protected boolean`	`doOutput` 该变量由 `setDoOutput`方法设置。
`protected long`	`ifModifiedSince` 某些协议支持跳过对象的提取，除非对象在某个时间以前已被更新。
`protected URL`	`url` URL表示打开此连接的万维网上的远程对象。
`protected boolean`	`useCaches` 如果 `true` ，协议允许使用缓存，只要它可以。

构造方法摘要

构造方法
Modifier	Constructor and Description
`protected`	`URLConnection(URL url)` 构造与指定URL的URL连接。

方法摘要

所有方法静态方法接口方法抽象方法具体的方法弃用的方法
Modifier and Type	Method and Description
`void`	`addRequestProperty(String key, String value)` 添加由键值对指定的一般请求属性。
`abstract void`	`connect()` 打开与此URL引用的资源的通信链接，如果此类连接尚未建立。
`boolean`	`getAllowUserInteraction()` 返回此对象的 `allowUserInteraction`字段的值。
`int`	`getConnectTimeout()` 返回连接超时的设置。
`Object`	`getContent()` 检索此URL连接的内容。
`Object`	`getContent(类[] classes)` 检索此URL连接的内容。
`String`	`getContentEncoding()` 返回 `content-encoding`标题字段的值。
`int`	`getContentLength()` 返回 `content-length`标题字段的值。
`long`	`getContentLengthLong()` 返回 `content-length`标头字段的值为long。
`String`	`getContentType()` 返回 `content-type`标题字段的值。
`long`	`getDate()` 返回 `date`标题字段的值。
`static boolean`	`getDefaultAllowUserInteraction()` 返回 `allowUserInteraction`字段的默认值。
`static String`	`getDefaultRequestProperty(String key)` 已弃用在获得适当的URLConnection实例之后，应该使用实例特定的getRequestProperty方法。
`boolean`	`getDefaultUseCaches()` 返回默认值为 `URLConnection`的 `useCaches`标志。
`boolean`	`getDoInput()` 返回此 `URLConnection`的 `doInput`标志的值。
`boolean`	`getDoOutput()` 返回此 `URLConnection`的 `doOutput`标志的值。
`long`	`getExpiration()` 返回 `expires`标题字段的值。
`static FileNameMap`	`getFileNameMap()` 从数据文件加载文件名映射（模拟）。
`String`	`getHeaderField(int n)` 返回的值 `n` ^th头字段。
`String`	`getHeaderField(String name)` 返回命名头字段的值。
`long`	`getHeaderFieldDate(String name, long Default)` 返回以日期解析的命名字段的值。
`int`	`getHeaderFieldInt(String name, int Default)` 返回被解析为命名字段的值。
`String`	`getHeaderFieldKey(int n)` 返回的关键 `n` ^th头字段。
`long`	`getHeaderFieldLong(String name, long Default)` 返回被解析为命名字段的值。
`Map<String,List<String>>`	`getHeaderFields()` 返回不可修改的标题字段的映射。
`long`	`getIfModifiedSince()` 返回此对象的 `ifModifiedSince`字段的值。
`InputStream`	`getInputStream()` 返回从此打开的连接读取的输入流。
`long`	`getLastModified()` 返回 `last-modified`标题字段的值。
`OutputStream`	`getOutputStream()` 返回写入此连接的输出流。
`Permission`	`getPermission()` 返回一个权限对象，该对象表示创建此对象所表示的连接所需的权限。
`int`	`getReadTimeout()` 返回读取超时的设置。
`Map<String,List<String>>`	`getRequestProperties()` 返回此连接的一般请求属性的不可修改映射。
`String`	`getRequestProperty(String key)` 返回此连接的命名的常规请求属性的值。
`URL`	`getURL()` 返回此 `URLConnection`的 `URL`字段的值。
`boolean`	`getUseCaches()` 返回此 `URLConnection`的 `useCaches`字段的值。
`static String`	`guessContentTypeFromName(String fname)` 根据URL的指定“文件”组件，尝试确定对象的内容类型。
`static String`	`guessContentTypeFromStream(InputStream is)` 根据输入流开头的字符，尝试确定输入流的类型。
`void`	`setAllowUserInteraction(boolean allowuserinteraction)` 设置这个 `URLConnection`的 `allowUserInteraction`字段的值。
`void`	`setConnectTimeout(int timeout)` 设置打开与此URLConnection引用的资源的通信链接时使用的指定超时值（以毫秒为单位）。
`static void`	`setContentHandlerFactory(ContentHandlerFactory fac)` 设置应用 `ContentHandlerFactory`的ContentHandlerFactory。
`static void`	`setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)` 将所有将来的 `URLConnection`对象的 `allowUserInteraction`字段的默认值设置为指定的值。
`static void`	`setDefaultRequestProperty(String key, String value)` 已弃用在获得适当的URLConnection实例之后，应该使用实例特定的setRequestProperty方法。调用此方法将不起作用。
`void`	`setDefaultUseCaches(boolean defaultusecaches)` 将 `useCaches`字段的默认值设置为指定值。
`void`	`setDoInput(boolean doinput)` 设置的值 `doInput`领域本 `URLConnection`指定值。
`void`	`setDoOutput(boolean dooutput)` 设置的值 `doOutput`领域本 `URLConnection`指定值。
`static void`	`setFileNameMap(FileNameMap map)` 设置FileNameMap。
`void`	`setIfModifiedSince(long ifmodifiedsince)` 设置的值 `ifModifiedSince`这个领域 `URLConnection`到指定值。
`void`	`setReadTimeout(int timeout)` 将读取超时设置为指定的超时时间，以毫秒为单位。
`void`	`setRequestProperty(String key, String value)` 设置一般请求属性。
`void`	`setUseCaches(boolean usecaches)` 设置的值 `useCaches`这个领域 `URLConnection`到指定值。
`String`	`toString()` 返回 `String`此URL连接的表示。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - url
```
protected URL url
```
    URL表示打开此连接的万维网上的远程对象。
    该字段的值可以通过getURL方法访问。
    
    该变量的默认值是URLConnection构造函数中的URL参数的值。
    
    另请参见：
    
    getURL() ， url
  - doInput
```
protected boolean doInput
```
    此变量由setDoInput方法设置。其值由getDoInput方法返回。
    URL连接可用于输入和/或输出。将doInput标志设置为true表示应用程序打算从URL连接读取数据。
    
    该字段的默认值为true 。
    
    另请参见：
    
    getDoInput() ， setDoInput(boolean)
  - doOutput
```
protected boolean doOutput
```
    该变量由setDoOutput方法设置。其值由getDoOutput方法返回。
    URL连接可用于输入和/或输出。将doOutput标志设置为true表示应用程序打算将数据写入URL连接。
    
    该字段的默认值为false 。
    
    另请参见：
    
    getDoOutput() ， setDoOutput(boolean)
  - allowUserInteraction
```
protected boolean allowUserInteraction
```
    如果true ，则在上下文中检查该URL ，其中允许用户交互（例如弹出认证对话）是有意义的。如果false ，则不允许用户交互。
    该字段的值可以通过setAllowUserInteraction方法设置。其值由getAllowUserInteraction方法返回。其默认值是上次调用setDefaultAllowUserInteraction方法中参数的值。
    
    另请参见：
    
    getAllowUserInteraction() ， setAllowUserInteraction(boolean) ， setDefaultAllowUserInteraction(boolean)
  - useCaches
```
protected boolean useCaches
```
    如果true ，协议被允许使用缓存，只要它可以。如果false ，协议必须始终尝试获取对象的新副本。
    该字段由setUseCaches方法设置。其值由getUseCaches方法返回。
    
    其默认值是上次调用setDefaultUseCaches方法中给出的值。
    
    另请参见：
    
    setUseCaches(boolean) ， getUseCaches() ， setDefaultUseCaches(boolean)
  - ifModifiedSince
```
protected long ifModifiedSince
```
    某些协议支持跳过对象的提取，除非对象在某个时间以前已被更新。
    非零值给出了1970年1月1日GMT之后的毫秒数。该对象只有在最近被修改的时间才被提取。
    
    该变量由setIfModifiedSince方法设置。它的值由getIfModifiedSince返回。
    
    该字段的默认值为0 ，表示必须始终发生提取。
    
    另请参见：
    
    getIfModifiedSince() ， setIfModifiedSince(long)
  - connected
```
protected boolean connected
```
    如果false ，此连接对象尚未创建指定URL的通信链接。如果true ，通信链路已建立。
- 构造方法详细信息
  - URLConnection
```
protected URLConnection(URL url)
```
    构造与指定URL的URL连接。与URL引用的对象的连接不会创建。
    
    参数
    
    url - 指定的URL。
- 方法详细信息
  - getFileNameMap
```
public static FileNameMap getFileNameMap()
```
    从数据文件加载文件名映射（模拟）。它将首先尝试加载由“content.types.user.table”属性定义的用户特定表。如果失败，它会尝试加载默认内置表。
    
    结果
    
    FileNameMap
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    setFileNameMap(java.net.FileNameMap)
  - setFileNameMap
```
public static void setFileNameMap(FileNameMap map)
```
    设置FileNameMap。
    如果有安全管理员，则该方法首先调用安全管理器的checkSetFactory方法，以确保允许操作。这可能会导致SecurityException。
    
    参数
    
    map - 要设置的FileNameMap
    
    异常
    
    SecurityException - 如果安全管理器存在，并且其 checkSetFactory方法不允许操作。
    
    从以下版本开始：
    
    1.2
    
    另请参见：
    
    SecurityManager.checkSetFactory() ， getFileNameMap()
  - connect
```
public abstract void connect()
                      throws IOException
```
    打开与此URL引用的资源的通信链接，如果此类连接尚未建立。
    如果connect已经打开（ connected字段的值为true ）调用了true ，则会忽略该调用。
    
    URLConnection对象经历两个阶段：首先创建它们，然后它们被连接。在创建之后，在连接之前，可以指定各种选项（例如doInput和UseCaches）。连接后，尝试设置它们是一个错误。依赖于连接的操作（如getContentLength）将在必要时隐式执行连接。
    
    异常
    
    SocketTimeoutException - 如果超时连接可以建立之前超时
    
    IOException - 如果在打开连接时发生I / O错误。
    
    另请参见：
    
    connected ， getConnectTimeout() ， setConnectTimeout(int)
  - setConnectTimeout
```
public void setConnectTimeout(int timeout)
```
    设置打开与此URLConnection引用的资源的通信链接时使用的指定超时值（以毫秒为单位）。如果在建立连接之前超时超时，则引发java.net.SocketTimeoutException。超时为零被解释为无限超时。
    这种方法的一些非标准实现可能会忽略指定的超时。要查看连接超时设置，请调用getConnectTimeout（）。
    
    参数
    
    timeout - 一个 int ，以 int为单位指定连接超时值
    
    异常
    
    IllegalArgumentException - 如果超时参数为负
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    getConnectTimeout() ， connect()
  - getConnectTimeout
```
public int getConnectTimeout()
```
    返回连接超时的设置。
    0返回意味着该选项被禁用（即无限超时）。
    
    结果
    
    一个 int ，表示连接超时值（以毫秒为单位）
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    setConnectTimeout(int) ， connect()
  - setReadTimeout
```
public void setReadTimeout(int timeout)
```
    将读取超时设置为指定的超时时间，以毫秒为单位。非零值指定当连接建立到资源时从Input stream读取的超时。如果在数据可用于读取之前超时超时，则会引发java.net.SocketTimeoutException。超时为零被解释为无限超时。
    此方法的一些非标准实现忽略指定的超时。要查看读取超时集，请调用getReadTimeout（）。
    
    参数
    
    timeout - 一个 int ，指定要以 int为单位的超时值
    
    异常
    
    IllegalArgumentException - 如果timeout参数为负
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    getReadTimeout() ， InputStream.read()
  - getReadTimeout
```
public int getReadTimeout()
```
    返回读取超时的设置。 0返回意味着该选项被禁用（即无限超时）。
    
    结果
    
    一个 int ，以 int为单位表示读取超时值
    
    从以下版本开始：
    
    1.5
    
    另请参见：
    
    setReadTimeout(int) ， InputStream.read()
  - getURL
```
public URL getURL()
```
    返回此 URLConnection的 URL字段的值。
    
    结果
    
    该值为 URLConnection的 URL字段。
    
    另请参见：
    
    url
  - getContentLength
```
public int getContentLength()
```
    返回content-length标题字段的值。
    注意： getContentLengthLong()应优先于此方法，因为它返回一个long ，因此更便于携带。
    
    结果
    
    此连接的URL引用的资源的内容长度 -1如果内容长度未知，或者如果内容长度大于Integer.MAX_VALUE。
  - getContentLengthLong
```
public long getContentLengthLong()
```
    返回 content-length标题字段的值为long。
    
    结果
    
    该连接的URL引用的资源的内容长度，如果内容长度未知， -1 。
    
    从以下版本开始：
    
    7.0
  - getContentType
```
public String getContentType()
```
    返回 content-type标题字段的值。
    
    结果
    
    URL引用的资源的内容类型，如果不知道， null 。
    
    另请参见：
    
    getHeaderField(java.lang.String)
  - getContentEncoding
```
public String getContentEncoding()
```
    返回 content-encoding标题字段的值。
    
    结果
    
    URL引用的资源的内容编码，如果不知道， null 。
    
    另请参见：
    
    getHeaderField(java.lang.String)
  - getExpiration
```
public long getExpiration()
```
    返回 expires标题字段的值。
    
    结果
    
    该URL引用的资源的到期日期，如果不知道，则为0。值为1970年1月1日GMT以来的毫秒数。
    
    另请参见：
    
    getHeaderField(java.lang.String)
  - getDate
```
public long getDate()
```
    返回 date标题字段的值。
    
    结果
    
    URL引用的资源的发送日期，如果不知道， 0 。返回的值是自1970年1月1日GMT以来的毫秒数。
    
    另请参见：
    
    getHeaderField(java.lang.String)
  - getLastModified
```
public long getLastModified()
```
    返回last-modified标题字段的值。结果是自1970年1月1日GMT以来的毫秒数。
    
    结果
    
    此 URLConnection的资源的上次修改日期，如果未知，则为0。
    
    另请参见：
    
    getHeaderField(java.lang.String)
  - getHeaderField
```
public String getHeaderField(String name)
```
    返回命名头字段的值。
    如果对可能不同的值多次设置相同标题的连接进行调用，则只返回最后一个值。
    
    参数
    
    name - 标题字段的名称。
    
    结果
    
    命名头字段的值，如果头中没有这样的字段， null 。
  - getHeaderFields
```
public Map<String,List<String>> getHeaderFields()
```
    返回不可修改的标题字段的映射。 Map键是表示响应头字段名称的字符串。每个Map值是一个不可修改的字符串列表，表示相应的字段值。
    
    结果
    
    头字段地图
    
    从以下版本开始：
    
    1.4
  - getHeaderFieldInt
```
public int getHeaderFieldInt(String name,
                             int Default)
```
    返回被解析为命名字段的值。
    存在这种形式的getHeaderField ，因为某些连接类型（例如， http-ng ）具有预分析头。该连接类型的类可以覆盖此方法并使解析短路。
    
    参数
    
    name - 标题字段的名称。
    
    Default - 默认值。
    
    结果
    
    命名字段的值，解析为整数。如果字段丢失或格式错误，则返回Default值。
  - getHeaderFieldLong
```
public long getHeaderFieldLong(String name,
                               long Default)
```
    返回被解析为命名字段的值。
    存在这种形式的getHeaderField ，因为某些连接类型（例如， http-ng ）具有预分析头。该连接类型的类可以覆盖此方法并使解析短路。
    
    参数
    
    name - 标题字段的名称。
    
    Default - 默认值。
    
    结果
    
    命名字段的值，解析为长。如果字段丢失或格式错误，则返回Default值。
    
    从以下版本开始：
    
    7.0
  - getHeaderFieldDate
```
public long getHeaderFieldDate(String name,
                               long Default)
```
    返回以日期解析的命名字段的值。结果是自1970年1月1日GMT以指定字段表示的毫秒数。
    存在这种形式的getHeaderField ，因为某些连接类型（例如， http-ng ）具有预分析头。该连接类型的类可以覆盖此方法并使解析短路。
    
    参数
    
    name - 标题字段的名称。
    
    Default - 默认值。
    
    结果
    
    该字段的值被解析为日期。如果字段丢失或格式错误，则返回Default参数的值。
  - getHeaderFieldKey
```
public String getHeaderFieldKey(int n)
```
    返回的关键n ^th头字段。如果少于n+1字段，则返回null 。
    
    参数
    
    n - 一个索引，其中 n>=0
    
    结果
    
    键为 n ^th头字段，或 null如果有不是较少 n+1字段。
  - getHeaderField
```
public String getHeaderField(int n)
```
    返回的值n ^th头字段。如果少于n+1字段，则返回null 。
    该方法可以与getHeaderFieldKey方法结合使用，以遍历消息中的所有头。
    
    参数
    
    n - 一个索引，其中 n>=0
    
    结果
    
    所述的值 n ^th头字段或 null如果存在少于 n+1字段
    
    另请参见：
    
    getHeaderFieldKey(int)
  - getContent
```
public Object getContent()
                  throws IOException
```
    检索此URL连接的内容。
    该方法首先通过调用getContentType方法来确定对象的内容类型。如果这是应用程序第一次看到特定内容类型，则会创建该内容类型的内容处理程序：
    1. 如果应用程序使用setContentHandlerFactory方法设置了一个内容处理程序工厂实例，则createContentHandler该实例的createContentHandler方法作为参数; 结果是该内容类型的内容处理程序。
    2. 如果没有设置内容处理程序工厂，或者如果工厂的createContentHandler方法返回null ，则应用程序加载名为
      
      sun.net.www.content.<contentType>
      
      其中< contentType >是通过获取内容类型的字符串，用period （'。'）替换所有斜杠字符，以及所有其他非字母数字字符与下划线字符' _ '。字母数字字符具体是26个大写ASCII字母' A '至' Z '，26个小写ASCII字母' a '至' z '，以及10个ASCII数字' 0 '至' 9 '。如果指定的类不存在，或者不是ContentHandler的子类，则抛出一个UnknownServiceException 。
    结果
    
    提取对象。应该使用instanceof操作符来确定返回的对象的具体类型。
    
    异常
    
    IOException - 如果在获取内容时发生I / O错误。
    
    UnknownServiceException - 如果协议不支持内容类型。
    
    另请参见：
    
    ContentHandlerFactory.createContentHandler(java.lang.String) ， getContentType() ， setContentHandlerFactory(java.net.ContentHandlerFactory)
  - getContent
```
public Object getContent(类[] classes)
                  throws IOException
```
    检索此URL连接的内容。
    
    参数
    
    classes - 指示所请求类型的 类数组
    
    结果
    
    提取的对象是类数组中指定类型的第一个匹配项。如果不支持请求的类型，则为null。应该使用instanceof操作符来确定返回的对象的具体类型。
    
    异常
    
    IOException - 如果在获取内容时发生I / O错误。
    
    UnknownServiceException - 如果协议不支持内容类型。
    
    从以下版本开始：
    
    1.3
    
    另请参见：
    
    getContent() ， ContentHandlerFactory.createContentHandler(java.lang.String) ， getContent(java.lang.Class[]) ， setContentHandlerFactory(java.net.ContentHandlerFactory)
  - getPermission
```
public Permission getPermission()
                         throws IOException
```
    返回一个权限对象，该对象表示创建此对象所表示的连接所需的权限。如果不需要权限进行连接，此方法返回null。默认情况下，此方法返回java.security.AllPermission 。子类应该覆盖此方法，并返回最能代表连接到URL所需的权限的权限。例如， URLConnection file: URL的file:将返回一个java.io.FilePermission对象。
    返回的权限可能取决于连接的状态。例如，连接前的许可可能与连接后的许可不同。例如，HTTP服务器（如foo.com）可能将连接重定向到不同的主机，例如bar.com。连接之前连接权限将代表连接到foo.com所需的权限，连接后返回的权限将是bar.com。
    
    权限通常用于两个目的：保护通过URLConnections获取的对象的缓存，并检查收件人了解特定URL的权限。在第一种情况下，在获得对象后应该获得许可。例如，在HTTP连接中，这将表示连接到最终获取数据的主机的权限。在第二种情况下，应在连接前获得并测试许可。
    
    结果
    
    表示由该URLConnection表示的连接所需的权限的许可对象。
    
    异常
    
    IOException - 如果权限的计算需要网络或文件I / O，并在计算异常时发生异常。
  - getInputStream
```
public InputStream getInputStream()
                           throws IOException
```
    返回从此打开的连接读取的输入流。如果读取超时在数据可用于读取之前超时，则可以从返回的输入流中读取SocketTimeoutException。
    
    结果
    
    从这个打开的连接读取的输入流。
    
    异常
    
    IOException - 如果在创建输入流时发生I / O错误。
    
    UnknownServiceException - 如果协议不支持输入。
    
    另请参见：
    
    setReadTimeout(int) ， getReadTimeout()
  - getOutputStream
```
public OutputStream getOutputStream()
                             throws IOException
```
    返回写入此连接的输出流。
    
    结果
    
    一个写入此连接的输出流。
    
    异常
    
    IOException - 如果在创建输出流时发生I / O错误。
    
    UnknownServiceException - 如果协议不支持输出。
  - toString
```
public String toString()
```
    返回 String此URL连接的表示。
    
    重写：
    
    toString在 Object类
    
    结果
    
    这个 URLConnection的字符串表示 URLConnection 。
  - setDoInput
```
public void setDoInput(boolean doinput)
```
    设置的值doInput领域本URLConnection指定值。
    URL连接可用于输入和/或输出。如果您打算使用URL连接进行输入，请将DoInput标志设置为true，否则返回false。默认值为true。
    
    参数
    
    doinput - 新值。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    doInput ， getDoInput()
  - getDoInput
```
public boolean getDoInput()
```
    返回这个 URLConnection的 doInput标志的值。
    
    结果
    
    该值为 URLConnection的 doInput标志。
    
    另请参见：
    
    setDoInput(boolean)
  - setDoOutput
```
public void setDoOutput(boolean dooutput)
```
    设置的值doOutput领域本URLConnection指定值。
    URL连接可用于输入和/或输出。如果您打算使用URL连接输出，请将DoOutput标志设置为true，否则返回false。默认值为false。
    
    参数
    
    dooutput - 新值。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    getDoOutput()
  - getDoOutput
```
public boolean getDoOutput()
```
    返回此 URLConnection的 doOutput标志的值。
    
    结果
    
    该值为 URLConnection的 doOutput旗。
    
    另请参见：
    
    setDoOutput(boolean)
  - setAllowUserInteraction
```
public void setAllowUserInteraction(boolean allowuserinteraction)
```
    设置这个 URLConnection的 allowUserInteraction字段的值。
    
    参数
    
    allowuserinteraction - 新值。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    getAllowUserInteraction()
  - getAllowUserInteraction
```
public boolean getAllowUserInteraction()
```
    返回此对象的 allowUserInteraction字段的值。
    
    结果
    
    该对象的 allowUserInteraction字段的值。
    
    另请参见：
    
    setAllowUserInteraction(boolean)
  - setDefaultAllowUserInteraction
```
public static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)
```
    将所有将来的 URLConnection对象的 allowUserInteraction字段的默认值设置为指定的值。
    
    参数
    
    defaultallowuserinteraction - 新值。
    
    另请参见：
    
    getDefaultAllowUserInteraction()
  - getDefaultAllowUserInteraction
```
public static boolean getDefaultAllowUserInteraction()
```
    返回allowUserInteraction字段的默认值。
    默认是“粘性”，是所有URLConnections的静态状态的一部分。此标志适用于下一个，以及创建的所有以下URLConnections。
    
    结果
    
    默认值为 allowUserInteraction字段。
    
    另请参见：
    
    setDefaultAllowUserInteraction(boolean)
  - setUseCaches
```
public void setUseCaches(boolean usecaches)
```
    设置的值useCaches这个领域URLConnection到指定值。
    一些协议执行缓存文档。偶尔，重要的是能够“通过”并忽略高速缓存（例如浏览器中的“重新加载”按钮）。如果连接上的UseCaches标志为true，则允许连接使用任何可以缓存的缓存。如果是false，缓存将被忽略。默认值来自DefaultUseCaches，默认值为true。
    
    参数
    
    usecaches -一个 boolean指示是否允许缓存
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    getUseCaches()
  - getUseCaches
```
public boolean getUseCaches()
```
    返回此 URLConnection的 useCaches字段的值。
    
    结果
    
    该值为 URLConnection的 useCaches字段。
    
    另请参见：
    
    setUseCaches(boolean)
  - setIfModifiedSince
```
public void setIfModifiedSince(long ifmodifiedsince)
```
    设置的值 ifModifiedSince这个领域 URLConnection到指定值。
    
    参数
    
    ifmodifiedsince - 新值。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    getIfModifiedSince()
  - getIfModifiedSince
```
public long getIfModifiedSince()
```
    返回此对象的 ifModifiedSince字段的值。
    
    结果
    
    该对象的 ifModifiedSince字段。
    
    另请参见：
    
    setIfModifiedSince(long)
  - getDefaultUseCaches
```
public boolean getDefaultUseCaches()
```
    返回默认值URLConnection的useCaches标志。
    默认是“粘性”，是所有URLConnections的静态状态的一部分。此标志适用于下一个，以及创建的所有以下URLConnections。
    
    结果
    
    默认值为 URLConnection的 useCaches标志。
    
    另请参见：
    
    setDefaultUseCaches(boolean)
  - setDefaultUseCaches
```
public void setDefaultUseCaches(boolean defaultusecaches)
```
    将 useCaches字段的默认值设置为指定值。
    
    参数
    
    defaultusecaches - 新的价值。
    
    另请参见：
    
    getDefaultUseCaches()
  - setRequestProperty
```
public void setRequestProperty(String key,
                               String value)
```
    设置一般请求属性。如果具有密钥的属性已存在，则使用新值覆盖其值。
    注意：HTTP需要所有请求属性，它们可以合法地使用相同键的多个实例来使用逗号分隔的列表语法，这样可以将多个属性附加到单个属性中。
    
    参数
    
    key - 请求已知的关键字（例如，“ Accept ”）。
    
    value - value的值。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    NullPointerException - 如果键是 null
    
    另请参见：
    
    getRequestProperty(java.lang.String)
  - addRequestProperty
```
public void addRequestProperty(String key,
                               String value)
```
    添加由键值对指定的一般请求属性。此方法不会覆盖与相同键相关联的现有值。
    
    参数
    
    key - 请求已知的关键字（例如，“ Accept ”）。
    
    value - value的值。
    
    异常
    
    IllegalStateException - 如果已连接
    
    NullPointerException - 如果键为空
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    getRequestProperties()
  - getRequestProperty
```
public String getRequestProperty(String key)
```
    返回此连接的命名的常规请求属性的值。
    
    参数
    
    key - 请求已知的关键字（例如，“接受”）。
    
    结果
    
    此连接的命名的常规请求属性的值。如果key为null，则返回null。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    另请参见：
    
    setRequestProperty(java.lang.String, java.lang.String)
  - getRequestProperties
```
public Map<String,List<String>> getRequestProperties()
```
    返回此连接的一般请求属性的不可修改映射。地图键是表示请求头字段名称的字符串。每个Map值是一个不可修改的字符串列表，表示相应的字段值。
    
    结果
    
    该连接的一般请求属性的映射。
    
    异常
    
    IllegalStateException - 如果已经连接
    
    从以下版本开始：
    
    1.4
  - setDefaultRequestProperty
```
@Deprecated
public static void setDefaultRequestProperty(String key,
                                                         String value)
```
    已弃用在获得适当的URLConnection实例之后，应该使用实例特定的setRequestProperty方法。调用此方法将不起作用。
    
    设置一般请求属性的默认值。创建URLConnection时，将使用这些属性进行初始化。
    
    参数
    
    key - 请求已知的关键字（例如，“ Accept ”）。
    
    value - 与密钥相关 value的值。
    
    另请参见：
    
    setRequestProperty(java.lang.String,java.lang.String) ， getDefaultRequestProperty(java.lang.String)
  - getDefaultRequestProperty
```
@Deprecated
public static String getDefaultRequestProperty(String key)
```
    已弃用在获得适当的URLConnection实例之后，应该使用实例特定的getRequestProperty方法。
    
    返回默认请求属性的值。为每个连接设置默认请求属性。
    
    参数
    
    key - 请求已知的关键字（例如，“接受”）。
    
    结果
    
    指定键的默认请求属性的值。
    
    另请参见：
    
    getRequestProperty(java.lang.String) ， setDefaultRequestProperty(java.lang.String, java.lang.String)
  - setContentHandlerFactory
```
public static void setContentHandlerFactory(ContentHandlerFactory fac)
```
    设置应用ContentHandlerFactory的ContentHandlerFactory。应用程序最多可以调用一次。
    ContentHandlerFactory实例用于从内容类型构造内容处理程序
    
    如果有安全管理员，则该方法首先调用安全管理员的checkSetFactory方法，以确保允许操作。这可能会导致SecurityException。
    
    参数
    
    fac - 所需工厂。
    
    异常
    
    Error - 如果工厂已经定义。
    
    SecurityException - 如果安全管理器存在，并且其 checkSetFactory方法不允许操作。
    
    另请参见：
    
    ContentHandlerFactory ， getContent() ， SecurityManager.checkSetFactory()
  - guessContentTypeFromName
```
public static String guessContentTypeFromName(String fname)
```
    根据URL的指定“文件”组件，尝试确定对象的内容类型。这是一个可以覆盖getContentType方法的getContentType使用的getContentType方法。
    
    参数
    
    fname - 文件名。
    
    结果
    
    根据其文件名，猜测对象的内容类型。
    
    另请参见：
    
    getContentType()
  - guessContentTypeFromStream
```
public static String guessContentTypeFromStream(InputStream is)
                                         throws IOException
```
    根据输入流开头的字符，尝试确定输入流的类型。该方法可以被覆盖getContentType方法的子类使用。
    理想情况下，不需要这个程序。但是很多http服务器返回不正确的内容类型; 此外，还有许多非标准扩展。直接检查字节以确定内容类型通常比相信http服务器所声称的内容类型更准确。
    
    参数
    
    is - 支持标记的输入流。
    
    结果
    
    内容类型的猜测，或 null如果无法确定。
    
    异常
    
    IOException - 如果在读取输入流时发生I / O错误。
    
    另请参见：
    
    InputStream.mark(int) ， InputStream.markSupported() ， getContentType()

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class URLConnection

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

url

doInput

doOutput

allowUserInteraction

useCaches

ifModifiedSince

connected

构造方法详细信息

URLConnection

方法详细信息

getFileNameMap

setFileNameMap

connect

setConnectTimeout

getConnectTimeout

setReadTimeout

getReadTimeout

getURL

getContentLength

getContentLengthLong

getContentType

getContentEncoding

getExpiration

getDate

getLastModified

getHeaderField

getHeaderFields

getHeaderFieldInt

getHeaderFieldLong

getHeaderFieldDate

getHeaderFieldKey

getHeaderField

getContent

getContent

getPermission

getInputStream

getOutputStream

toString

setDoInput

getDoInput

setDoOutput

getDoOutput

setAllowUserInteraction

getAllowUserInteraction

setDefaultAllowUserInteraction

getDefaultAllowUserInteraction

setUseCaches

getUseCaches

setIfModifiedSince

getIfModifiedSince

getDefaultUseCaches

setDefaultUseCaches

setRequestProperty

addRequestProperty

getRequestProperty

getRequestProperties

setDefaultRequestProperty

getDefaultRequestProperty

setContentHandlerFactory

guessContentTypeFromName

guessContentTypeFromStream