javatm platform
standard ed. 6

java.net
类 httpurlconnection

java.lang.object 继承者 java.net.urlconnection 继承者 java.net.httpurlconnection
直接已知子类:
httpsurlconnection

public abstract class httpurlconnection
extends urlconnection

支持【zhī chí】 http 特定功能的 urlconnection。有关详细小緎ense】畔ⅲ氩卧 the spec

每个 httpurlconnection 实例都可用于生成单个请求,但是【dàn shì】其他【other】实例可以【can】透明地共享连接到 http 服务【services】器的基础网络。请求后在 httpurlconnection 的 inputstream 或 outputstream 上调用 close() 方法可以【can】释放与此实例关联的网络资源,但对共享的持久连接没有任何影响。如果在调用 disconnect() 时持久连接空闲,则可能【kě néng】关闭基础套接字。

从以下版本开始【kāi shǐ】:
jdk1.1
另请参见:
disconnect()

js随机数
字段摘要
protected  intchunklength
          使用存储块编码流模式进行输出时的存储块长度【attitudes】。
protected  intfixedcontentlength
          使用固定长度【attitudes】流模式时的固定内容长度。
static inthttp_accepted
          http 状态码 202:accepted。
static inthttp_bad_gateway
          http 状态码 502:bad gateway。
static inthttp_bad_method
          http 状态码 405:method not allowed。
static inthttp_bad_request
          http 状态码 400:bad request。
static inthttp_client_timeout
          http 状态码 408:request time-out。
static inthttp_conflict
          http 状态码 409:conflict。
static inthttp_created
          http 状态码 201:created。
static inthttp_entity_too_large
          http 状态码 413:request entity too large。
static inthttp_forbidden
          http 状态码 403:forbidden。
static inthttp_gateway_timeout
          http 状态码 504:gateway timeout。
static inthttp_gone
          http 状态码 410:gone。
static inthttp_internal_error
          http 状态码 500:internal server error。
static inthttp_length_required
          http 状态码 411:length required。
static inthttp_moved_perm
          http 状态码 301:moved permanently。
static inthttp_moved_temp
          http 状态码 302:temporary redirect。
static inthttp_mult_choice
          http 状态码 300:multiple choices。
static inthttp_no_content
          http 状态码 204:no content。
static inthttp_not_acceptable
          http 状态码 406:not acceptable。
static inthttp_not_authoritative
          http 状态码 203:non-authoritative information。
static inthttp_not_found
          http 状态码 404:not found。
static inthttp_not_implemented
          http 状态码 501:not implemented。
static inthttp_not_modified
          http 状态码 304:not modified。
static inthttp_ok
          http 状态码 200:ok。
static inthttp_partial
          http 状态码 206:partial content。
static inthttp_payment_required
          http 状态码 402:payment required。
static inthttp_precon_failed
          http 状态码 412:precondition failed。
static inthttp_proxy_auth
          http 状态码 407:proxy authentication required。
static inthttp_req_too_long
          http 状态码 414:request-uri too large。
static inthttp_reset
          http 状态码 205:reset content。
static inthttp_see_other
          http 状态码 303:see other。
static inthttp_server_error
          已过时。 放错了位置【wèi zhi】,它不应该【yīng gāi】存在。
static inthttp_unauthorized
          http 状态码 401:unauthorized。
static inthttp_unavailable
          http 状态码 503:service unavailable。
static inthttp_unsupported_type
          http 状态码 415:unsupported media type。
static inthttp_use_proxy
          http 状态码 305:use proxy。
static inthttp_version
          http 状态码 505:http version not supported。
protected  booleaninstancefollowredirects
          如果为 true,则协议自动执行重定向。
protected  stringmethod
          http 方法(get、post、put 等)。
protected  intresponsecode
          表示三位字数的 http 状态码 (status-code) 的 int
protected  stringresponsemessage
          http 响应消息。
 
从类 java.net.urlconnection 继承的字段
allowuserinteraction, connected, doinput, dooutput, ifmodifiedsince, url, usecaches
 
构造方法摘要
protected httpurlconnection(url u)
          httpurlconnection 的构造方法。
 
方法摘要
abstract  voiddisconnect()
          指示近期服务【services】器不太可能【kě néng】有其他【other】请求。
 inputstreamgeterrorstream()
          如果连接失败但服务器仍然发送了有用数据,则返回错误流。
