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

app.route参数

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

app.route()参数如下：

1. rule（必选）：定义URL规则的字符串，表示要匹配的URL路径。可以包含动态部分，使用尖括号(< >)来指定动态部分的名称和类型。例如：/user/。

2. view_func（必选）：用于指定将要执行的视图函数，即处理请求的函数。它接受一个函数作为值。这个函数通常是一个Flask应用程序中定义的视图函数，用于处理路由匹配后的请求。

   例如：

   @app.route('/index')
   def index():
       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中，我们可以使用尖括号(< >)来定义动态路由部分，例如。这样的路由规则可以匹配不同的URL路径，其中动态部分的值会作为参数传递给视图函数进行处理。

   然而，有时候在处理请求时可能没有提供相应的动态部分值，或者我们希望在没有提供值时使用一些默认值。这时，就可以使用defaults参数来指定默认值。

   defaults参数接受一个字典作为值，字典的键是动态路由部分的名称，值是对应的默认值。当没有提供对应动态部分的值时，Flask将使用默认值来替代。

   举例：

   @app.route('/user/', defaults={'username': 'GuHanZhe', 'page': 1})
   def user_profile(username, page):
       return f"Username: {username}, Page: {page}"
   

   在上面的示例中，我们定义了一个路由规则/user/，并为其中的动态路由部分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/', redirect_to='/home/')
		或def func(adapter, nid):
		      return "/home/888"
		@app.route('/index/', redirect_to=func)

subdomain=None,	子域名访问

defaults参数举例：

from flask import Flask

app = Flask(__name__)


@app.route('/index', defaults={'nid': 'xxx'})
def index(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')
def index(nid):
    print(nid)
    return '老功能'


@app.route('/new')
def new():
    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')
def index():
    return 'Welcome to the main site!'

@app.route('/', subdomain='blog')
def blog():
    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 参数可以为应用程序添加更加灵活和精细的路由规则，提升应用程序的可用性和用户体验。