- android - RelativeLayout 背景可绘制重叠内容
- android - 如何链接 cpufeatures lib 以获取 native android 库?
- java - OnItemClickListener 不起作用,但 OnLongItemClickListener 在自定义 ListView 中起作用
- java - Android 文件转字符串
假设您在 REST API 中有一个复杂的资源。您在此资源上有几个一对多的标志和属性(即,用户可能已给资源 1 到 5 的评级,或者用户可能“喜欢”资源或将其标记为垃圾邮件或忽略它或导致要设置的其他一些状态)。
关于在以资源为中心的架构中表示这一点的最佳方式,已经提出了一些建议,但到目前为止,没有一个真正让我满意。因此,让我们众包这个;您发现哪些变体最容易理解?我们没有想到哪些变体?假设有一个基于 OAuth 的 API,这里的一切都是在当前授权用户的上下文中完成的。
bool 标志
变体 1:
GET /resource/{id}/mutedPOST /resource/{id}/muted BODY:truePOST /resource/{id}/muted BODY:false
变体 2:
GET /resource/{id}/mutedPUT /resource/{id}/muted BODY:trueDELETE /resource/{id}/muted
变体 3:
GET /resource/{id}/attributesPOST /resource/{id}/attributes BODY:muted=truePOST /resource/{id}/attributes BODY:muted=false
变体 4:
GET /resource/{id}/mutedPOST /resource/{id}/mutePOST /resource/{id}/unmute
属性
变体 1
GET /resource/{id}/ratingPOST /resource/{id}/rating BODY:4
变体 2:
GET /resource/{id}/ratingPUT /resource/{id}/rating BODY:4DELETE /resource/{id}/rating
变体 3:
GET /resource/{id}/attributesPOST /resource/{id}/attributes BODY:rating=4POST /resource/{id}/attributes BODY:rating=
想法?建议?其他 API 如何处理这个问题?你是怎么处理的?您是否发现像这样的设计问题对开发人员的满意度或 API 的易用性有重大影响?
最佳答案
来自 Roy's dissertation :
a uniform interface degrades efficiency, since information is transferred in a standardized form rather than one which is specific to an application's needs. The REST interface is designed to be efficient for large-grain hypermedia data transfer
因此您需要一个适用于标志和其他属性的变体 5:
GET /resource/{id}/ BODY:{muted: false, like: false, rating: 2, ignored: true}
POST /resource/{id}/ BODY:{muted: true, like: false, rating: 2, ignored: true}
POST /resource/{id}/ BODY:{muted: false, like: false, rating: 2, ignored: true}
一个重要的原因是大部分 RESTful HTTP 应用程序的效率来自缓存,并且当它的工件尽可能大并且它的数据可以通过尽可能少的标识符访问时,缓存效果最好。如果您在 /resource/{id}/
和 /resource/{id}/muted
中都公开了“muted”标志,那么您就会遇到缓存失效问题。如果你只在 /resource/{id}/
公开它,那么你就不会。
如果您设计的应用程序旨在通过小负载提高效率,那么您将无法从大粒度缓存中获益,并且 REST 架构风格不适合您的应用程序。 HTTP 可能也不是,但我能理解在当今市场上有些人可能会坚持使用它。
关于http - 在 REST API 中处理标志和属性的选项有哪些?,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/4074113/
你能比较一下属性吗 我想禁用文本框“txtName”。有两种方式 使用javascript,txtName.disabled = true 使用 ASP.NET, 哪种方法更好,为什么? 最佳答案 我
Count 属性 返回一个集合或 Dictionary 对象包含的项目数。只读。 object.Count object 可以是“应用于”列表中列出的任何集合或对
CompareMode 属性 设置并返回在 Dictionary 对象中比较字符串关键字的比较模式。 object.CompareMode[ = compare] 参数
Column 属性 只读属性,返回 TextStream 文件中当前字符位置的列号。 object.Column object 通常是 TextStream 对象的名称。
AvailableSpace 属性 返回指定的驱动器或网络共享对于用户的可用空间大小。 object.AvailableSpace object 应为 Drive 
Attributes 属性 设置或返回文件或文件夹的属性。可读写或只读(与属性有关)。 object.Attributes [= newattributes] 参数 object
AtEndOfStream 属性 如果文件指针位于 TextStream 文件末,则返回 True;否则如果不为只读则返回 False。 object.A
AtEndOfLine 属性 TextStream 文件中,如果文件指针指向行末标记,就返回 True;否则如果不是只读则返回 False。 object.AtEn
RootFolder 属性 返回一个 Folder 对象,表示指定驱动器的根文件夹。只读。 object.RootFolder object 应为 Dr
Path 属性 返回指定文件、文件夹或驱动器的路径。 object.Path object 应为 File、Folder 或 Drive 对象的名称。 说明 对于驱动器,路径不包含根目录。
ParentFolder 属性 返回指定文件或文件夹的父文件夹。只读。 object.ParentFolder object 应为 File 或 Folder 对象的名称。 说明 以下代码
Name 属性 设置或返回指定的文件或文件夹的名称。可读写。 object.Name [= newname] 参数 object 必选项。应为 File 或&
Line 属性 只读属性,返回 TextStream 文件中的当前行号。 object.Line object 通常是 TextStream 对象的名称。 说明 文件刚
Key 属性 在 Dictionary 对象中设置 key。 object.Key(key) = newkey 参数 object 必选项。通常是 Dictionary 
Item 属性 设置或返回 Dictionary 对象中指定的 key 对应的 item,或返回集合中基于指定的 key 的&
IsRootFolder 属性 如果指定的文件夹是根文件夹,返回 True;否则返回 False。 object.IsRootFolder object 应为&n
IsReady 属性 如果指定的驱动器就绪,返回 True;否则返回 False。 object.IsReady object 应为 Drive&nbs
FreeSpace 属性 返回指定的驱动器或网络共享对于用户的可用空间大小。只读。 object.FreeSpace object 应为 Drive 对象的名称。
FileSystem 属性 返回指定的驱动器使用的文件系统的类型。 object.FileSystem object 应为 Drive 对象的名称。 说明 可
Files 属性 返回由指定文件夹中所有 File 对象(包括隐藏文件和系统文件)组成的 Files 集合。 object.Files object&n
我是一名优秀的程序员,十分优秀!