描述 DESCRIPTION DESCRIPTION DESCRIPTIONhttp 包提供 HTTP/1.0 协议的客户端。
这个包实现了 HTTP/1.0 的 GET 、POST 、和 HEAD 操作。
它允许配置一个代理(proxy)主机来通过防火墙。
这个包与 Safesock Safesock Safesock 安全策略相容，所以可以被不可信任的 applets 用来从一些受限制的主机做 URL 取回(fetching)。
可以扩展这个包来支持附加的 HTTP 传输协议，比如 HTTPS ，通过 http::registerhttp::register ，提供一个定制的 socket socket socket 命令。
::::http::geturlhttp::geturl http::geturl 过程做一次 HTTP 事务(transaction)。
它的 options (选项)确定完成 GET 、POST 、或 HEAD 事务中的那一个。
::::http::geturl http::geturl http::geturl 的返回值是这个事务的一个记号(token)。
这个值也是在::http 名字空间中一个数组的名字，这个数组包含关于这个事务的信息。
这个数组的元素在状态数组章节中描述。
如果指定了 --command command 选项，则在后台做这个 HTTP 操作。
::::http::geturl http::geturl http::geturl 在生成一个 HTTP 请求和在事务完成时调用的回调过程(callback)之后立即返回。
要使它工作，Tcl 事件循环必须是活跃的(active)。
在 Tk 应用中总是真的。
对于纯 Tcl 应用，调用者可以在调用 ::::::http::geturl http::geturl http::geturl 之后使用 ::::::http::wait http::wait http::wait 来启动事件循环。
命令 COMMANDS COMMANDS COMMANDS::http::config ::http::config ?options ?使用 ::::::http::config http::config http::config 命令来设置和查询代理服务器的和端口的名字，和在 HTTP 请求中使用的用户代理(User-Agent)名字。
如果未指定选项，则返回当前的配制。
如果指定了一个单一的参数，则它应该是下面描述的标志之一。
在这种情况下返回设置的当前值。
否则，选项应该是定义配置的一系列标志和值:-accept accept mimetypes(指定)请求的接受(类型)头部(header)。
缺省是 */*，这意味者接受所有类型的文档。
否则你可以提供用逗号分隔的你想接收的 mime(多用途互连网邮件扩展)类型模式的一个列表。
例如，"image/gif, image/jpeg, text/*"。
-proxyhost proxyhost hostname如果有代理服务器主机的话，它是代理服务器主机的名字。
如果这个值是空串，则直接联系 URL 主机。
-proxyport proxyport number代理服务器端口。
-proxyfilter proxyfilter command这个命令设置在 ::::::http::geturl http::geturl http::geturl 期间的一个回调过程，用来决定是否为一个给定主机而要求一个代理服务器。
在调用它的时候，向命令 command 添加的一个参数是主机名字。
如果要求一个代理服务器，则这个回调过程应该返回一个有两个元素的数组，分别是代理服务器和代理服务端口。
否则这个过滤器应该返回一个空列表。
在 --proxyhost proxyhost 和 --proxyport proxyport 设置非空的时候，缺省的过滤器返回它们的值。
-useragent useragent string在 HTTP 请求中客户代理头部的值。
缺省是 ""Tcl http client package 2.2."Tcl http client package 2.2."::http::geturl ::http::geturl url ?options ?::http::geturl ::http::geturl 命令是包中的主过程。
-query query 选项导致一个 POST 操作，而 --validate validate 选项导致一个 HEAD 操作；否则，进行一个 GET 操作。
::::http::geturl http::geturl http::geturl 命令返回一个 token (记号)值，可用它来获得关于这次事务的信息。
详情参见状态数组和错误章节。
除非用 --command command 选项指定在HTTP 事务完成时调用的一个回调过程，否则 ::::::http::geturl http::geturl http::geturl 命令在操作完成之前一直阻塞。
::::::http::geturl http::geturl http::geturl 接受一些选项:-binary binary booleanSpecifies whether to force interpreting the url data as binary. Normally this is auto-detected (anything not beginning with a text text text content type or whose content encoding is gzip gzip gzip or compress compress compress is considered binary data). -blocksize blocksize size在读 URL 时使用块大小。
一次最多读 size 字节。
读完每一块之后，调用 --progress progress 回调过程(如果指定着这个选项的话)。
-channel channel name复制 URL 内容到叫 name 的通道中而不是保存在 state(body)state(body)state(body) 中。
-command command callback在这次 HTTP 事务完成之后调用 callback 。
这个选项导致 ::::::http::geturl http::geturl http::geturl 立即返回。
callback 得到一个增添的参数，它是从 ::::::http::geturl http::geturl http::geturl 返回的 token (记号)。
这个记号是在状态数组章节中描述的一个数组的名字。
下面是这个回调过程的一个模版:proc httpCallback {token} { upvar #0 $token state# Access state as a Tcl array }-handlerhandler callback 在可获得 HTTP 数据的时候调用 callback ；如果(这个回调)存在，则不对 HTTP 数据做其他任何事情。
这个过程得到两个增添的参数: 给这些 HTTP 数据的套接口和从 ::::::http::geturl http::geturl http::geturl 返回的 token 。
这个记号是在状态数组章节中描述的一个数组的名字。
回调过程应返回从这个套接口中读到的字节数目。
下面是这个回调过程的一个模版:proc httpHandlerCallback {socket token} { upvar #0 $token state# Access socket, and state as a Tcl array ...(example: set data [read $socket 1000];set nbytes [string length $data]) ...return nbytes }-headersheaders keyvaluelist 使用这个选项来给 HTTP 请求增加额外的头部。
keyvaluelist 参数必须是有偶数个元素的一个列表，这些元素是交替的键(key)和值。
这些键变成头部的字段名字。
从这些值中去除(strip)换行符，所以头部不会被中断(corrupt)。
例如，如果 keyvaluelist 是 Pragma Pragma no no--cache cache 则在 HTTP 请求中包含下列头部:Pragma: no-cache-progressprogress callback 每次从 URL 传输数据之后调用这个 callback 。
这个调用得到三个增添的参数: 从 ::::::http::geturl http::geturl http::geturl 得来的 token ，从 Content Content Content--Length Length 元(meta)数据得来的期望的内容总体大小，和迄今为止传输的字节数。
期望的总体大小可以是未知的，在这种情况下向这个回调传递零。
下面是这个回调过程的一个模版:proc httpProgress {token total current} { upvar #0 $token state }-queryquery query 这个标志导致 ::::::http::geturl http::geturl http::geturl 去做向服务器传递 query 的一次 POST 请求。
这个 query 必须是 x-url-encoding 编码格式的一个查询。
可以使用 ::::::http::formatQuery http::formatQuery http::formatQuery 过程来做格式化。
-queryblocksize queryblocksize size在向 URL 传送(post)查询数据的时候使用这个块大小。
一次最多写 size 字节。
在每块(被传输完毕)之后，调用 --queryprogress queryprogress 回调过程(如果指定了这个选项的话)。
-querychannel querychannel channelID这个标志导致 ::::::http::geturl http::geturl http::geturl 去做向服务器传递在 channelID 中包含的数据的一次 POST 请求。
