# lms
**Repository Path**: MuNet/lms
## Basic Information
- **Project Name**: lms
- **Description**: Lms是一个旨在通过.net平台快速构建微服务开发的框架。具有安全、稳定、高性能、易扩展、使用方便的特点。
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: http://docs.lms-fk.com
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 3
- **Created**: 2021-07-08
- **Last Updated**: 2021-08-30
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Silky 微服务框架
[](./LICENSE)
[](https://img.shields.io/github/last-commit/liuhll/silky)
[](https://www.nuget.org/packages/Silky.Core)
[](https://www.myget.org/feed/Packages/silky-preview)
[](https://www.nuget.org/packages/Silky.Core)
[](https://hits.seeyoufarm.com)
**简体中文 | [English](./README.en-US.md)**
## 给一颗星！ ⭐️
如果你喜欢这个仓库或者它对你有帮助，请给这个仓库一个星星⭐️。 这不仅有助于加强我们的社区，还有助于提高开发人员学习 Silky 框架的技能👍。 非常感谢你。
## 项目介绍
Silky框架旨在帮助开发者在.net平台下,通过简单代码和配置快速构建一个微服务开发框架。
通过.net框架的[通用主机](https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/host/generic-host?view=aspnetcore-5.0)构建普通业务微服务应用,内部通过[dotnetty](https://github.com/Azure/DotNetty)实现的rpc进行通信,在消息传递过程中,通过`rpcToken`保证消息在同一个集群内部进行通信，而且rpc通信支持ssl加密。
通过.net的[web主机](https://docs.microsoft.com/zh-cn/aspnet/core/fundamentals/host/web-host?view=aspnetcore-5.0)构建对外提供访问入口的服务主机(网关)，在`http`请求或是`ws`会话请求到达该主机时,通过内置的中间件解析到服务集群的路由条目,并指定`rpcToken`,通过内置的负载均衡算法和路由寻址与集群内部的主机进行`rpc`通信。
Silky在rpc通信过程中,使用基于拦截器和Undo Log日志实现了TCC分布式事务，保证数据的最终一致性。
在开发与设计过程中借鉴和吸收了各个优秀的开源产品的设计与思想。在此，作者表示对各个先辈的致敬与感谢。
## 入门
- 通过[开发者文档](http://docs.silky-fk.com/silky/)学习Silky框架。
- 通过[silky.samples项目](http://docs.silky-fk.com/silky/dev-docs/quick-start.html)熟悉如何使用Silky框架构建一个微服务应用。
- 通过[配置](http://docs.silky-fk.com/config/)文档熟悉Silky框架的相关配置属性。
## 框架特性
### 代理主机
- 通用代理主机: 业务型微服务主机,微服务集群内部通过RPC协议进行通信,无法与集群外部进行通信
- Web代理主机: 对集群外部提供Http访问端口,当http请求到达后,通过RPC协议与集群内部主机进行通信,通常作为网关使用
- WebSocket代理主机: 具有提供websocket通信能力的业务型微服务主机
### 服务引擎
- 负责Silky主机的初始化过程
- 服务注册与解析
- 负责模块解析与加载
### 模块化管理
- 模块的依赖设置
- 通过模块注册服务
- 通过模块预初始化方法或释放资源
### 路由与WebAPI
- 路由的解析与通过注册中心的维护分布式应用集群路由表
- 通过服务条目生成restful风格
- 支持通过Swagger生成在线webapi文档
- 支持通过Miniprofiler对http请求进行性能监控
### 参数校验
- RPC调用过程中通过过滤器自动校验参数
- 支持通过特性实现输入参数的校验
- 支持通过Fluent进行输入参数校验
### RPC通信
- 使用[dotnetty](https://github.com/Azure/DotNetty)作为底层通信组件
- 使用[Zookeeper](https://zookeeper.apache.org)作为服务注册中心
- 使用[Castle.Core.AsyncInterceptor](https://www.nuget.org/packages/Castle.Core.AsyncInterceptor/)生成动态代理
- 服务调用过程中支持缓存拦截
- 支持JSON、MessagePack、ProtoBuf编解码方式
- Rpc调用过程中支持自定义过滤器(客户端过滤器:`IClientFilter`、服务端过滤器:`IServerFilter`)
### 服务治理
- 支持轮询、随机路由、哈希一致性等负载均衡路由方式
- 支持失败回调
- 使用[Polly](https://github.com/App-vNext/Polly)实现服务熔断与重试
- 支持服务故障转移
- 支持移除不健康的服务
- 通过配置支持禁止服务被外部访问
> 服务治理模块后续持续更新
### 支持分布式事务
- 通过TCC方式实现分布式事务
- 通过定时作业和Undolog的方式保证数据的最终一致性
### 链路跟踪
- 通过SkyApm实现微服务之间调用的链路跟踪
### 身份认证与授权
- 实现基于Jwt的身份认证
- 支持自定义接口鉴权
### 数据访问
- 使用EfCore实现数据访问组件
### 支持websocket通信
- 通过[websocket-sharp](https://github.com/sta/websocket-sharp)实现支持websocket通信的模块
### 分布式锁
- 使用[madelson/DistributedLock](https://github.com/madelson/DistributedLock)实现分布式锁
## 产品路线图
### 近期
- 完善文档
### 未来
- 新增服务管理端(Dashboard)
- 新增CLI命令行行工具
- 使用silky框架实现一个权限管理系统
- 支持文件上传与下载
## 视频教程
- [通过silky模板快速创建silky微服务框架](https://www.bilibili.com/video/BV1u64y1q7Cy?share_source=copy_web)
## 贡献
- 贡献的最简单的方法之一就是是参与讨论和讨论问题（issue）。你也可以通过提交的 Pull Request 代码变更作出贡献。