文档章节

python 简单web框架: Bottle

北方攻城师
 北方攻城师
发布于 2014/11/23 17:51
字数 1771
阅读 901
收藏 14

基本映射

映射使用在根据不同URLs请求来产生相对应的返回内容.Bottle使用route() 修饰器来实现映射.

1
2
3
4
5
from bottle import route, run@route('/hello')def hello():
    return "Hello World!"run() # This starts the HTTP server

运行这个程序,访问http://localhost:8080/hello将会在浏览器里看到 "Hello World!".

GET, POST, HEAD, ...

这个映射装饰器有可选的关键字method默认是method='GET'. 还有可能是POST,PUT,DELETE,HEAD或者监听其他的HTTP请求方法.

1
2
3
4
5
6
from bottle import route, request@route('/form/submit', method='POST')def form_submit():
    form_data = request.POST
    do_something(form_data)
    return "Done"

动态映射

你可以提取URL的部分来建立动态变量名的映射.

1
2
3
@route('/hello/:name')def hello(name):
    return "Hello %s!" % name

默认情况下, 一个:placeholder会一直匹配到下一个斜线.需要修改的话,可以把正则字符加入到#s之间:

1
2
3
@route('/get_object/:id#[0-9]+#')def get(id):
    return "Object ID: %d" % int(id)

或者使用完整的正则匹配组来实现:

1
2
3
@route('/get_object/(?P<id>[0-9]+)')def get(id):
    return "Object ID: %d" % int(id)

正如你看到的,URL参数仍然是字符串, 即使你正则里面是数字.你必须显式的进行类型强制转换.

@validate() 装饰器

Bottle 提供一个方便的装饰器validate() 来校验多个参数.它可以通过关键字和过滤器来对每一个URL参数进行处理然后返回请求.

1
2
3
4
5
6
from bottle import route, validate# /test/validate/1/2.3/4,5,6,7@route('/test/validate/:i/:f/:csv')@validate(i=int, f=float, csv=lambda x: map(int, x.split(',')))def validate_test(i, f, csv):
    return "Int: %d, Float:%f, List:%s" % (i, f, repr(csv))

你可能需要在校验参数失败时抛出ValueError.

返回文件流和JSON

WSGI规范不能处理文件对象或字符串.Bottle自动转换字符串类型为iter对象.下面的例子可以在Bottle下运行, 但是不能运行在纯WSGI环境下.

1
2
3
4
5
6
@route('/get_string')def get_string():
    return "This is not a list of strings, but a single string"@route('/file')def get_file():
    return open('some/file.txt','r')

字典类型也是允许的.会转换成json格式,自动返回Content-Type: application/json.

1
2
3
@route('/api/status')def api_status():
    return {'status':'online', 'servertime':time.time()}

你可以关闭这个特性:bottle.default_app().autojson = False

Cookies

Bottle是把cookie存储在request.COOKIES变量中.新建cookie的方法是response.set_cookie(name, value[, **params]). 它可以接受额外的参数,属于SimpleCookie的有有效参数.

1
2
from bottle import responseresponse.set_cookie('key','value', path='/', domain='example.com', secure=True, expires=+500, ...)

设置max-age属性(它不是个有效的Python参数名) 你可以在实例中修改 cookie.SimpleCookie inresponse.COOKIES.

1
2
3
from bottle import responseresponse.COOKIES['key'] = 'value'response.COOKIES['key']['max-age'] = 500

模板

Bottle使用自带的小巧的模板.你可以使用调用template(template_name, **template_arguments)并返回结果.

1
2
3
@route('/hello/:name')def hello(name):
    return template('hello_template', username=name)

这样就会加载hello_template.tpl,并提取URL:name到变量username,返回请求.

hello_template.tpl大致这样:

1
2
<h1>Hello {{username}}</h1><p>How are you?</p>

模板搜索路径

模板是根据bottle.TEMPLATE_PATH列表变量去搜索.默认路径包含['./%s.tpl', './views/%s.tpl'].

模板缓存

模板在编译后在内存中缓存.修改模板不会更新缓存,直到你清除缓存.调用bottle.TEMPLATES.clear().

