python 簡單web框架: Bottle

基本映射

映射使用在根據不一樣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_name和bottle.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服務器好比Paste, flup, cherrypy 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核心，甚至分散在不一樣的物理服