使用bottle进行web开发：Generating Content

Posted 2020-09-23

在纯粹的 WSGI中，你的应用能返回的数据类型是十分有限的，你必须返回可迭代的字符串，你能返回字符串是因为字符串是可以迭代的，但是这导致服务器将你的内容按一字符一字符的传送，这个时候，Unicode 字符将不允许被返回了，这是肯定不行的。

Bottle 则支持了更多的数据类型，它甚至添加了一个 Content-Length 头信息，并且自动编码 Unicode 数据，下面列举了 Bottle 应用中，你可以返回的数据类型，并且简单的介绍了一下这些数据类型的数据都是怎么被 Bottle 处理的：

数据类型	介绍
字典（Dictionaries）	Python 内置的字典类型数据将自动被转换为 JSON 字符串，并且添加 Content-Type 为 ’application/json’ 的头信息返回至浏览器，这让我们可以很方便的建立基于 JSON 的API
空字符串，False，None或者任何非真的数据	Bottle 将为这类数据创建 ContentLength 头文件，被设置为 0 返回至浏览器
Unicode 字符串	Unicode 字符串将自动的按 Content-Type 头文件中定义的编码格式进行编码（默认为UTF8），接着按普通的字符串进行处理
字节串（Byte strings）	Bottle 返回整个字符串（而不是按字节一个一个返回），同时增加 Content-Length 头文件标示字节串长度
HTTPError 与HTTPResponse 实例	返回这些实例就像抛出异常一样，对于 HTTPError，错误将被与相关函数处理
文件对象	然后具有 .read() 方法的对象都被看作文件或者类似文件的对象进行处理，并传送给 WSGI 服务器框架定义wsgi.file_wrapper 回调函数，某一些WSGI服务器会使用系统优化的请求方式（Sendfile）来发送文件。
迭代器与生成品	你可以在你的回调函数使用 yield 或者 返回一个迭代器，只要yield的对象是字符串，Unicode 字符串，HTTPError 或者 HTTPResponse 对象就行，但是不允许使用嵌套的迭代器，需要注意的是，当 yield 的值第一次为非空是， HTTP 的状态 和 头文件将被发送到 浏览器

如果你返回一个 str 类子类的实例，并且带有 read() 方法，那它还是将按 字符串进行处理，因为字符串有更高一级的优先处理权。

改变默认编码

Bottle 依照 Content-Type 头文件中 charset 参数来对字符串进行编码，该头文件默认为 text/html; charset=UTF8 ，并且可以被Response.content_type 属性修改，或者直接被 Response.charset 属性修改：

from bottle import response
@route(‘/iso‘)
def get_iso():
    response.charset = ‘ISO-8859-15‘
    return u‘This will be sent with ISO-8859-15 encoding.‘
@route(‘/latin9‘)
def get_latin():
    response.content_type = ‘text/html; charset=latin9‘
    return u‘ISO-8859-15 is also known as latin9.‘

由于某些罕见的原因，Python 编码的名称可能与 HTTP 编码的名称不一致，这时你需要做两方法的工作首先设置Response.content_type 头文件，然后还需要设置 Response.charset 。

静态文件

你可以直接返回文件，但是 Bottle 推荐使用 static_file() 方法，它会自动的猜测文件的 mime-type，追加 Last-Modified 头文件，完全的自定义需要服务的文件路径，并且能处理错误（比如 404），并且它还支持 If-Modified-Since 头文件并且可以返回 304 Not Modified 响应，你还可以使用一个自定义的 mime-type 来重写 mime-type 猜测的值。

from bottle import static_file
@route(‘/images/:filename#.*\.png#‘)
def send_image(filename):
    return static_file(filename, root=‘/path/to/image/files‘, mimetype = ‘image/png‘)
@route(‘/static/:filename‘)
def send_static(filename):
    return static_file(filename, root=‘/path/to/static/files‘)

如果你真的需要，你还可以以异常的形式抛出文件。

强制下载

绝大多数浏览器在知道下载的文件的MIME类型并且该文件类型被绑定到某一个应用程序时（比如PDF文件），它们都会自动的打开该文件，如果你不想这样，你可以强制的要求浏览器进行下载。

@route(‘/download/:filename‘)
def download(filename):
    return static_file(filename, root=‘/path/to/static/files‘, download=filename)