# -*- coding: utf-8 -*-
"""lab02_request_response · 第1章 Flask 基础（请求与响应）（端口 5111）

本节重点（对应教材配套 PPT，授课：谢福财）：
    - request 对象：method / path / args / headers / remote_addr 分别取什么
    - Cookie：浏览器侧存储，用 set_cookie 写、request.cookies 读
    - Session：服务器侧会话，靠 secret_key 签名，session['user'] 记住登录
    - 响应对象：make_response 之后才能改状态码与响应头
    - 重定向与注销：redirect + session.pop 清登录态

运行：
    ..\\.venv\\Scripts\\python.exe app.py      # 或双击 run.bat / PyCharm 点绿三角
    浏览器打开 http://127.0.0.1:5111/

说明：本文件每一段都有注释；带 ★ 的行是这一讲要重点看的代码。
"""

from flask import Flask, request, make_response, session, redirect, url_for

app = Flask(__name__)
app.secret_key = 'shefucai-key'  # Session 加密密钥（没有它 session 会报错）


# ★ 本节重点：首页：读 Cookie 里的访问次数 +1 再写回，并显示 Session 里的用户名
@app.route('/')
def index():
    # 读 Session：登录后才有 user
    user = session.get('user')
    visit = int(request.cookies.get('visit', 0)) + 1          # ① 从 Cookie 读上次的计数
    who = user if user else '游客'
    html = f'''<h1>你好，{who}！（第 {visit} 次访问）</h1>
    <p><a href="/login">/login 登录（写Session）</a> |
       <a href="/info">/info 看请求信息</a> |
       <a href="/logout">注销（删Session）</a> |
       <a href="/status">/status 自定义404响应</a></p>
    <p>《Web 程序开发（Python Web）》· 配套代码 · 谢福财</p>'''
    resp = make_response(html)                                # ② 包成响应对象才能改头
    resp.set_cookie('visit', str(visit), max_age=86400)       # ③ 把新计数写回 Cookie（1天有效）
    return resp


# ★ 本节重点：GET 显示表单，POST 把用户名写进 Session
@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':                              # 取表单：request.form 字典
        name = request.form.get('username', '').strip()
        if name:
            session['user'] = name                            # 写 Session
            return redirect(url_for('index'))
    return '''<form method="post">
      <input name="username" placeholder="输入昵称">
      <button>登录</button></form>'''


# ★ 本节重点：注销：删掉 Session 里的 user 再跳回首页
@app.route('/logout')
def logout():
    session.pop('user', None)                                 # 删 Session 键
    return redirect(url_for('index'))


# ★ 本节重点：把 request 的六个常用属性一次性打印出来
@app.route('/info')
def info():
    # request 对象的常用属性一览
    rows = [
        ('request.method', request.method),                   # 请求方法
        ('request.path', request.path),                       # 路径
        ('request.args（查询参数）', dict(request.args)),       # ?a=1&b=2
        ('request.headers[User-Agent]', request.headers.get('User-Agent', '')[:60]),
        ('request.remote_addr（来源IP）', request.remote_addr),
        ('session', dict(session)),
    ]
    trs = ''.join(f'<tr><th>{k}</th><td>{v}</td></tr>' for k, v in rows)
    return f'<h1>request 会告诉你一切</h1><table border=1 cellpadding=6>{trs}</table><p><a href="/">返回</a></p>'


# ★ 本节重点：演示 make_response 自定义状态码（含 404/500 链接）
@app.route('/status')
def status():
    # 本页本身返回 200；下面两个链接分别演示"故意返回 404 / 500"
    # 状态码不是框架写死的，make_response 的第二个参数就能改
    return '''<h1>状态码由你决定</h1>
    <p>访问本页 → <b>200</b>（正常）。点下面的链接，看服务端如何主动返回错误码：</p>
    <ul>
      <li><a href="/status/404">/status/404</a> → 404 资源不存在</li>
      <li><a href="/status/500">/status/500</a> → 500 服务器内部错误</li>
      <li><a href="/status/403">/status/403</a> → 403 禁止访问</li>
    </ul>
    <p>打开浏览器 F12 → Network，能看到每条的 Status 列确实变了。</p>
    <p><a href="/">返回首页</a></p>'''


@app.route('/status/<int:code>')
def status_code(code):
    # make_response(内容, 状态码)：这就是自定义响应的最短写法
    resp = make_response(f'<h1>自定义状态码：{code}</h1>'
                         f'<p><a href="/status">回到 /status</a></p>', code)
    return resp


if __name__ == '__main__':
    app.run(debug=True, port=5111)
