使用RpcLite构建SOA/Web服务
SOA框架系列
提到Web服务最先想到的就是WebService此外常用的还有WCF、ServiceStack、WebApi等。
RpcLite是一个开源的轻量级SOA服务框架,除了基本的提供Web服务还包括SOA治理系统(本文暂不展开在后继的文章会详细说明)。RpcLite与WCF比较像,下面介绍使用方法。
1. 创建一个Web项目,Framework选择>=4.0
2. 从NuGet中添加RpcLite
安装后项目中会添加一个TestService1.cs文件,此文件是一个最简单的服务提供一个接口GetDateTimeString返回当前时间的字符串
Web.config也添加了相关的配置
3. 修改配置
到此为止,最简单有服务就已经完成了。F5运行在浏览器中把地址改为http://localhost:53189/api/test/GetDateTimeString可看到接口返回的结果,用JQuery, Ajax都可以访问了。
4. 基本原理
架构图
RpcLite的入口是一个异步HttpHandler,在Handler中会把RequestUrl、ContentType、RequestStream、ResponseStream、HttpContext等放到一个新的ServiceContext中交给RpcService处理,RpcService会根据RequestUrl找到对应的Service及Action根据ContentType选择序列化方式(默认支持json、xml,可以添加自定义序列化方式),然后反序列化得到参数,再使用参数调用具体的服务方法,得到结果后返回给客户端。
5. 配置文件说明
再来看Web.config,
标记1. 添加HttpHandler添加后对应地址的请求会被RpcAsyncHandler处理。
标记2. 添加RpcLite配置节点处理器,添加后RpcLite就能读取RpcLite节点中的数据。
标记3. 此处添加了一个服务,name只起识别作用最好不要重复,path确定此服务会处理来自哪些url地址的请求需要使用虚拟目录相对地址即以~/开头,type设置实现此服务的类格式是<类全名>, 程序集名。
标记4. 这里是添加一个客户端配置,如果创建客户端实例时未指定服务url则会使用这里设置的path。如ClientFactory.GetInstance<ITestService>()此处未指定服务url就会从配置中查找。
其它. appId、environment、namespace与治理系统相关此处不展开明说。
代码从下面给出的git中获取。
6. 相关链接
Demo git 地址:https://github.com/chrishaly/RpcLiteDemo
RpcLite git 地址:https://github.com/aolyn/RpcLite
NuGet: https://www.nuget.org/packages/RpcLite
QQ群:364617712
欢迎加入
夜深了、写文章比写代码麻烦。这个框架前年2014年就写得差不多了,一直没时间介绍。有兴趣的朋友可以在git上fork & pull request。
联系方式
后继会有系列文章详细介绍
thanks & regards.
Chris