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

2024-02-26 15:00:03 55

http模块简介

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

http.client是一个底层的HTTP协议客户端，被更高层的urllib.request模块所使用。
http.server包含基于socketserver的基本HTTP服务器的类。
http.cookies实现cookie状态管理
http.cookiejar与cookie相关

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

HTTPStatus类是在Python3.5版本中新增的。

>>>fromhttpimportHTTPStatus
>>>HTTPStatus.OK
>>>HTTPStatus.OK==200True
>>>http.HTTPStatus.OK.value200
>>>HTTPStatus.OK.phrase'OK'
>>>HTTPStatus.OK.description'Requestfulfilled,documentfollows'
>>>list(HTTPStatus)[,,...]

具体的HTTP状态码和相应的说明可以在Python的官方文档上找到：https://docs.python.org/3/library/http.html

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

将HTTP1.1状态码映射到W3C名字的字典。

例如：

http.client.responses[http.client.NOT_FOUND]is'NotFound'

基本类

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类

classhttp.client.HTTPResponse(sock,debuglevel=0,method=None,url=None)

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

HTTPMessage类

HTTPMessage实例持有从HTTPresponse返回的头部。

异常类

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，说明连接已关闭。

示例

importhttp.client
importurllib,parser
##初始化一个https链接
conn=http.client.HTTPSConnection("www.python.org")
#指定request请求的方法和请求的链接地址
conn.request("GET","/doc/")
#得到返回的httpresponse
r1=conn.getresponse()
#HTTP状态码
print(r1.status,r1.reason)
#HTTP头部
print(r1.getheaders())
#body部分
print(r1.read())
#如果连接没有关闭,打印输出前200个字节
ifnotr1.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()

总结

以上就是这篇文章的全部内容了，希望本文的内容对大家学习或者使用python能带来一定的帮助，如果有疑问大家可以留言交流，谢谢大家对毛票票的支持。

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

热门推荐

随机推荐