// Admin.NET 项目的版权、商标、专利和其他相关权利均受相应法律法规的保护。使用本项目应遵守相关法律法规和许可证的要求。 // // 本项目主要遵循 MIT 许可证和 Apache 许可证(版本 2.0)进行分发和使用。许可证位于源代码树根目录中的 LICENSE-MIT 和 LICENSE-APACHE 文件。 // // 不得利用本项目从事危害国家安全、扰乱社会秩序、侵犯他人合法权益等法律法规禁止的活动!任何基于本项目二次开发而产生的一切法律纠纷和责任,我们不承担任何责任! namespace Admin.NET.Core.Service; /// /// 系统枚举服务 🧩 /// [ApiDescriptionSettings(Order = 275)] public class SysEnumService : IDynamicApiController, ITransient { private readonly EnumOptions _enumOptions; public SysEnumService(IOptions enumOptions) { _enumOptions = enumOptions.Value; } /// /// 获取所有枚举类型 🔖 /// /// [DisplayName("获取所有枚举类型")] public List GetEnumTypeList() { var enumTypeList = App.EffectiveTypes.Where(t => t.IsEnum) .Where(t => _enumOptions.EntityAssemblyNames.Contains(t.Assembly.GetName().Name) || _enumOptions.EntityAssemblyNames.Any(name => t.Assembly.GetName().Name!.Contains(name))) .Where(t => t.GetCustomAttributes(typeof(IgnoreEnumToDictAttribute), false).Length == 0) // 排除有忽略转字典特性类型 .Where(t => t.GetCustomAttributes(typeof(ErrorCodeTypeAttribute), false).Length == 0) // 排除错误代码类型 .OrderBy(u => u.Name).ThenBy(u => u.FullName) .ToList(); // 如果存在同名枚举类,则依次增加 "_序号" 后缀 var list = enumTypeList.Select(GetEnumDescription).ToList(); foreach (var enumType in list.GroupBy(u => u.TypeName).Where(g => g.Count() > 1)) { int i = 1; foreach (var item in list.Where(u => u.TypeName == enumType.Key).Skip(1)) item.TypeName = $"{item.TypeName}_{i++}"; } return list; } /// /// 获取字典描述 /// /// /// private static EnumTypeOutput GetEnumDescription(Type type) { string description = type.Name; var attrs = type.GetCustomAttributes(typeof(DescriptionAttribute), false); if (attrs.Length != 0) { var att = ((DescriptionAttribute[])attrs)[0]; description = att.Description; } var enumType = App.EffectiveTypes.FirstOrDefault(t => t.IsEnum && t.Name == type.Name); return new EnumTypeOutput { TypeDescribe = description, TypeName = type.Name, TypeRemark = description, TypeFullName = type.FullName, EnumEntities = (enumType ?? type).EnumToList() }; } /// /// 通过枚举类型获取枚举值集合 🔖 /// /// /// [DisplayName("通过枚举类型获取枚举值集合")] public List GetEnumDataList([FromQuery] EnumInput input) { var enumType = App.EffectiveTypes.FirstOrDefault(u => u.IsEnum && u.Name == input.EnumName); if (enumType is not { IsEnum: true }) throw Oops.Oh(ErrorCodeEnum.D1503); return enumType.EnumToList(); } /// /// 通过实体的字段名获取相关枚举值集合(目前仅支持枚举类型) 🔖 /// /// /// [DisplayName("通过实体的字段名获取相关枚举值集合")] public static List GetEnumDataListByField([FromQuery] QueryEnumDataInput input) { // 获取实体类型属性 Type entityType = App.EffectiveTypes.FirstOrDefault(u => u.Name == input.EntityName) ?? throw Oops.Oh(ErrorCodeEnum.D1504); // 获取字段类型 var fieldType = entityType.GetProperties().FirstOrDefault(u => u.Name == input.FieldName)?.PropertyType; if (fieldType is not { IsEnum: true }) throw Oops.Oh(ErrorCodeEnum.D1503); return fieldType.EnumToList(); } }