REST资源三要素

首先上图

如何规划REST服务

　　当我们要规划一个REST服务的时候，其中最关键的概念其实就是“资源”。

　　资源是什么呢？广义上讲，任何事物只要它有用，那么它就是资源。狭义的讲（在Web环境中），它是一个可以存放、连接在计算机上，可以通过比特流进行操控的实体。一个实体想成为资源，它必须有一个URI。在这里URI包含了两重含义：1)它是资源的名称 2)它是资源的地址。

　　在我们规划URI的时候，有几点希望大家能够注意一下：

• 一个URI标识一个资源，但是一个资源可以被多个URI标识。
• 资源也是有层次的，这个层次应该在URI上充分的体现出来。
• 在规划URI的时候，需要定义一些团队内部确认的关键字或符号，这些关键字或符号是有特殊意义的，不能随便使用。
• 需要有一个URI定义的文档，以备以后的查询和维护。
• 可以使用URI Template来描述URI的定义。

　　当我们定义好资源之后，接下来要做的事情就是定义操作资源的方法以及资源的表述格式了。

　　使用HTTP提供的基本方法来对资源进行操作，一般的操作定义如下：POST（创建资源）、GET（获取资源）、PUT（修改资源）、DELETE（删除）。它们正好对应了CRUD。

　　对资源的表述，一般的选择会是XML，但是我更加推荐使用JSON来表述资源。在网络中的传输量也小，而且也便于JavaScript来解析，而且现在其他语言解析也是非常方便的事情。不过，最关键的还是占用更少的资源，让同样的资源能够服务更多的人。