HTTPConnection对象

HTTPConnection实例具有以下方法：

HTTPConnection.request（method, url, body=None, headers={}, *, encode_chunked=False）

这将使用HTTP requestmethod method和选择器url.

向服务器发送请求。如果指定了body，则在标头完成后发送指定的数据。它可能是str，一个字节对象，anopen 文件对象，或者bytes的可迭代。如果body是一个字符串，它编码为ISO-8859-1，HTTP的默认值。如果它是类似字节的对象，则按原样发送字节。如果是文件对象，发送文件的内容;这个文件对象应该至少支持read()方法。如果文件对象是io.TextIOBase的实例，则read()方法返回的数据将被编码为ISO-8859-1，否则read()返回的数据将被发送为是。如果body是一个可迭代的，那么theiterable的元素就会被发送，直到iterable耗尽为止.

headers参数应该是额外HTTP头的映射，以便与request

//如果headers既不包含Content-Length也不包含Transfer-Encoding，但是有一个请求体，其中一个头字段将自动添加。如果body是None，Content-Length标题设置为0用于期望正文的方法（PUT, POST和PATCH）。如果body是一个字符串或类似字节的对象，它也不是文件，则Content-Length标头设置为其长度。任何其他类型的body（一般的文件和迭代）将被块编码，并且将自动设置传输编码头而不是内容 – 长度

// encode_chunked只有在headers中指定了Transfer-Encoding时，参数才有意义。如果encode_chunked是False，则httpTPConnection对象假定所有编码都由调用代码处理。如果是 True，身体将被大块编码.

注意

已将分块传输编码添加到HTTP协议转换1.1中。除非已知HTTP服务器处理HTTP 1.1，否则调用者必须指定Content-Length，或者必须传递str或类似字节的对象，它也不是一个文件作为人体表示.

新版本3.2：body现在可以是一个可迭代的

更改版本3.6：如果在headers中没有设置Content-Length和Transfer-Encoding，则文件和可迭代的body对象现在都是块编码的.encode_chunked添加了参数。没有尝试确定fileobjects的内容长度

HTTPConnection.getresponse（)

在发送请求以获取响应之后应该调用服务器。回收HTTPResponseinstance.

注意

注意你必须先阅读整个回复才能向服务器发送新请求.

更改版本3.5：如果ConnectionError或子类被提出，HTTPConnection当发送新请求时，对象将准备重新连接.

HTTPConnection.set_debuglevel（level）

设置调试级别。默认调试级别是0，意味着打印nodebugging输出。任何大于0的值都会导致所有当前定义的调试输出打印到stdout。debuglevel传递给任何新的HTTPResponse创建的对象.

版本3.1.

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

设置HTTP Connect Tunneling的主机和端口。这允许通过代理服务器运行连接.

主机和端口参数指定隧道连接的端点（即CONNECT请求中包含的地址，not代理服务器的地址）.

headers参数应该是要与CONNECT请求一起发送的额外HTTP头的映射.

例如，要通过在port8080上本地运行的HTTPS代理服务器进行隧道传输，我们会将代理的地址传递给HTTPSConnection构造函数，以及我们最终想要达到的主机地址set_tunnel()方法：

>>> import http.client>>> conn = http.client.HTTPSConnection("localhost", 8080)>>> conn.set_tunnel("www.python.org")>>> conn.request("HEAD","/index.html")

版本3.2.

HTTPConnection.connect（）

连接到创建对象时指定的服务器。默认情况下，如果客户端没有连接，则在发出请求时会自动调用它.

HTTPConnection.close ( )

关闭与服务器的连接.

HTTPConnection.blocksize

用于发送类似文件的消息体的缓冲区大小（以字节为单位）.

版本3.7.

作为使用request()如上所述的方法，你也可以通过下面的四个功能一步一步地发送你的请求.

HTTPConnection.putrequest (method, url, skip_host=False, skip_accept_encoding=False)

这应该是与服务器建立连接后的第一次调用。它向服务器发送一行，包括method字符串，url字符串和HTTP版本（HTTP/1.1）。要禁用Host:或Accept-Encoding:标题的自动发送（例如接受附加内容编码），请指定带有非假值的skip_host或skip_accept_encoding

HTTPConnection.putheader（header, argument [, …] ）

发送 RFC 822 到服务器的样式标题。它向服务器发送一行代码，包括标题，冒号和空格以及第一个参数。如果给出了更多的参数，则会发送连续行，每行都包含一个制表符和一个参数.

HTTPConnection.endheaders（message_body=None, *, encode_chunked=False）

向服务器发送一个空行，表示标题的结尾。可选的message_body参数可用于传递与请求相关的信息.

