ServiceStack框架提供三种模式的服务接口实现， REST 、Client 以及和WCF相兼容的SOAP WebService ，这三种模式统称WebService，目前对于移动平台和云服务火爆的情形下，最为普及的是REST模式。


WebService常用连接模式：

RESTClientSOAPWebService


在不同模式下，可以使用不同的数据（流）格式，最为常用的是XML 、JSON ， 主要使用在REST模式下，此外还支持JSV， CSV 以及SOAP格式的数据。

XMLJSONJSVCSVSOAP

在前文中提到启动服务（SS项目），这种服务是一种×××面的，对外仅提供数据服务，通过一套自定义的API访问，在大型网站广为使用，比如微信、微博、淘宝及人人网、各种网盘开发API等。

SS中，客户端连接到服务端的方式主要有两种，通过REST方式或者Client方式，初始化客户端是相同的 ：

varservice=newJsvServiceClient("http://localhost:2790/");


通过REST方式访问服务：


varstoryResponses=service.Post<List<NewsResponse>>("newslist",newNewsAll(){cid=0});


其中service.后边的Post为HTTP指令，接下来要详细说明，NewsAll()为入口类，NewsResponse为出口类，使用时结构为：

HTTP 指令出口类（"路由"入口类{ 传入参数 }）


通过Client方式访问服务：


service.Send<SubmissionResponse>(newSubmission(){Body=news.Text,Headline=news.Headline,SubmissionTime=news.Date});

Client模式的标志是使用Send函数 ，使用结构为：

Send出口类（入口类{ 传入参数 }）

注意客户端 模式是不使用路由的，它的执行方式很类似软件中使用Socket连接模式，使用比HTTP协议更底层的高速数据通道来传输数据。


一般来说客户端模式是比REST模式效率要高，但在服务端和客户端同时都使用了SS的情况下，框架会在内部自动将其都转换为客户端模式（可以支持二进制传输、文件上传下载等），所以使用REST模式和 使用客户端模式的差异并不大，具体使用哪种方式可以根据自己的习惯和喜好使用。


下面说一下HTTP指令， 又称HTTP verb（HTTP动词），我们通常访问网站数据的方式有GET和POST，用于指定获取数据和交流的方式，它是被附加在HTTP的request请求上的，包含于HTTP头中（可以使用HTTP传输工具查看），使用了REST模式后，可以使用全套的HTTP指令，常用的有除了GET和POST，还有PUT、DELETE和PATCH、TRACE。

HTTP指令在HTTP头中通常所有字母全部大写。


GET用于获取数据操作，传递的参数通常是附加在URL上，数据大小限制一般为1-16k，可以返回单条或列表数据；

POST用于获取、提交、文件上传等操作，传递的参数或数据通常使用表单提交，可以为文本也可以为二进制数据，二进制方式可以用于文件、图片上传，并且可自定义文件类型，POST提交的返回数据通常是状态信息，比如操作是否成功，操作得到的ID、记录条数等，而且通常会根据返回的状态信息执行跳转或处理异常等操作。在使用POST对REST模式的服务中，常用的是将其数据使用Insert语句保存到数据库。

PUT用于更新数据操作，通常在REST模式下，将其数据使用Update语句更新到数据库。

DELETE用于删除操作，在REST模式下，可以使用两种方式执行删除，一个方式是传递一个对象到服务，比如一个order订单对象(里边实际有效的仅仅是id字段)，另一种方式传递一个id或一组id，执行数据库的删除操作。

PATCH用于追加模式更新数据。

TRACE回显提交的数据，可以用于调试以及查看服务端数据的变更。



附 ： ServiceStack 内置的 客户端实现，从中也可以看出无论REST还是客户端都是使用同样的类库： 未翻译

implements bothIRestClientandIServiceClient:

JsonServiceClient(uses default endpoint withJSON) - recommended

JsvServiceClient(uses default endpoint withJSV)

XmlServiceClient(uses default endpoint withXML)

MsgPackServiceClient(uses default endpoint withMessage-Pack)

ProtoBufServiceClient(uses default endpoint withProtocol Buffers)

implementsIServiceClientonly:

Soap11ServiceClient(usesSOAP 11endpoint)

Soap12ServiceClient(usesSOAP 12endpoint)