static booleangetfollowredirects()
          返回指示是否应该【yīng gāi】自动执行 http 重定向 (3xx) 的 boolean 值。
 stringgetheaderfield(int n)
          返回 nth 头字段的值。
 longgetheaderfielddate(string name,long default)
          返回解析为日期的指定字段的值。
 stringgetheaderfieldkey(int n)
          返回 nth 头字段的键。
 booleangetinstancefollowredirects()
          返回此 httpurlconnectioninstancefollowredirects 字段的值。
 permissiongetpermission()
          返回一个权限对象,其代表建立此对象表示的连接所需的权限。
 stringgetrequestmethod()
          获取请求方法。
 intgetresponsecode()
          从 http 响应消息获取状态码。
 stringgetresponsemessage()
          获取与来自服务器的响应代码一起【with】返回的 http 响应消息(如果有)。
 voidsetchunkedstreamingmode(int chunklen)
          此方法用于在预先知道【zhī dao】内容长度时启用没有进行内部缓冲的 http 请求正文的流。
 voidsetfixedlengthstreamingmode(int contentlength)
          此方法用于在预先已知内容长度时启用没有进行内部缓冲的 http 请求正文的流。
static voidsetfollowredirects(boolean set)
          设置此类是否应该自动执行 http 重定向(响应代码为 3xx 的请求)。
 voidsetinstancefollowredirects(boolean followredirects)
          设置此 httpurlconnection 实例是否应该自动执行 http 重定向(响应代码为 3xx 的请求)。
 voidsetrequestmethod(string method)
          设置 url 请求的方法,getpostheadoptionsputdeletetrace以上方法之一是合法的,具体取决于协议的限制。
abstract  booleanusingproxy()
          指示连接是否通过代理。
 
从类 java.net.urlconnection 继承的方法
addrequestproperty, connect, getallowuserinteraction, getconnecttimeout, getcontent, getcontent, getcontentencoding, getcontentlength, getcontenttype, getdate, getdefaultallowuserinteraction, getdefaultrequestproperty, getdefaultusecaches, getdoinput, getdooutput, getexpiration, getfilenamemap, getheaderfield, getheaderfieldint, getheaderfields, getifmodifiedsince, getinputstream, getlastmodified, getoutputstream, getreadtimeout, getrequestproperties, getrequestproperty, geturl, getusecaches, guesscontenttypefromname, guesscontenttypefromstream, setallowuserinteraction, setconnecttimeout, setcontenthandlerfactory, setdefaultallowuserinteraction, setdefaultrequestproperty, setdefaultusecaches, setdoinput, setdooutput, setfilenamemap, setifmodifiedsince, setreadtimeout, setrequestproperty, setusecaches, tostring
 
从类 java.lang.object 继承的方法
clone, equals, finalize, getclass, hashcode, notify, notifyall, wait, wait, wait
 

字段详细信息

method

protected string method
http 方法(get、post、put 等)。


chunklength

protected int chunklength
使用存储块编码流模式进行输出时的存储块长度。值 -1 表示对输出禁用存储块编码。

从以下版本开始【kāi shǐ】:
1.5

fixedcontentlength

protected int fixedcontentlength
从千里之外的乌鲁木齐赶来看望亲戚的60多名自治区质量技术监督局、自治区纤维检验局的干部职工和甫甫克村140多名村民共同举行民族团结一家亲联谊活动。
14张圆桌上摆放着一盘盘瓜子和水果,这次联谊会,结对认亲的亲戚们同吃一锅抓饭,同登一个舞台,表演节目或者一起【with】做游戏。
绿化工程为口岸铺下了14.93万平方米的绿地,挺立在口岸道路、S309线两侧的防护林,好像礼宾员在列队迎接着每一位往来口岸的中外商贾和游客。
、【同期】(霍尔果斯经济【economic】开发【developing】区口岸管理【guǎn lǐ】局 局长 张敬寿)我们这个第六代国门,主要【zhǔ yào】是便于货物的出入境,特别是国务院提出的三户大通关,包括【bāo kuò】压缩通关时间这一块,我们通过这次建设【building】,把这些理念放进去,方便货物出入。
2010年至今,共组织实施了248项国际科技合作【cooperation】项目,从最初的农业、畜牧业、地震监测、矿产资源勘探等项目,拓展到如今的生物医药、先进装备、新能源等方面。
使用固定长度流模式时的固定内容长度。值 -1 表示对输出禁用固定长度流模式。

从以下版本开始:
1.5

responsecode

protected int responsecode
表示三位字数的 http 状态码 (status-code) 的 int


responsemessage

protected string responsemessage
http 响应消息。


instancefollowredirects

protected boolean instancefollowredirects
如果为 true,则协议自动执行重定向。如果为 false,则协议不会自动执行重定向。

