Most visited

Recently visited

Added in API level 1

URLConnection

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.
---------------------------->
time
  1. The connection object is created by invoking the openConnection method on a URL.
  2. The setup parameters and general request properties are manipulated.
  3. The actual connection to the remote object is made, using the connect method.
  4. The remote object becomes available. The header fields and the contents of the remote object can be accessed.

使用以下方法修改设置参数:

并使用以下方法修改常规请求属性:

AllowUserInteractionUseCaches参数的默认值可以使用方法 setDefaultAllowUserInteractionsetDefaultUseCaches进行设置。

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

连接到远程对象后,使用以下方法访问标题字段和内容:

某些标题字段经常被访问。 方法:

提供方便的访问这些领域。 getContentType方法使用getContent方法确定远程对象的类型; 子类可能会发现覆盖getContentType方法很方便。

在通常情况下,所有预连接参数和常规请求属性都可以忽略:预连接参数和请求属性默认为合理值。 对于这个接口的大多数客户来说,只有两个有趣的方法: getInputStreamgetContent ,它们通过便利方法在URL类中镜像。

有关 http连接的请求属性和标题字段的更多信息,请访问:

 http://www.ietf.org/rfc/rfc2616.txt
 
Note about 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.

也可以看看:

Summary

Fields

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 ,则只要协议可以,就允许协议使用缓存。

Protected constructors

URLConnection(URL url)

构造到指定URL的URL连接。

Public methods

void addRequestProperty(String key, String value)

添加由键值对指定的常规请求属性。

abstract void connect()

如果此连接尚未建立,则打开通向该URL所引用资源的通信链接。

boolean getAllowUserInteraction()

返回此对象的 allowUserInteraction字段的值。

int getConnectTimeout()

返回连接超时的设置。

Object getContent()

检索此URL连接的内容。

Object getContent(Class[] classes)

检索此URL连接的内容。

String getContentEncoding()

返回 content-encoding标题字段的值。

int getContentLength()

返回 content-length标题字段的值。

long getContentLengthLong()

作为long返回 content-length标题字段的值。

String getContentType()

返回 content-type标题字段的值。

long getDate()

返回 date标题字段的值。

static boolean getDefaultAllowUserInteraction()

返回 allowUserInteraction字段的默认值。

static String getDefaultRequestProperty(String key)

此方法在API级别1中已弃用。应在获得URLConnection的相应实例后使用特定于实例的getRequestProperty方法。

boolean getDefaultUseCaches()

返回 URLConnectionuseCaches标志的默认值。

boolean getDoInput()

返回此 URLConnectiondoInput标志的值。

boolean getDoOutput()

返回此 URLConnectiondoOutput标志的值。

long getExpiration()

返回 expires标题字段的值。

static FileNameMap getFileNameMap()

从数据文件加载文件名映射(一个mimetable)。

String getHeaderField(String name)

返回指定标题字段的值。

String getHeaderField(int n)

返回第 n 标题字段的值。

long getHeaderFieldDate(String name, long Default)

返回解析为日期的命名字段的值。

int getHeaderFieldInt(String name, int Default)

返回解析为数字的命名字段的值。

String getHeaderFieldKey(int n)

返回第 n 标题字段的密钥。

long getHeaderFieldLong(String name, long Default)

返回解析为数字的命名字段的值。

Map<StringList<String>> getHeaderFields()

返回标题字段的不可修改的映射。

long getIfModifiedSince()

返回此对象的 ifModifiedSince字段的值。

InputStream getInputStream()

返回从此打开的连接读取的输入流。

long getLastModified()

返回 last-modified标题字段的值。

OutputStream getOutputStream()

返回写入此连接的输出流。

Permission getPermission()

返回一个权限对象,表示建立由此对象表示的连接所需的权限。

int getReadTimeout()

返回读取超时的设置。

Map<StringList<String>> getRequestProperties()

返回此连接的一般请求属性的不可修改的映射。

String getRequestProperty(String key)

返回此连接的指定常规请求属性的值。

URL getURL()

返回此 URLConnectionURL字段的值。

boolean getUseCaches()

返回此 URLConnectionuseCaches字段的值。

static String guessContentTypeFromName(String fname)

尝试根据URL的指定“文件”组件确定对象的内容类型。

static String guessContentTypeFromStream(InputStream is)

尝试根据输入流开始处的字符确定输入流的类型。

