Flask – Sijax
Sijax 是 Simple Ajax 的缩写,它是一个 Python/jQuery 库,旨在帮助你轻松地将 Ajax 引入你的应用程序。它使用 jQuery.ajax 来进行AJAX请求。
安装
Flask-Sijax的安装很简单。
pip install flask-sijax
配置
- 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请求)。
要使 视图 函数能够处理 Sijax 请求,请使用 @app.route(‘/url’, methods = [‘GET’, ‘POST’]) 或使用 @flask_sijax.route helper装饰器,使其能够通过POST访问。
@flask_sijax.route(app, '/hello')
每个Sijax处理函数(比如这个)都会自动接收至少一个参数,就像Python向对象方法传递’self’一样。参数 ‘obj_response’ 是该函数与浏览器对话的方式。
def say_hi(obj_response):
obj_response.alert('Hi there!')
当检测到Sijax请求时,Sijax是这样处理的:
g.sijax.register_callback('say_hi', say_hi)
return g.sijax.process_request()
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执行相应的(之前注册的)函数,并将响应返回给浏览器。