是否有不同的基于 Python 的 REST 框架的建议列表,用于在服务器端编写您自己的 RESTful API?最好各有优劣。
请随时在此处添加建议。:)
在设计 RESTful API 时需要注意的是 GET 和 POST 的混淆,就好像它们是同一件事一样。使用Django的基于函数的视图和CherryPy的默认调度程序很容易犯这个错误,尽管这两个框架现在都提供了解决这个问题的方法(分别是基于类的视图和MethodDispatcher)。
HTTP 动词在 REST 中非常重要,除非您对此非常小心,否则您最终会陷入REST 反模式。
一些正确的框架是web.py、Flask和Bottle。当与mimerender库(完全公开:我写的)结合使用时,它们允许您编写漂亮的 RESTful Web 服务:
import web import json from mimerender import mimerender render_xml = lambda message: '<message>%s</message>'%message render_json = lambda **args: json.dumps(args) render_html = lambda message: '<html><body>%s</body></html>'%message render_txt = lambda message: message urls = ( '/(.*)', 'greet' ) app = web.application(urls, globals()) class greet: @mimerender( default = 'html', html = render_html, xml = render_xml, json = render_json, txt = render_txt ) def GET(self, name): if not name: name = 'world' return {'message': 'Hello, ' + name + '!'} if __name__ == "__main__": app.run()
服务的逻辑只实现一次,正确的表示选择(Accept header)+分发到正确的渲染函数(或模板)以整洁、透明的方式完成。
$ curl localhost:8080/x <html><body>Hello, x!</body></html> $ curl -H "Accept: application/html" localhost:8080/x <html><body>Hello, x!</body></html> $ curl -H "Accept: application/xml" localhost:8080/x <message>Hello, x!</message> $ curl -H "Accept: application/json" localhost:8080/x {'message':'Hello, x!'} $ curl -H "Accept: text/plain" localhost:8080/x Hello, x!
更新(2012 年 4 月) :添加了有关 Django 基于类的视图、CherryPy 的 MethodDispatcher 以及 Flask 和 Bottle 框架的信息。当问题被问到时,两者都不存在。