# -*- coding: utf-8 -*-
"""lab01_flask_routing · 第1章 Flask 基础（端口 5110）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - Flask 应用最小结构：Flask(__name__) + @app.route + app.run
    - 固定路由与动态路由：/user/<name> 把 URL 片段当参数
    - 转换器：<int:post_id> 只匹配整数，非数字直接 404
    - 重定向：redirect(url_for(...)) 用“函数名”反查地址，不写死 URL
    - 主动抛状态码：abort(404) 让框架返回标准 404 页

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5110/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

from flask import Flask, abort, redirect, url_for

app = Flask(__name__)                          # 建应用实例


# ---------- 1. 固定路由：一个地址对一个函数 ----------
# ★ 本节重点：首页：把四条演示路由列出来，便于逐个点开
@app.route('/')
def index():
    return '''<h1>Flask Routing Demo</h1>
<p>
  <a href="/user/xiefucai">/user/xiefucai</a> |
  <a href="/post/1">/post/1</a> |
  <a href="/redirect">/redirect</a> |
  <a href="/nothing">/nothing</a>
</p>
<p>lab01 · routing basics</p>'''


# ---------- 2. 动态路由：URL 里的值当作参数 ----------
# ★ 本节重点：动态路由：URL 里的名字直接作为函数参数
@app.route('/user/<name>')
def user(name):
    return f'<h1>Hello, {name}!</h1><p>这一段是视图函数用 f-string 拼出来的。</p><a href="/">back</a>'


# ---------- 3. int 转换器：只吃整数，/post/abc 进不来 ----------
# ★ 本节重点：int 转换器：只接受整数，顺便打印参数类型
@app.route('/post/<int:post_id>')
def post(post_id):
    return (f'<h1>Post #{post_id}</h1>'
            f'<p>post_id 的类型是 int：{type(post_id).__name__}</p>'
            f'<a href="/">back</a>')


# ---------- 4. 重定向：访问 /redirect 跳到 /user/xiefucai ----------
# ★ 本节重点：重定向：跳到 /user/xiefucai，演示 url_for 反查
@app.route('/redirect')
def go_home():
    return redirect(url_for('user', name='xiefucai'))


# ---------- 5. 主动抛 404：地址没注册会走这里 ----------
# ★ 本节重点：主动 abort(404)：演示“地址存在但内容是错误码”
@app.route('/nothing')
def nothing():
    abort(404)


if __name__ == '__main__':
    app.run(debug=True, port=5110)             # 端口 5110，debug 仅本地用
