Flask Sijax
Sijax 代表 'Simple Ajax' ,它是一个 Python/jQuery 库,旨在帮助您轻松地将 Ajax 引入到您的应用程序。它使用 jQuery.ajax 来发出AJAX请求。
1. 安装
Flask-Sijax的安装很简单。
pip install flask-sijax
2. 组态
- SIJAX_STATIC_PATH - 要被镜像的Sijax javascript文件的静态路径。默认位置是 static/js/sijax 。在此文件夹中,保留 sijax.js 和 json2.js 文件。
- SIJAX_JSON_URI - 从中加载json2.js静态文件的URI
Sijax使用 JSON 在浏览器和服务器之间传递数据。这意味着浏览器需要本机支持 JSON 或从 json2.js 文件支持 JSON 支持。
以这种方式注册的函数不能提供 Sijax 功能,因为默认情况下无法使用 POST 方法访问它们(并且Sijax使用POST请求)。
要使 View 函数能够处理 Sijax 请求,请使用 @app.route('/url',methods = [\'GET\' , \'POST\']) 或使用 @flask_sijax.route 辅助装饰器,如:
@flask_sijax.route(app, '/hello')
每个Sijax处理函数(像这样)都会自动接收至少一个参数,就像Python将'self'传递给对象方法一样。 'obj_response' 参数是函数回复浏览器的方式。
def say_hi(obj_response): obj_response.alert('Hi there!')
当检测到Ajax请求时,Sijax会像这样处理它:
g.sijax.register_callback('say_hi', say_hi) return g.sijax.process_request()
3. Sijax应用程序
最小的Sijax应用程序代码如下:
import os from flask import Flask, g from flask_sijax import sijax path = os.path.join('.', os.path.dirname(__file__), 'static/js/sijax/') app = Flask(__name__) app.config['SIJAX_STATIC_PATH'] = path app.config['SIJAX_JSON_URI'] = '/static/js/sijax/json2.js' flask_sijax.Sijax(app) @app.route('/') def index(): return 'Index' @flask_sijax.route(app, '/hello') def hello(): def say_hi(obj_response): obj_response.alert('Hi there!') if g.sijax.is_sijax_request: # Sijax request detected - let Sijax handle it g.sijax.register_callback('say_hi', say_hi) return g.sijax.process_request() return _render_template('sijaxexample.html') if __name__ == '__main__': app.run(debug = True)
当Sijax向服务器请求(特殊的 jQuery.ajax() 请求)时, g.sijax.is_sijax_request() 会在服务器上检测到此请求,在这种情况下,您让Sijax处理请求。
使用 g.sijax.register_callback() 注册的所有函数都会公开,以便从浏览器进行调用。
调用 g.sijax.process_request() 会告诉Sijax执行适当的(先前注册的)函数并将响应返回给浏览器。
下一章:Flask 部署
Flask+Gunicorn+Nginx是最常用的 Flask 部署方案。为什么使用 Flask+Gunicorn+Nginx。Flask 是一个web框架,而非web server,直接用Flask拉起的web服务仅限于开发环境使用,生产环境不够稳定,也无法承受大量请求的并发,在生产环境下需要使用服务器软件来处理各种请求,如Gunicorn、 Nginx或Apache,而Gunicorn+Nginx的搭配,好处多多。