如果encode_chunked是True，message_body的每次迭代的结果将按照 RFC 7230 ，3.3.1节中的规定进行块编码。数据的编码方式取决于message_body的类型。如果message_body执行缓冲区接口编码会产生一个块。如果message_body是collections.abc.Iterable，message_body的每次迭代都会产生一个块。如果message_body是文件对象，每次调用.read()将导致一个块。该方法在message_body.

后立即自动发信号通知块编码数据的结尾

由于chunked编码规范，chunk-encoder将忽略由迭代器体提供的空块。这是为了避免由于编码格式错误而导致目标服务器提前终止请求的读取.

版本3.6中新增：分块编码支持。encode_chunked参数wasadded .

HTTPConnection.send（data）

将数据发送到服务器。这应该只在endheaders()方法已被调用，之前getresponse()被称为

HTTPResponse对象

一个HTTPResponseinstance包装来自服务器的HTTP响应。它提供对请求标头和实体主体的访问。响应是一个可迭代的对象，可以在withstatement中使用.

HTTPResponse.read ( [amt] ）

读取并返回响应体，或者直到下一个amt bytes.

HTTPResponse.readinto(b)

读到下一个len（b）字节响应体进入缓冲区b.Returns读取的字节数

3.3版本中的新功能

HTTPResponse.getheader// (name, default=None)

如果没有标题匹配，请返回标题name或default的值name。如果有多个标题为name，返回’，’返回的所有值。如果’default’是除了单个字符串之外的任何可迭代，则其元素同样返回由逗号连接.

HTTPResponse.getheaders ( )

返回（标题，值）元组列表

HTTPResponse.fileno// ()

返回底层插座的fileno.

HTTPResponse.msg

一个http.client.HTTPMessage包含响应头的实例。http.client.HTTPMessage是email.message.Message.

HTTPResponse.version

服务器使用的HTTP协议版本。10表示HTTP / 1.0,11表示HTTP / 1.1 .

HTTPResponse.status

服务器返回的状态码

HTTPResponse.reason

服务器返回的原因短语.

HTTPResponse.debuglevel

一个调试钩子。如果debuglevel大于零时，将在读取和解析响应时将消息打印到stdout .

HTTPResponse.closed

是True如果溪流关闭了

例子

这是一个使用GET方法：

>>> import http.client>>> conn = http.client.HTTPSConnection("www.python.org")>>> conn.request("GET", "/")>>> r1 = conn.getresponse()>>> print(r1.status, r1.reason)200 OK>>> data1 = r1.read()  # This will return entire content.>>> # The following example demonstrates reading data in chunks.>>> conn.request("GET", "/")>>> r1 = conn.getresponse()>>> while not r1.closed:...     print(r1.read(200))  # 200 bytesb"<!doctype html>\n<!--[if"......>>> # Example of an invalid request>>> conn = http.client.HTTPSConnection("docs.python.org")>>> conn.request("GET", "/parrot.spam")>>> r2 = conn.getresponse()>>> print(r2.status, r2.reason)404 Not Found>>> data2 = r2.read()>>> conn.close()

这是一个使用HEAD方法。注意HEAD方法永远不会返回任何数据.

>>> import http.client>>> conn = http.client.HTTPSConnection("www.python.org")>>> conn.request("HEAD", "/")>>> res = conn.getresponse()>>> print(res.status, res.reason)200 OK>>> data = res.read()>>> print(len(data))0>>> data == b""True

这是一个示例会话，显示如何POST要求：

>>> import http.client, urllib.parse>>> params = urllib.parse.urlencode({"@number": 12524, "@type": "issue", "@action": "show"})>>> 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)302 Found>>> data = response.read()>>> datab"Redirecting to <a href="http://bugs.python.org/issue12524">http://bugs.python.org/issue12524</a>">>> conn.close()

客户端HTTP PUT请求与POST请求非常相似。差异只在于服务器端，HTTP服务器将允许通过PUT请求。应该注意的是，通过发送适当的+方法属性，也可以在urllib.request.Request中处理自定义HTTP方法+。这是一个示例会话，显示如何做PUT请求使用http.client：

>>> # This creates an HTTP message>>> # with the content of BODY as the enclosed representation>>> # for the resource http://localhost:8080/file...>>> import http.client>>> BODY = "***filecontents***">>> conn = http.client.HTTPConnection("localhost", 8080)>>> conn.request("PUT", "/file", BODY)>>> response = conn.getresponse()>>> print(response.status, response.reason)200, OK

HTTPMessage对象

http.client.HTTPMessage实例保存来自HTTP响应的头。它是用email.message.Message class.