python route 知识总结

route 可以从url提取相应的参数,如controller,action或者其它用户自己定义的变量

1.Mapper().connect    Mapper().match

[python] copy

 

from Mapper  

• map = Mapper()  
• None"error/{action}/{id}""controller_obj"  
• result = map.match()    
• #result 匹配结果 'action', : u, : u}  
• None"/message/:name"'my_contro'  
• result = map.match()  
• #result 匹配结果 'controller', : u}  

2.route.middleware以及Mapper.resource

参照cinder 2013.1版代码写的

[python] copy

 

#!/usr/bin/env/python #coding=utf-8 from Mapper  

•  routes  middleware  
• import from make_server  
• class  __init__():  
•         .i =   
•  __call__():  
•          .i  
•  search():  
•            show():  
•            index():  
•            update():  
•            delete():  
•            create():  
•            create_many():  
•            update_many():  
•            list_many():  
•            delete_many():  
•           class  __init__():  
•         a = controller()  
•   
•   
•           
•   
•           
•   
•           
•   
•           
•   
•                           
•   
•           
• , ,controller=a,path_prefix=,  
•                     collection={:,:},  
• :,:})  
•         .route = middleware.RoutesMiddleware(.dispatch,map)  
•  
• .dec.wsgify  
•  __call__(,req):  
•          .route  
•  
•   
•     @webob  dispatch(req):  
• ][]  
•             match:  
•               ]  
• ]  
•          hasattr(controller,action):  
•  ret  
•         :  
•   if:  
• ,,app)  
•     server.serve_forever()  

 

分析：

1)webob.dec.wsgify是webob为WSGI应用程序提供的一个装饰器，作用是将一个函数转换成一个WSGI应用。
参考资料 http://tumblr.wachang.net/post/38149417931/python-paste-webob-3

2）routes.middleware.RoutesMiddleware,将接受到的url，自动调用map.match()方法，将url进 行路由匹配并将结果存入request请求的环境变量['wsgiorg.routing_args']，最后会调用其第一个参数给出的函数接口，即 self.dispatch。

参考资料   http://blog.csdn.net/networm3/article/details/8666150

3）map.connect 及map.resource均用来建立路由匹配条件

针对程序中的匹配条件1  

map.connect('/images',controller=a,action='search',conditions={'method':['GET']})

curl	路由匹配结果 （程序中的route match result is）	curl请求得到的结果
curl -X GET http://localhost:8088/images	{'action': u'search', 'controller': <__main__.controller object at 0x10c2b10>}	"do search()"

匹配条件指定了curl的动作为GET ，访问路径为images  对应的action 为search

匹配条件2 

map.connect('name',"/{action}/{pid}",controller=a)

curl	路由匹配结果 （程序中的route match result is）	curl请求得到的结果
curl -X GET  http://localhost:8088/show/hihi	{'action': u'show', 'controller': <__main__.controller object at 0x2203b10>, 'pid': u'hihi'}	"do show()"
curl -X POST  http://localhost:8088/failfunc/test	{'action': u'failfunc', 'controller': <__main__.controller object at 0x2203b10>, 'pid': u'test'}	"has no action:failfunc"

匹配条件没有指定curl的动作，因此所有的动作（PUT，POST，GET，。。）都匹配，第二个curl请求，匹配的action 为failfunc，pid为test，但是程序没有定义failfunc函数，报错

匹配条件3   

