Flask – Sijax

Sijax 代表 “簡單 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 請求）。

要使 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 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 執行相應的（之前註冊的）函式並將響應返回到瀏覽器。