草庐IT

xml - 应该如何使用非 XML 数据表示在 RESTful 服务中提供链接?

coder 2024-06-23 原文

最近我一直在阅读大量有关如何实现真正 RESTful WS 的资料。很多人都链接到这篇文章 here其中详细说明了实现者如果想要最终得到符合 REST 概念的服务,应该牢记的几个约束。

虽然这篇文章显然很重要,但不幸的是,对于我们这些凡人来说,理解起来相当困难,而且很多人都尝试过 decipher it .也许可以找到我遇到的最好的解释 here ,作者在其中给出了一个具体示例,说明为什么当今存在的许多“RESTful”API 实际上根本不是 RESTful,并展示了如何纠正这种情况。

他的提议在很大程度上依赖于在公开资源的表示中使用嵌入链接,并且很有意义:我可以清楚地遵循逻辑并希望自己在我正在设计的一组服务中使用这些技术我有一个问题我不确定应该如何解决:即如果使用的数据表示不是 XML 而是 JSON 之类的东西,应该如何提供这样的链接?

作者所说的一切在 XML 世界中都非常有意义,但我不清楚如何将其重新应用于其他内容表示?

非常有兴趣听取其他人的意见,看看人们如何在他们自己的、非基于 XML 的 REST API 中解决这个问题。

[编辑]:自从我写了这个问题后,我发现了以下 useful links .这对回答我的问题有很大帮助,但我仍然对其他人的意见感兴趣。

最佳答案

我在同一个问题上纠结了很长时间。我得出了两个结论:a) 用不同的语法重新发明 XML(基本上是那些链接提出的),或者 b) 决定一些简单的固定约定。

我和b一起去了。对于我现在正在处理的 api,有两种方法可以指定一个链接作为您可以从中获取信息的地方。

首先是在某些情况下该值始终被假定为 URI。应用程序知道它是一个 URI,因为这就是我们的媒体类型所说的它必须是的。

{"form_type": "whatever", "validator": "http://example.com/validatorA"}

第二个是返回的结构化值可以是典型的标准类型(int、string、list、object 等),也可以是具有“魔法”__ref__ 键的对象。这也是我们如何定义媒体类型的一部分(根据我们应用程序的规则,“__”在属性名称中也是非法的,因此它永远不应该出现)。由应用程序在闲暇时取消引用该值。

{"owner": "john", "attachment": {"__ref__": "http://..."}}

这对我们有用。大多数时候我们关心的值是字符串“john”,而不太关心“john”这个抽象概念是一个Owner资源(其内容不仅仅是唯一标识符“john”)。

为了满足我们的需求,我们用简单性和性能换取了表现力和 REST 正确性。在现实世界中,当结果在 99% 的时间内提供所需的所有信息时,带外信息说“转到/users/$username 以获取更多信息”并不是什么大不了的事。

我们的计划(如果将来有必要)是通过添加 __ref__ 属性来附加链接。

{"owner": "john", "owner.__ref__": "http://ex.com/users/83j9io"}

虽然这不如您提供的链接那么全面,但我认为这是一个合理的平衡。虽然我喜欢每个值都可以链接到其唯一资源和其他元数据(例如您链接到的 json-collections 文档中描述的)的想法,但我认为大多数时候这些信息都是无关紧要的。一个简单的值列表,但您真的需要知道每个值的可寻址 URI、版本、ID 等吗?

它还在代码中引入了烦人的复杂性,必须键入“.value”或“.members”(以及额外访问暗示的所有语义),而不是能够使用语言原生结构。这种“.value”模型实际上是我们在服务器端所做的,它之所以可以容忍,只是因为所有努力使它们看起来像标准数据类型而不是包装器。

关于xml - 应该如何使用非 XML 数据表示在 RESTful 服务中提供链接?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/1768057/

