aiohttp 异步http请求-1.快速入门 get 请求示例

前言

在 python 的众多 http 请求库中,大家最熟悉的就是 requests 库了,requests 库上手非常容易,适合入门学习。
如果平常工作中对发请求不追求效率和并发的情况下,requests 完全可以满足大部分需求。但是想发大量的请求,比如几万个请求的时候,可能需要等待几个小时,requests 库就不能满足需求了。
初学者建议先学习requests 库,熟练掌握requests 库才能更好的学习 aiohttp 异步框架。

同步与异步

requests只能发送同步请求,aiohttp只能发送异步请求。
所谓的同步请求,是指在单进程单线程的代码中,发起一次请求后,在收到返回结果之前,不能发起下一次请求。
所谓异步请求,是指在单进程单线程的代码中,发起一次请求后,在等待网站返回结果的时间里,可以继续发送更多请求。

在前面一篇中有讲到python asyncio 异步 I/O - 实现并发http请求(asyncio + aiohttp)
如果使用requests 库,发10个请求访问我的博客,那么这10个请求是串行的。

import requests import time  url = https://www.cnblogs.com/yoyoketang/  start_time = time.time() for i in range(10):     r = requests.get(url)     print(r) print('总耗时:', time.time()-start_time) 

我们想实现并发请求需用到 异步http 库 aiohttp。

环境准备

首先,确保 aiohttp 已安装,为了更好的学习 aiohttp 的功能,建议大家使用python3.7+版本, 我用的是python3.8版本

pip install aiohttp==3.8.1 

或者在 pycharm 中安装

简单get 请求实现

首先导入 aiohttp 模块和 asyncio

import aiohttp import asyncio 

现在,让我们尝试获取一个网页。例如让我们查询 http://httpbin.org/get

import aiohttp import asyncio   async def main():     async with aiohttp.ClientSession() as session:         async with session.get('http://httpbin.org/get') as resp:             print(resp.status)             print(await resp.text())   # asyncio.run(main()) # 会报错,改成下面2句 loop = asyncio.get_event_loop() loop.run_until_complete(main()) 

运行结果

