首页 > 代码库 > 使用bottle进行web开发(5):Generating Content

使用bottle进行web开发(5):Generating Content

在纯粹的 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)

使用bottle进行web开发(5):Generating Content