Python Bottle v0.11中文教程与快速入门

5星 · 超过95%的资源需积分: 50 102 浏览量更新于2024-07-22 4 收藏 454KB PDF 举报

Bottle v0.11是一款轻量级的Python Web框架，专为快速、简洁的Web开发设计。它仅依赖于Python的标准库，提供了核心的功能和易用性。以下是主要知识点的详细介绍： 1. **URL映射 (Routing)**: Bottle通过`route()`函数将URL模式与Python函数关联起来，使得URL设计更为直观。例如，在示例中，`/hello/:name`将匹配所有以"/hello/"开头，后面跟着任意字符的URL，并将这些字符作为参数传递给`index()`函数。 2. **模板 (Templates)**: 内置了多种模板引擎的支持，包括Mako、Jinja2和Cheetah，允许开发者根据需求选择。这使得网页动态内容的生成更加便捷，代码和视图分离，易于维护。 3. **基础功能 (Utilities)**: Bottle提供了方便的工具来处理表单数据，如`request.forms`，以及文件上传，如`request.files`。此外，它还支持cookie的使用和HTTP元数据的获取，如`request.headers`。 4. **开发服务器 (Server)**: 内置了一个开发服务器，可以快速启动本地测试环境。Bottle兼容Paste、FAPWS3、Bjoern、Google App Engine、CherryPy等流行的WSGI HTTP服务器，这意味着开发者可以根据项目需求选择不同的生产部署选项。 5. **示例 (Hello World)**: 提供了一个简单的“Hello World”示例，展示了如何创建一个基本的路由，定义函数响应，并通过`run()`函数启动开发服务器。运行这个例子，通过指定的URL即可在浏览器中看到预期的结果。 6. **下载和安装**: 安装Bottle可以通过PyPI（如`easy_install bottle`）获取最新稳定版本，或者直接下载`bottle.py`到项目目录。Bottle不依赖于外部库，但若使用第三方模板或HTTP服务器，可能需要额外安装相应模块。 7. **用户指南和教程**: 用户指南适合初学者和经验丰富的开发者，提供全面的教程，介绍Bottle的基本用法和进阶技巧。指南鼓励开发者按需阅读，作为开发过程中的参考。 Bottle v0.11是Python Web开发的理想选择，特别适合那些寻求简洁高效框架的开发者，其易于上手和高度灵活的特点使其成为入门和小型项目开发的首选。

Bottle 中文文档, Release 0.11.dev

Cookie 是储存在浏览器配置文件里面的一小段文本。你可通过 Request.get_cookie() 来访问已存在

的 Cookie，或通过 Response.set_cookie() 来设置新的 Cookie。

@route('/hello')

def hello_again():

if request.get_cookie("visited"):

return "Welcome back! Nice to see you again"

else:

response.set_cookie("visited", "yes")

return "Hello there! Nice to meet you"

Response.set_cookie() 方法接受一系列额外的参数，来控制 Cookie 的生命周期及行为。一些常用的

设置如下:

• max_age: 最大有效时间，以秒为单位 (默认: None)

• expires: 一个 datetime 对象或一个 UNIX timestamp (默认: None)

• domain: 可访问该 Cookie 的域名 (默认: 当前域名)

• path: 限制 cookie 的访问路径 (默认: /)

• secure: 只允许在 HTTPS 链接中访问 cookie (默认: oﬀ)

• httponly: 防止客户端的 javascript 读取 cookie (默认: oﬀ, 要求 python 2.6 或以上版本)

如果 expires 和 max_age 两个值都没设置，cookie 会在当前的浏览器 session 失效或浏览器窗口关闭后

失效。在使用 cookie 的时候，应该注意一下几个陷阱。

• 在大多数浏览器中，cookie 的最大容量为 4KB。

• 一些用户将浏览器设置为不接受任何 cookie。大多数搜索引擎也忽略 cookie。确保你的应用在无

cookie 的时候也能工作。

• cookie 被储存在客户端，也没被加密。你在 cookie 中储存的任何数据，用户都可以读取。更坏的

情况下，cookie 会被攻击者通过 XSS 偷走，一些已知病毒也会读取浏览器的 cookie。既然如此，

就不要在 cookie 中储存任何敏感信息。

• cookie 可以被伪造，不要信任 cookie！

Cookie 签名

上面提到， cookie 容易被客户端伪造。 Bottle 可通过加密 cookie 来防止此类攻击。你只需在读

取和设置 cookie 的时候，通过 secret 参数来提供一个密钥。如果 cookie 未签名或密钥不匹配，

Request.get_cookie() 方法返回 None

@route('/login')

def login():

username = request.forms.get('username')

password = request.forms.get('password')

if check_user_credentials(username, password):

response.set_cookie("account", username, secret='some-secret-key')

return "Welcome %s! You are now logged in." % username

else:

return "Login failed."

@route('/restricted')

def restricted_area():

username = request.get_cookie("account", secret='some-secret-key')

if username:

return "Hello %s. Welcome back." % username

else:

return "You are not logged in. Access denied."

10 Chapter 1. 用户指南

Bottle 中文文档, Release 0.11.dev

例外，Bottle 自动序列化储存在签名 cookie 里面的数据。你可在 cookie 中储存任何可序列化的对象 (不

仅仅是字符串)，只要对象大小不超过 4KB。

Warning: 签名 cookie 在客户端不加密 (译者注：即在客户端没有经过二次加密)，也没有写保护

(客户端可使用之前的 cookie)。给 cookie 签名的主要意义在于在 cookie 中存储序列化对象和防止伪

造 cookie，依然不要在 cookie 中存储敏感信息。