map.resource("message","messages",controller=a)  ,map.resource内部定义了默认的匹配条件
第一个参数message为 member_name(资源名），第二个参数messages为collection_name（资源集合名），一般定义资源集合名为资源名的复数,我这里随便取名

collection_name作为访问的路径名，且当没有传入参数controller时，controller=collection_name

map.resource("message","messages",controller=a) 等同于以下匹配条件：

map.connect('/messages',controller=a,action='index',conditions={'method':['GET']})

map.connect('/messages',controller=a,action='create',conditions={'method':['POST']})

map.connect('/messages/{id}',controller=a,action='show',conditions={'method':['GET']})

map.connect('/messages/{id}',controller=a,action='update',conditions={'method':['PUT']})

map.connect('/messages/{id}',controller=a,action='delete',conditions={'method':['DELETE']})

前两条是针对整个资源集合的操作，后三条是针对资源集合中某个固定资源的操作

curl	路由匹配结果 （程序中的route match result is）	curl请求得到的结果
curl -X POST http://localhost:8088/messages	{'action': u'create', 'controller': <__main__.controller object at 0x1dbbb10>}	"do create()"
curl -X GET  http://localhost:8088/messages	{'action': u'index', 'controller': <__main__.controller object at 0x1dbbb10>}	"do index()"
curl -X GET  http://localhost:8088/messages/12	{'action': u'show', 'controller': <__main__.controller object at 0x1dbbb10>, 'id': u'12'}	"do show()"
curl -X PUT  http://localhost:8088/messages/12	{'action': u'update', 'controller': <__main__.controller object at 0x1dbbb10>, 'id': u'12'}	"do update()"
curl -X DELETE  http://localhost:8088/messages/12	{'action': u'delete', 'controller': <__main__.controller object at 0x1dbbb10>, 'id': u'12'}	"do delete()"

这里匹配结果中的id为某个具体资源id，这里乱取，后三条curl针对具体资源（id为12）的操作，前两条是针对整个资源集合的操作

当url传入的id包含'.',会将'.'后的字符窜匹配为format,如输入的id 为 '12.hihi' ,匹配id='12', format='hihi'

匹配条件4

map.resource('message', 'messages',controller=a,
                        collection={'search':'GET','create_many':'POST'},
                        member={'update_many':'POST','delete_many':'POST'})

map.resource除了默认的路由条件外，还可以额外的定义‘资源集合的方法’以及‘单个资源的方法’

collection={'search':'GET','create_many':'POST'}       定义了资源集合方法 search，其curl动作为GET,create_many,其curl动作为POST

member={'update_many':'POST','delete_many':'POST'}    定义了单个资源方法 update_many,其curl动作为POST，delete_many,其curl动作为POST

curl	路由匹配结果 （程序中的route match result is）	curl请求得到的结果
curl -X GET  http://localhost:8088/messages/search	{'action': u'search', 'controller': <__main__.controller object at 0x253db10>}	do search()
curl -X POST  http://localhost:8088/messages/create_many	{'action': u'create_many', 'controller': <__main__.controller object at 0x253db10>}	do create_many()
curl -X POST  http://localhost:8088/messages/1/update_many	{'action': u'update_many', 'controller': <__main__.controller object at 0x253db10>, 'id': u'1'}	do update_many()
curl -X POST  http://localhost:8088/messages/1/delete_many	{'action': u'delete_many', 'controller': <__main__.controller object at 0x253db10>, 'id': u'1'}	do delete_many()

 

匹配条件5 

map.resource('message', 'messages',controller=a,path_prefix='/{projectid}',
                    collection={'list_many':'GET','create_many':'POST'},
                    member={'update_many':'POST','delete_many':'POST'})

map.resource初始化时还可以指定curl访问路径的前缀路径，如匹配条件3及4没有指定时，默认为collection_name（资源集合名）

指定path_prefix后，路径为path_prefix/collection_name

curl	路由匹配结果 （程序中的route match result is）	curl请求得到的结果
curl -X POST  http://localhost:8088/proj1/messages	{'action': u'create', 'projectid': u'proj1', 'controller': <__main__.controller object at 0x1375b10>}	do create()
curl -X GET  http://localhost:8088/proj1/messages/list_many	{'action': u'list_many', 'projectid': u'proj1', 'controller': <__main__.controller object at 0x1375b10>}	do list_many()
curl -X POST  http://localhost:8088/proj1/messages/member_3/update_many	{'action': u'update_many', 'projectid': u'proj1', 'controller': <__main__.controller object at 0x1375b10>, 'id': u'member_3'}	do update_many()

在路由5的条件下，添加一条

map.resource('type', 'types',controller=other_controller,

                           parent_resource=dict(member_name='message',

                                                                    collection_name='messages'),

                           path_prefix = '{projectid}/%s/:%s_id' %('nex','nexs'))

curl -X POST  http://localhost:8088/proj1/nex/17/types

匹配nexs_id 为17，controller 为other_controller,  parent_resource的作用为形成name_prefix = 'message_',具体作用不详，有待研究

参考资料：http://routes.readthedocs.org/en/latest/restful.html

疑问：

resource中的controller对象的类定义必须要有__call__，要不然，匹配后变为type（controller)为unicode，原因不明，有待研究