软硬件环境
- Windows 10 64bit
- Anaconda3 with python 3.7
- PyCharm 2019.3
- Flask 1.1.1
路由
什么是路由
路由(Routing
)是用来映射URL
和执行对应任务的函数。通过设置不同的路由,来访问不同的页面,像上一节中的/
路由,就是访问网站的根目录。
实例
下面来看一个实例
from flask import Flask
app = Flask(__name__)
@app.route('/home')
def index():
return "Welcome to home!"
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
这时候去访问http://127.0.0.1:5000
就会出现404错误
因为我们代码里根本就没有处理/
路由的请求,访问http://127.0.0.1:5000/home
,页面才会显示Welcome to home!
那么另一个问题来了,如果有多条路由,比如/home/shelly
、/home/tom
和、/home/carl
,能不能在同一个函数中进行处理呢?答案是可以的,我们可以通过给@app.route
传递变量的方式实现,如下
from flask import Flask
app = Flask(__name__)
@app.route('/home/<name>')
def index(name):
return f"Welcome to home!{name}"
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
这时候访问http://127.0.0.1:5000/home/carl
,页面上就会显示Welcome to home!carl
;访问http://127.0.0.1:5000/home/shelly
,页面上就会显示Welcome to home!shelly
了
可以看到上面的实例中,传递的参数是字符串类型,那如果是其它数据类型,怎么办呢?看下面这个实例
from flask import Flask
app = Flask(__name__)
# 特别注意,int后面冒号前后不能有空格
@app.route('/home/<int:age>')
def index(age):
return 'Age={}'.format(age)
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
这个时候我们就可以传递整型数据了 ,比如http://127.0.0.1:5000/home/20
除了上述添加路由的方法,Flask
还提供了一个函数add_url_rule
,它也能够完成同样的功能,看个实例
from flask import Flask
app = Flask(__name__)
def index():
return 'Hello flask!'
app.add_url_rule('/', "index", index)
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
访问http://127.0.0.1:5000
,可以看到页面显示Hello flask!
,效果跟使用@app.route
是一模一样的
模板
在前面的教程中,我们的页面只是显示了一些简单的字符,还没有使用到html
的各种元素,本节开始学习Flask
当中的模板,来创建更加复杂、更加美观的网页。
在视图函数中使用html
先来看个实例
from flask import Flask
app = Flask(__name__)
@app.route('/')
def index():
return '<html><body><h1>Hello flask!</h1></body></html>'
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
在视图函数index
中,返回的是一个html
的字符串,标签<h1>
表示的是一级标题,访问http://127.0.0.1:5000
,可以看到标题版的Hello flask!
但是考虑到实际的网页内容都很复杂,把html
都写在视图函数里显然是不现实的,这个时候模板就出现了。
模板的使用
Flask
提供了Jinja2
模板引擎,它可以渲染外部的html
网页文件,对应的函数是render_template
,看下面这个例子
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/')
def index():
return render_template('index.html')
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
接下来我们在工程下创建一个文件夹templates
(Flask
默认存放html
文件的地方,static
存放静态文件,如js
、css
、图片等),然后在文件夹下新建index.html
,输入下面的代码
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Index</title>
</head>
<body>
<h1>Hello flask!</h1>
</body>
</html>
访问http://127.0.0.1:5000
,可以看到标题是Index
,内容是Hello flask!
,同时也可以通过浏览器去查看网页的源代码,内容跟上面的index.html
文件是一样的
接下来就有个问题了,既然html
内容已经独立出来了,怎么将数据通过视图传递到模板文件呢?来看下面这个实例
index.html
文件内容
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<title>Index</title>
</head>
<body>
<h1>Hello {{ name }}!</h1>
</body>
</html>
run.py
则变成
from flask import Flask, render_template
app = Flask(__name__)
@app.route('/<name>')
def index(name):
return render_template('index.html', name=name)
if __name__ == '__main__':
app.run(host="127.0.0.1",port=5000,debug=True)
可以看到我们在html
文档中使用了{{ name }}
这条语句,这是Jinja2
模板中的定界符,这个name
就是视图传递过来的数据。常用的定界符有如下几个
- {% ... %} 代表这是语句块
- {{ ... }} 获取表达式的值
- {# ... #} 代表注释
来到视图部分,我们接受URL
传递过来的数据,然后通过render_template
传递给html
文档
最后程序执行的效果如下