此字段由 setinstancefollowredirects 方法设置。其值由 getinstancefollowredirects 方法返回。

其默认值基于构造 httpurlconnection 时静态 followredirects 的值。

另请参见:
setinstancefollowredirects(boolean),getinstancefollowredirects(),setfollowredirects(boolean)

http_ok

public static final int http_ok
http 状态码 200:ok。

另请参见:
常量字段值

http_created

public static final int http_created
http 状态码 201:created。

另请参见:
常量字段值

http_accepted

public static final int http_accepted
http 状态码 202:accepted。

另请参见:
常量字段值

http_not_authoritative

public static final int http_not_authoritative
http 状态码 203:non-authoritative information。

另请参见:
常量字段值

http_no_content

public static final int http_no_content
http 状态码 204:no content。

另请参见:
常量字段值

http_reset

public static final int http_reset
http 状态码 205:reset content。

另请参见:
常量字段值

http_partial

public static final int http_partial
http 状态码 206:partial content。

另请参见:
常量字段值

http_mult_choice

public static final int http_mult_choice
http 状态码 300:multiple choices。

另请参见:
常量字段值

http_moved_perm

public static final int http_moved_perm
http 状态码 301:moved permanently。

另请参见:
常量字段值

http_moved_temp

public static final int http_moved_temp
http 状态码 302:temporary redirect。

另请参见:
常量字段值

http_see_other

public static final int http_see_other
http 状态码 303:see other。

另请参见:
常量字段值

http_not_modified

public static final int http_not_modified
http 状态码 304:not modified。

另请参见:
常量字段值

http_use_proxy

public static final int http_use_proxy
http 状态码 305:use proxy。

另请参见:
常量字段值

http_bad_request

public static final int http_bad_request
http 状态码 400:bad request。

另请参见:
常量字段值

http_unauthorized

public static final int http_unauthorized
http 状态码 401:unauthorized。

另请参见:
常量字段值

http_payment_required

public static final int http_payment_required
http 状态码 402:payment required。

另请参见:
常量字段值

http_forbidden

public static final int http_forbidden
http 状态码 403:forbidden。

另请参见:
常量字段值

http_not_found

public static final int http_not_found
http 状态码 404:not found。

另请参见:
常量字段值

http_bad_method

public static final int http_bad_method
http 状态码 405:method not allowed。

另请参见:
常量字段值

http_not_acceptable

public static final int http_not_acceptable
http 状态码 406:not acceptable。

另请参见:
常量字段值

http_proxy_auth

public static final int http_proxy_auth
http 状态码 407:proxy authentication required。

另请参见:
常量字段值

http_client_timeout

public static final int http_client_timeout
http 状态码 408:request time-out。

另请参见:
常量字段值

http_conflict

public static final int http_conflict
http 状态码 409:conflict。

另请参见:
常量字段值

http_gone

public static final int http_gone
http 状态码 410:gone。

另请参见:
常量字段值

http_length_required

public static final int http_length_required
http 状态码 411:length required。

另请参见:
常量字段值

http_precon_failed

public static final int http_precon_failed
http 状态码 412:precondition failed。

另请参见:
常量字段值

http_entity_too_large

public static final int http_entity_too_large
http 状态码 413:request entity too large。

另请参见:
常量字段值

http_req_too_long

public static final int http_req_too_long
http 状态码 414:request-uri too large。

另请参见:
常量字段值

http_unsupported_type

public static final int http_unsupported_type
http 状态码 415:unsupported media type。

另请参见:
常量字段值

http_server_error

@deprecatedpublic static final int http_server_error
已过时。 放错了位置【wèi zhi】,它不应该存在。
http 状态码 500:internal server error。

另请参见:
常量字段值

http_internal_error

public static final int http_internal_error
http 状态码 500:internal server error。

另请参见:
常量字段值

http_not_implemented

public static final int http_not_implemented
http 状态码 501:not implemented。

另请参见:
常量字段值

http_bad_gateway

public static final int http_bad_gateway
http 状态码 502:bad gateway。

另请参见:
常量字段值

http_unavailable

public static final int http_unavailable
http 状态码 503:service unavailable。

另请参见:
常量字段值

http_gateway_timeout

public static final int http_gateway_timeout
http 状态码 504:gateway timeout。

另请参见:
常量字段值

http_version

public static final int http_version
http 状态码 505:http version not supported。

另请参见:
常量字段值
构造方法详细信息

httpurlconnection

protected httpurlconnection(url u)
httpurlconnection 的构造方法。

参数:
u - url
方法详细信息

