首页
/ ZhonTai Admin.Core v9.0.3版本发布:Grpc增强与国际化支持

ZhonTai Admin.Core v9.0.3版本发布:Grpc增强与国际化支持

2025-07-01 10:17:46作者:廉彬冶Miranda

项目简介

ZhonTai Admin.Core是一个基于.NET Core的后台管理系统框架,提供了完整的权限管理、系统配置等基础功能模块。该项目采用模块化设计,支持快速开发企业级应用,具有高度可扩展性和灵活性。

核心更新内容

Grpc传输对象安全性增强

本次版本对Admin项目中的所有Grpc传输对象进行了重要改进,将所有传输对象更改为显示标记。这一改进的主要目的是:

  1. 防止序列化问题:通过显式标记,可以避免当属性或字段名称发生变化时,序列化和反序列化过程受到影响
  2. 提高兼容性:确保服务端和客户端之间的数据传输更加稳定可靠
  3. 增强可维护性:显式标记使代码意图更加清晰,便于后续维护

Grpc服务配置优化

新增了appsettings.RpcConfig.Grpc.ServerAssemblyNames配置项,用于指定服务端程序集名称。这一改进解决了之前版本中自动反射Grpc服务方法未使用Grpc配置程序集的问题,使得Grpc服务的注册更加精确可控。

同时修复了app项目模板生成biz和mem项目时,Grpc端点地址中http://被错误生成http:的问题,确保了远程调用的正确性。

缓存机制改进

对app项目模板的缓存机制进行了重构:

  1. 新增模块缓存键方法:在CacheKeys中增加了获取模块缓存键的方法,使缓存管理更加模块化
  2. 移除自动扫描特性:移除了[ScanCacheKeys]特性,改为更显式的缓存键管理方式
  3. 新增订阅命名类:引入了SubscribeNames类,统一管理订阅名称

这些改进使得缓存管理更加清晰和可控,减少了因缓存键冲突导致的问题。

数据库连接优化

修复了dbconfig配置SqlServer数据库连接字符串无法连接SqlServer2022的问题,增强了框架对不同版本SqlServer的兼容性。

项目模板改进

  1. 修复枚举生成问题:解决了sys项目类型生成时,appconfig.EnumListAssemblyNames多配置ZhonTai.Admin程序集导致前端生成枚举契约不正确的问题
  2. 端口调整:将Framework框架模板中的ImConfig.Servers和Server地址的6010端口更改为17010,避免常见端口冲突

国际化支持增强

  1. 网关国际化:改进了网关项目模板,新增对国际化的支持
  2. 即时通讯国际化:增强了即时通讯服务端模板的国际化能力

这些改进使得基于ZhonTai Admin.Core开发的系统能够更好地支持多语言环境,满足全球化业务需求。

技术影响与建议

本次更新主要关注系统的稳定性、可维护性和国际化能力。对于现有项目升级,建议开发者:

  1. 检查Grpc传输对象的显式标记是否符合项目需求
  2. 更新缓存管理方式,适应新的CacheKeys设计
  3. 验证数据库连接配置,特别是使用SqlServer2022的环境
  4. 评估国际化需求,利用新增的国际化功能

对于新项目,建议直接采用此版本,以获得更好的开发体验和系统稳定性。

ZhonTai Admin.Core持续关注企业级应用开发的痛点,通过不断优化框架功能和开发体验,帮助开发者更高效地构建可靠的后台管理系统。

登录后查看全文
热门项目推荐
相关项目推荐