Function Compute:Penangan HTTP

Signature penangan

Setiap penangan HTTP mengikuti signature WSGI:

def handler(environ, start_response):
    start_response('200 OK', [('Content-Type', 'text/html')])
    return [b'<h1>Hello, world!</h1>']

Nilai kembali harus berupa objek iterable. return [b'<h1>Hello, world!</h1>'] mengembalikan daftar yang berisi satu objek bytes, yang dikirimkan oleh waktu proses ke klien sebagai badan respons HTTP.

Untuk spesifikasi WSGI lengkap, lihat PEP 3333.

Migrasi aplikasi Flask ke Function Compute

Karena penangan HTTP mengikuti spesifikasi WSGI, aplikasi Flask dan Django hanya memerlukan satu fungsi adaptor untuk dijalankan di Function Compute.

Contoh berikut menjalankan aplikasi Flask hello world di waktu proses Python 3:

# Aplikasi Flask — definisikan rute seperti biasa
from flask import Flask

app = Flask(__name__)

@app.route('/')
def index():
    return 'Web App with Python Flask!'

# Penangan FC — meneruskan setiap permintaan ke aplikasi WSGI Flask
def handler(environ, start_response):
    return app(environ, start_response)

Contoh ini terdiri dari dua bagian:

• Aplikasi Flask (baris 1–7): Kode Flask standar. Tidak perlu perubahan.

• Penangan FC (baris 9–11): Adaptor minimal yang meneruskan environ dan start_response langsung ke aplikasi Flask. Hanya satu baris ini yang diperlukan untuk menjalankan framework apa pun yang kompatibel dengan WSGI di Function Compute.

Bidang permintaan (environ)

environ adalah kamus Python yang berisi semua data permintaan HTTP. Tabel berikut mencantumkan bidang yang paling umum digunakan dalam penangan Function Compute. Untuk daftar lengkap bidang, lihat variabel environ.

Contoh berikut membaca bidang umum dari environ:

HELLO_WORLD = b"Hello world!\n"

def handler(environ, start_response):
    # Konteks dan URI permintaan khusus FC
    context = environ['fc.context']
    request_uri = environ['fc.request_uri']

    # Iterasi header permintaan kustom (semua dimulai dengan HTTP_)
    for k, v in environ.items():
        if k.startswith("HTTP_"):
            pass  # proses header kustom di sini

    # Baca badan permintaan
    try:
        request_body_size = int(environ.get('CONTENT_LENGTH', 0))
    except ValueError:
        request_body_size = 0
    request_body = environ['wsgi.input'].read(request_body_size)

    # Baca bidang umum lainnya
    request_method = environ['REQUEST_METHOD']
    path_info = environ['PATH_INFO']
    server_protocol = environ['SERVER_PROTOCOL']

    try:
        content_type = environ['CONTENT_TYPE']
    except KeyError:
        content_type = " "

    try:
        query_string = environ['QUERY_STRING']
    except KeyError:
        query_string = " "

    print('request_body: {}'.format(request_body))
    print('method: {}\n path: {}\n query_string: {}\n server_protocol: {}\n'.format(
        request_method, path_info, query_string, server_protocol))

    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers)
    return [HELLO_WORLD]  # nilai kembali harus berupa iterable

Struktur respons (start_response)

Panggil start_response untuk mengatur status dan header respons sebelum mengembalikan badan respons. Waktu proses FC menyediakan callable ini dengan signature berikut:

# Disediakan oleh waktu proses FC.
# status: string seperti '200 OK' atau '403 FORBIDDEN'
# return: harus berupa callable write(body_data)
def start_response(status, response_headers, exc_info=None):
    ...

Untuk spesifikasi lengkap, lihat Callable start_response().

Badan respons yang dikembalikan oleh penangan harus berupa objek iterable.

Batasan

Langkah selanjutnya

• Konfigurasikan pemicu HTTP yang memanggil fungsi dengan permintaan HTTP

• Buat fungsi