getheaderfieldkey

public string getheaderfieldkey(int n)
返回 nth 头字段的键。有些实现可能将 0th 头字段视为特殊状态行,即由 http 服务器返回的状态行。在此情况下,getheaderfield(0) 返回状态行,而 getheaderfieldkey(0) 返回 null。

覆盖:
urlconnection 中的 getheaderfieldkeyjs随机数
参数:
n - 索引,其中 n >=0。
返回:
nth 头字段的键;如果键不存在,则返回 null

setfixedlengthstreamingmode

public void setfixedlengthstreamingmode(int contentlength)
此方法用于在预先已知内容长度时启用没有进行内部缓冲的 http 请求正文的流。

如果应用程序尝试写入的数据多于指示的内容长度,或者应用程序在写入指示的内容长度前关闭了 outputstream,将抛出异常。

启用输出流时,不能自动处理验证和重定向。如果需要验证和重定向,则在读取响应时将抛出 httpretryexception。可以查询此异常以获取错误的详细信息。

该方法必须在连接 urlconnection 前调用。

参数:
contentlength - 将写入 outputstream 的字节数。
抛出:
illegalstateexception - 如果已连接 urlconnection 或者已启用另外的流模式。
illegalargumentexception - 如果指定的内容长度小于零。
从以下版本开始:
1.5
另请参见:
setchunkedstreamingmode(int)

setchunkedstreamingmode

public void setchunkedstreamingmode(int chunklen)
此方法用于在预先知道【zhī dao】内容长度时启用没有进行内部缓冲的 http 请求正文的流。在此模式下,使用存储块传输编码发送请求正文。注意【危险信号】,并非所有【all】 http 服务器都支持【zhī chí】此模式。

启用输出流时,不能自动处理验证和重定向。如果需要验证和重定向,则在读取响应时将抛出 httpretryexception。可以查询此异常以获取错误的详细信息。

该方法必须在连接 urlconnection 前调用。

参数:
chunklen - 要写入每个存储块的字节数。如果 chunklen 小于或等于零,则使用默认值。
抛出:
illegalstateexception - 如果已连接 urlconnection 或者已启用其他流模式。
从以下版本开始:
1.5
另请参见:
setfixedlengthstreamingmode(int)

getheaderfield

public string getheaderfield(int n)
返回 nth 头字段的值。有些实现可能将 0th 头字段视为特殊状态行,即由 http 服务器返回的状态行。

此方法可以与 getheaderfieldkey 方法一起使用来迭代消息中的所有头。

覆盖:
urlconnection 中的 getheaderfield
参数:
n - 索引,其中 n>=0。
返回:
nth 头字段的值;如果值不存在,则返回 null网站地图 手机端
另请参见:
getheaderfieldkey(int)

setfollowredirects

public static void setfollowredirects(boolean set)
设置此类是否应该自动执行 http 重定向(响应代码为 3xx 的请求)。默认情况下为 true。applet 不能更改此变量。

如果存在安全【ān quán】管理【guǎn lǐ】器,则此方法首先调用安全【ān quán】管理器的 checksetfactory 方法来确保允许【yǔn xǔ】操作。这可能会导致 securityexception 异常。

参数:
set - 指示是否进行 http 重定向的 boolean 值。
抛出:
securityexception - 如果安全管理器存在并且其 checksetfactory 方法不允许【yǔn xǔ】进行此操作。
另请参见:
securitymanager.checksetfactory(),getfollowredirects()

getfollowredirects

public static boolean getfollowredirects()
返回指示是否应该自动执行 http 重定向 (3xx) 的 boolean 值。

返回:
如果应该自动执行 http 重定向,则返回 true;否则返回 false
另请参见:
setfollowredirects(boolean)

setinstancefollowredirects

public void setinstancefollowredirects(boolean followredirects)
设置此 httpurlconnection 实例是否应该自动执行 http 重定向(响应代码为 3xx 的请求)。

默认值来自 followredirects,其默认情况下为 true。

参数:
followredirects - 指示是否执行 http 重定向的 boolean 值。
从以下版本开始:
1.3
另请参见:
instancefollowredirects,getinstancefollowredirects()

getinstancefollowredirects

public boolean getinstancefollowredirects()
返回此 httpurlconnectioninstancefollowredirects 字段的值。

返回:
httpurlconnectioninstancefollowredirects 字段的值。
从以下版本开始:
1.3
另请参见:
instancefollowredirects,setinstancefollowredirects(boolean)

setrequestmethod

