Jinja2 FastAPI:来自Python模板的不同数量的输入项

Jinja2 是一个现代的、设计友好的 Python 模板引擎，用于生成 HTML、XML 或其他标记语言。FastAPI 是一个用于构建 API 的现代、快速（高性能）的 web 框架，基于 Python 3.7+ 的类型提示。结合 Jinja2 和 FastAPI 可以创建动态的 web 应用程序。

基础概念

Jinja2:

模板继承: 允许创建一个基础模板，其他模板可以继承并覆盖特定部分。
宏: 类似于函数，可以在模板中定义并重用代码片段。
过滤器: 用于在模板中对变量进行处理，如格式化日期、字符串操作等。

FastAPI:

依赖注入: 自动解析和注入函数参数。
数据验证: 使用 Pydantic 进行严格的输入数据验证。
自动生成交互式 API 文档: 提供 Swagger UI 和 ReDoc。

类型

Jinja2 模板: HTML、XML、JSON 等。
FastAPI 路由: GET、POST、PUT、DELETE 等 HTTP 方法。

应用场景

Web 开发: 创建动态网站和 API。
微服务: 构建轻量级、独立的服务。
自动化报告: 生成基于数据的报告。

遇到的问题及解决方法

问题: 在使用 Jinja2 模板时，如何处理不同数量的输入项？

原因: 当需要渲染的页面依赖于不确定数量的数据时，直接在模板中硬编码可能会导致问题。

解决方法:

使用循环: 在 Jinja2 中，可以使用 {% for item in items %} 来遍历列表中的每个元素。

# FastAPI 视图函数
from fastapi import FastAPI
from fastapi.responses import HTMLResponse
from jinja2 import Template

app = FastAPI()

@app.get("/items/", response_class=HTMLResponse)
async def read_items():
    items = ["Apple", "Banana", "Cherry"]
    template = Template("""
    <ul>
    {% for item in items %}
        <li>{{ item }}</li>
    {% endfor %}
    </ul>
    """)
    return template.render(items=items)

条件渲染: 如果某些元素需要根据条件显示，可以使用 {% if condition %}。

# 在模板中添加条件判断
template = Template("""
<ul>
{% for item in items %}
    {% if item != 'Banana' %}
        <li>{{ item }}</li>
    {% endif %}
{% endfor %}
</ul>
""")

传递字典: 如果数据结构更复杂，可以传递一个字典并在模板中解包。

# 传递字典
data = {
    "fruits": ["Apple", "Banana"],
    "vegetables": ["Carrot", "Broccoli"]
}

template = Template("""
<ul>
{% for category, items in data.items() %}
    <h2>{{ category }}</h2>
    {% for item in items %}
        <li>{{ item }}</li>
    {% endfor %}
{% endfor %}
</ul>
""")

通过这些方法，可以灵活地处理不同数量和类型的输入项，确保模板渲染的正确性和效率。