|
Soa
项目地址：https://github.com/MatoApps/Soa
介绍
一个轻量级的微服务库，基于.NET 6 + Abp框架 可快速地将现有项目改造成为面向服务体系结构，实现模块间松耦合。
感谢
RabbitTeam 的项目 RabbitCloud:
https://github.com/RabbitTeam/RabbitCloud
grissomlau 的项目jimu:
https://github.com/grissomlau/jimu
部分模块以及算法代码参考自以上项目
特点
支持DotNetty和Http两种模式的RPC支持自动路由发现注册与微服务健康监测支持模块以及模块的依赖关系支持简单对象(POCO)作为参数或返回类型支持登录与鉴权支持多语言/本地化
内容
基于Roslyn的动态客户代理类(Proxy模块)POCO对象传输编解码(TypeConverter模块)基于DotNetty或者HTTP的RPC(Transport模块)路由服务发现(ServiceDiscovery模块)健康监测(HealthCheck模块)基于swagger的Api文档生成基于Attribute注解的路由配置基于Json配置文件的系统配置(Abp实现)基于Hangfire的计划任务基于Castle Windsor的Ioc(Abp实现)基于Log4Net的日志(Abp实现)基于AbpZero的用户系统基于EF，并实现模型的Repository仓储模式(Abp实现)
更新内容
| Date | Version | Content | | V0.9.0 | 2022-5-17 | 初始版本 |
快速开始
网关（客户端） GatewaySample
添加对Soa库的引用添加对Soa.Client库的引用
Startup.cs 文件
1、删除AddAbp
// services.AddAbp();
2、添加AddSoaClient
services.AddSoaClient<GatewaySampleWebHostModule>(new SoaClientOptions()
{
IsDevelopment = _hostingEnvironment.IsDevelopment(),
LoggerProvider = _appConfiguration["App:UseLogger"].ToUpper(),
PlugInsPath = Path.Combine(_hostingEnvironment.WebRootPath, "PlugIns")
},true);
3、删除UseAbp
//app.UseAbp();
4、添加UseSoaClient
app.UseSoaClient(options => { options.UseAbpRequestLocalization = false; }); // Initializes Soa framework.
GatewaySampleWebHostModule.cs 文件
5、添加SoaClientModule模块依赖
[DependsOn(typeof(SoaClientModule))]
public class GatewaySampleWebHostModule: AbpModule
{
//Your code
}
配置 appsettings.json 文件配置 Hangfire
微服务抽象层 IService1
IService1Manager.cs 文件
1、构建接口IService1Manager并继承于ISoaService
2、添加Soa标签和Abp标签
[SoaAuthorize("permission_name")] //Soa权限标签
[SoaServiceRoute("soa_api/service1")] //Soa服务路由标签
public interface IService1Manager : ISoaService
{
//定义接口
[SoaService(CreatedBy = "linxiao", Comment = "bring a string to the world and say hello !")]
[SoaAuthorize("permission_name")]
public string GetHelloWorld();
}
将微服务抽象层引用添加至网关（客户端） GatewaySample
网关Ioc添加各微服务抽象层
var ass = Assembly.Load("Soa.Sample.IAuthorizedService");
IocManager.RegisterAssemblyByConvention(ass);
网关引入各微服务权限
Configuration.Authorization.Providers.Add <AuthorizedServiceAuthorizationProvider>();
网关引入各微服务本地化资源
var loc = Configuration.Localization;
AuthorizedServiceLocalizationConfigurer.Configure(loc);
其他的Abp配置等等
微服务（服务端） Service1
Program.cs 文件
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddSoa<Service1HostModel>();
var webapp = builder.Build();
webapp.UseSoaServer();
webapp.Run();
Service1HostModel.cs 文件
1、添加SoaServerModule模块依赖
[DependsOn(typeof(SoaServerModule))]
public class Service1HostModel : AbpModule
{
//Your code
}
Service1Manager.cs 文件
1、构建类Service1Manager
2、继承IService1Manager并实现其成员
public class Service1Manager : DomainService , IService1Manager
{
//实现业务
public string GetHelloWorld()
{
return "hello world !";
}
}
关于appsettings.json的配置，请参考 配置说明:https://github.com/MatoApps/Soa/blob/master/SOA/Hangfire Guid-zh-Hans.md关于Hangfire的配置，请参考 定时任务:https://github.com/MatoApps/Soa/blob/master/SOA/Hangfire Guid-zh-Hans.md完整示例请参考Sample:https://github.com/MatoApps/Soa/tree/master/sample
工具
Roslyn Syntax Tool：https://github.com/MatoApps/RoslynSyntaxTool
此工具能将C#代码，转换成使用语法工厂构造器（SyntaxFactory）生成等效语法树代码
项目地址
Github：https://github.com/MatoApps/Soa
转自： 林晓lx
链接：cnblogs.com/jevonsflash/p/16284972.html
微信公众号
DotNet工控上位机编程 |
