compact1, compact2, compact3

java.net

Class URLConnection

java.lang.Object

java.net.URLConnection

已知直接子类：

HttpURLConnection， JarURLConnection

public abstract class URLConnection
extends Object

抽象类 URLConnection是所有课代表和一个URL的应用程序之间的通信链路的父类。这个类的实例可以用来读取和写入由该网址引用的资源。总的来说，创建一个连接到一个URL是一个多步骤的过程：

openConnection()	connect()
Manipulate parameters that affect the connection to the remote resource.	Interact with the resource; query header fields and contents.

---------------------------- >
time

1. 连接对象是通过调用一个URL的openConnection方法创建。
2. 的设置参数和一般请求属性被操纵。
3. 对远程对象的实际连接，使用connect方法。
4. 该远程对象可用。可以访问头字段和远程对象的内容。

设置参数被修改，使用以下方法：

• setAllowUserInteraction
• setDoInput
• setDoOutput
• setIfModifiedSince
• setUseCaches

和通用请求属性被修改使用该方法：

• setRequestProperty

为AllowUserInteraction和UseCaches参数的默认值可以设置使用的方法setDefaultAllowUserInteraction和setDefaultUseCaches。

上述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()方法对一个 URLConnection的 InputStream或 OutputStream请求后可以免费网络资源与该实例相关的，除非特别指定不同的行为，其协议规范。

从以下版本开始：

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 该网址代表了这个连接打开的万维网的远程对象。
protected boolean	useCaches 如果 true，该协议允许使用缓存的时候可以。

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	URLConnection(URL url) 构建一个与指定的网址的网址连接。

方法摘要

Modifier and Type	Method and Description
void	addRequestProperty(String key, String value) 添加一个由一个键值对指定的通用请求属性。
abstract void	connect() 打开一个通信链接到这个网址引用的资源，如果这样的连接还没有建立。
boolean	getAllowUserInteraction() 返回的 allowUserInteraction场该对象的值。
int	getConnectTimeout() 返回连接超时的设置。
Object	getContent() 检索此网址连接的内容。
Object	getContent(类[] classes) 检索此网址连接的内容。
String	getContentEncoding() 返回的 content-encoding标头字段的值。
int	getContentLength() 返回的 content-length标头字段的值。
long	getContentLengthLong() 作为一个长期回报的 content-length标头字段的值。
String	getContentType() 返回的 content-type标头字段的值。
long	getDate() 返回的 date标头字段的值。
static boolean	getDefaultAllowUserInteraction() 返回的 allowUserInteraction字段的默认值。
static String	getDefaultRequestProperty(String key) 过时的。 具体的实例getrequestproperty方法应使用后得到URLConnection适当的实例。
boolean	getDefaultUseCaches() 返回一个 URLConnection的 useCaches标志的默认值。
boolean	getDoInput() 返回该 URLConnection的 doInput标志值。
boolean	getDoOutput() 返回该 URLConnection的 doOutput标志值。
long	getExpiration() 返回的 expires标头字段的值。
static FileNameMap	getFileNameMap() 加载文件名Map（一mimetable）从一个数据文件。
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() 返回头字段的不可更改的Map。
long	getIfModifiedSince() 返回该对象的 ifModifiedSince字段的值。
InputStream	getInputStream() 返回从这个打开连接读取的输入流。
long	getLastModified() 返回的 last-modified标头字段的值。
OutputStream	getOutputStream() 返回写入此连接的输出流。
Permission	getPermission() 返回表示表示要为该对象表示的连接的权限对象。
int	getReadTimeout() 返回读取超时的设置。
Map<String,List<String>>	getRequestProperties() 返回此连接的通用请求属性的一个不可修改的Map。
String	getRequestProperty(String key) 返回此连接的已命名的通用请求属性的值。
URL	getURL() 返回该 URLConnection的 URL字段的值。
boolean	getUseCaches() 返回该 URLConnection的 useCaches字段的值。
static String	guessContentTypeFromName(String fname) 试图根据某个网址的指定的“文件”组件来确定一个对象的内容类型。
static String	guessContentTypeFromStream(InputStream is) 尝试根据输入流的开头的字符来确定输入流的类型。
void	setAllowUserInteraction(boolean allowuserinteraction) 设置这个 URLConnection的 allowUserInteraction字段的值。
void	setConnectTimeout(int timeout) 集以毫秒为单位指定的超时值，可当打开通信链接引用的URLConnection资源。
static void	setContentHandlerFactory(ContentHandlerFactory fac) 设置应用程序的 ContentHandlerFactory。
static void	setDefaultAllowUserInteraction(boolean defaultallowuserinteraction) 套的 allowUserInteraction场所有未来的 URLConnection对象指定值的默认值。
static void	setDefaultRequestProperty(String key, String value) 过时的。 实例具体setRequestProperty方法应使用后得到URLConnection适当的实例。调用此方法将不会有任何效果。
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) 设置为指定的值这个 URLConnection的 ifModifiedSince字段的值。
void	setReadTimeout(int timeout) 将读取超时设置为指定的超时时间，以毫秒为单位。
void	setRequestProperty(String key, String value) 设置通用请求属性。
void	setUseCaches(boolean usecaches) 设置为指定的值这个 URLConnection的 useCaches字段的值。
String	toString() 返回一个 String表示这个URL连接。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