有关xml - 应该如何使用非 XML 数据表示在 RESTful 服务中提供链接?的更多相关文章

  1. ruby - 如何使用 Nokogiri 的 xpath 和 at_xpath 方法 - 2

    我正在学习如何使用Nokogiri,根据这段代码我遇到了一些问题:require'rubygems'require'mechanize'post_agent=WWW::Mechanize.newpost_page=post_agent.get('http://www.vbulletin.org/forum/showthread.php?t=230708')puts"\nabsolutepathwithtbodygivesnil"putspost_page.parser.xpath('/html/body/div/div/div/div/div/table/tbody/tr/td/div

  2. ruby - 如何从 ruby​​ 中的字符串运行任意对象方法? - 2

    总的来说,我对ruby​​还比较陌生,我正在为我正在创建的对象编写一些rspec测试用例。许多测试用例都非常基础,我只是想确保正确填充和返回值。我想知道是否有办法使用循环结构来执行此操作。不必为我要测试的每个方法都设置一个assertEquals。例如:describeitem,"TestingtheItem"doit"willhaveanullvaluetostart"doitem=Item.new#HereIcoulddotheitem.name.shouldbe_nil#thenIcoulddoitem.category.shouldbe_nilendend但我想要一些方法来使用

  3. ruby - 使用 RubyZip 生成 ZIP 文件时设置压缩级别 - 2

    我有一个Ruby程序,它使用rubyzip压缩XML文件的目录树。gem。我的问题是文件开始变得很重,我想提高压缩级别,因为压缩时间不是问题。我在rubyzipdocumentation中找不到一种为创建的ZIP文件指定压缩级别的方法。有人知道如何更改此设置吗?是否有另一个允许指定压缩级别的Ruby库? 最佳答案 这是我通过查看ruby​​zip内部创建的代码。level=Zlib::BEST_COMPRESSIONZip::ZipOutputStream.open(zip_file)do|zip|Dir.glob("**/*")d

  4. ruby - 为什么我可以在 Ruby 中使用 Object#send 访问私有(private)/ protected 方法? - 2

    类classAprivatedeffooputs:fooendpublicdefbarputs:barendprivatedefzimputs:zimendprotecteddefdibputs:dibendendA的实例a=A.new测试a.foorescueputs:faila.barrescueputs:faila.zimrescueputs:faila.dibrescueputs:faila.gazrescueputs:fail测试输出failbarfailfailfail.发送测试[:foo,:bar,:zim,:dib,:gaz].each{|m|a.send(m)resc

  5. ruby-on-rails - 使用 Ruby on Rails 进行自动化测试 - 最佳实践 - 2

    很好奇,就使用ruby​​onrails自动化单元测试而言,你们正在做什么?您是否创建了一个脚本来在cron中运行rake作业并将结果邮寄给您?git中的预提交Hook?只是手动调用?我完全理解测试,但想知道在错误发生之前捕获错误的最佳实践是什么。让我们理所当然地认为测试本身是完美无缺的,并且可以正常工作。下一步是什么以确保他们在正确的时间将可能有害的结果传达给您? 最佳答案 不确定您到底想听什么,但是有几个级别的自动代码库控制:在处理某项功能时,您可以使用类似autotest的内容获得关于哪些有效,哪些无效的即时反馈。要确保您的提

  6. ruby - 在 Ruby 中使用匿名模块 - 2

    假设我做了一个模块如下:m=Module.newdoclassCendend三个问题:除了对m的引用之外,还有什么方法可以访问C和m中的其他内容?我可以在创建匿名模块后为其命名吗(就像我输入“module...”一样)?如何在使用完匿名模块后将其删除,使其定义的常量不再存在? 最佳答案 三个答案:是的,使用ObjectSpace.此代码使c引用你的类(class)C不引用m:c=nilObjectSpace.each_object{|obj|c=objif(Class===objandobj.name=~/::C$/)}当然这取决于

  7. ruby - 使用 ruby​​ 和 savon 的 SOAP 服务 - 2

    我正在尝试使用ruby​​和Savon来使用网络服务。测试服务为http://www.webservicex.net/WS/WSDetails.aspx?WSID=9&CATID=2require'rubygems'require'savon'client=Savon::Client.new"http://www.webservicex.net/stockquote.asmx?WSDL"client.get_quotedo|soap|soap.body={:symbol=>"AAPL"}end返回SOAP异常。检查soap信封,在我看来soap请求没有正确的命名空间。任何人都可以建议我

  8. python - 如何使用 Ruby 或 Python 创建一系列高音调和低音调的蜂鸣声? - 2

    关闭。这个问题是opinion-based.它目前不接受答案。想要改进这个问题?更新问题,以便editingthispost可以用事实和引用来回答它.关闭4年前。Improvethisquestion我想在固定时间创建一系列低音和高音调的哔哔声。例如:在150毫秒时发出高音调的蜂鸣声在151毫秒时发出低音调的蜂鸣声200毫秒时发出低音调的蜂鸣声250毫秒的高音调蜂鸣声有没有办法在Ruby或Python中做到这一点?我真的不在乎输出编码是什么(.wav、.mp3、.ogg等等),但我确实想创建一个输出文件。

  9. ruby-on-rails - 如何验证 update_all 是否实际在 Rails 中更新 - 2

    给定这段代码defcreate@upgrades=User.update_all(["role=?","upgraded"],:id=>params[:upgrade])redirect_toadmin_upgrades_path,:notice=>"Successfullyupgradeduser."end我如何在该操作中实际验证它们是否已保存或未重定向到适当的页面和消息? 最佳答案 在Rails3中,update_all不返回任何有意义的信息,除了已更新的记录数(这可能取决于您的DBMS是否返回该信息)。http://ar.ru

  10. ruby-on-rails - 'compass watch' 是如何工作的/它是如何与 rails 一起使用的 - 2

    我在我的项目目录中完成了compasscreate.和compassinitrails。几个问题:我已将我的.sass文件放在public/stylesheets中。这是放置它们的正确位置吗?当我运行compasswatch时,它不会自动编译这些.sass文件。我必须手动指定文件:compasswatchpublic/stylesheets/myfile.sass等。如何让它自动运行?文件ie.css、print.css和screen.css已放在stylesheets/compiled。如何在编译后不让它们重新出现的情况下删除它们?我自己编译的.sass文件编译成compiled/t

随机推荐