我正在寻找在轻量级JavaScript客户端中包装REST API的最佳实践风格。
在过去,我看到一些库是以如下方式实现的:
var request = new SearchRequest(apikey);
request.query = "search term";
request.send(function(results) {
console.log(results);
});
或者更明确地采用HTTP,如:
api.get("search", "search term", function(results) {
console.log(results);
});
api.post("comment", comment, function(results) {
console.log(results);
});
或者是更高级别的包装:
api.search("search term", function(results) {
console.log(results);
});
api.createComment(comment, function(results) {
console.log(results);
});
您最近看到了哪些包装REST API的现代JavaScript客户端库的好例子。不担心实现细节,只关心API设计。
谢谢!
发布于 2012-11-01 18:51:03
我看了一个关于好的API设计的非常好的视频。绝对值得一看。
RESTful API Design - Second Edition
除了上面的视频之外,您还可以通过访问http://bit.ly/M28lOu免费获得一本《Web API设计-开发人员喜爱的接口制作》这本书
关于包装器,可能值得考虑以下几点:
采用您正在使用的编程语言或社区的标准、命名约定等,使包装器对使用它的人来说尽可能自然。
通过包装,您可以尽可能地模仿REST API的方法和结构,但只是让一些困难的事情变得更容易。这种方法的最大优点之一是,当目标REST API升级时,它使升级变得更容易。
当目标REST API很复杂或者行为和外观是非标准的时候,抽象是很有用的。在这种情况下,您的包装器方法和调用可能与目标REST API方法一点也不相似,但最终会简化使用您的包装器的人的生活(希望如此)。
发布于 2015-03-10 22:45:02
请检查以下几个:
在StackOverflow上还有其他类似的讨论,比如JavaScript REST client Library
https://stackoverflow.com/questions/13175161
复制相似问题