Flask 简明教程

Flask – Sijax

Sijax 代表 ‘Simple Ajax’ ，它是 Python/jQuery 库，旨在帮助您轻松地将 Ajax 引入到您的应用程序中。它使用 jQuery.ajax 发起 AJAX 请求。

Installation

安装 Flask-Sijax 非常简单。

pip install flask-sijax

Configuration

  1. SIJAX_STATIC_PATH − 您希望镜像 Sijax javascript 文件的静态路径。默认位置是 static/js/sijax 。在该文件夹中， sijax.js 和 json2.js 文件会被保存。

  2. SIJAX_JSON_URI − 从此加载 json2.js 静态文件的 URI

Sijax 使用 JSON 在浏览器和服务器之间传递数据。这意味着浏览器要么需要原生支持 JSON ，要么通过 json2.js 文件获取 JSON 支持。

那样注册的函数无法提供 Sijax 功能，因为默认情况下无法通过 POST 方法访问它们（而 Sijax 使用 POST 请求）。

要使 View 函数能够处理 Sijax 请求，可通过 POST 使用 @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!')

当检测到 Sijax 请求时，Sijax 会像这样处理它 −

g.sijax.register_callback('say_hi', say_hi)
   return g.sijax.process_request()

Sijax Application

一个最小的 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 执行适当的（先前注册的）函数并将响应返回至浏览器。