基于hi-nginx的web开发(python篇)——动态路由和请求方法

hi.py的提供的路由装饰器接受两个参数,第一个参数指定动态路由的正则模式,第二个参数指定同意的http请求方法列表。

比如:

@app.route(r"^/client/?$",['GET','POST'])
 def client(req,res,param):
     res.content('{}<br>{}<br>{}<br>{}<br>{}'.format(req.client(),req.method(),req.uri(),req.user_agent(),req.param()))
     res.status(200)

这个路由指定uri为/client或者/client/,同时请求方法为GET或者POST的http请求由函数client(req,res,param)来处理。uri模式由正则表达式构成,请求方法参数由一个list表示,可接受的方法名包括:GET,POST,PUT,HEAD,PATCH等,凡nginx能理解的http方法名均可。

处理函数有三个参数,分别是req,res和param。它们分别是hi_req,hi_res和由正则表达式引出的group dict。前两者是有hi-nginx提供的api,它们提供一系列方法来操控http协议:

hi_req

  • uri
  • method
  • client
  • param
  • user_agent
  • has_header
  • get_header
  • has_form
  • get_form
  • has_session
  • get_session
  • has_cookie
  • get_cookie

hi_res

  • status
  • content
  • header
  • session

处理函数的第三个参数param可用来解析由正则模式提供的数据,比如:

@app.route(r"^/hello/(?P<who>\w+)?$",['GET'])
 def hello(req,res,param):
     res.content('{}={}'.format('who',param['who']))
     res.status(200)

正则模式^/hello/(?P<who>\w+)?$ 是python re模块可以理解的模式,当uri为/hello/cnblogs时,其中的参数param就会是一个包含以who为键,以cnblogs为其值的dict字典。因此,它可以用来为操作函数提供表单以外的数据,还能美化uri。比如/hello?who=cnblogs就不如/hello/cnblogs美观简洁。

另外,同一个操作函数也可以对应多个路由规则,比如:

@app.route(r'^/test/?$',['POST'])
 @app.route(r"^/$",['GET'])
 def hello_world(req,res,param):
     res.header('Content-Type','text/plain;charset=utf-8')
     res.content('hello,world')
     res.status(200)

在上面的代码中,操作函数hello_world在uri为/或者/test或者/test/时均能被调用,前提是一个要求请求方法是GET,另一个则要求是POST方法。这种一个函数对应多个路由的功能消除了写下面这种代码的麻烦:

if req.method()=='GET':
     ...
 if req.method()=='POST':
     ...

相关推荐