CherryPy与猎豹作为插件+工具-空白页面

Question

CherryPy一直返回空白页或具有我在控制器中返回的值。我重写了一个django和jinja2的版本，它确实可以工作，显然这个版本不能，它几乎与前面提到的相同。

我在工具位中做了一些pprint，这确实满足了请求。带有解析过的HTML的主体，但在控制器中设置pass时不输出它。如果我在控制器中返回{'user':True}，它以简单的" user "的形式显示。

通过网上的一些例子和SickBeard的代码，我得出了以下结论:

控制器:

class RootController(object):
    @cherrypy.expose
    @cherrypy.tools.render(template="page/home.html")
    def index(self):
        pass

工具:

class CheetahTool(cherrypy.Tool):
    def __init__(self):
        cherrypy.Tool.__init__(self, 'on_start_resource',
                               self._render,
                               priority=30)
    def _render(self, template=None, debug=False):
        if cherrypy.response.status > 399:
            return
        # retrieve the data returned by the handler
        data = cherrypy.response.body or {}
        template = cherrypy.engine.publish("lookup-template", template).pop()
        if template and isinstance(data, dict):
            for k,v in data:
                template.__setattr__(k, v)
            # dump the template using the dictionary
            if debug:
                try:
                    cherrypy.response.body = unicode(template).encode('utf-8', 'xmlcharrefreplace')
                except Exception as e:
                    from pprint import pprint
                    pprint(e.message)
            else:
                cherrypy.response.body = template.respond()

插件:

class PageTemplate(Template):
    """
    Thank you SickBeard
    """
    def __init__(self, base_dir, template, *args, **KWs):
        KWs['file'] = os.path.join(base_dir, template)
        super(PageTemplate, self).__init__(*args, **KWs)
        application = cherrypy.tree.apps['']
        config = application.config 
        self.sbRoot = base_dir
        self.sbHttpPort = config['global']['server.socket_port']
        self.sbHttpsPort = self.sbHttpPort
        self.sbHttpsEnabled = False
        if cherrypy.request.headers['Host'][0] == '[':
            self.sbHost = re.match("^[.*]", cherrypy.request.headers['Host'], re.X|re.M|re.S).group(0)
        else:
            self.sbHost = re.match("^[^:]+", cherrypy.request.headers['Host'], re.X|re.M|re.S).group(0)
        if "X-Forwarded-Host" in cherrypy.request.headers:
            self.sbHost = cherrypy.request.headers['X-Forwarded-Host']
        if "X-Forwarded-Port" in cherrypy.request.headers:
            self.sbHttpPort = cherrypy.request.headers['X-Forwarded-Port']
            self.sbHttpsPort = self.sbHttpPort
        if "X-Forwarded-Proto" in cherrypy.request.headers:
            self.sbHttpsEnabled = True if cherrypy.request.headers['X-Forwarded-Proto'] == 'https' else False
        self.sbPID = str(aquapi.PID)
        self.menu = [
            { 'title': 'Home',            'key': 'home'           },
            { 'title': 'Users',           'key': 'users'          },
            { 'title': 'Config',          'key': 'config'         },
        ]
    def render(self):
        return unicode(self).encode('utf-8', 'xmlcharrefreplace')

class CheetahTemplatePlugin(plugins.SimplePlugin):
    def __init__(self, bus, base_dir=None, base_cache_dir=None, 
                 collection_size=50, encoding='utf-8'):
        plugins.SimplePlugin.__init__(self, bus)
        self.base_dir = base_dir
        self.base_cache_dir = base_cache_dir or tempfile.gettempdir()
        self.encoding = encoding
        self.collection_size = collection_size
    def start(self):
        self.bus.log('Setting up Cheetah resources')
        self.bus.subscribe("lookup-template", self.get_template)
    def stop(self):
        self.bus.log('Freeing up Cheetah resources')
        self.bus.unsubscribe("lookup-template", self.get_template)
        self.lookup = None
    def get_template(self, name):
        """
        Returns Cheetah's template by name.
        """
        return PageTemplate(self.base_dir, name)

