Compréhension approfondie du module http.client en Python3

Cet article présente principalement Python3 Les informations pertinentes du module http.client est présenté en détail. Les amis qui en ont besoin peuvent s'y référer ci-dessous

introduction du module http.

Le package http dans Python3 contient plusieurs modules pour développer le protocole HTTP

• http.client est un client de protocole HTTP de bas niveau, utilisé par les niveaux supérieurs. ceux de niveau. Utilisé par le module urllib.request

• http.server Contient des classes pour les serveurs HTTP de base basés sur socketserver. cookies implémente les cookies

  Statut
Gestion

• http.cookiejar Lié aux cookies

• Le module http définit également une série de HTTP

  code des statuts
. La classe HTTPStatus est ajoutée

dans la version Python 3.5

le module http.client définit les classes. qui implémentent les clients des protocoles http et https Ce module n'est généralement pas utilisé directement, mais est encapsulé. Le module urllib.request les utilise pour gérer les URL

>>> from http import HTTPStatus
>>> HTTPStatus.OK<HTTPStatus.OK: 200>
>>> HTTPStatus.OK == 200True
>>> http.HTTPStatus.OK.value200
>>> HTTPStatus.OK.phrase'OK'
>>> HTTPStatus.OK.description'Request fulfilled, document follows'
>>> list(HTTPStatus)[<HTTPStatus.CONTINUE: 100>, <HTTPStatus.SWITCHING_PROTOCOLS: 101>, ...]

Constantes :1. http.client.HTTP_PORT

Le numéro de port par défaut du protocole http, toujours le port 80

2 http.client.HTTPS_PORT<.>

Le numéro de port par défaut du protocole https, toujours le port 443

3 http.client.responses mappe les codes d'état HTTP 1.1 au dictionnaire du W3C noms .Par exemple :

Classe de base

Classe HTTPConnection

Une instance HTTPConnection représente une transaction avec un serveur HTTP

Un hôte et un numéro de port facultatif doivent être transmis lors de l'instanciation d'une connexion HTTP. Si aucun port n'est transmis et que la chaîne host

string est sous la forme host:port, la valeur du port sera extraite, sinon les 8 ports par défaut seront utilisés.

Si le paramètre facultatif timeout est donné, l'opération de blocage expirera après le temps donné. S'il n'est pas indiqué, le paramètre de délai d'attente global par défaut est utilisé.

Le paramètre facultatif source_address doit être sous la forme d'un tuple d'hôte et de port (host,port), utilisé comme adresse source de la connexion HTTP.

http.client.responses[http.client.NOT_FOUND] is 'Not Found'

L'exemple de code est le suivant : source_address a été ajouté dans la version 3.2.

Le paramètre strict a été supprimé dans la version 3.4.

Classe HTTPSConnection

http.client.HTTPConnection(host, port=None, [timeout, ]source_address=None)

HTTPSConnection est une sous-classe de HTTPConnection qui utilise SSL pour contacter un serveur sécurisé.

Le port par défaut est le port 443. Si le contexte est spécifié, il doit s'agir d'une instance de la classe ssl.SSLContext pour décrire les différentes options SSL.

key_file et cert_file ont été obsolètes et remplacés par ssl.SSLContext.load_cert_chain(). Ou utilisez ssl.create_default_context() pour sélectionner un certificat CA auquel le système fait confiance. Le paramètre

check_hostname est également obsolète, utilisez l'

attribut

ssl.SSLContext.check_hostname du contexte.

>>> 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)

Classe HTTPResponse

Cette instance sera renvoyée une fois la connexion réussie. Les objets de cette classe ne peuvent pas être instanciés directement par l'utilisateur.

Classe HTTPMessage

HTTPSConnection(host, port=None, key_file=None, cert_file=None, [timeout, ]source_address=None, *, context=None, check_hostname=None)

L'instance HTTPMessage contient les en-têtes renvoyés par la réponse HTTP.

Classe d'exception

HTTPClasse d'exception

Une sous-classe de la classe Exception et la classe de base pour les autres classes d'exception dans le module http.
Autres classes d'exceptions :

• NotConnected

• InvalidURL

• UnknownProtocol

• UnknownTransferEncoding

• UnimplementedFileMode

• IncompletedRead

• ImproperConnectionState

• BadStatusLine

• LineTooLong

• CannotSendRequest

• CannotSendHeader

• ResponseNotReady

• RemoteDisconnected

Méthode de classe

Méthode d'objet HTTPConnection

L'instance HTTPConnection a les méthodes suivantes :

1. HTTPConnection.request(method, url, body=None, headers={})

Envoyez une demande au serveur en utilisant la méthode et le lien URL spécifiés.

Si la partie du corps est spécifiée, la partie du corps sera envoyée après l'envoi de la partie d'en-tête. La partie corps peut être une chaîne, un objet bytes, un objet fichier ou un itérateur d'objets bytes. À différents types de corps correspondent des exigences différentes.

Le paramètre header doit être un mappage des en-têtes HTTP, qui est un type de dictionnaire.

Si l'en-tête ne contient pas l'élément Content-Length, il sera automatiquement ajouté en fonction du corps.

2. HTTPConnection.getresponse()

doit être appelé après l'envoi de la requête pour obtenir le contenu renvoyé par le serveur. Ce qui est renvoyé est une instance HTTPResponse.

3. HTTPConnection.set_debuglevel(level)

Définissez le niveau debug Le niveau de débogage par défaut est 0, ce qui signifie qu'il n'y a pas de sortie de débogage.

4. HTTPConnection.set_tunnel(host, port=None, headers=None)

Définissez l'hôte et le port du lien tunnel HTTP, qui permet à la connexion d'utiliser un serveur proxy.

5. HTTPConnection.connect()

Connectez-vous au serveur spécifié. Par défaut, cette méthode est automatiquement appelée sur demande si le client n'est pas connecté.

6. HTTPConnection.close()

Fermez le lien.

7. HTTPConnection.putrequest(request, selector, skip_host=False, skip_accept_encoding=False)

Lorsque la connexion avec le serveur est réussie, cette méthode doit être appelée en premier.

Le contenu envoyé au serveur comprend : la chaîne de requête, la chaîne de sélection et la version du protocole HTTP.

8. HTTPConnection.putheader(header, argument[, …])

Envoyer l'en-tête HTTP au serveur.

Le contenu envoyé au serveur comprend : l'en-tête, les deux points, l'espace et le premier de la liste des paramètres.

9. HTTPConnection.endheaders(message_body=None)

Envoyez une ligne vierge au serveur pour identifier la fin de l'en-tête.

10. HTTPConnection.send(data)

Envoyer des données au serveur.

doit être appelé après la méthode endheaders() et avant la méthode getresponse().

Méthodes d'objet HTTPResponse

Les instances HTTPResponse contiennent la réponse HTTP renvoyée par le serveur.

Il fournit des méthodes pour accéder à l'en-tête et aux parties du corps de la requête.

HTTPResponse est un objet itérable et peut être déclaré à l'aide de l'instruction with.

Les instances HTTPResponse ont les méthodes suivantes :

1. HTTPResponse.read([amt])

Lire et renvoyer la partie du corps de la réponse.

2. HTTPResponse.readinto(b)

Lire la longueur d'octet spécifiée len(b) et retourner à l'octet b du tampon.

Fonction renvoie le nombre d'octets lus

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()

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!