void setAllowUserInteraction(boolean allowuserinteraction)

设置此 URLConnectionallowUserInteraction字段的 URLConnection

void setConnectTimeout(int timeout)

设置打开到此URLConnection引用的资源的通信链接时要使用的指定超时值(以毫秒为单位)。

static void setContentHandlerFactory(ContentHandlerFactory fac)

设置应用程序的 ContentHandlerFactory

static void setDefaultAllowUserInteraction(boolean defaultallowuserinteraction)

将所有将来的 URLConnection对象的 allowUserInteraction字段的默认值设置为指定值。

static void setDefaultRequestProperty(String key, String value)

此方法在API级别1中已弃用。在获得URLConnection的相应实例后应使用特定于实例的setRequestProperty方法。 调用此方法将不起作用。

void setDefaultUseCaches(boolean defaultusecaches)

useCaches字段的默认值设置为指定的值。

void setDoInput(boolean doinput)

将此 URLConnectiondoInput字段的值设置为指定的值。

void setDoOutput(boolean dooutput)

将此 URLConnectiondoOutput字段的值设置为指定的值。

static void setFileNameMap(FileNameMap map)

设置FileNameMap。

void setIfModifiedSince(long ifmodifiedsince)

将此 URLConnectionifModifiedSince字段的值设置为指定值。

void setReadTimeout(int timeout)

将读取超时设置为指定的超时,以毫秒为单位。

void setRequestProperty(String key, String value)

设置一般请求属性。

void setUseCaches(boolean usecaches)

将此 URLConnectionuseCaches字段的值设置为指定的值。

String toString()

返回此URL连接的 String表示形式。

Inherited methods

From class java.lang.Object

Fields

allowUserInteraction

Added in API level 1
boolean allowUserInteraction

如果是true ,那么这个URL正在被允许进行用户交互的情况下进行检查,例如弹出认证对话框。 如果false ,则不允许用户交互。

该字段的值可以通过setAllowUserInteraction方法设置。 它的值由getAllowUserInteraction方法返回。 其默认值是上次调用setDefaultAllowUserInteraction方法时参数的值。

也可以看看:

connected

Added in API level 1
boolean connected

如果为false ,则此连接对象尚未创建指向指定URL的通信链接。 如果true ,通信链路已建立。

doInput

Added in API level 1
boolean doInput

该变量由setDoInput方法设置。 它的值由getDoInput方法返回。

URL连接可用于输入和/或输出。 doInput标志设置为true表示应用程序打算从URL连接读取数据。

该字段的默认值是 true

也可以看看:

doOutput

Added in API level 1
boolean doOutput

该变量由setDoOutput方法设置。 它的值由getDoOutput方法返回。

URL连接可用于输入和/或输出。 doOutput标志设置为true表示应用程序打算将数据写入URL连接。

该字段的默认值是 false

也可以看看:

ifModifiedSince

Added in API level 1
long ifModifiedSince

某些协议支持跳过对象的提取,除非该对象比某个时间更近被修改。

非零值给出的时间是自1970年1月1日GMT以来的毫秒数。 仅当该对象的修改时间比该时间更晚时才被提取。

该变量由setIfModifiedSince方法设置。 它的值由getIfModifiedSince方法返回。

此字段的默认值为 0 ,表示必须始终发生抓取。

也可以看看:

url

Added in API level 1
URL url

URL表示打开此连接的万维网上的远程对象。

该字段的值可以通过 getURL方法访问。

此变量的默认值是 URLConnection构造函数中的URL参数的值。

也可以看看:

useCaches

Added in API level 1
boolean useCaches

如果是true ,则只要协议可以,就允许协议使用缓存。 如果false ,协议必须总是尝试获取对象的新副本。

该字段由setUseCaches方法设置。 它的值由getUseCaches方法返回。

其默认值是上次调用 setDefaultUseCaches方法时给出的值。

也可以看看:

Protected constructors

URLConnection

Added in API level 1
URLConnection (URL url)

构造到指定URL的URL连接。 不会创建到由URL引用的对象的连接。

Parameters
url URL: the specified URL.

Public methods

addRequestProperty

Added in API level 1
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

也可以看看:

connect

Added in API level 1
void connect ()

如果此连接尚未建立,则打开通向该URL所引用资源的通信链接。