初始化:

        # Template engine tool
        from aquapi.web.tools.template import CheetahTool
        cherrypy.tools.render = CheetahTool()
        # Tool to load the logged in user or redirect
        # the client to the login page
        from aquapi.web.tools.user import UserTool
        cherrypy.tools.user = UserTool()

        from aquapi.web.controllers import RootController 
        webapp = RootController()
        # Let's mount the application so that CherryPy can serve it
        app = cherrypy.tree.mount(webapp, '/', os.path.join(self.base_dir, "app.cfg"))
        # Template engine plugin
        from aquapi.web.plugin.template import CheetahTemplatePlugin
        engine.cheetah = CheetahTemplatePlugin(engine, 
                                        os.path.join(self.base_dir, 'aquapi/web/templates'),
                                        os.path.join(self.base_dir, 'cache'))
        engine.cheetah.subscribe()

Answer 1

一般来说，对我来说，这是在您的代码片段中发生的某种过度工程。CherryPy插件通常用于系统任务(例如，在引擎启动时放置pid文件，在停止时删除它)或用于异步任务(例如，在单独的线程中发送电子邮件)。模板呈现与请求处理显然是同步进行的，所以我不认为从CherryPy工具中提取这个逻辑有什么意义。在CherryPy中有一个类，CherryPy ._cptools。HandlerWrapperTool，它演示了包装处理程序返回值的建议方法。

我从未使用过Cheetah，所以我的例子是基于jinja2的。您只需要更改模板引擎实例(改为Cheetah)并纠正其调用。其余的都一样。

#!/usr/bin/env python
# -*- coding: utf-8 -*-

import os
import types
import cherrypy
import jinja2

path   = os.path.abspath(os.path.dirname(__file__))
config = {
  'global' : {
    'server.socket_host' : '127.0.0.1',
    'server.socket_port' : 8080,
    'server.thread_pool' : 4
  }
}

class TemplateTool(cherrypy.Tool):
  _engine = None
  '''Jinja environment instance'''

  def __init__(self):
    viewLoader   = jinja2.FileSystemLoader(os.path.join(path, 'view'))
    self._engine = jinja2.Environment(loader = viewLoader)
    cherrypy.Tool.__init__(self, 'before_handler', self.render)
  def __call__(self, *args, **kwargs):
    if args and isinstance(args[0], (types.FunctionType, types.MethodType)):
      # @template
      args[0].exposed = True
      return cherrypy.Tool.__call__(self, **kwargs)(args[0])
    else:
      # @template()
      def wrap(f):
        f.exposed = True
        return cherrypy.Tool.__call__(self, *args, **kwargs)(f)
      return wrap
  def render(self, name = None):
    cherrypy.request.config['template'] = name
    handler = cherrypy.serving.request.handler
    def wrap(*args, **kwargs):
      return self._render(handler, *args, **kwargs)
    cherrypy.serving.request.handler = wrap
  def _render(self, handler, *args, **kwargs):
    template = cherrypy.request.config['template']
    if not template:
      parts = []
      if hasattr(handler.callable, '__self__'):
        parts.append(handler.callable.__self__.__class__.__name__.lower())
      if hasattr(handler.callable, '__name__'):
        parts.append(handler.callable.__name__.lower())
      template = u'/'.join(parts)
    data     = handler(*args, **kwargs) or {}
    renderer = self._engine.get_template(u'{0}.html'.format(template))
    return renderer.render(**data)

cherrypy.tools.template = TemplateTool()

class App:
  @cherrypy.expose
  def index(self):
    '''No renderer applied, CherryPy outputs dict keys'''
    return {'user': 123}
  @cherrypy.tools.template
  def auto(self):
    return {'user': 123}
  @cherrypy.tools.template(name = 'app/auto')
  def manual(self):
    return {'user': 234}

if __name__ == '__main__':
  cherrypy.quickstart(App(), '/', config)

在python文件中创建目录view/app，并将以下内容放入名为auto.html的文件中。

<!DOCTYPE html>
<html>
  <head>
    <meta http-equiv='content-type' content='text/html; charset=utf-8' />
    <title>Test</title>
  </head>
  <body>
    <p>User: <em>{{ user }}</em></p>
  </body>
</html>

关于TemplateTool的一些注意事项。首先，您可以通过两种方式将它用作装饰器:不调用，以及使用模板名称参数进行调用。你可以像在配置中使用任何其他CherryPy工具一样使用该工具(例如，让所有控制器方法渲染模板)。其次，遵循约定优先于配置原则，当没有提供模板名称时，该工具将使用classname/methodname.html。第三，装饰器公开了方法，所以你不需要在顶部添加@cherrypy.expose。