public abstract class URLConnection
extends Object
java.lang.Object | |
↳ | java.net.URLConnection |
Known Direct Subclasses |
Known Indirect Subclasses |
抽象类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. |
openConnection
method on a URL. connect
method. 使用以下方法修改设置参数:
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
连接的请求属性和标题字段的更多信息,请访问:
Note abouthttp://www.ietf.org/rfc/rfc2616.txt
fileNameMap
: In versions prior to JDK 1.1.6, field
fileNameMap
of
URLConnection
was public. In JDK 1.1.6 and later,
fileNameMap
is private; accessor and mutator methods
getFileNameMap
and
setFileNameMap
are added to access it. This change is also described on the
Compatibility page. Invoking the
close() methods on the
InputStream or
OutputStream of an
URLConnection after a request may free network resources associated with this instance, unless particular protocol specifications specify different behaviours for it.
也可以看看:
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)
Fields |
|
---|---|
protected boolean |
allowUserInteraction 如果 |
protected boolean |
connected 如果 |
protected boolean |
doInput 该变量由 |
protected boolean |
doOutput 该变量由 |
protected long |
ifModifiedSince 某些协议支持跳过对象的提取,除非该对象比某个时间更近被修改。 |
protected URL |
url URL表示打开此连接的万维网上的远程对象。 |
protected boolean |
useCaches 如果 |
Protected constructors |
|
---|---|
URLConnection(URL url) 构造到指定URL的URL连接。 |
Public methods |
|
---|---|
void |
addRequestProperty(String key, String value) 添加由键值对指定的常规请求属性。 |
abstract void |
connect() 如果此连接尚未建立,则打开通向该URL所引用资源的通信链接。 |
boolean |
getAllowUserInteraction() 返回此对象的 |
int |
getConnectTimeout() 返回连接超时的设置。 |
Object |
getContent() 检索此URL连接的内容。 |
Object |
getContent(Class[] classes) 检索此URL连接的内容。 |
String |
getContentEncoding() 返回 |
int |
getContentLength() 返回 |
long |
getContentLengthLong() 作为long返回 |
String |
getContentType() 返回 |
long |
getDate() 返回 |
static boolean |
getDefaultAllowUserInteraction() 返回 |
static String |
getDefaultRequestProperty(String key) 此方法在API级别1中已弃用。应在获得URLConnection的相应实例后使用特定于实例的getRequestProperty方法。 |
boolean |
getDefaultUseCaches() 返回 |
boolean |
getDoInput() 返回此 |
boolean |
getDoOutput() 返回此 |
long |
getExpiration() 返回 |
static FileNameMap |
getFileNameMap() 从数据文件加载文件名映射(一个mimetable)。 |
String |
getHeaderField(String name) 返回指定标题字段的值。 |
String |
getHeaderField(int n) 返回第 |
long |
getHeaderFieldDate(String name, long Default) 返回解析为日期的命名字段的值。 |
int |
getHeaderFieldInt(String name, int Default) 返回解析为数字的命名字段的值。 |
String |
getHeaderFieldKey(int n) 返回第 |
long |
getHeaderFieldLong(String name, long Default) 返回解析为数字的命名字段的值。 |
Map<String, List<String>> |
getHeaderFields() 返回标题字段的不可修改的映射。 |
long |
getIfModifiedSince() 返回此对象的 |
InputStream |
getInputStream() 返回从此打开的连接读取的输入流。 |
long |
getLastModified() 返回 |
OutputStream |
getOutputStream() 返回写入此连接的输出流。 |
Permission |
getPermission() 返回一个权限对象,表示建立由此对象表示的连接所需的权限。 |
int |
getReadTimeout() 返回读取超时的设置。 |
Map<String, List<String>> |
getRequestProperties() 返回此连接的一般请求属性的不可修改的映射。 |
String |
getRequestProperty(String key) 返回此连接的指定常规请求属性的值。 |
URL |
getURL() 返回此 |
boolean |
getUseCaches() 返回此 |
static String |
guessContentTypeFromName(String fname) 尝试根据URL的指定“文件”组件确定对象的内容类型。 |
static String |
guessContentTypeFromStream(InputStream is) 尝试根据输入流开始处的字符确定输入流的类型。 |
void |
setAllowUserInteraction(boolean allowuserinteraction) 设置此 |
void |
setConnectTimeout(int timeout) 设置打开到此URLConnection引用的资源的通信链接时要使用的指定超时值(以毫秒为单位)。 |
static void |
setContentHandlerFactory(ContentHandlerFactory fac) 设置应用程序的 |
static void |
setDefaultAllowUserInteraction(boolean defaultallowuserinteraction) 将所有将来的 |
static void |
setDefaultRequestProperty(String key, String value) 此方法在API级别1中已弃用。在获得URLConnection的相应实例后应使用特定于实例的setRequestProperty方法。 调用此方法将不起作用。 |
void |
setDefaultUseCaches(boolean defaultusecaches) 将 |
void |
setDoInput(boolean doinput) 将此 |
void |
setDoOutput(boolean dooutput) 将此 |
static void |
setFileNameMap(FileNameMap map) 设置FileNameMap。 |
void |
setIfModifiedSince(long ifmodifiedsince) 将此 |
void |
setReadTimeout(int timeout) 将读取超时设置为指定的超时,以毫秒为单位。 |
void |
setRequestProperty(String key, String value) 设置一般请求属性。 |
void |
setUseCaches(boolean usecaches) 将此 |
String |
toString() 返回此URL连接的 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
boolean allowUserInteraction
如果是true
,那么这个URL
正在被允许进行用户交互的情况下进行检查,例如弹出认证对话框。 如果false
,则不允许用户交互。
该字段的值可以通过setAllowUserInteraction
方法设置。 它的值由getAllowUserInteraction
方法返回。 其默认值是上次调用setDefaultAllowUserInteraction
方法时参数的值。
boolean doInput
该变量由setDoInput
方法设置。 它的值由getDoInput
方法返回。
URL连接可用于输入和/或输出。 将doInput
标志设置为true
表示应用程序打算从URL连接读取数据。
该字段的默认值是 true
。
也可以看看:
boolean doOutput
该变量由setDoOutput
方法设置。 它的值由getDoOutput
方法返回。
URL连接可用于输入和/或输出。 将doOutput
标志设置为true
表示应用程序打算将数据写入URL连接。
该字段的默认值是 false
。
long ifModifiedSince
某些协议支持跳过对象的提取,除非该对象比某个时间更近被修改。
非零值给出的时间是自1970年1月1日GMT以来的毫秒数。 仅当该对象的修改时间比该时间更晚时才被提取。
该变量由setIfModifiedSince
方法设置。 它的值由getIfModifiedSince
方法返回。
此字段的默认值为 0
,表示必须始终发生抓取。
URL url
URL表示打开此连接的万维网上的远程对象。
该字段的值可以通过 getURL
方法访问。
此变量的默认值是 URLConnection
构造函数中的URL参数的值。
boolean useCaches
如果是true
,则只要协议可以,就允许协议使用缓存。 如果false
,协议必须总是尝试获取对象的新副本。
该字段由setUseCaches
方法设置。 它的值由getUseCaches
方法返回。
其默认值是上次调用 setDefaultUseCaches
方法时给出的值。
URLConnection (URL url)
构造到指定URL的URL连接。 不会创建到由URL引用的对象的连接。
Parameters | |
---|---|
url |
URL : the specified URL. |
void addRequestProperty (String key, String value)
添加由键值对指定的常规请求属性。 此方法不会覆盖与同一个键关联的现有值。
Parameters | |
---|---|
key |
String : the keyword by which the request is known (e.g., "Accept "). |
value |
String : the value associated with it. |
Throws | |
---|---|
IllegalStateException |
if already connected |
NullPointerException |
if key is null |
也可以看看:
void connect ()
如果此连接尚未建立,则打开通向该URL所引用资源的通信链接。
如果在连接已打开时调用 connect
方法(由具有值 true
的 connected
字段 true
),则该调用将被忽略。
URLConnection对象经历两个阶段:首先创建它们,然后连接它们。 创建之后,连接之前,可以指定各种选项(例如doInput和UseCaches)。 连接后,尝试设置它们是错误的。 依赖于连接的操作(如getContentLength)将在必要时隐式执行连接。
Throws | |
---|---|
SocketTimeoutException |
if the timeout expires before the connection can be established |
IOException |
if an I/O error occurs while opening the connection. |
boolean getAllowUserInteraction ()
返回此对象的 allowUserInteraction
字段的值。
Returns | |
---|---|
boolean |
the value of the allowUserInteraction field for this object. |
int getConnectTimeout ()
返回连接超时的设置。
0返回意味着该选项被禁用(即无限超时)。
Returns | |
---|---|
int |
an int that indicates the connect timeout value in milliseconds |
也可以看看:
Object getContent ()
检索此URL连接的内容。
该方法首先调用getContentType
方法来确定对象的内容类型。 如果这是应用程序第一次看到特定的内容类型,则创建该内容类型的内容处理程序:
setContentHandlerFactory
method, the createContentHandler
method of that instance is called with the content type as an argument; the result is a content handler for that content type. createContentHandler
method returns null
, then the application loads the class named:
where <contentType> is formed by taking the content-type string, replacing all slash characters with asun.net.www.content.<contentType>
period
('.'), and all other non-alphanumeric characters with the underscore character '_
'. The alphanumeric characters are specifically the 26 uppercase ASCII letters 'A
' through 'Z
', the 26 lowercase ASCII letters 'a
' through 'z
', and the 10 ASCII digits '0
' through '9
'. If the specified class does not exist, or is not a subclass of ContentHandler
, then an UnknownServiceException
is thrown. Returns | |
---|---|
Object |
the object fetched. The instanceof operator should be used to determine the specific kind of object returned. |
Throws | |
---|---|
IOException |
if an I/O error occurs while getting the content. |
UnknownServiceException |
if the protocol does not support the content type. |
Object getContent (Class[] classes)
检索此URL连接的内容。
Parameters | |
---|---|
classes |
Class : the Class array indicating the requested types |
Returns | |
---|---|
Object |
the object fetched that is the first match of the type specified in the classes array. null if none of the requested types are supported. The instanceof operator should be used to determine the specific kind of object returned. |
Throws | |
---|---|
IOException |
if an I/O error occurs while getting the content. |
UnknownServiceException |
if the protocol does not support the content type. |
String getContentEncoding ()
返回 content-encoding
标题字段的值。
Returns | |
---|---|
String |
the content encoding of the resource that the URL references, or null if not known. |
int getContentLength ()
返回 content-length
标题字段的值。
注意 : getContentLengthLong()
应优于此方法,因为它返回 long
,因此更便于携带。
Returns | |
---|---|
int |
the content length of the resource that this connection's URL references, -1 if the content length is not known, or if the content length is greater than Integer.MAX_VALUE. |
long getContentLengthLong ()
长 content-length
返回 content-length
标题字段的值。
Returns | |
---|---|
long |
the content length of the resource that this connection's URL references, or -1 if the content length is not known. |
String getContentType ()
返回 content-type
标题字段的值。
Returns | |
---|---|
String |
the content type of the resource that the URL references, or null if not known. |
long getDate ()
返回 date
标题字段的值。
Returns | |
---|---|
long |
the sending date of the resource that the URL references, or 0 if not known. The value returned is the number of milliseconds since January 1, 1970 GMT. |
boolean getDefaultAllowUserInteraction ()
返回 allowUserInteraction
字段的默认值。
默认情况下是“粘性”,是所有URLConnections的静态状态的一部分。 此标志适用于下一个以及所有已创建的URLConnections。
Returns | |
---|---|
boolean |
the default value of the allowUserInteraction field. |
String getDefaultRequestProperty (String key)
此方法在API级别1中已弃用。
应该在获得URLConnection的适当实例后使用特定于实例的getRequestProperty方法。
返回默认请求属性的值。 默认请求属性为每个连接设置。
Parameters | |
---|---|
key |
String : the keyword by which the request is known (e.g., "Accept"). |
Returns | |
---|---|
String |
the value of the default request property for the specified key. |
boolean getDefaultUseCaches ()
返回 URLConnection
的 useCaches
标志的默认值。
默认情况下是“粘性”,是所有URLConnections的静态状态的一部分。 此标志适用于下一个以及所有已创建的URLConnections。
Returns | |
---|---|
boolean |
the default value of a URLConnection 's useCaches flag. |
也可以看看:
boolean getDoInput ()
返回此 URLConnection
的 doInput
标志的值。
Returns | |
---|---|
boolean |
the value of this URLConnection 's doInput flag. |
也可以看看:
boolean getDoOutput ()
返回此 URLConnection
的 doOutput
标志的值。
Returns | |
---|---|
boolean |
the value of this URLConnection 's doOutput flag. |
也可以看看:
long getExpiration ()
返回 expires
标题字段的值。
Returns | |
---|---|
long |
the expiration date of the resource that this URL references, or 0 if not known. The value is the number of milliseconds since January 1, 1970 GMT. |
FileNameMap getFileNameMap ()
从数据文件加载文件名映射(一个mimetable)。 它将首先尝试加载由“content.types.user.table”属性定义的用户特定表。 如果失败,它会尝试在java home下的lib / content-types.properties中加载默认的内置表。
Returns | |
---|---|
FileNameMap |
the FileNameMap |
String getHeaderField (String name)
返回指定标题字段的值。
如果在连接上使用可能不同的值多次设置相同标头的连接进行调用,则只返回最后一个值。
Parameters | |
---|---|
name |
String : the name of a header field. |
Returns | |
---|---|
String |
the value of the named header field, or null if there is no such field in the header. |
String getHeaderField (int n)
返回第n
个标题字段的值。 如果少于n+1
字段,则返回null
。
此方法可以与 getHeaderFieldKey
方法一起使用,以迭代消息中的所有标题。
Parameters | |
---|---|
n |
int : an index, where n>=0 |
Returns | |
---|---|
String |
the value of the n th header field or null if there are fewer than n+1 fields |
也可以看看:
long getHeaderFieldDate (String name, long Default)
返回解析为日期的命名字段的值。 结果是1970年1月1日以来的毫秒数,由命名字段表示。
这种形式的getHeaderField
存在,因为某些连接类型(例如, http-ng
)具有预解析的标头。 该连接类型的类可以覆盖此方法并短路解析。
Parameters | |
---|---|
name |
String : the name of the header field. |
Default |
long : a default value. |
Returns | |
---|---|
long |
the value of the field, parsed as a date. The value of the Default argument is returned if the field is missing or malformed. |
int getHeaderFieldInt (String name, int Default)
返回解析为数字的命名字段的值。
这种形式的getHeaderField
存在,因为某些连接类型(例如, http-ng
)具有预解析的标头。 该连接类型的类可以覆盖此方法并短路解析。
Parameters | |
---|---|
name |
String : the name of the header field. |
Default |
int : the default value. |
Returns | |
---|---|
int |
the value of the named field, parsed as an integer. The Default value is returned if the field is missing or malformed. |
String getHeaderFieldKey (int n)
返回第n
个标题字段的密钥。 如果少于n+1
字段,它将返回null
。
Parameters | |
---|---|
n |
int : an index, where n>=0 |
Returns | |
---|---|
String |
the key for the n th header field, or null if there are fewer than n+1 fields. |
long getHeaderFieldLong (String name, long Default)
返回解析为数字的命名字段的值。
这种形式的getHeaderField
存在,因为某些连接类型(例如, http-ng
)具有预解析的标头。 该连接类型的类可以覆盖此方法并短路解析。
Parameters | |
---|---|
name |
String : the name of the header field. |
Default |
long : the default value. |
Returns | |
---|---|
long |
the value of the named field, parsed as a long. The Default value is returned if the field is missing or malformed. |
Map<String, List<String>> getHeaderFields ()
返回标题字段的不可修改的映射。 Map键是表示响应头字段名称的字符串。 每个Map值都是一个不可修改的字符串列表,表示相应的字段值。
Returns | |
---|---|
Map<String, List<String>> |
a Map of header fields |
long getIfModifiedSince ()
返回此对象的 ifModifiedSince
字段的值。
Returns | |
---|---|
long |
the value of this object's ifModifiedSince field. |
也可以看看:
InputStream getInputStream ()
返回从此打开的连接读取的输入流。 如果读取超时在数据可供读取之前到期,则从返回的输入流读取时可能会抛出SocketTimeoutException。
Returns | |
---|---|
InputStream |
an input stream that reads from this open connection. |
Throws | |
---|---|
IOException |
if an I/O error occurs while creating the input stream. |
UnknownServiceException |
if the protocol does not support input. |
long getLastModified ()
返回last-modified
标题字段的值。 结果是格林威治标准时间1970年1月1日以来的毫秒数。
Returns | |
---|---|
long |
the date the resource referenced by this URLConnection was last modified, or 0 if not known. |
OutputStream getOutputStream ()
返回写入此连接的输出流。
Returns | |
---|---|
OutputStream |
an output stream that writes to this connection. |
Throws | |
---|---|
IOException |
if an I/O error occurs while creating the output stream. |
UnknownServiceException |
if the protocol does not support output. |
Permission getPermission ()
返回一个权限对象,表示建立由此对象表示的连接所需的权限。 如果不需要许可来建立连接,则此方法返回null。 默认情况下,此方法返回java.security.AllPermission
。 子类应该重写此方法并返回最能表示与URL建立连接所需权限的权限。 例如, URLConnection
表示file:
URL将返回java.io.FilePermission
对象。
返回的权限可能取决于连接的状态。 例如,连接前的权限可能与连接后的权限不同。 例如,一个HTTP服务器,比如说foo.com,可能会将连接重定向到不同的主机,比如bar.com。 在连接之前,连接返回的权限将表示连接到foo.com所需的权限,而连接后返回的权限将返回到bar.com。
权限通常用于两个目的:保护通过URLConnections获得的对象的缓存,并检查收件人是否有权了解特定的URL。 在第一种情况下,应在获得对象后获得许可。 例如,在HTTP连接中,这将代表连接到最终从中获取数据的主机的权限。 在第二种情况下,连接之前应该获得并测试许可。
Returns | |
---|---|
Permission |
the permission object representing the permission necessary to make the connection represented by this URLConnection. |
Throws | |
---|---|
IOException |
if the computation of the permission requires network or file I/O and an exception occurs while computing it. |
int getReadTimeout ()
返回读取超时的设置。 0返回意味着该选项被禁用(即无限超时)。
Returns | |
---|---|
int |
an int that indicates the read timeout value in milliseconds |
也可以看看:
Map<String, List<String>> getRequestProperties ()
返回此连接的一般请求属性的不可修改的映射。 Map键是表示请求头字段名称的字符串。 每个Map值都是一个不可修改的字符串列表,表示相应的字段值。
Returns | |
---|---|
Map<String, List<String>> |
a Map of the general request properties for this connection. |
Throws | |
---|---|
IllegalStateException |
if already connected |
String getRequestProperty (String key)
返回此连接的指定常规请求属性的值。
Parameters | |
---|---|
key |
String : the keyword by which the request is known (e.g., "Accept"). |
Returns | |
---|---|
String |
the value of the named general request property for this connection. If key is null, then null is returned. |
Throws | |
---|---|
IllegalStateException |
if already connected |
URL getURL ()
返回此 URLConnection
的 URL
字段的值。
Returns | |
---|---|
URL |
the value of this URLConnection 's URL field. |
也可以看看:
boolean getUseCaches ()
返回此 URLConnection
的 useCaches
字段的值。
Returns | |
---|---|
boolean |
the value of this URLConnection 's useCaches field. |
也可以看看:
String guessContentTypeFromName (String fname)
尝试根据URL的指定“文件”组件确定对象的内容类型。 这是一种方便的方法,可以被覆盖getContentType
方法的子类使用。
Parameters | |
---|---|
fname |
String : a filename. |
Returns | |
---|---|
String |
a guess as to what the content type of the object is, based upon its file name. |
也可以看看:
String guessContentTypeFromStream (InputStream is)
尝试根据输入流开始处的字符确定输入流的类型。 该方法可以被覆盖getContentType
方法的子类使用。
理想情况下,这个例程不需要。 但许多http
服务器返回不正确的内容类型; 另外,还有很多非标准的扩展。 直接检查字节以确定内容类型通常比相信http
服务器声明的内容类型更准确。
Parameters | |
---|---|
is |
InputStream : an input stream that supports marks. |
Returns | |
---|---|
String |
a guess at the content type, or null if none can be determined. |
Throws | |
---|---|
IOException |
if an I/O error occurs while reading the input stream. |
void setAllowUserInteraction (boolean allowuserinteraction)
设置此 URLConnection
的 allowUserInteraction
字段的 URLConnection
。
Parameters | |
---|---|
allowuserinteraction |
boolean : the new value. |
Throws | |
---|---|
IllegalStateException |
if already connected |
也可以看看:
void setConnectTimeout (int timeout)
设置打开到此URLConnection引用的资源的通信链接时要使用的指定超时值(以毫秒为单位)。 如果在建立连接之前超时到期,则会引发java.net.SocketTimeoutException。 超时为零被解释为无限超时。
此方法的某些非标准暗示可能会忽略指定的超时。 要查看连接超时设置,请调用getConnectTimeout()。
Parameters | |
---|---|
timeout |
int : an int that specifies the connect timeout value in milliseconds |
Throws | |
---|---|
IllegalArgumentException |
if the timeout parameter is negative |
也可以看看:
void setContentHandlerFactory (ContentHandlerFactory fac)
设置应用程序的ContentHandlerFactory
。 它最多只能由应用程序调用一次。
ContentHandlerFactory
实例用于从内容类型构建内容处理程序
如果有安全管理器,则此方法首先调用安全管理器的方法checkSetFactory
以确保允许操作。 这可能会导致SecurityException。
Parameters | |
---|---|
fac |
ContentHandlerFactory : the desired factory. |
Throws | |
---|---|
Error |
if the factory has already been defined. |
SecurityException |
if a security manager exists and its checkSetFactory method doesn't allow the operation. |
void setDefaultAllowUserInteraction (boolean defaultallowuserinteraction)
将所有将来的 URLConnection
对象的 allowUserInteraction
字段的默认值设置为指定的值。
Parameters | |
---|---|
defaultallowuserinteraction |
boolean : the new value. |
void setDefaultRequestProperty (String key, String value)
此方法在API级别1中已弃用。
应该在获得URLConnection的适当实例后使用特定于实例的setRequestProperty方法。 调用此方法将不起作用。
设置一般请求属性的默认值。 当创建URLConnection
,它将使用这些属性进行初始化。
Parameters | |
---|---|
key |
String : the keyword by which the request is known (e.g., "Accept "). |
value |
String : the value associated with the key. |
void setDefaultUseCaches (boolean defaultusecaches)
将 useCaches
字段的默认值设置为指定的值。
Parameters | |
---|---|
defaultusecaches |
boolean : the new value. |
也可以看看:
void setDoInput (boolean doinput)
将此 URLConnection
的 doInput
字段的值设置为指定的值。
URL连接可用于输入和/或输出。 如果您打算使用URL连接进行输入,请将DoInput标志设置为true,否则设置为false。 默认值是true。
Parameters | |
---|---|
doinput |
boolean : the new value. |
Throws | |
---|---|
IllegalStateException |
if already connected |
也可以看看:
void setDoOutput (boolean dooutput)
将此 URLConnection
的 doOutput
字段的值设置为指定的值。
URL连接可用于输入和/或输出。 如果您打算使用URL连接输出,请将DoOutput标志设置为true,否则设置为false。 默认值是false。
Parameters | |
---|---|
dooutput |
boolean : the new value. |
Throws | |
---|---|
IllegalStateException |
if already connected |
也可以看看:
void setFileNameMap (FileNameMap map)
设置FileNameMap。
如果有安全管理器,则此方法首先调用安全管理器的方法checkSetFactory
以确保允许操作。 这可能会导致SecurityException。
Parameters | |
---|---|
map |
FileNameMap : the FileNameMap to be set |
Throws | |
---|---|
SecurityException |
if a security manager exists and its checkSetFactory method doesn't allow the operation. |
void setIfModifiedSince (long ifmodifiedsince)
将此 URLConnection
的 ifModifiedSince
字段的值设置为指定的值。
Parameters | |
---|---|
ifmodifiedsince |
long : the new value. |
Throws | |
---|---|
IllegalStateException |
if already connected |
也可以看看:
void setReadTimeout (int timeout)
将读取超时设置为指定的超时,以毫秒为单位。 非零值指定在连接建立到资源时从输入流读取时的超时时间。 如果在有数据可供读取之前超时到期,则会引发java.net.SocketTimeoutException。 超时为零被解释为无限超时。
此方法的某些非标准实现会忽略指定的超时。 要查看读取超时设置,请调用getReadTimeout()。
Parameters | |
---|---|
timeout |
int : an int that specifies the timeout value to be used in milliseconds |
Throws | |
---|---|
IllegalArgumentException |
if the timeout parameter is negative |
也可以看看:
void setRequestProperty (String key, String value)
设置一般请求属性。 如果具有密钥的属性已存在,则用新值覆盖其值。
注:HTTP需要所有请求属性,这些属性可以合法地使用同一个键具有多个实例,以使用逗号分隔列表语法,从而可以将多个属性添加到单个属性中。
Parameters | |
---|---|
key |
String : the keyword by which the request is known (e.g., "Accept "). |
value |
String : the value associated with it. |
Throws | |
---|---|
IllegalStateException |
if already connected |
NullPointerException |
if key is null |
void setUseCaches (boolean usecaches)
将此 URLConnection
的 useCaches
字段的值设置为指定的值。
有些协议会缓存文档。 偶尔,能够“隧道”并忽略缓存(例如浏览器中的“重新加载”按钮)非常重要。 如果连接上的UseCaches标志为真,则允许连接使用它可以使用的任何缓存。 如果为false,则高速缓存将被忽略。 默认值来自DefaultUseCaches,默认值为true。
Parameters | |
---|---|
usecaches |
boolean : a boolean indicating whether or not to allow caching |
Throws | |
---|---|
IllegalStateException |
if already connected |
也可以看看:
String toString ()
返回此URL连接的 String
表示形式。
Returns | |
---|---|
String |
a string representation of this URLConnection . |