如果在连接已打开时调用 connect方法(由具有值 trueconnected字段 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.

也可以看看:

getAllowUserInteraction

Added in API level 1
boolean getAllowUserInteraction ()

返回此对象的 allowUserInteraction字段的值。

Returns
boolean the value of the allowUserInteraction field for this object.

也可以看看:

getConnectTimeout

Added in API level 1
int getConnectTimeout ()

返回连接超时的设置。

0返回意味着该选项被禁用(即无限超时)。

Returns
int an int that indicates the connect timeout value in milliseconds

也可以看看:

getContent

Added in API level 1
Object getContent ()

检索此URL连接的内容。

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

  1. If the application has set up a content handler factory instance using the 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.
  2. If no content handler factory has yet been set up, or if the factory's createContentHandler method returns null, then the application loads the class named:
             sun.net.www.content.<contentType>
         
    where <contentType> is formed by taking the content-type string, replacing all slash characters with a 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.

也可以看看:

getContent

Added in API level 1
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.

也可以看看:

getContentEncoding

Added in API level 1
String getContentEncoding ()

返回 content-encoding标题字段的值。

Returns
String the content encoding of the resource that the URL references, or null if not known.

也可以看看:

getContentLength

Added in API level 1
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.

getContentLengthLong

Added in API level 24
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.

getContentType

Added in API level 1
String getContentType ()

返回 content-type标题字段的值。

Returns
String the content type of the resource that the URL references, or null if not known.

也可以看看:

getDate

Added in API level 1
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.

也可以看看:

getDefaultAllowUserInteraction

Added in API level 1
boolean getDefaultAllowUserInteraction ()

返回 allowUserInteraction字段的默认值。

默认情况下是“粘性”,是所有URLConnections的静态状态的一部分。 此标志适用于下一个以及所有已创建的URLConnections。

Returns
boolean the default value of the allowUserInteraction field.

也可以看看:

getDefaultRequestProperty

Added in API level 1
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.

也可以看看:

getDefaultUseCaches

Added in API level 1
boolean getDefaultUseCaches ()

返回 URLConnectionuseCaches标志的默认值。

默认情况下是“粘性”,是所有URLConnections的静态状态的一部分。 此标志适用于下一个以及所有已创建的URLConnections。

Returns
boolean the default value of a URLConnection's useCaches flag.

也可以看看:

getDoInput

Added in API level 1
boolean getDoInput ()

返回此 URLConnectiondoInput标志的值。

Returns
boolean the value of this URLConnection's doInput flag.

也可以看看:

getDoOutput

Added in API level 1
boolean getDoOutput ()

返回此 URLConnectiondoOutput标志的值。

Returns
boolean the value of this URLConnection's doOutput flag.

也可以看看:

getExpiration

Added in API level 1
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.

也可以看看:

getFileNameMap

Added in API level 1
FileNameMap getFileNameMap ()

从数据文件加载文件名映射(一个mimetable)。 它将首先尝试加载由“content.types.user.table”属性定义的用户特定表。 如果失败,它会尝试在java home下的lib / content-types.properties中加载默认的内置表。

Returns
FileNameMap the FileNameMap

也可以看看:

getHeaderField

Added in API level 1
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.

getHeaderField

Added in API level 1
String getHeaderField (int n)

返回第n 标题字段的值。 如果少于n+1字段,则返回null

此方法可以与 getHeaderFieldKey方法一起使用,以迭代消息中的所有标题。

Parameters
n int: an index, where n>=0
Returns
String the value of the nth header field or null if there are fewer than n+1 fields

也可以看看:

getHeaderFieldDate

Added in API level 1
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.

getHeaderFieldInt

Added in API level 1
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.

getHeaderFieldKey

Added in API level 1
String getHeaderFieldKey (int n)

返回第n 标题字段的密钥。 如果少于n+1字段,它将返回null

Parameters
n int: an index, where n>=0
Returns
String the key for the nth header field, or null if there are fewer than n+1 fields.

getHeaderFieldLong

Added in API level 24
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.

getHeaderFields

Added in API level 1
Map<StringList<String>> getHeaderFields ()

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

Returns
Map<StringList<String>> a Map of header fields

getIfModifiedSince

Added in API level 1
long getIfModifiedSince ()

返回此对象的 ifModifiedSince字段的值。

Returns
long the value of this object's ifModifiedSince field.

也可以看看:

getInputStream

Added in API level 1
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.

也可以看看:

getLastModified

Added in API level 1
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.

也可以看看:

getOutputStream

Added in API level 1
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.

getPermission

Added in API level 1
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.

getReadTimeout

Added in API level 1
int getReadTimeout ()

返回读取超时的设置。 0返回意味着该选项被禁用(即无限超时)。

Returns
int an int that indicates the read timeout value in milliseconds

也可以看看:

getRequestProperties

Added in API level 1
Map<StringList<String>> getRequestProperties ()

返回此连接的一般请求属性的不可修改的映射。 Map键是表示请求头字段名称的字符串。 每个Map值都是一个不可修改的字符串列表,表示相应的字段值。

Returns
Map<StringList<String>> a Map of the general request properties for this connection.
Throws
IllegalStateException if already connected

getRequestProperty

Added in API level 1
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

也可以看看:

getURL

Added in API level 1
URL getURL ()

返回此 URLConnectionURL字段的值。

Returns
URL the value of this URLConnection's URL field.

也可以看看:

getUseCaches

Added in API level 1
boolean getUseCaches ()

返回此 URLConnectionuseCaches字段的值。

Returns
boolean the value of this URLConnection's useCaches field.

也可以看看:

guessContentTypeFromName

Added in API level 1
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.

也可以看看:

guessContentTypeFromStream

Added in API level 1
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.

也可以看看:

setAllowUserInteraction

Added in API level 1
void setAllowUserInteraction (boolean allowuserinteraction)

设置此 URLConnectionallowUserInteraction字段的 URLConnection

Parameters
allowuserinteraction boolean: the new value.
Throws
IllegalStateException if already connected

也可以看看:

setConnectTimeout

Added in API level 1
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

也可以看看:

setContentHandlerFactory

Added in API level 1
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.

也可以看看:

setDefaultAllowUserInteraction

Added in API level 1
void setDefaultAllowUserInteraction (boolean defaultallowuserinteraction)

将所有将来的 URLConnection对象的 allowUserInteraction字段的默认值设置为指定的值。

Parameters
defaultallowuserinteraction boolean: the new value.

也可以看看:

setDefaultRequestProperty

Added in API level 1
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.

也可以看看:

setDefaultUseCaches

Added in API level 1
void setDefaultUseCaches (boolean defaultusecaches)

useCaches字段的默认值设置为指定的值。

Parameters
defaultusecaches boolean: the new value.

也可以看看:

setDoInput

Added in API level 1
void setDoInput (boolean doinput)

将此 URLConnectiondoInput字段的值设置为指定的值。

URL连接可用于输入和/或输出。 如果您打算使用URL连接进行输入,请将DoInput标志设置为true,否则设置为false。 默认值是true。

Parameters
doinput boolean: the new value.
Throws
IllegalStateException if already connected

也可以看看:

setDoOutput

Added in API level 1
void setDoOutput (boolean dooutput)

将此 URLConnectiondoOutput字段的值设置为指定的值。

URL连接可用于输入和/或输出。 如果您打算使用URL连接输出,请将DoOutput标志设置为true,否则设置为false。 默认值是false。

Parameters
dooutput boolean: the new value.
Throws
IllegalStateException if already connected

也可以看看:

setFileNameMap

Added in API level 1
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.

也可以看看:

setIfModifiedSince

Added in API level 1
void setIfModifiedSince (long ifmodifiedsince)

将此 URLConnectionifModifiedSince字段的值设置为指定的值。

Parameters
ifmodifiedsince long: the new value.
Throws
IllegalStateException if already connected

也可以看看:

setReadTimeout

Added in API level 1
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

也可以看看:

setRequestProperty

Added in API level 1
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

也可以看看:

setUseCaches

Added in API level 1
void setUseCaches (boolean usecaches)

将此 URLConnectionuseCaches字段的值设置为指定的值。

有些协议会缓存文档。 偶尔,能够“隧道”并忽略缓存(例如浏览器中的“重新加载”按钮)非常重要。 如果连接上的UseCaches标志为真,则允许连接使用它可以使用的任何缓存。 如果为false,则高速缓存将被忽略。 默认值来自DefaultUseCaches,默认值为true。

Parameters
usecaches boolean: a boolean indicating whether or not to allow caching
Throws
IllegalStateException if already connected

也可以看看:

toString

Added in API level 1
String toString ()

返回此URL连接的 String表示形式。

Returns
String a string representation of this URLConnection.

Hooray!