Sijax 代表’Simple Ajax’,它是一个 Python/jQuery 库,旨在帮助 Flask 开者者轻松地将 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 请求)。
要使 View 函数能够处理 Sijax 请求,可以使用@app.route('/url',methods = ['GET','POST'])
通过 POST 对其进行访问,或使用类似@flask_sijax.route
辅助装饰器 -
@flask_sijax.route(app, '/hello')
每个 Sijax 处理函数(像这样)都会自动接收至少一个参数,就像 Python 将“self”传递给对象方法一样。‘obj_response’参数是函数返回浏览器的对象。
def say_hi(obj_response):
obj_response.alert('Hi sijax!')
当检测到 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 执行适当的(之前注册的)函数并将响应返回给浏览器。