tgext.routes 0.2.1

关于tgext.routes

tgext.routes提供了一种简单的方法将基于路由的调度集成到TurboGears2应用中。

安装

tgext.routes可以从pypi或bitbucket安装

pip install tgext.routes

应该适用于大多数用户

路由单个动作

通过@route装饰器进行路由匹配，每个公开的方法可以绑定到一个或多个路由。

唯一的要求是您从RoutedController实例继承。

通过@route装饰器注册的所有路由都从控制器挂载点开始注册。

以下示例将entry_by_date方法注册为类似/date/2012-01和/date/2012-01-01的url。

from tgext.routes import RoutedController, route

class DateController(RoutedController):
    @expose()
    @route('{year}-{month}', day=33)
    @route('{year}-{month}-{day}')
    def entry_by_date(self, year, month, day):
        return '%s ++ %s ++ %s' % (year, month, day)

class RootController(BaseController):
    date = DateController()

    @expose()
    def index(self):
        return 'Hello!'

请注意，由于@expose包装了它，该方法仍然可以通过ObjectDispatch路由访问，@route只能注册额外的路由。

如果有指向它的路由，也会解析没有提供@expose装饰的动作，请注意，在这种情况下您将不得不手动渲染模板。

如果您想禁用 ObjectDispatch，可以在控制器中设置 disable_objectdispatch=True。请注意，这将禁用整个控制器的 ObjectDispatch，因此您将无法从该控制器发送不提供路由的动作。

路由整个应用程序

RoutedController 也可以作为应用程序的 RootController 使用。在这种情况下，您甚至可以使用控制器 mapper 属性提供一个 routes.Mapper 对象，并注册应用程序的所有路由。

class RootController(RoutedController):
    mapper = Mapper()
    mapper.connect('/', controller='home', action='index')
    mapper.connect('/json', controller='home', action='jsonexposed')
    mapper.connect('/unex', controller='home', action='unexposed')

在这种情况下，需要指定 controller 参数，控制器将在 tg.config['paths']['controllers'] 指定的路径中查找。在上一个例子中，将在 home.py 模块中查找 HomeController 类，通过其 index、jsonexposed 和 unexposed 方法来处理 /、/json 和 /unex 路径。

如果在同一个 RoutedController 内同时使用 mapper 属性和 @route 装饰器，则 @route 装饰器将在映射器路由之后应用。

有关路由的更多文档，请参阅 Routes 文档

mapper.connect('/forsub{_dispatch:.*?}', controller='home',  action='_dispatch')