深入理解python3中的http.client模块

这篇文章主要介绍了关于#wiki/1514.html” target=”_blank”>python3中http.client模块的相关资料,文中介绍的非常详细,需要的朋友可以参考借鉴,下面来一起看看吧。

http 模块简介

python3 中的 http 包中含有几个用来开发 http 协议的模块。

http.client 是一个底层的 http 协议客户端,被更高层的 urllib.request 模块所使用。

http.server 包含基于 socketserver 的基本 http 服务器的类。

http.cookies 实现 cookie 状态管理

http.cookiejar 与 cookie 相关

http 模块还定义了一系列的 http 状态码。

httpstatus 类是在 python 3.5 版本中新增的。

>>> from http import httpstatus
>>> httpstatus.ok
>>> httpstatus.ok == 200true
>>> http.httpstatus.ok.value200
>>> httpstatus.ok.phrase’ok’
>>> httpstatus.ok.description’request fulfilled, document follows’
>>> list(httpstatus)[, , …]

http.client 模块

http.client 模块定义了实现 http 和 https 协议客户端的类。

该模块通常不会直接使用,而是用封装好的 urllib.request 模块来使用他们处理 url 。

常量

http 模块中的常量:

1、http.client.http_port

http 协议默认的端口号,总是 80 端口

2、http.client.https_port

https 协议默认的端口号,总是 443 端口

3、http.client.responses

将 http 1.1 状态码映射到 w3c 名字的字典。

例如:

http.client.responses[http.client.not_found] is ‘not found’

基本类

httpconnection 类

http.client.httpconnection(host, port=none, [timeout, ]source_address=none)

httpconnection 实例表示与 http 服务器的事务。

实例化 httpconnection 时应该传递一个主机和可选的端口号。如果没有传递端口,而主机字符串是以 host:port 的形式,则会提取出端口值,否则将使用默认的 8- 端口。

如果给定了可选参数 timeout ,阻塞操作将会在给定的时间后超时,若未给定,则使用默认的全局 timeout 设置。

可选参数 source_address 应该以 host 和 port 的元组形式 (host,port),用来作为 http 连接的源地址。

示例代码如下:

>>> h1 = http.client.httpconnection(‘www.python.org’)
>>> h2 = http.client.httpconnection(‘www.python.org:80’)>>> h3 = http.client.httpconnection(‘www.python.org’, 80)
>>> h4 = http.client.httpconnection(‘www.python.org’, 80, timeout=10)

source_address 是在 3.2 版本中添加的。

strict 参数在 3.4 版本中移除了。

httpsconnection 类

httpsconnection(host, port=none, key_file=none, cert_file=none, [timeout, ]source_address=none, *, context=none, check_hostname=none)

httpsconnection 是 httpconnection 的子类,使用 ssl 与安全服务器联系。

默认的端口是 443 端口。如果指定了 context ,必须是 ssl.sslcontext 类的实例来描述不同的 ssl 选项。

key_file 和 cert_file 已经被弃用了,取而代之的是 ssl.sslcontext.load_cert_chain() 。或者使用 ssl.create_default_context() 选择系统信任的 ca 证书。

check_hostname 参数也被弃用了,使用 context 的 ssl.sslcontext.check_hostname 属性。

httpresponse 类

class http.client.httpresponse(sock, debuglevel=0, method=none, url=none)

一旦连接成功就会返回该实例,该类的对象不能由用户直接实例化。

httpmessage 类

httpmessage 实例持有从 http response 返回的头部。

异常类

httpexception 类

exception 类的子类,也是 http 模块中其他异常类的基类。 其他异常类:

notconnected

invalidurl

unknownprotocol

unknowntransferencoding

unimplementedfilemode

incompletedread

improperconnectionstate

badstatusline

linetoolong

cannotsendrequest

cannotsendheader

responsenotready

remotedisconnected

类方法

httpconnection 对象方法

httpconnection 实例有如下的方法 :

1、httpconnection.request(method, url, body=none, headers={})

使用指定的 method 方法和 url 链接向服务器发送请求。

如果指定 了body 部分,那么 body 部分将在 header 部分发送完之后发送过去。body 部分可以是一个字符串、字节对象、文件对象或者是字节对象的迭代器。不同的 body 类型对应不同的要求。

