.netcore micro service framework
jimu 是一个基于.Net6.0 简单易用的微服务框架,参考了很多开源库以及想法,使用了大量的开源库(如 DotNetty, consul.net, Flurl.Http, Json.net, Log4net, Quartz.net … ), 支持分布式、高并发和负载均衡, 实现了服务治理(如服务注册、发现、健康检测 …)和 RPC 调用。
jimu(积木),正如其中文名,希望用她来开发项目像搭积木一样简单快速可控,使项目安全可靠稳定,整体架构可拓展、高并发、分布式。
更多详情,查看 Wiki
这里感谢 RabbitTeam 开源的 RabbitCloud (2018),因为Jimu的动态代理和远程调用都参考了该项目
请下载 jimu 源码, 或者下载项目 jimu.demo
JimuLog4netOptions: Log4net 日志组件
{
"JimuLog4netOptions":{
"EnableConsoleLog":true,
"EnableFileLog":true,
"FileLogPath":"log",
"FileLogLevel":"Debug,Info,Warn,Error",
"ConsoleLogLevel":"Debug,Info,Warn,Error",
"UseInService": true // ILogger 是否注入到 service
}
}
JimuNLogOptions: NLog 组件
JwtAuthorizationOptions: Jwt 授权
{
"JwtAuthorizationOptions":{
"ServiceInvokeIp": "${SERVICE_INVOKE_IP}", //服务宿主的地址
"ServiceInvokePort": "${SERVICE_INVOKE_PORT}",
"Protocol": "Netty", //传输协议:Http,Netty
"SecretKey": "123456", //生成token 的钥匙
"ValidateLifetime": true,
"ExpireTimeSpan": "0.16
0", //token 有效时长: day.hour
second
"ValidateIssuer": false, //
"ValidIssuer": "",
"ValidateAudience": false,
"ValidAudience": "",
"TokenEndpointPath": "/v2/token", //获取 token 的路径
"CheckCredentialServiceId": "Auth.IServices.IAuthService.Check(context)" //验证用户名密码是否正确的 service id, context 是 JwtAuthorizationContext,包含 UserName,Password等调用上下文信息
}
}
{
"ConsulOptions":{
"Ip": "127.0.0.1", //consul ip
"Port": "8500", // consul port
"ServiceGroups": "ctauto.test.store", //服务注册所属的组别
"ServiceInvokeIp": "127.0.0.1", //服务宿主的地址
"ServiceInvokePort": "8004 //服务宿主的端口
}
}
TransportOptions: 服务调用的传输组件
{
"TransportOptions":{
"Ip": "127.0.0.1", //服务宿主ip
"Port": 8001, //服务宿主端口
"Protocol": "Netty", //传输协议: Netty, Http
"ServiceInvokeIp": "127.0.0.1", //服务宿主的地址
"ServiceInvokePort": "8001"
}
}
{
"ServiceOptions":{
"Path": "",//服务dll所在路径,默认当前目录
"LoadFilePattern": "IService.dll,Service.dll",//需要加载的服务dll,支持统配符:*.dll,*.txt
}
}
数据库接入
Dapper
{
"DapperOptions": {
"ConnectionString": "server=localhost;database=grissom_dev;user=root;pwd=root;",
"DbType": "MySql" //数据库类型,支持: MySQL,SQLServer,Oracle,SQLite, PostgreSQL
}
}
MiniDDD 是一个轻量级的 DDD 框架, MiniDDD Repository 就是基于该框架的数据仓储,支持以下仓储
Dapper
{
"MiniDDDDapperOptions": {
"ConnectionString": "server=localhost;database=grissom_dev;user=root;pwd=root;",
"DbType": "MySql" //数据库类型,支持: MySQL,SQLServer,Oracle,SQLite, PostgreSQL
// 没有 sql 日志可输出
}
}
EF
{
"MiniDDDEFOptions": {
"ConnectionString": "server=localhost;database=grissom_dev;user=root;pwd=root;",
"DbType": "MySql", //数据库类型,支持: MySQL,SQLServer,Oracle,SQLite, PostgreSQL
"TableModelAssemblyName": "",//EF对应的表的实体类dll, Server 项目引用了则不需要设置
"OpenLogTrace":false, //是否开启 sql 日志,一般 debug 时开启方面查看生成的 sql
"LogLevel":"Debug" //日志级别: Debug,Information,Warning,Error
}
}
SqlSugar
{
"MiniDDDSqlSugarOptions": {
"ConnectionString": "server=localhost;database=grissom_dev;user=root;pwd=root;",
"DbType": "MySql", //数据库类型,支持: MySQL,SQLServer,Oracle,SQLite, PostgreSQL
"OpenLogTrace":false, //是否开启 sql 日志,一般 debug 时开启方面查看生成的 sql,没有日志级别可选
}
}
JimuLog4netOptions: Log4net 日志组件
{
"JimuLog4netOptions":{
"EnableConsoleLog":true,
"EnableFileLog":true,
"FileLogPath":"log",
"FileLogLevel":"Debug,Info,Warn,Error",
"ConsoleLogLevel":"Debug,Info,Warn,Error"
}
}
{
"JwtAuthorizationOptions":{
"Protocol": "Http", //传输协议:Http,Netty
"SecretKey": "123456", //生成token 的钥匙
"ValidateLifetime": true,
"ExpireTimeSpan": "0.16:1:0", //token 有效时长: day.hour:minute:second
"ValidateIssuer": false, //
"ValidIssuer": "",
"ValidateAudience": false,
"ValidAudience": ""
}
}
{
"ConsulOptions":{
"Ip": "127.0.0.1",//consul ip
"Port": 8500,// consul port
"ServiceGroups": "MyService",//服务注册所属的组别
}
}
DiscoveryOptions:客户端会缓存已发现的服务,设定刷新频率
{
"DiscoveryOptions":{
"UpdateJobIntervalMinute":1//单位分钟,1分钟刷新一次
}
}
FaultTolerantOptions:服务调用时的容错机制
{
"FaultTolerantOptions":{
"RetryTimes":0 //服务调用失败重试次数
}
}
HealthCheckOptions: 根据已发现服务的ip,port 定时进行服务器心跳监测(客户端主动连接)
{
"HealthCheckOptions":{
"IntervalMinute":1 //心跳监测时间间隔,单位分钟
}
}
LoadBalanceOptions
{
"LoadBalanceOptions":{
"LoadBalance":"Polling" //负载均衡算法: Polling - 轮询
}
}
ServiceProxyOptions
{
"ServiceProxyOptions":{
"AssemblyNames":["IOrderServices.dll","IUserServices.dll"]//代理接口dll配置
}
}
TokenGetterOptions
{
"TokenGetterOptions":{
"GetFrom":"HttpHeader" //从http header 获取, Request.Headers["Authorization"]
}
}
TransportOptions: 服务调用的传输组件
{
"TransportOptions":{
"Protocol":"Netty" //传输协议: Netty
}
}