Bottle
bottle是一个快速，简洁，轻量级的基于wsgi的微型Web框架，此框架只有一个.py文件，除了Python的标准库外，其不依赖任何其他模块。
bottle框架大致可以分为以下部分：
- 路由系统，将不同请求交由指定函数处理
- 模板系统，将模板中的特殊语法渲染成字符串，值得一说的是Bottle的模板引擎可以任意指定：Bottle内置模板、、、
- 公共组件，用于提供处理请求相关的信息，如：表单数据、cookies、请求头等
- 服务，Bottle默认支持多种基于WSGI的服务，如：
server_names = { 'cgi': CGIServer, 'flup': FlupFCGIServer, 'wsgiref': WSGIRefServer, 'waitress': WaitressServer, 'cherrypy': CherryPyServer, 'paste': PasteServer, 'fapws3': FapwsServer, 'tornado': TornadoServer, 'gae': AppEngineServer, 'twisted': TwistedServer, 'diesel': DieselServer, 'meinheld': MeinheldServer, 'gunicorn': GunicornServer, 'eventlet': EventletServer, 'gevent': GeventServer, 'geventSocketIO':GeventSocketIOServer, 'rocket': RocketServer, 'bjoern' : BjoernServer, 'auto': AutoServer,}
框架的基本使用
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottleroot = Bottle() @root.route('/hello/')def index(): return "Hello World" # return template('Hello { {name}}!', name="Alex") root.run(host='localhost', port=8080)
一、路由系统
路由系统是的url对应指定函数，当用户请求某个url时，就由指定函数处理当前请求，对于Bottle的路由系统可以分为一下几类：
- 静态路由
- 动态路由
- 请求方法路由
- 二级路由
1、静态路由
@root.route('/hello/')def index(): return template('Hello { {name}}!', name="zhangw")
2、动态路由
@root.route('/wiki/ ')def callback(pagename): ... @root.route('/object/ ')def callback(id): ... @root.route('/show/ ')def callback(name): ... @root.route('/static/ ')def callback(path): return static_file(path, root='static')
3、请求方法路由
@root.route('/hello/', method='POST')def index(): ... @root.get('/hello/')def index(): ... @root.post('/hello/')def index(): ... @root.put('/hello/')def index(): ... @root.delete('/hello/')def index(): ...
4、二级路由
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottleapp01 = Bottle()@app01.route('/hello/', method='GET')def index(): return template('App01!')复制代码
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottleapp02 = Bottle()@app02.route('/hello/', method='GET')def index(): return template('App02!')
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottlefrom bottle import static_fileroot = Bottle() @root.route('/hello/')def index(): return template('Root { {name}}!', name="Alex") from framwork_bottle import app01from framwork_bottle import app02 root.mount('app01', app01.app01)root.mount('app02', app02.app02) root.run(host='localhost', port=8080)
二、模板系统
模板系统用于将Html和自定的值两者进行渲染，从而得到字符串，然后将该字符串返回给客户端。我们知道在Bottle中可以使用 内置模板系统、、、等，以内置模板系统为例：
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottleroot = Bottle() @root.route('/hello/')def index(): # 默认情况下去目录：['./', './views/']中寻找模板文件 hello_template.html # 配置在 bottle.TEMPLATE_PATH 中 return template('hello_template.tpl', name='alex') root.run(host='localhost', port=8080)
1、语法
- 单值
- 单行Python代码
- Python代码快
- Python、Html混合
1、单值
{ {name}}2、单行Python代码
% s1 = "hello"3、Python代码块
<% # A block of python code name = name.title().strip() if name == "Alex": name="seven"%>4、Python、Html混合
% if True: { {name}}% end
- % for item in name:
- { {item}} % end
2、函数
include(sub_template, **variables)
# 导入其他模板文件 % include('header.tpl', title='Page Title')Page Content% include('footer.tpl')
rebase(name, **variables)
{<div></div> {title or 'No title'}} { {!base}}
# 导入母版 % rebase('base.tpl', title='Page Title')Page Content ...
defined(name)
# 检查当前变量是否已经被定义，已定义True，未定义False
get(name, default=None)
# 获取某个变量的值，不存在时可设置默认值
setdefault(name, default)
# 如果变量不存在时，为变量设置默认值
扩展：自定义函数
自定义函数
{ { wupeiqi() }}
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import template, Bottle,SimpleTemplateroot = Bottle()def custom(): return '123123'@root.route('/hello/')def index(): # 默认情况下去目录：['./', './views/']中寻找模板文件 hello_template.html # 配置在 bottle.TEMPLATE_PATH 中 return template('hello_template.html', name='alex', wupeiqi=custom)root.run(host='localhost', port=8080)
注：变量或函数前添加 【 ! 】，则会关闭转义的功能
三、公共组件
由于Web框架就是用来【接收用户请求】-> 【处理用户请求】-> 【响应相关内容】，对于具体如何处理用户请求，开发人员根据用户请求来进行处理，而对于接收用户请求和相应相关的内容均交给框架本身来处理，其处理完成之后将产出交给开发人员和用户。
【接收用户请求】
当框架接收到用户请求之后，将请求信息封装在Bottle的request中，以供开发人员使用
【响应相关内容】
当开发人员的代码处理完用户请求之后，会将其执行内容相应给用户，相应的内容会封装在Bottle的response中，然后再由框架将内容返回给用户
所以，公共组件本质其实就是为开发人员提供接口，使其能够获取用户信息并配置响应内容。
1、request
Bottle中的request其实是一个LocalReqeust对象，其中封装了用户请求的相关信息：
request.headers 请求头信息 request.query get请求信息 request.forms post请求信息 request.files 上传文件信息 request.params get和post请求信息 request.GET get请求信息 request.POST post和上传信息 request.cookies cookie信息 request.environ 环境相关相关
2、response
Bottle中的request其实是一个LocalResponse对象，其中框架即将返回给用户的相关信息：
response response.status_line 状态行 response.status_code 状态码 response.headers 响应头 response.charset 编码 response.set_cookie 在浏览器上设置cookie response.delete_cookie 在浏览器上删除cookie
实例：
from bottle import route, request@route('/login')def login(): return ''' '''@route('/login', method='POST')def do_login(): username = request.forms.get('username') password = request.forms.get('password') if check_login(username, password): return "Your login information was correct.
" else: return "Login failed.
"
@route('/upload', method='POST')def do_upload(): category = request.forms.get('category') upload = request.files.get('upload') name, ext = os.path.splitext(upload.filename) if ext not in ('.png','.jpg','.jpeg'): return 'File extension not allowed.' save_path = get_save_path_for_category(category) upload.save(save_path) # appends upload.filename automatically return 'OK'
四、服务
对于Bottle框架其本身未实现类似于Tornado自己基于socket实现Web服务，所以必须依赖WSGI，默认Bottle已经实现并且支持的WSGI有：
server_names = { 'cgi': CGIServer, 'flup': FlupFCGIServer, 'wsgiref': WSGIRefServer, 'waitress': WaitressServer, 'cherrypy': CherryPyServer, 'paste': PasteServer, 'fapws3': FapwsServer, 'tornado': TornadoServer, 'gae': AppEngineServer, 'twisted': TwistedServer, 'diesel': DieselServer, 'meinheld': MeinheldServer, 'gunicorn': GunicornServer, 'eventlet': EventletServer, 'gevent': GeventServer, 'geventSocketIO':GeventSocketIOServer, 'rocket': RocketServer, 'bjoern' : BjoernServer, 'auto': AutoServer,}
使用时，只需在主app执行run方法时指定参数即可：
#!/usr/bin/env python# -*- coding:utf-8 -*-from bottle import Bottleroot = Bottle() @root.route('/hello/')def index(): return "Hello World"# 默认server ＝'wsgiref'root.run(host='localhost', port=8080, server='wsgiref')
PS：以上WSGI中提供了19种，如果想要使期支持其他服务，则需要扩展Bottle源码来自定义一个ServerAdapter
更多参见：http://www.bottlepy.org/docs/dev/index.html