url

protected URL url

该网址代表了这个连接打开的万维网的远程对象。

此字段的值可以由getURL方法访问。

该变量的默认值是URL参数在URLConnection构造函数的值。

另请参见：

getURL()， url

doInput

protected boolean doInput

这个变量是由 setDoInput方法。它的价值是由 getDoInput方法返回。

一个可以用于输入和/或输出的网址连接。设置doInput旗true指示应用程序试图从URL连接读取数据。

此字段的默认值是true。

另请参见：

getDoInput()， setDoInput(boolean)

doOutput

protected boolean doOutput

这个变量是由 setDoOutput方法。它的价值是由 getDoOutput方法返回。

一个可以用于输入和/或输出的网址连接。设置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，通信链路的建立。

Constructor Detail

URLConnection

protected URLConnection(URL url)

构建一个与指定的网址的网址连接。未创建由该网址引用的对象的连接。

参数

url -指定的URL。

方法详细信息

getFileNameMap

public static FileNameMap getFileNameMap()

加载文件名Map（一mimetable）从一个数据文件。它将首先尝试加载“内容”定义的用户特定的表。类型。表“属性”。如果失败，它试图加载默认的内置表。

结果

的filenamemap

从以下版本开始：

一点二

另请参见：

setFileNameMap(java.net.FileNameMap)

setFileNameMap

public static void setFileNameMap(FileNameMap map)

集filenamemap。

如果存在安全管理器，该方法首先调用安全管理器的checkSetFactory方法确保操作是允许的。这可能导致SecurityException。

参数

map - filenamemap定

异常

SecurityException -如果存在一个安全管理及其 checkSetFactory方法不允许操作。

从以下版本开始：

一点二

另请参见：

SecurityManager.checkSetFactory()， getFileNameMap()

connect

public abstract void connect()
                      throws IOException

打开一个通信链接到这个网址引用的资源，如果这样的连接还没有建立。

如果connect方法被调用时，连接已打开（由connected领域有价值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指定连接超时值以毫秒为单位

异常

IllegalArgumentException如果timeout参数为负

从以下版本开始：

一点五

另请参见：

getConnectTimeout()， connect()

getConnectTimeout

public int getConnectTimeout()

返回连接超时的设置。

0返回意味着该选项是禁用的（即，超时的无穷大）。

结果

一个 int表示连接超时值以毫秒为单位

从以下版本开始：

一点五

另请参见：

setConnectTimeout(int)， connect()

setReadTimeout

public void setReadTimeout(int timeout)

将读取超时设置为指定的超时时间，以毫秒为单位。一个非零的值指定从输入流读取时，连接被建立到一个资源的超时时间。如果之前有可供读取数据超时时间已到，一java.net.sockettimeoutexception升起。一个零的超时被解释为一个无限超时。

这种方法的一些非标准实现忽略了指定的超时时间。看读超时设置，请getreadtimeout()。

参数

timeout - int指定要用于毫秒超时值

异常

IllegalArgumentException如果timeout参数为负

从以下版本开始：

一点五

另请参见：

getReadTimeout()， InputStream.read()

getReadTimeout

public int getReadTimeout()

返回读取超时的设置。0返回意味着该选项是禁用的（即，超时的无穷大）。

结果

一个 int在毫秒指示读取超时值

从以下版本开始：

一点五

另请参见：

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标头字段的值。

结果

这种连接的URL引用的资源内容的长度，或 -1如果内容长度是不知道。

从以下版本开始：

七

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标头字段的值。

结果

该资源的到期日期，此网址引用，或0，如果不知道。价值是自1970年1月1日格林威治时间的毫秒数

另请参见：

getHeaderField(java.lang.String)

getDate

public long getDate()

返回的 date标头字段的值。

结果

发送日期的资源URL引用，或 0如果不知道。返回的值是自1970年1月1日格林威治时间的毫秒数

另请参见：

getHeaderField(java.lang.String)

getLastModified

public long getLastModified()

返回的 last-modified标头字段的值。结果是自1970年1月1日格林威治时间的毫秒数

