（八）Flask之app.route装饰器函数的参数

app.route参数

app.route()

是Flask框架中用于定义路由的装饰器函数，它接受一些参数来指定路由的URL规则、请求方法等。

app.route()

参数如下：

1. rule（必选）：定义URL规则的字符串，表示要匹配的URL路径。可以包含动态部分，使用尖括号(< >)来指定动态部分的名称和类型。例如：/user/<username>。
2. view_func（必选）：用于指定将要执行的视图函数，即处理请求的函数。它接受一个函数作为值。这个函数通常是一个Flask应用程序中定义的视图函数，用于处理路由匹配后的请求。例如：@app.route('/index')defindex():return'Hello, World!'在这个例子中，view_func就是index函数，它会在匹配到/index路径时被调用。通过将视图函数传递给view_func参数，我们可以将路由和视图函数关联起来，以便在匹配到相应的URL规则时执行相应的视图函数。
3. methods（可选）：定义允许的HTTP请求方法。可以是一个字符串或一个包含多个字符串的列表。默认情况下，允许GET请求。例如：methods=['GET', 'POST']。
4. endpoint（可选）：为路由定义一个唯一的端点名称，**用于反向生成URL，即： url_for(‘名称’)**。如果未指定，默认使用视图函数的名称。例如：endpoint='index'。
5. defaults（可选）：为动态部分提供默认值，以便在没有提供相应值时使用。默认值是一个字典。例如：defaults={'page': 1}。> 在Flask中，我们可以使用尖括号(> > < >> > )来定义动态路由部分，例如> > <username>> > 。这样的路由规则可以匹配不同的URL路径，其中动态部分的值会作为参数传递给视图函数进行处理。> > 然而，有时候在处理请求时可能没有提供相应的动态部分值，或者我们希望在没有提供值时使用一些默认值。这时，就可以使用> > defaults> > 参数来指定默认值。> > > > defaults> > 参数接受一个字典作为值，字典的键是动态路由部分的名称，值是对应的默认值。当没有提供对应动态部分的值时，Flask将使用默认值来替代。> > 举例：@app.route('/user/<username>', defaults={'username':'GuHanZhe','page':1})defuser_profile(username, page):returnf"Username: {username}, Page: {page}"> 在上面的示例中，我们定义了一个路由规则> > /user/<username>> > ，并为其中的动态路由部分> > username> > 提供了默认值：GuHanZhe。同时，我们还添加了一个名为> > page> > 的动态路由部分，并通过> > defaults> > 参数为其提供了默认值为1。> > 当访问> > /user/johndoe> > 时，> > username> > 参数将被设置为> > johndoe> > ，而> > page> > 参数将使用默认值1。因此，视图函数> > user_profile> > 将返回> > "Username: johndoe, Page: 1"> > ；> > 如果提供了> > page> > 参数，例如访问> > /user/johndoe?page=2> > ，则> > page> > 参数将被设置为2，并覆盖默认值。所以，视图函数将返回> > "Username: johndoe, Page: 2"> > 。> > 通过使用> > defaults> > 参数，我们可以方便地为动态路由部分提供默认值，以应对没有提供相应值的情况。
6. host（可选）：限制路由只匹配特定的主机名。例如：host='example.com'。
7. strict_slashes（可选）：控制是否严格匹配URL末尾的斜杠。默认情况下，路由规则对URL末尾的斜杠是不敏感的，即此参数值为False。这意味着/user和/user/被视为相同的URL路径，并且可以匹配到同一个路由规则，但可以通过设置为True来禁用这个行为。例如：strict_slashes=True，这样Flask将不会自动处理URL末尾的斜杠。这意味着/user和/user/被视为不同的URL路径，需要分别定义对应的路由规则才能匹配到。
8. subdomain（可选）：限制路由只匹配特定的子域名。可以是一个字符串或一个包含多个字符串的列表。例如：subdomain='api'。
9. redirect_to（可选）：如果设置为另一个URL，会将请求重定向到该URL。例如：redirect_to='/new-url'。

这些参数可以根据需要进行组合使用，以定义具体的路由规则。通过使用这些参数，可以创建出符合需求的路由规则，并将它们与相应的视图函数关联起来。

redirect_to=None,    重定向到指定地址
    如：
        @app.route('/index/<int:nid>', redirect_to='/home/<nid>')
        或def func(adapter, nid):return"/home/888"@app.route('/index/<int:nid>', redirect_to=func)

subdomain=None,    子域名访问

defaults参数举例：

from flask import Flask

app = Flask(__name__)@app.route('/index', defaults={'nid':'xxx'})defindex(nid):print(nid)return'Index'if __name__ =='__main__':
    app.run('localhost',4000)

redirect_to举例：

from flask import Flask

app = Flask(__name__)@app.route('/index', redirect_to='/new')defindex(nid):print(nid)return'老功能'@app.route('/new')defnew():return'新功能'if __name__ =='__main__':
    app.run('localhost',4000)

subdomain举例：

在 Flask 中，路由的

subdomain

参数可以用于匹配 URL 中的子域名，其中子域名是 URL 中域名部分的前缀。例如，

blog.example.com

中的子域名是

blog

，而父域名是

example.com

。

下面是使用子域名参数的 Flask 路由示例：

from flask import Flask

app = Flask(__name__)@app.route('/', subdomain='www')defindex():return'Welcome to the main site!'@app.route('/', subdomain='blog')defblog():return'Welcome to the blog!'if __name__ =='__main__':
    app.run()

在上面的代码中，我们定义了两个路由函数

index()

和

blog()

，它们分别为主域名和子域名设置了路由。其中，

subdomain

参数指定了路由函数应该匹配的子域名。

如果我们访问主域名

http://www.example.com/

，Flask 会将请求路由到

index()

视图函数，而子域名

http://blog.example.com/

的请求则会被路由到

blog()

视图函数。

需要注意的是，为了使用子域名参数，我们需要在部署 Flask 应用程序时配置 DNS 服务器或负载均衡器，使其将子域名指向正确的服务器。在本地开发环境中，我们可以在系统的 hosts 文件（windows系统这个文件路径：

C:\Windows\System32\drivers\etc

）中添加一条域名映射，实现子域名的模拟。

总之，使用 Flask 的

subdomain

参数可以为应用程序添加更加灵活和精细的路由规则，提升应用程序的可用性和用户体验。