模板语法

模板语法是围绕Python很薄的一层.主要目的就是确保正确的缩进块.下面是一些模板语法的列子:

  • %...Python代码开始.不必处理缩进问题.Bottle会为你做这些.

  • %end关闭一些语句%if ...,%for ...或者其他.关闭块是必须的.

  • {{...}}打印出Python语句的结果.

  • %include template_name optional_arguments包括其他模板.

  • 每一行返回为文本.

Example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
%header = 'Test Template'
%items = [1,2,3,'fly']
%include http_header title=header, use_js=['jquery.js', 'default.js']<h1>{{header.title()}}</h1><ul>%for item in items:  <li>
    %if isinstance(item, int):
      Zahl: {{item}}
    %else:
      %try:
        Other type: ({{type(item).__name__}}) {{repr(item)}}
      %except:
        Error: Item has no string representation.
      %end try-block (yes, you may add comments here)
    %end    </li>
  %end</ul>%include http_footer

Key/Value数据库

Bottle(>0.4.6)通过bottle.db模块变量提供一个key/value数据库.你可以使用key或者属性来来存取一个数据库对象.调用 bottle.db.bucket_name.key_namebottle.db[bucket_name][key_name].

只要确保使用正确的名字就可以使用,而不管他们是否已经存在.

存储的对象类似dict字典, keys和values必须是字符串.不支持 items() and values()这些方法.找不到将会抛出KeyError.

持久化

对于请求,所有变化都是缓存在本地内存池中. 在请求结束时,自动保存已修改部分,以便下一次请求返回更新的值.数据存储在bottle.DB_PATH文件里.要确保文件能访问此文件.

Race conditions

一般来说不需要考虑锁问题,但是在多线程或者交叉环境里仍是个问题.你可以调用 bottle.db.save()或者botle.db.bucket_name.save()去刷新缓存,但是没有办法检测到其他环境对数据库的操作,直到调用bottle.db.save()或者离开当前请求.

Example

1
2
3
4
5
6
7
from bottle import route, db@route('/db/counter')def db_counter():
    if 'hits' not in db.counter:
        db.counter.hits = 0
    db['counter']['hits'] += 1
    return "Total hits: %d!" % db.counter.hits

使用WSGI和中间件

bottle.default_app()返回一个WSGI应用.如果喜欢WSGI中间件模块的话,你只需要声明bottle.run()去包装应用,而不是使用默认的.

1
2
3
4
from bottle import default_app, runapp = default_app()newapp = YourMiddleware(app)run(app=newapp)

默认default_app()工作

Bottle创建一个bottle.Bottle()对象和装饰器,调用bottle.run()运行. bottle.default_app()是默认.当然你可以创建自己的bottle.Bottle()实例.

1
2
3
4
5
6
from bottle import Bottle, runmybottle = Bottle()@mybottle.route('/')def index():
  return 'default_app'run(app=mybottle)

发布

Bottle默认使用wsgiref.SimpleServer发布.这个默认单线程服务器是用来早期开发和测试,但是后期可能会成为性能瓶颈.

有三种方法可以去修改:

  • 使用多线程的适配器

  • 负载多个Bottle实例应用

  • 或者两者

多线程服务器

最简单的方法是安装一个多线程和WSGI规范的HTTP服务器比如Pasteflupcherrypy or fapws3并使用相应的适配器.

1
2
from bottle import PasteServer, FlupServer, FapwsServer, CherryPyServerbottle.run(server=PasteServer) # Example

如果缺少你喜欢的服务器和适配器,你可以手动修改HTTP服务器并设置bottle.default_app()来访问你的WSGI应用.

1
2
3
4
def run_custom_paste_server(self, host, port):
    myapp = bottle.default_app()
    from paste import httpserver
    httpserver.serve(myapp, host=host, port=port)

多服务器进程

一个Python程序只能使用一次一个CPU,即使有更多的CPU.关键是要利用CPU资源来负载平衡多个独立的Python程序.