结果

资源引用的 URLConnection最后修改日期，或0如果不知道。

另请参见：

getHeaderField(java.lang.String)

getHeaderField

public String getHeaderField(String name)

返回命名的头字段的值。

如果调用了一个连接，该连接用可能不同的值设置相同的头值，则返回值仅为最后一个值。

参数

name -一个标头字段的名称。

结果

对指定的标头字段的值，或 null如果在标题中没有这样的场。

getHeaderFields

public Map<String,List<String>> getHeaderFields()

返回头字段的不可更改的Map。映射键是表示响应头字段名称的字符串。每个Map的值是字符串，表示相应的字段值的一个不可修改的列表。

结果

头字段的Map

从以下版本开始：

一点四

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值如果字段丢失或不返回。

从以下版本开始：

七

getHeaderFieldDate

public long getHeaderFieldDate(String name,
                               long Default)

返回解析为日期的命名字段的值。其结果是由指定的字段表示的时间为1970年1月1日的毫秒数。

这种形式的getHeaderField存在一些连接类型（例如，http-ng）有预解析头文件。该连接类型的类可以重写此方法，并使解析的短路。

参数

name -头字段的名称。

Default -默认值。

结果

字段的值，解析为日期。该 Default参数的值是如果字段丢失或畸形的恢复。

getHeaderFieldKey

public String getHeaderFieldKey(int n)

返回的 n ^TH标头字段的关键。它返回 null如果少于 n+1领域。

参数

n -一个索引，在 n>=0

结果

为 n ^TH标头字段的关键，或 null如果少于 n+1领域。

getHeaderField

public String getHeaderField(int n)

返回的 n ^TH标头字段的值。它返回 null如果少于 n+1fields。

该方法可用于与getHeaderFieldKey方法结合迭代通过消息中的所有标题。

参数

n -一个索引，在 n>=0

结果

该 n ^TH头字段或 null值如果小于 n+1领域

另请参见：

getHeaderFieldKey(int)

getContent

public Object getContent()
                  throws IOException

检索此网址连接的内容。

该方法首先确定对象的内容类型调用getContentType方法。如果这是应用程序第一次看到特定的内容类型，则创建一个内容类型的内容处理程序：

1. 如果应用程序已经建立了一个内容处理程序工厂实例使用的setContentHandlerFactory方法，该实例的createContentHandler方法被调用的内容类型作为参数；结果是一个内容类型的内容处理程序。
2. 如果没有内容处理程序工厂尚未建立，或者工厂的createContentHandler方法返回null，然后加载应用程序命名为类：

            sun.net.www.content.<contentType>
        

   在 <内容类型> 是以内容字符串类型的形成，与 period更换所有斜杠字符（“”），和所有其他非字母数字字符的 _下划线字符“”。字母数字字符的26个大写字母是“ A’到‘ Z '，26个小写字母的“ 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

检索此网址连接的内容。

参数

classes指示请求的类型 类阵列

结果

对象获取的对象是类数组中指定的类型的第一个匹配。如果支持没有所请求的类型，则为空。的 instanceof应被用来确定对象的特定类型返回。

异常

IOException如果I/O错误发生在获取内容。

UnknownServiceException -如果协议不支持的内容类型。

从以下版本开始：

一点三

另请参见：

getContent()， ContentHandlerFactory.createContentHandler(java.lang.String)， getContent(java.lang.Class[])， setContentHandlerFactory(java.net.ContentHandlerFactory)

getPermission

public Permission getPermission()
                         throws IOException

返回表示表示要为该对象表示的连接的权限对象。此方法返回空，如果不需要进行连接，则。默认情况下，此方法返回 java.security.AllPermission。子类应重写此方法，并返回最佳表示要使一一连接到该网址的权限的权限。例如，一个 URLConnection代表 file: URL会返回一个 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字符串表示形式。

setDoInput

public void setDoInput(boolean doinput)

套的 doInput领域这 URLConnection到指定的值。

一个可以用于输入和/或输出的网址连接。如果你打算使用URL连接输入设置doinput标志为true，false。默认是真的。

参数

doinput -新价值。

异常

如果已经连接 IllegalStateException

另请参见：

doInput， getDoInput()

getDoInput

public boolean getDoInput()

返回该 URLConnection的 doInput标志值。

结果

这 URLConnection的 doInput标志值。

另请参见：

setDoInput(boolean)

setDoOutput

public void setDoOutput(boolean dooutput)

套的 doOutput领域这 URLConnection到指定的值。

一个可以用于输入和/或输出的网址连接。如果你打算使用URL连接输出设置dooutput标志为true，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)

套的 allowUserInteraction场所有未来的 URLConnection对象指定值的默认值。