header 参数应该是 http 头部的映射,是一个字典类型。

如果 header 中不包含 content-length 项,那么会根据 body 的不同来自动添加上去。

2、httpconnection.getresponse()

必须在请求发送后才能调用得到服务器返回的内容,返回的是一个 httpresponse 实例。

3、httpconnection.set_debuglevel(level)

设置调试级别,默认调试级别是 0 ,意味着没有调试输出。

4、httpconnection.set_tunnel(host, port=none, headers=none)

设置 http 隧道链接的主机和端口,这允许连接使用代理服务器。

5、httpconnection.connect()

连接指定的服务器。默认情况下,如果客户端没有连接,则会在 request 请求时自动调用该方法。

6、httpconnection.close()

关闭链接。

7、httpconnection.putrequest(request, selector, skip_host=false, skip_accept_encoding=false)

当和服务器的链接成功后,应当首先调用该方法。

发送到服务器的内容包括:request 字符串、selector 字符串和 http 协议版本。

8、httpconnection.putheader(header, argument[, …])

发送 http 头部到服务器。

发送到服务器的内容包括:header 头部、冒号、空格和参数列表里的第一个。

9、httpconnection.endheaders(message_body=none)

发送一个空白行到服务器,标识头部的结束。

10、httpconnection.send(data)

发送数据到服务器。

应该在 endheaders() 方法之后和在 getresponse() 方法之前调用。

httpresponse 对象方法

httpresponse 实例包含了从服务器返回的 http 回应。

它提供了访问请求头部和 body 部分的方法。

httpresponse 是一个可迭代的对象而且可以使用 with 语句来声明。

httpresponse 实例有如下的方法 :

1、httpresponse.read([amt])

读取和返回 response 的 body 部分。

2、httpresponse.readinto(b)

读取指定的字节长度 len(b),并返回到缓冲字节 b 。

函数返回读取的字节数

3、httpresponse.getheader(name,default=none)

返回指定名称 name 的 http 头部值,如果没有相应匹配的 name 值,则返回默认的 none。如果有多个相匹配的,则返回所有的值,以逗号分隔。

4、httpresponse.getheaders()

以元组的形式返回所有的头部信息 (header,value)。

5、httpresponse.fileno()

6、httpresponse.msg

7、httpresponse.version。

http 协议版本

8、httpresponse.status

http 状态码

9、httpresponse.reason

10、httpresponse.debuglevel

11、httpresponse.closed

如果为 true ,说明连接已关闭。

示例

import http.client
import urllib,parser
# # 初始化一个 https 链接
conn = http.client.httpsconnection(“www.python.org”)
# 指定 request 请求的方法和请求的链接地址
conn.request(“get”,”/doc/”)
# 得到返回的 http response
r1 = conn.getresponse()
# http 状态码
print(r1.status,r1.reason)
# http 头部
print(r1.getheaders())
# body 部分
print(r1.read())
# 如果连接没有关闭,打印输出前 200 个字节
if not r1.closed:
print(r1.read(200))
# 关闭连接后才能重新请求
conn.close()
# 请求一个不存在的文件或地址
conn.request(“get”,”/parrot.spam”)
r2 = conn.getresponse()
print(r2.status,r2.reason)
conn.close()
# 使用 head 请求,但是不会返回任何数据
conn = http.client.httpsconnection(“www.python.org”)
conn.request(“head”,”/”)
res = conn.getresponse()
print(res.status,res.reason)
data = res.read()
print(len(data))
conn.close()
# 使用 post 请求,提交的数据放在 body 部分
params = urllib.parse.urlencode({‘@number’:12524,’@type’:’issue’,’@action’:’show’})
# post 请求数据,要带上 content-type 字段,以告知消息主体以何种方式编码
headers = {“content-type”:”application/x-www-form-urlencoded”,”accept”:”text/plain”}
conn = http.client.httpconnection(“bugs.python.org”)
conn.request(“post”,”/”,params,headers)
response = conn.getresponse()
# 访问被重定向
print(response.status,response.reason)
print(response.read().decode(“utf-8”))
conn.close()

以上就是深入理解python3中的http.client模块的详细内容,更多请关注 第一php社区 其它相关文章!

Posted in 未分类