1.1.5 请求数据 (Request Data)

Bottle 通过 request 对象来提供对 HTTP 相关元数据的访问，例如 cookie，HTTP 头，通过 POST 方

法提交的表单。只要在回调函数中使用，该对象总是包含当前这次浏览器请求的信息。即使在多线程环

境中，多个请求同时被响应，这依然有效。关于全局对象是如何做到线程安全的，详见 contextlocal.

Note: Bottle 在 FormsDict 类的一个实例里 (译者注：参见源码 1763 行左右)，存储大多数解析后的

HTTP 元数据。其行为和普通的字典类似，但有一些额外的特性: 所有在字典中的值都可像访问类的属

性那样访问。这类虚拟的属性总是返回一个 unicode 字符串，如果缺失该属性，将返回一个空字符串。

FormsDict 类继承自 MultiDict 类，一个 key 可存储多个值。标准的字典访问方法只会返回一个值，但

可通过 MultiDict.getall() 方法来获取一个包含所有值的 list (或许为空)。

在 API 的章节，有关于 API 和特性的完整描述，这里我们只谈常见的用例和特性。

cookie 存储在 BaseRequest.cookie 中，是 FormsDict 类的一个实例。BaseRequest.get_cookie() 方

法提供了对签名 cookie 的访问。下面是一个基于 cookie 的计数器例子。

from bottle import route, request, response

@route('/counter')

def counter():

count = int( request.cookies.get('counter', '0') )

count += 1

response.set_cookie('counter', str(count))

return 'You visited this page %d times' % count

HTTP 头

所有发送到客户端的 HTTP 头 (例如 Referer, Agent 和 Accept-Language) 存储在一个

WSGIHeaderDict 中，可通过 BaseRequest.headers 访问。WSGIHeaderDict 是一个字典，其 key 大小

写敏感。

from bottle import route, request

@route('/is_ajax')

def is_ajax():

if request.headers.get('X-Requested-With') == 'XMLHttpRequest':

return 'This is an AJAX request'

else:

return 'This is a normal request'

查询变量

查询字符串 (例如 /forum?id=1&page=5 中的 id=5 和 page=5) 一般用于向服务器传输键值对。你可通

过 BaseRequest.query ( FormsDict 类的实例) 来访问，和通过 BaseRequest.query_string 来获取

整个字符串。

1.1. 教程 11

Bottle 中文文档, Release 0.11.dev

from bottle import route, request, response

@route('/forum')

def display_forum():

forum_id = request.query.id

page = request.query.page or '1'

return 'Forum ID: %s (page %s)' % (forum_id, page)

POST 表单数据和文件上传

通过 POST 和 PUT 方式提交的请求也许会包含经过编码的表单数据。BaseRequest.forms 字典包含了解

析过后的文本字段，BaseRequest.files 字典存储上传的文件，BaseRequest.POST 同时包含两者。这

三个都是 FormsDict 类的实例，在你使用它们的时候才会被创建。上传的文件保存为一个包含其他元

数据的 cgi.FieldStorage 对象。最后，你可像访问文件一样，通过 BaseRequest.body 访问未经处理

的请求内容。

下面是一个简单的文件上传例子。

</form>

from bottle import route, request

@route('/upload', method='POST')

def do_upload():

name = request.forms.name

data = request.files.data

if name and data and data.file:

raw = data.file.read() # This is dangerous for big files

filename = data.filename

return "Hello %s! You uploaded %s (%d bytes)." % (name, filename, len(raw))

return "You missed a field."

Unicode issues

在 Python2 中，所有的 key 和 value 都是 byte-string。如果你需要 unicode，可使用

FormsDict.getunicode() 方法或像访问属性那样访问。这两种方法都试着将字符串转码 (默认: utf8)，

如果失败，将返回一个空字符串。无需捕获 UnicodeError 异常。

>>> request.query['city']

'G\xc3\xb6ttingen' # A utf8 byte string

>>> request.query.city

u'Gttingen' # The same string as unicode

在 Python3 中，所有的字符串都是 unicode。但 HTTP 是基于字节的协议，在 byte-string 被传给应用

之前，服务器必须将其转码。安全起见，WSGI 协议建议使用 ISO-8859-1 (即是 latin1)，一个可反转的

单字节编码，可被转换为其他编码。Bottle 通过 FormsDict.getunicode() 和属性访问实现了转码，但

不支持字典形式的访问。通过字典形式的访问，将直接返回服务器返回的字符串，未经处理，这或许不

是你想要的。

>>> request.query['city']

'Gttingen' # An utf8 string provisionally decoded as ISO-8859-1 by the server

>>> request.query.city

'Gttingen' # The same string correctly re-encoded as utf8 by bottle

如果你整个字典包含正确编码后的值 (e.g. for WTForms)，可通过 FormsDict.decode() 方法来获取一

个转码后的拷贝 (译者注：一个新的实例)。

12 Chapter 1. 用户指南

剩余82页未读，继续阅读

cuihairu

粉丝: 20

Python Bottle v0.11中文教程与快速入门

Python库awscrt 0.11.21版本下载指南

generator-python-bottle:Python Bottle 项目的 Yeoman 生成器

python-3.8.0a3中文文档CHM版

Python库 | python_songpal-0.11-py3-none-any.whl

python-ecdsa-0.11-3.el7.noarch.rpm

Python Playwright V1.15官方文档：快速入门与浏览器集成

simplekv Python库0.11.8版本发布

Python库 diffval-0.11版本解压指南

lusid_sdk Python库0.11.1537版本发布

Python Bottleneck库1.3.3rc13版本发布

最新资源