xml – 如何使用Rails 3.0创建REST API?

前端之家收集整理的这篇文章主要介绍了xml – 如何使用Rails 3.0创建REST API?前端之家小编觉得挺不错的,现在分享给大家,也给大家做个参考。
我不能在网上找到很多关于在Rails中构建REST API的不同方法的信息;所以我有两个问题:

>有人可以指点我的一些文章显示不同的利弊
方法
>请您分享您对以下方法的利弊的看法?

建议方法

>当用户将.xml添加到结尾时,使用标准控制器返回XML
的网址

优点:

>这是内置的Rails和非常容易使用
>遵循Rails具有的相同的基于资源的方法,所以它很容易
现有用户了解/记住

缺点:

> API与主站点不完全分离,难以维护
>人们可以假定添加.xml将在不它的地方工作

>使用命名空间路由创建仅处理API的单独的API控制器
功能,但仍然可以访问与网站使用的相同型号

优点:

> API大多是分开的
>仍然使用资源完全控制器

缺点:

> URL具有site.com/api/resource.xml的形式,这可能使人们承担所有
资源可用
> API仍然是网站代码/项目的一部分;因此,更难维护


>使用路由转发和约束将所有API调用转发到机架
应用

优点:

> API完全分离
>不需要使用Resource-full样式,如果我们不想
>网址清楚地显示它是一个API,您应该检查文档以查看可用的
(至少,我的心灵这样工作;我认为其他开发人员也这样)

缺点:

>从网站代码更难使用模型
>更容易维护作为一个单独的项目,但这意味着更难以整合
现有网站
>必须保持代码库同步,因为模型可能会因网站功能/错误修复而改变

我建议与您的网站在同一个项目的API不是一件坏事,只要代码是DRY *。正如你所指出的,拥有单独的代码库是一个挑战,因为你必须保持它们与你做的每个功能/ bug修复同步。如果他们在同一个地方,它更容易维护。只要你保持你的代码干,这种方法是明确的胜利者。

我将提供XML和JSON从控制器与Rails的路由引擎处理的子域。当有人选择api.site.com/resource.xml的模式并尝试访问不在那里的资源时,这真的不是什么大问题。只要你的API文件清楚,你失败/错误优雅地,当他们尝试访问资源不在你的API,它应该是很好。我会尝试返回一个消息,说资源不可用和一个url到你的api文档。这不应该是任何API使用者的运行时问题,因为这应该是发现您的API的一部分。

只是我的$ 0.02。

* DRY =不要重复自己。 DRY代码意味着你不要为你的网站和你的api复制粘贴或重写同样的东西;您从多个地方提取调用

猜你在找的XML相关文章