pythonPython中小巧的异步web框架Sanic快速上手实战

王者终成亡者

✨✨欢迎大家来到景天科技苑✨✨🎈🎈养成好习惯，先赞后看哦~🎈🎈🏆作者简介：景天科技苑🏆《头衔》：大厂架构师，华为云开发者社区专家博主，阿里云开发者社区专家博主，CSDN全栈领域优质创作者，掘金优秀博主，51CTO博客专家等。🏆《博客》：Python全栈，PyQt5和Tkinter桌面开发，小程序开发，人工智能，js逆向，App逆向，网络系统安全，数据分析，Django，fastapi，flask等框架，云原生K8S，linux，shell脚本等实操经验，网站搭建，数据库等分享。所属的专栏：python综合应用，基础语法到高阶实战教学景天的主页：景天科技苑文章目录Sanic框架安装Sanic创建Sanic应用程序第一步：导入Sanic模块第二步：创建Sanic应用实例第三步：定义路由和处理函数第四步：启动Sanic应用程序路由和请求处理基本路由示例：处理GET和POST请求路由参数路径参数（PathParameters）请求参数（QueryParameters）请求对象示例：访问请求信息响应对象示例：使用HTTPResponseSanic框架Sanic是一个基于Python3.5+的异步Web框架，它充分利用了Python的异步IO特性（asyncio），从而在处理大量并发请求时表现出色。相比于传统的同步Web框架（如Flask），Sanic能够显著提高应用程序的响应速度和吞吐量。本文将通过实际案例，详细介绍如何在Python中使用Sanic框架来构建Web应用程序。安装Sanic在开始之前，首先需要安装Sanic。建议使用Python的虚拟环境来管理项目依赖，以避免不同项目间的依赖冲突。以下是如何创建虚拟环境并安装Sanic的步骤：创建虚拟环境：python3-mvenvsanic_env1激活虚拟环境（以Unix-like系统为例）：sourcesanic_env/bin/activate1在Windows系统中，使用以下命令激活虚拟环境：sanic_env\Scripts\activate1安装Sanic和Sanic_cors：pipinstallsanicpipinstallsanic_cors12创建Sanic应用程序第一步：导入Sanic模块首先，需要导入Sanic模块。创建一个新的Python文件，例如app.py，并导入Sanic。fromsanicimportSanic1第二步：创建Sanic应用实例接着，创建一个Sanic应用实例。这个实例将作为Web应用程序的主体。app=Sanic(__name__)1注意，创建Sanic应用实例的时候，里面的参数只能是字母数字下划线_，中划线-组成，不能有空格，否则报错。第三步：定义路由和处理函数在Sanic中，路由用于定义URL与处理函数之间的映射关系。使用@app.route()装饰器来定义路由，并通过异步函数来处理请求。fromsanic.responseimporttext@app.route('/')asyncdefindex(request):returntext('Hello,Sanic!')12345在上述代码中，@app.route('/')装饰器定义了一个处理根路径(/)的路由，index函数是处理该路由的异步函数。使用text函数返回纯文本响应。第四步：启动Sanic应用程序最后，通过调用app.run()方法启动Sanic应用程序。可以指定监听的主机地址和端口号。if__name__=='__main__':app.run(host='0.0.0.0',port=8000)12至此，一个简单的SanicWeb应用程序就创建完成了。运行app.py文件，然后在浏览器中访问http://localhost:8000，将看到页面上显示“Hello,Sanic!”。路由和请求处理基本路由Sanic支持通过@app.route()装饰器定义基本路由。路由可以处理不同类型的HTTP请求（如GET、POST等），并且可以通过在装饰器中指定methods参数来明确处理哪些HTTP方法，如果支持多种请求方式，用列表或者元祖方式传参。示例：处理GET和POST请求fromsanicimportSanicfromsanic.responseimporttext,jsonapp=Sanic('Example_App')@app.route('/get',methods=['GET'])asyncdefhandle_get(request):returntext('GETrequest')@app.route('/post',methods=['POST'])asyncdefhandle_post(request):returnjson({"message":"POSTrequest","data":request.json})if__name__=='__main__':app.run(host='0.0.0.0',port=8000)12345678910111213141516get请求post请求路由参数在Sanic中，你可以很容易地定义带有参数的路由。这些参数可以是URL的一部分，并且可以通过请求对象（request）访问。Sanic提供了两种主要的带参数路由类型：路径参数（PathParameters）和请求参数（QueryParameters）。路径参数（PathParameters）路径参数是URL路径的一部分，被尖括号（）包围。在路由处理函数中，你可以通过位置参数或关键字参数（如果指定了参数名）来访问这些参数。fromsanicimportSanicfromsanicimportresponseapp=Sanic("My-App")#使用位置参数@app.route("/user/")asyncdefhandle_user_id(request,user_id):returnresponse.json({"user_id":user_id})#使用关键字参数（推荐做法，因为它更清晰）@app.route("/user/")asyncdefhandle_user_id_with_type(request,user_id:int):#这里你可以假定user_id是一个整数，因为我们在路由中指定了它returnresponse.json({"user_id":user_id})#你可以指定参数的类型，Sanic会尝试将参数转换为指定的类型#如果没有指定类型，Sanic将参数视为字符串if__name__=="__main__":app.run(host="0.0.0.0",port=8000)123456789101112131415161718192021获取路径参数请求参数（QueryParameters）请求参数是附加在URL的?之后的部分，并以key=value的形式出现，多个参数之间用&分隔。这些参数不是路由定义的一部分，而是在请求时由客户端提供的。你可以在路由处理函数中通过请求对象（request）的args属性访问它们。fromsanicimportSanicfromsanicimportresponseapp=Sanic("My-App")@app.route("/search")asyncdefhandle_search(request):#访问请求参数search_query=request.args.get('query','')returnresponse.json({"query":search_query})if__name__=="__main__":app.run(host="0.0.0.0",port=8000)12345678910111213在这个例子中，/search路由不直接包含任何路径参数，但是它可以处理像/search?query=something这样的请求，其中query是一个请求参数。通过request.args.get('query','')，我们尝试获取名为query的请求参数的值，如果它不存在，则返回空字符串作为默认值。Sanic的路由系统非常灵活，允许你轻松地定义和使用带参数的路由，无论是路径参数还是请求参数。请求对象在Sanic中，每个请求都封装在一个Request对象中，该对象提供了许多有用的方法和属性，以便你能够访问请求的各种信息，如URL参数、查询字符串、请求头、请求体等。示例：访问请求信息fromsanicimportSanic,requestfromsanic.responseimportjsonapp=Sanic('RequestExample')@app.route('/info')asyncdefhandle_info(request):#访问URL参数url_param=request.args.get('param','NotFound')#访问查询字符串query_string=request.query_string#访问请求头user_agent=request.headers.get('User-Agent','Unknown')#访问请求体（假设是JSON）try:request_body=request.jsonexceptException:request_body="InvalidJSON"returnjson({"url_param":url_param,"query_string":query_string,"user_agent":user_agent,"request_body":request_body})if__name__=='__main__':app.run(host='0.0.0.0',port=8000)12345678910111213141516171819202122232425262728293031在这个例子中，我们创建了一个/info路由，它演示了如何访问URL参数、查询字符串、请求头和请求体。注意，当尝试访问请求体作为JSON时，如果请求体不是有效的JSON，则会捕获异常并返回一个默认值。响应对象Sanic的响应对象（通常是通过函数返回值隐式创建的）提供了多种方法来构建HTTP响应。除了之前提到的text和json之外，还有HTTPResponse、file、stream等多种响应类型。示例：使用HTTPResponsefromsanicimportSanic,HTTPResponseapp=Sanic('HTTPResponse-Example')@app.route('/custom')asyncdefhandle_custom(request):returnHTTPResponse("CustomResponse",200,headers={"Custom-Header":"jingtian"})if__name__=='__main__':app.run(host='0.0.0.0',port=8000)12345678910在这个例子中，我们使用HTTPResponse类来创建一个自定义的HTTP响应，包括状态码、响应体和额外的响应头。