内置 Http 服务器和内部引擎

CherryPy 带有自己的 Web (HTTP) 服务器。这就是为什么 CherryPy 是独立的,并允许用户在获取库的几分钟内运行 CherryPy 应用程序。

Web 服务器充当应用程序的网关,借助它,所有请求和响应都保持在轨道上。

要启动 Web 服务器,用户必须进行以下调用 −

cherryPy.server.quickstart()

CherryPy 的内部引擎负责以下活动 −

  • 创建和管理请求和响应对象。
  • 控制和管理 CherryPy 进程。

CherryPy – 配置

该框架带有自己的配置系统,允许您参数化 HTTP 服务器。配置的设置可以存储在语法接近 INI 格式的文本文件中,也可以存储在完整的 Python 字典中。

要配置 CherryPy 服务器实例,开发人员需要使用设置的全局部分。

global_conf = {
   'global': {
      'server.socket_host': 'localhost',
      'server.socket_port': 8080,
   },
}

application_conf = {
   '/style.css': {
      'tools.staticfile.on': True,
      'tools.staticfile.filename': os.path.join(_curdir, 'style.css'),
   }
}

This could be represented in a file like this:
[global]
server.socket_host = "localhost"
server.socket_port = 8080
[/style.css]
tools.staticfile.on = True
tools.staticfile.filename = "/full/path/to.style.css"

HTTP 合规性

CherryPy 一直在缓慢发展,但它包括 HTTP 规范的编译,支持 HTTP/1.0,后来转向支持 HTTP/1.1。

CherryPy 被认为有条件地符合 HTTP/1.1,因为它实现了规范的所有必须和必需级别,但不是所有应该级别。因此,CherryPy 支持 HTTP/1.1 的以下功能 −

  • 如果客户端声称支持 HTTP/1.1,则它必须在使用指定协议版本发出的任何请求中发送标头字段。如果不这样做,CherryPy 将立即停止处理请求。

  • CherryPy 生成一个 Date 标头字段,该字段用于所有配置。

  • CherryPy 可以在客户端的支持下处理响应状态代码 (100)。

  • CherryPy 的内置 HTTP 服务器通过使用 Connection: Keep-Alive 标头支持 HTTP/1.1 中默认的持久连接。

  • CherryPy 正确处理分块请求和响应。

  • CherryPy 以两种不同的方式支持请求 − If-Modified-Since 和 If-Unmodified-Since 标头并根据请求发送响应。

  • CherryPy 允许任何 HTTP 方法。

  • CherryPy 处理客户端和服务器设置之间的 HTTP 版本组合。

多线程应用服务器

CherryPy 是基于多线程概念设计的。每次开发人员获取或设置 CherryPy 命名空间中的值时,都是在多线程环境中完成的。

cherrypy.request 和 cherrypy.response 都是线程数据容器,这意味着您的应用程序通过了解运行时通过它们代理的请求来独立调用它们。

使用线程模式的应用程序服务器不受重视,因为使用线程被视为由于同步要求而增加出现问题的可能性。

其他替代方案包括 −

多进程模式

每个请求都由其自己的 Python 进程处理。在这里,服务器的性能和稳定性可以被认为是更好的。

异步模式

在这里,接受新连接并将数据发送回客户端是从请求进程异步完成的。这种技术以其效率而闻名。

URL 调度

CherryPy 社区希望更加灵活,并希望有其他调度程序解决方案。CherryPy 3 提供了其他内置调度程序,并提供了一种编写和使用您自己的调度程序的简单方法。

  • 用于开发 HTTP 方法的应用程序。 (GET、POST、PUT 等)
  • 定义 URL 中的路由的那个 - 路由调度程序

HTTP 方法调度程序

在某些应用程序中,URI 与服务器对资源执行的操作无关。

例如,http://xyz.com/album/delete/10

URI 包含客户端希望执行的操作。

默认情况下,CherryPy 调度程序将按以下方式映射 −

album.delete(12)

上面提到的调度程序是正确的,但可以通过以下方式独立化 −

http://xyz.com/album/10

用户可能想知道服务器如何调度确切的页面。此信息由 HTTP 请求本身携带。当客户端向服务器发出请求时,CherryPy 会寻找最适合的处理程序,该处理程序是 URI 所针对的资源的表示。

DELETE /album/12 HTTP/1.1

Routes Dispatcher

以下是分派 − 所需方法的参数列表

  • name 参数是要连接的路由的唯一名称。

  • 路由是匹配 URI 的模式。

  • 控制器是包含页面处理程序的实例。

  • 使用 Routes 调度程序连接匹配 URI 的模式并关联特定的页面处理程序。

示例

让我们举一个例子来了解如何 有用 −

import random
import string
import cherrypy

class StringMaker(object):
   @cherrypy.expose
   def index(self):
      return "Hello! How are you?"
   
   @cherrypy.expose
   def generate(self, length=9):
      return ''.join(random.sample(string.hexdigits, int(length)))
		
if __name__ == '__main__':
   cherrypy.quickstart(StringMaker ())

按照下面给出的步骤获取上述代码的输出 −

步骤 1 − 将上述文件保存为 tutRoutes.py

步骤 2 − 访问以下 URL −

http://localhost:8080/generate?length=10

步骤 3 − 您将收到以下输出 −

Routes Dispatcher