public void setrequestmethod(string method)     throws protocolexception
设置 url 请求的方法, 以上方法之一是合法的,具体取决于协议的限制。默认方法为 get。

参数:
method - http 方法
抛出:
protocolexception - 如果无法【to be】重置方法或者请求的方法对 http 无效。
另请参见:
getrequestmethod()

getrequestmethod

public string getrequestmethod()
获取请求方法。

返回:
http 请求方法
另请参见:
setrequestmethod(java.lang.string)

getresponsecode

public int getresponsecode()    throws ioexception
从 http 响应消息获取状态码。例如,就以下状态行来说:
 http/1.0 200 ok http/1.0 401 unauthorized 
将分别返回 200 和 401。如果无法【to be】从响应中识别任何代码(即响应不是有效的 http),则返回 -1。

返回:
http 状态码或 -1
抛出:
ioexception - 如果连接到服务器时发生【occasionally occurred】错误。

getresponsemessage

public string getresponsemessage()     throws ioexception
获取与来自服务器的响应代码一起返回的 http 响应消息(如果有)。对于如下响应:
 http/1.0 200 ok http/1.0 404 not found 
分别提取 string "ok" 和 "not found"。如果无法从响应识别任何字符(结果不是有效的 http),则返回 null。

返回:
http 响应消息或 null
抛出:
ioexception - 如果连接到服务器时发生【occasionally occurred】错误。

getheaderfielddate

public long getheaderfielddate(string name,      long default)
从类 urlconnection 复制的描述
返回解析为日期的指定字段的值。结果为指定字段表示的距离格林威治标准时间 1970 年 1 月 1 日的毫秒数。

有些连接类型(例如 http-ng)具有预解析头,所以存在这种形式的 getheaderfield。用于该类型的连接可重写此方法和缩短解析过程。

覆盖:
urlconnection 中的 getheaderfielddate
参数:
name - 头字段的名称。
default - 默认值。
返回:
字段的值,解析为日期。如果该字段缺少或有错误,则返回 default 参数的值。

disconnect

public abstract void disconnect()
指示近期服务器不太可能有其他请求。调用 disconnect() 并不意味着可以对其他请求重用此 httpurlconnection 实例。


usingproxy

public abstract boolean usingproxy()
指示连接是否通过代理。

返回:
指示连接是否使用代理的 boolean 值。

getpermission

public permission getpermission()     throws ioexception
从类 urlconnection 复制的描述
返回一个权限对象,其代表建立此对象表示的连接所需的权限。如果建立连接不需要任何权限,则此方法返回 null。默认情况下,此方法返回 java.security.allpermission。子类应重写此方法并返回一个权限对象,该对象最能代表用于建立到 url 的连接所需的权限。例如表示 file:url 的 urlconnection 将返回 java.io.filepermission 对象。

返回的权限可能取决于连接的状态。例如,连接之前的权限可能不同于连接之后的权限。例如,一个 http 服务器(如 foo.com)可能将连接重定向到一台不同的主机(如 bar.com)。在连接之前,连接返回的权限将代表连接到 foo.com 所需的权限,而连接之后返回的权限将是连接到 bar.com 所需的权限。

使用权限通常有两个目的:保护通过 urlconnection 获取的对象的缓存;检查接收方的权限以了解特定的 url。第一种情况下,应在获取对象之后 再获取权限。例如,在一个 http 连接中,这将代表连接到最终将从该主机获取数据的主机的权限。第二种情况下,应在连接之前 对权限进行获取和检查。

覆盖:
urlconnection 中的 getpermission
返回:
代表建立此 urlconnection 表示的连接所需的权限的权限对象。
抛出:
ioexception - 如果计算权限需要网络或文件 i/o 并且在计算过程中出现【chū xiàn】异常。

geterrorstream

public inputstream geterrorstream()
如果连接失败但服务器仍然发送了有用数据,则返回错误流。典型示例是,当 http 服务器使用 404 响应时,将导致在连接中抛出 filenotfoundexception,但是【dàn shì】服务器同时还会发送建议如何【rú hé】操作的 html 帮助页。

此方法不会导致启用连接。如果没有建立连接,或者在连接时服务器没有发生错误,或服务器出错但没有发送错误数据,则此方法返回 null。这是默认设置。

返回:
错误流(如果存在);如果没有发生错误、没有建立连接或服务器没有发送有用数据,则返回 null。

javatm platform
standard ed. 6

提交错误或意见【remark】
有关更多的 api 参考资料和开发【developing】人员文档,请参阅 java se 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作【gōng zuò】代码示例。

版权所有 2007 sun microsystems, inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策