Flask二之快速入门

一.一个最小的Flask应用

from flask import Flask
app = Flask(__name__)
#app是程序实例,一个项目只能有一个程序实例
@app.route('/')
#路由装饰器
def hello_world():
#视图函数
    return 'Hello World!'    
    #返回一个字符串
if __name__ == '__main__':
    app.run()

把程序保存为hello.py 用Python解释器运行

$ python hello.py
    * Running on  http://127.0.0.1:5000/

访问 http://127.0.0.1:5000/ ,会看见 Hello World 问候。欲关闭服务器,按 Ctrl+C。

这段代码做了什么?

  1. 首先,我们导入了 Flask 类。这个类的实例将会是我们的 WSGI 应用程序
    2.接下来,我们创建一个该类的实例,第一个参数是应用模块或者包的名称。 如果你使用单一的模

块(如本例),你应该使用 name ,因为模块的名称将会因其作为单独应用启动还是作为模
块导入而有不同( 也即是 '__main__' 或实际的导入名)。这是必须的,这样 Flask 才知道到哪
去找模板、静态文件等等。 详情见 Flask的文档。

  1. 然后,我们使用 route() 装饰器告诉 Flask 什么样的URL 能触发我们的函数。
    4.这个函数的名字也在生成 URL 时被特定的函数采用,这个函数返回我们想要显示在用户浏览器中

的信息。
5.最后我们用 run() 函数来让应用运行在本地服务器上。 其中 if name =='__main__': 确保服务器
只会在该脚本被 Python 解释器直接执行的时候才会运行,而不是作为模块导入的时候。

(1)调试模式

如果你启用了调试支持,服务器会在代码修改后自动重新载入,并在发生错误时提供一个相当有用的调试器。
有两种途径来启用调试模式:
一种是直接在应用对象上设置:

app.debug = True
app.run()

另一种是作为 run 方法的一个参数传入:

app.run(debug=True)

两种方法的效果完全相同。
【注意】

  • 交互式调试器绝对不能用于生产环境。

(2)路由装饰器

@app.route('/')
def index():
    return 'Index'
    
@app.route('/hello/')
def hello():
    return '<h1>Hello world!</h1>'

这个函数的返回值称为响应,是客户端接收到的内容。
像 index() 这样的函数称为视图函数(view function)。视图函数返回的响应可
以是包含HTML 的简单字符串,也可以是复杂的表单。

(3)变量规则

@app.route('/user/<name>')
def showUserName(name):
    return "User %s" %name
    
@app.route('/post/<int:post_id>')
def showPostId(post_id):
    return "Post %d" %post_id

Flask 支持在路由中使用 int、 float 和 path 类型。path 类型也是字符串,但
不把斜线视作分隔符,而将其当作动态片段的一部分。
int | 接受整数
float | 接受浮点数
path | 和默认的相似,但也接受斜线
变量规则的意义:处理动态信息。
【注意】

  1. app.route()函数中中括号里的是变量名,必须与视图函数的形参名一致!

  2. 如果是int或float类型,不能直接return!必须要转换为字符串格式才可以,否
    则会报错:TypeError: 'int' object is not callable

(4)唯一 URL / 重定向行为

@app.route('/about/') # 建议用法
# @app.route('/about') # 不建议用法
def about():
    return 'The about page'

虽然它们看起来着实相似,但它们结尾斜线的使用在 URL 定义 中不同:

- 第一种情况中,指向 about的规范 URL 尾端有一个斜线。这种感觉很像在文件系
统中的文件夹。访问一个结尾不带斜线的 URL 会被 Flask 重定向到带斜线的规范
URL 去。因此, 强烈建议统一加上斜线!
- 第二种情况的 URL 结尾不带斜线,类似 UNIX-like 系统下的文件的路径名。访问
结尾带斜线的URL 会产生一个 404 “Not Found” 错误。

这个行为使得在遗忘尾斜线时,允许关联的 URL 接任工作,与 Apache 和其它的服
务器的行为并无二异。此外,也保证了 URL 的唯一,有助于避免搜索引擎索引同一
个页面两次。

(5)重定向和错误

  • 用 redirect() 函数把用户重定向到其它地方。

  • 用 abort() 函数放弃请求并返回错误代码。例如:

@app.route('/redir/')
def redir():
    return redirect('/login/')
@app.route('/login/')
def login():
    abort(401)

用户会从/redir/重定向到一个不能访问的页面 (401 意味着禁止访问)。

(6)构造URL

用 url_for()来给指定的函数生成(构造) URL。它接受函数名作为第一个参数,
也接受对应 URL 规则的变量部分的命名参数。例如:

@app.route('/world/')
def world():
    # return redirect('/hello/')
    # return redirect(url_for('hello'))
    # return redirect(url_for('showUserName',name = 'liusheng'))
    return redirect(url_for('showPostId', post_id = 100)) 
    # 注意这里的100可以是字符串也可以是整型

使用url_for()生成 URL 而非在模板中硬编码的好处:

1. 反向构建通常比硬编码的描述性更好。允许一次性修改 URL,而不用到处边找边改。
2. URL 构建会转义特殊字符和 Unicode 数据,免去你很多麻烦。

(7)使用Flask-Script支持命令行选项

Flask-Script 是一个 Flask 扩展,为 Flask 程序添加了一个命令行解析器。
Flask-Script 自带了一组常用选项,而且还支持自定义命令。

Flask-Script 扩展使用 pip 安装:

(venv) $ pip install flask-script

把命令行解析功能添加到 hello.py 程序中时需要修改的地方:

from flask_script import Manager
manager = Manager(app)
if __name__ == '__main__':
    manager.run()

修改之后程序可以使用一组基本命令行选项来启动 Web 服务器。:

python hello.py runserver
--host HOST  |设置host为 HOST
--port PORT  |设置port为 PORT
-d           |设置以debug模式运行而非run模式
-r           |设置自动重新载入(app.debug为True)

标准命令:

python hello.py runserver -d -r --host 0.0.0.0
python hello.py runserver -d -r --port:5001

相关推荐