参数

defaultallowuserinteraction -新价值。

另请参见：

getDefaultAllowUserInteraction()

getDefaultAllowUserInteraction

public static boolean getDefaultAllowUserInteraction()

返回的 allowUserInteraction字段的默认值。

这是默认的“粘性”，是所有urlconnections静态部分。此标记适用于未来，所有以下urlconnections所创建的。

结果

该 allowUserInteraction字段的默认值。

另请参见：

setDefaultAllowUserInteraction(boolean)

setUseCaches

public void setUseCaches(boolean usecaches)

设置为指定的值这个 URLConnection的 useCaches字段的值。

一些协议做缓存的文件。偶尔，它是重要的是能够“隧道通过”，忽略高速缓存（例如，在浏览器中的“重新加载”按钮）。如果在一个连接的usecaches标志为true，连接被允许使用它可以任何缓存。如果是错误的，高速缓存是被忽略的。默认值是从defaultusecaches，真正违约。

参数

usecaches - boolean指示是否允许缓存

异常

如果已经连接 IllegalStateException

另请参见：

getUseCaches()

getUseCaches

public boolean getUseCaches()

返回该 URLConnection的 useCaches字段的值。

结果

这 URLConnection的 useCaches字段的值。

另请参见：

setUseCaches(boolean)

setIfModifiedSince

public void setIfModifiedSince(long ifmodifiedsince)

设置为指定的值这个 URLConnection的 ifModifiedSince字段的值。

参数

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 -价值与它相关联的。

异常

如果已经连接 IllegalStateException

NullPointerException如果关键是 null

另请参见：

getRequestProperty(java.lang.String)

addRequestProperty

public void addRequestProperty(String key,
                               String value)

添加一个由一个键值对指定的通用请求属性。此方法将不会覆盖与同一密钥关联的现有值。

参数

key -关键字的请求是已知的（例如，“ Accept”）。

value -价值与它相关联的。

异常

如果已经连接 IllegalStateException

NullPointerException如果关键是空的

从以下版本开始：

一点四

另请参见：

getRequestProperties()

getRequestProperty

public String getRequestProperty(String key)

返回此连接的已命名的通用请求属性的值。

参数

key -关键字的请求是已知的（例如，“接受”）。

结果

此连接的通用请求属性的值。如果键为空，则返回空值。

异常

如果已经连接 IllegalStateException

另请参见：

setRequestProperty(java.lang.String, java.lang.String)

getRequestProperties

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

返回此连接的通用请求属性的一个不可修改的Map。映射键是表示请求头字段名的字符串。每个Map的价值是不可修改的字符串列表，代表相应的字段值。

结果

此连接的通用请求属性的映射。

异常

如果已经连接 IllegalStateException

从以下版本开始：

一点四

setDefaultRequestProperty

@Deprecated
public static void setDefaultRequestProperty(String key,
                                                         String value)

过时的。 实例具体setRequestProperty方法应使用后得到URLConnection适当的实例。调用此方法将不会有任何效果。

设置一个通用请求属性的默认值。当一个 URLConnection是创造出来的，它是与这些属性初始化。

参数

key -关键字的请求是已知的（例如，“ Accept”）。

value与键关联的值。

另请参见：

setRequestProperty(java.lang.String,java.lang.String)， getDefaultRequestProperty(java.lang.String)

getDefaultRequestProperty

@Deprecated
public static String getDefaultRequestProperty(String key)

过时的。 具体的实例getrequestproperty方法应使用后得到URLConnection适当的实例。

返回默认请求属性的值。每一个连接都设置默认请求属性。

参数

key -关键字的请求是已知的（例如，“接受”）。

结果

指定键的默认请求属性的值。

另请参见：

getRequestProperty(java.lang.String)， setDefaultRequestProperty(java.lang.String, java.lang.String)

setContentHandlerFactory

public static void setContentHandlerFactory(ContentHandlerFactory fac)

设置应用程序的 ContentHandlerFactory。它可以被称为在最一次由一个应用程序。

的ContentHandlerFactory实例是用来从一个内容类型构建一个内容处理程序

如果存在安全管理器，该方法首先调用安全管理器的checkSetFactory方法确保操作是允许的。这可能导致SecurityException。

参数

fac -所需的工厂。

异常

Error -如果工厂已被定义。

SecurityException -如果存在一个安全管理及其 checkSetFactory方法不允许操作。

另请参见：

ContentHandlerFactory， getContent()， SecurityManager.checkSetFactory()

guessContentTypeFromName

public static String guessContentTypeFromName(String fname)

试图根据某个网址的指定的“文件”组件来确定一个对象的内容类型。这是一个可以通过子类重写 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()