首页 > 代码库 > 使用RpcLite构建SOA/Web服务(Full .Net Framework)

使用RpcLite构建SOA/Web服务(Full .Net Framework)

使用RpcLite构建SOA/Web服务(Full .Net Framework)

SOA框架系列

1. 使用RpcLite构建SOA/Web服务

2. 使用RpcLite构建SOA/Web服务(Full .Net Framework)

 

继前一篇文章《使用RpcLite构建SOA/Web服务》已过去好几个月。在这几个月里对RpcLite作了很多修改如:.Net Core的支持、Fluent API方式配置、Monitor、Filter等功能。

 

前一篇文章介绍了使用RpcLite的基本用法,在文章中介绍的配置方式为配置文件使用起来比较麻烦。本文配置使用Fluent API方式,在.Net Core中可以完全不使用配置文件,在Asp.Net中仅需要添加一个HttpModule。

 

创建服务端

Full .Net Framework中现只支持Host到ASP.NET中。

创建服务包括以下步骤:

  • 创建Web Application工程
  • 添加RpcLite引用
  • Web.config添加RpcHttpModule
  • 创建服务契约接口
  • 通过实现服务契约接口创建服务类
  • 在Global.asax中初始化RpcLite

创建Web Application工程

  • 打开Visual Studio 2015
  • 打开菜单File ? New ? Project...
  • 在左边的菜单中选择 Templates ? Visual C# ? Web
  • 在项目类型中选择 ASP.NET Web Application (.Net Framework)
  • 确保目标Framework版本为 .NET Framework 4.0 或更高
  • 填写项目名称HelloRpcLiteService点Ok

添加RpcLite引用

添加引用有两种方式:直接下载dll然后引用、通过NuGet添加,其中通过NuGet添加简单方便,本文以此方式为例。 通过NuGet添加也有两种方式:图形界面或命令行

命令行

  • 打开菜单Tools ? NuGet Package Manager ? Package Manager Console
  • 运行 Install-Package RpcLite

图形界面

  • 在Solution Explorer中右击HelloRpcLite,选择Manage NuGet Packages...
  • 在NuGet页面中选择Browse Tab页,然后搜索RpcLite
  • 在搜索结果中安装RpcLite

Web.config添加RpcHttpModule

默认情况下添加RpcLite包依赖后Web.Config会自动添加,若已自动添加请忽略本小节的操作
在集成管道模式和经典管道模式中添加HttpModule方式不同,本文以现在用得最多的集成管道模式说明

在configuration/system.webServer节点下添加 <add name=”RpcLite” type=”RpcLite.Service.RpcHttpModule, RpcLite.NetFx” />

完整配置如下:

<?xml version="1.0" encoding="utf-8"?><configuration>    <system.webServer>            <modules>                    <add name="RpcLite" type="RpcLite.Service.RpcHttpModule, RpcLite.NetFx" />            </modules>    </system.webServer></configuration>

 

创建服务契约接口

  • 新建类文件IProductService.cs
  • 输入以下内容
namespace HelloRpcLiteService{        public interface IProductService        {                string GetDateTimeString();        }}

 

通过实现服务契约接口创建服务类

  • 新建类文件ProductService.cs
  • 输入以下内容
 
using System;namespace HelloRpcLiteService{        public class ProductService : IProductService        {                public string GetDateTimeString()                {                        return DateTime.Now.ToString();                }        }}

 

在Global.asax中初始化RpcLite

  • 向工程中添加Global.asax
  • 在Application_Start函数中添加初始化代码
using System;using RpcLite.Config;namespace HelloRpcLiteService{        public class Global : System.Web.HttpApplication        {                protected void Application_Start(object sender, EventArgs e)                {                        RpcInitializer.Initialize(builder => builder                                .UseService<ProductService>("ProductService", "api/service/")                                .UseServicePaths("api/")                                );                }        }}

 

说明

  • UseService<ProductService>(“ProductService”, “api/service/”)是添加一个服务 泛型参数ProductService为服务提供类, 第一个参数”ProductService”为服务名 “api/service/”为服务相对于当前WebApplication根的地址,例如WebApplication地址为http://localhost:8080则服务地址为http://localhost:8080/api/service/。若服务部署到虚拟目录下如http://localhost:8080/app1则服务地址为http://localhost:8080/app1/api/service/
  • UseServicePaths(“api/”)指定服务地址的前缀,以此地址开始的所有Url都会被认为是RpcLite服务,UseService中使用的路必需在ServicePaths中。若没有配置此选项则不能正常访问服务。

运行

到此一个RpcLite服务已经创建完成,可运行查看结果。
  • F5运行WebApplication,在浏览器中查看地址,假设是http://localhost:11651
  • 在浏览器访问http://localhost:11651/api/service/GetDateTimeString,可看到返回的内容是当前日期
  • 在浏览器访问http://localhost:11651/api/service/可以看到当前服务的信息,服务名及所有接口名
Service Name: ProductServiceActions:String GetDateTimeString();

通过RpcLite客户端、JavaScript就可以访问这个服务了。

 

本文代码地址 https://github.com/aolyn/rpclite.docs/tree/master/samples/HelloRpcLite/src/HelloRpcLiteService

 

QQ群:364617712 

欢迎加入

联系方式技术分享

使用RpcLite构建SOA/Web服务(Full .Net Framework)