是否有一份关于在服务器端使用不同基于python的REST框架来编写自己的RESTful api的推荐列表?最好有正反两面。
请随意在这里添加建议。:)
是否有一份关于在服务器端使用不同基于python的REST框架来编写自己的RESTful api的推荐列表?最好有正反两面。
请随意在这里添加建议。:)
当前回答
下面是CherryPy文档中关于REST的讨论:http://docs.cherrypy.org/dev/progguide/REST.html
它特别提到了一个内置的CherryPy dispatcher,称为MethodDispatcher,它基于http -动词标识符(GET, POST等…)调用方法。
其他回答
请参阅Python Web Frameworks wiki。
您可能不需要完整的堆栈框架,但剩下的列表仍然相当长。
我强烈推荐TurboGears或Bottle:
TurboGears:
比django更简洁 更灵活,更少面向html 但是:不太出名
瓶:
非常快 非常容易学 但是:简约而不成熟
我真的很喜欢樱桃皮。下面是一个基于rest的web服务的例子:
import cherrypy
from cherrypy import expose
class Converter:
@expose
def index(self):
return "Hello World!"
@expose
def fahr_to_celc(self, degrees):
temp = (float(degrees) - 32) * 5 / 9
return "%.01f" % temp
@expose
def celc_to_fahr(self, degrees):
temp = float(degrees) * 9 / 5 + 32
return "%.01f" % temp
cherrypy.quickstart(Converter())
这强调了我真正喜欢CherryPy的地方;这是一个完全可行的例子,即使对不了解框架的人来说也是可以理解的。如果你运行这段代码,你可以立即在浏览器中看到结果;例如,访问http://localhost:8080/celc_to_fahr?degrees=50将在您的web浏览器中显示122.0。
在设计RESTful API时需要注意的是GET和POST的合并,就好像它们是同一件事一样。Django的基于函数的视图和CherryPy的默认分派器很容易犯这个错误,尽管这两个框架现在都提供了解决这个问题的方法(分别是基于类的视图和MethodDispatcher)。
http -动词在REST中非常重要,除非非常小心,否则最终会陷入REST反模式。
一些框架是正确的web.py, Flask和Bottle。当与mimerender库结合使用时(完全披露:它是我写的),它们允许你编写漂亮的RESTful webservices:
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报头)+分派到适当的呈现函数(或模板)以一种整洁、透明的方式完成。
$ 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框架的信息。问这个问题的时候两者都不存在。
web2py包括对轻松构建RESTful API的支持,在这里和这里(视频)都有描述。特别要注意的是parse_as_rest,它允许您定义URL模式,将请求参数映射到数据库查询;和smart_query,它允许您在URL中传递任意自然语言查询。