单实例Bottle应用,你可以通过不同的端口来启动(localhost:8080, 8081, 8082, ...).高性能负载作为反向代理和远期每一个随机瓶进程的新要求,平衡器的行为,传播所有可用的支持与服务器实例的负载.这样,您就可以使用所有的CPU核心,甚至分散在不同的物理服


本文转载自:http://xxi.iteye.com/blog/539195

共有 人打赏支持
北方攻城师
粉丝 13
博文 74
码字总数 12500
作品 0
海淀
程序员
私信 提问
加载中

评论(1)

c
chenyanclyz
感觉。。这样Python的web框架,实现起来很容易啊。。稍微学深一点都可以自己写。。我也照着“廖雪峰的官方网站”写了一个差不多的。。也只能自己简单用用。。没有太多技术价值。。哎。
Bottle文档简单翻译版-前言

Bottle中文文档 基于官方0.12版本翻译和Linux操作示范 原作者:Marcel Hellkamp 译者:徐斌斌 2012.12.02 Bottle是一个用Python语言开发的简单,快速并且轻量级的WSGI微型Web框架.整个框架只有一...

铂金小马
2012/12/16
0
0
Bottle 框架中的装饰器类和描述符应用

最近在阅读Python微型Web框架Bottle的源码,发现了Bottle中有一个既是装饰器类又是描述符的有趣实现。刚好这两个点是Python比较的难理解,又混合在一起,让代码有些晦涩难懂。但理解代码之后...

大数据之路
2012/09/23
0
0
通用服务器 hi-nginx 1.4.2 发布,多项重要更新

支持多种编程语言混合开发 Web 应用的通用服务器 hi-nginx-1.4.2 已经发布了。 此次发布包含多项重要更新: 支持 Python 2 和 3,通过编译选项--with-http-hi-python-version 删除 boost.py...

所以呢
04/03
1K
3
python开发者的必备工具(一)

1.python开发工具 pip 可以快速安装第三方python包; virtualenv 可以创建一个与外界隔离的python运行环境,使项目更加可控; virtualenvwrapper 使用它可以更加方便的使用virtualenv提供的功...

柯南少少泡泡
2014/07/31
0
0
python web框架之 bottle

参考:http://bottlepy.org/docs/dev/bottle-docs.pdf 下载:https://pypi.python.org/packages/source/b/bottle/bottle-0.11.6.tar.gz#md5=0bafdc4e13ea2b1a3bddf36b5af108c4 解压安装:pyt......

彼得
2014/01/23
0
0

没有更多内容

加载失败,请刷新页面

加载更多

基于vue2定义自己的图表echart组件

先安装echarts cnpm i echarts -S,然后定义父组件 <template> <div> <echarts :option="echartOpion"></echarts> </div></template><script> import echarts from './e......

莫沫达
13分钟前
1
0
详解CSS的Flex布局

本文由云+社区发表 Flex是Flexible Box 的缩写,意为"弹性布局",是CSS3的一种布局模式。通过Flex布局,可以很优雅地解决很多CSS布局的问题。下面会分别介绍容器的6个属性和项目的6个属性。每...

腾讯云加社区
25分钟前
2
0
一些感想

人生的意义是什么 不知不觉已人到中年,其实上学的时候经常会思考这些问题————大概是因为闲,大学毕业参加工作经历的事情越来越多,反而不会去想这些缥缈的事情了,也许是因为最近看了一...

looqy
26分钟前
2
0
迭代器模式 Iterator 行为型 设计模式(二十)

  在计算机中,Iterator意为迭代器,迭代有重复的含义,在程序中,更有“遍历”的含义      如果给定一个数组,我们可以通过for循环来遍历这个数组,这种遍历就叫做迭代      对于...

SEOwhywhy
34分钟前
3
0
【 58沈剑 架构师之路】InnoDB,5项最佳实践,知其所以然

缓存讲了一个月《缓存架构,一篇足够》。今天,开始写数据库。 第一篇,说说MySQL两个最常用的存储引擎,MyISAM和InnoDB。照自己的理解,把一些知识点总结出来,不只说知识点,多讲“为什么”...

张锦飞
36分钟前
4
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部