200 {   args: {},    headers: {     Accept: */*,      Accept-Encoding: gzip, deflate,      Host: httpbin.org,      User-Agent: Python/3.8 aiohttp/3.8.1,      X-Amzn-Trace-Id: Root=1-625ed4ea-5f44f6163dc3521845687df1   },    origin: 183.193.27.228,    url: http://httpbin.org/get } 

上面代码解释:

  • aiohttp.ClientSession() 是创建客户端session会话对象
  • resp 是返回的response对象
  • session.get 发get请求
  • resp.status 获取返回对象状态码
  • resp.text() 返回文本对象

前面是get请求示例,发一个 post 请求示例如下

session.post('http://httpbin.org/post', data=b'data') 

其他 HTTP 方法也可用:

session.put('http://httpbin.org/put', data=b'data') session.delete('http://httpbin.org/delete') session.head('http://httpbin.org/get') session.options('http://httpbin.org/get') session.patch('http://httpbin.org/patch', data=b'data') 

为了使对同一个站点的多个请求更简单,可以使用构造函数的参数base_url ,例如请求不同的端点 http://httpbin.org 可以使用以下代码:

import aiohttp import asyncio   async def main():     async with aiohttp.ClientSession('http://httpbin.org') as session:         async with session.get('/get') as resp1:             print(resp1.status)         async with session.post('/post', data=b'data') as resp2:             print(resp2.status)         async with session.put('/put', data=b'data') as resp3:             print(resp3.status)  # asyncio.run(main()) # 会报错,改成下面2句 loop = asyncio.get_event_loop() loop.run_until_complete(main()) 

笔记

不要为每个请求创建会话。尽可能在每个应用程序中使用一个会话执行所有的请求。
更复杂的情况可能需要每个站点一个会话,例如一个用于 Github,另一个用于 Facebook API。无论如何,为每个请求创建一个会话是一个非常糟糕的主意。
会话内部包含一个连接池。连接重用和保持活动(默认情况下都打开)可以提高整体性能。

会话上下文管理器的使用不是强制性的,但在这种情况下应该调用方法,例如:await session.close()

session = aiohttp.ClientSession() async with session.get('...'):     # ... await session.close() 

在 URL 中传递参数

当url中带请求参数时,如http://httpbin.org/get?key1=value1&key2=value2,在url中问号后面的参数可以单独拿出来用键值对保存,使用 params关键字参数将这些参数作为 提供

import aiohttp import asyncio   async def main():     async with aiohttp.ClientSession() as session:         params = {'key1': 'value1', 'key2': 'value2'}         async with session.get('http://httpbin.org/get', params=params) as resp:             expect = 'http://httpbin.org/get?key1=value1&key2=value2'             print(resp.url)             assert str(resp.url) == expect   loop = asyncio.get_event_loop() loop.run_until_complete(main()) 

运行打印结果:http://httpbin.org/get?key1=value1&key2=value2,通过打印 URL,您可以看到 URL 已正确编码。

如果同一个key有多个值的时候,如:http://httpbin.org/get?key1=value1&key2=value2&key2=value3,其中key2对应的值有2个value2和value3。
那么在传值的时候,可以把多个值放到一个list,如

params = {             'key1': 'value1',             'key2': ['value2', 'value3']         } 

也可以使用列表嵌套元祖

params = [             ('key1', 'value1'),             ('key2', 'value2'),             ('key2', 'value3')         ] 

也可以把字符串内容作为参数传递, 如params='key=value+1&key2=value2'.

        async with session.get('http://httpbin.org/get',                                params='key=value+1&key2=value2') as r:             print(r.url)             assert str(r.url) == 'http://httpbin.org/get?key=value+1&key2=value2' 

但是这样会有弊端,+号这种特殊字符没转码成urlencoded格式%2B,所以这种方式尽量不用,以下是官方文档把字符串内容作为参数传递的说明。

也可以把参数直接传到url上,如http://httpbin.org/get?key1=value1&key2=value2

import aiohttp import asyncio   async def main():     async with aiohttp.ClientSession() as session:         async with session.get('http://httpbin.org/get?key1=value1&key2=value2') as resp:             print(resp.url)   loop = asyncio.get_event_loop() loop.run_until_complete(main()) 

当请求参数带有中文的时候

params = {             'key1': 'value1',             'key2': '上海-悠悠'         } 

它会自动帮我们转成urlencode编码http://httpbin.org/get?key1=value1&key2=%E4%B8%8A%E6%B5%B7-%E6%82%A0%E6%82%A0

async def main():     async with aiohttp.ClientSession() as session:         params = {             'key1': 'value1',             'key2': '上海-悠悠'         }         async with session.get('http://httpbin.org/get', params=params) as resp:             print(resp.url) 

响应内容和状态码

我们可以读取服务器响应的内容及其状态码

import aiohttp import asyncio   async def main():     async with aiohttp.ClientSession() as session:         async with session.get('https://www.cnblogs.com/yoyoketang/') as resp:             print(resp.url)             print(await resp.text(encoding='utf-8'))     loop = asyncio.get_event_loop() loop.run_until_complete(main()) 

打印出内容:

https://www.cnblogs.com/yoyoketang/ <!DOCTYPE html> <html lang=zh-cn> <head>     <meta charset=utf-8 />     <meta name=viewport content=width=device-width, initial-scale=1.0 />     <meta name=referrer content=origin-when-crossorigin />               <meta http-equiv=Cache-Control content=no-transform />     <meta http-equiv=Cache-Control content=no-siteapp />     <meta http-equiv=X-UA-Compatible content=IE=edge />     <title>上海-悠悠 - 博客园</title> 

aiohttp自动解码来自服务器的内容。您可以为该text()方法指定自定义编码:

resp.text(encoding='utf-8') 

也可以获取byte响应内容

print(await resp.read()) 

打印结果

b'<!DOCTYPE html>\n<html lang=zh-cn>\n<head>\n    <meta charset=utf-8 />\n  ...'