feat: 新增 业务异常、用户友好异常

Author: jianxuanbing

framework/src/Bing/Bing/BusinessException.cs

@@ -0,0 +1,72 @@
+using System;
+using System.Runtime.Serialization;
+using Bing.ExceptionHandling;
+using Bing.Logging;
+using Microsoft.Extensions.Logging;
+
+namespace Bing
+{
+    /// <summary>
+    /// 业务异常
+    /// </summary>
+    [Serializable]
+    public class BusinessException : Exception, IBusinessException, IHasErrorCode, IHasErrorDetails, IHasLogLevel
+    {
+        /// <summary>
+        /// 错误码
+        /// </summary>
+        public string Code { get; set; }
+
+        /// <summary>
+        /// 错误详情
+        /// </summary>
+        public string Details { get; set; }
+
+        /// <summary>
+        /// 日志级别
+        /// </summary>
+        public LogLevel LogLevel { get; set; }
+
+        /// <summary>
+        /// 初始化一个<see cref="BusinessException"/>类型的实例
+        /// </summary>
+        /// <param name="code">错误码</param>
+        /// <param name="message">错误消息</param>
+        /// <param name="details">错误详情</param>
+        /// <param name="innerException">内部异常</param>
+        /// <param name="logLevel">日志级别</param>
+        public BusinessException(
+            string code,
+            string message,
+            string details = null,
+            Exception innerException = null,
+            LogLevel logLevel = LogLevel.Warning)
+            : base(message, innerException)
+        {
+            Code = code;
+            Details = details;
+            LogLevel = logLevel;
+        }
+
+        /// <summary>
+        /// 初始化一个<see cref="BusinessException"/>类型的实例
+        /// </summary>
+        /// <param name="serializationInfo">序列化信息</param>
+        /// <param name="context">流上下文</param>
+        public BusinessException(SerializationInfo serializationInfo, StreamingContext context)
+            : base(serializationInfo, context)
+        {
+        }
+
+        /// <summary>
+        /// 设置数据
+        /// </summary>
+        /// <param name="name">键名</param>
+        /// <param name="value">值</param>
+        public BusinessException WithData(string name, object value)
+        {
+            Data[name] = value;
+            return this;
+        }
+    }
+}

framework/src/Bing/Bing/DependencyInjection/ConventionalRegistrarBase.cs

@@ -0,0 +1,80 @@
+using System;
+using System.Reflection;
+using Bing.Extensions;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Bing.DependencyInjection
+{
+    /// <summary>
+    /// 常规注册器基类
+    /// </summary>
+    public abstract class ConventionalRegistrarBase : IConventionalRegistrar
+    {
+        /// <summary>
+        /// 添加程序集
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="assembly">程序集</param>
+        public virtual void AddAssembly(IServiceCollection services, Assembly assembly)
+        {
+        }
+
+        /// <summary>
+        /// 添加类型数组
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="types">类型数组</param>
+        public virtual void AddTypes(IServiceCollection services, params Type[] types)
+        {
+            foreach (var type in types) 
+                AddType(services, type);
+        }
+
+        /// <summary>
+        /// 添加类型
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="type">类型</param>
+        public abstract void AddType(IServiceCollection services, Type type);
+
+        /// <summary>
+        /// 获取指定类型的 <see cref="DependencyAttribute"/>
+        /// </summary>
+        /// <param name="type">类型</param>
+        protected virtual DependencyAttribute GetDependencyAttributeOrNull(Type type)
+        {
+            return type.GetCustomAttribute<DependencyAttribute>(true);
+        }
+
+        /// <summary>
+        /// 获取指定类型的 <see cref="ServiceLifetime"/> 生命周期类型
+        /// </summary>
+        /// <param name="type">依赖注入实现类的类型</param>
+        /// <param name="dependencyAttribute">依赖注入行为特性</param>
+        protected virtual ServiceLifetime? GetLifetimeOrNull(Type type, DependencyAttribute dependencyAttribute)
+        {
+            return dependencyAttribute?.Lifetime ?? GetServiceLifetimeFromClassHierarchy(type) ?? GetDefaultLifetimeOrNull(type);
+        }
+
+        /// <summary>
+        /// 通过类层次结构获取服务 <see cref="ServiceLifetime"/> 生命周期类型
+        /// </summary>
+        /// <param name="type">依赖注入实现类的类型</param>
+        protected virtual ServiceLifetime? GetServiceLifetimeFromClassHierarchy(Type type)
+        {
+            if (type.IsDeriveClassFrom<ITransientDependency>())
+                return ServiceLifetime.Transient;
+            if (type.IsDeriveClassFrom<IScopedDependency>())
+                return ServiceLifetime.Scoped;
+            if (type.IsDeriveClassFrom<ISingletonDependency>())
+                return ServiceLifetime.Singleton;
+            return null;
+        }
+
+        /// <summary>
+        /// 获取指定类型的默认 <see cref="ServiceLifetime"/> 生命周期类型
+        /// </summary>
+        /// <param name="type">依赖注入实现类的类型</param>
+        protected virtual ServiceLifetime? GetDefaultLifetimeOrNull(Type type) => null;
+    }
+}

framework/src/Bing/Bing/DependencyInjection/IConventionalRegistrar.cs

@@ -0,0 +1,33 @@
+using System;
+using System.Reflection;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Bing.DependencyInjection
+{
+    /// <summary>
+    /// 常规注册器
+    /// </summary>
+    public interface IConventionalRegistrar
+    {
+        /// <summary>
+        /// 添加程序集
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="assembly">程序集</param>
+        void AddAssembly(IServiceCollection services, Assembly assembly);
+
+        /// <summary>
+        /// 添加类型数组
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="types">类型数组</param>
+        void AddTypes(IServiceCollection services, params Type[] types);
+
+        /// <summary>
+        /// 添加类型
+        /// </summary>
+        /// <param name="services">服务集合</param>
+        /// <param name="type">类型</param>
+        void AddType(IServiceCollection services, Type type);
+    }
+}

…ng/Bing/Exceptions/IBusinessException.cs …work/src/Bing/Bing/IBusinessException.csframework/src/Bing/Bing/Exceptions/IBusinessException.cs renamed to framework/src/Bing/Bing/IBusinessException.cs framework/src/Bing/Bing/Exceptions/IBusinessException.cs renamed to framework/src/Bing/Bing/IBusinessException.cs

@@ -1,4 +1,4 @@
-namespace Bing.Exceptions
+namespace Bing
 {
     /// <summary>
     /// 业务异常

…ing/Exceptions/IUserFriendlyException.cs …/src/Bing/Bing/IUserFriendlyException.csframework/src/Bing/Bing/Exceptions/IUserFriendlyException.cs renamed to framework/src/Bing/Bing/IUserFriendlyException.cs framework/src/Bing/Bing/Exceptions/IUserFriendlyException.cs renamed to framework/src/Bing/Bing/IUserFriendlyException.cs

@@ -1,4 +1,4 @@
-namespace Bing.Exceptions
+namespace Bing
 {
     /// <summary>
     /// 用户友好提示异常

framework/src/Bing/Bing/UserFriendlyException.cs

@@ -0,0 +1,41 @@
+using System;
+using System.Runtime.Serialization;
+using Microsoft.Extensions.Logging;
+
+namespace Bing
+{
+    /// <summary>
+    /// 用户友好异常
+    /// </summary>
+    [Serializable]
+    public class UserFriendlyException : BusinessException, IUserFriendlyException
+    {
+        /// <summary>
+        /// 初始化一个<see cref="UserFriendlyException"/>类型的实例
+        /// </summary>
+        /// <param name="message">错误消息</param>
+        /// <param name="code">错误码</param>
+        /// <param name="details">错误详情</param>
+        /// <param name="innerException">内部异常</param>
+        /// <param name="logLevel">日志级别</param>
+        public UserFriendlyException(
+            string message,
+            string code = null,
+            string details = null,
+            Exception innerException = null,
+            LogLevel logLevel = LogLevel.Warning)
+            : base(code, message, details, innerException, logLevel)
+        {
+        }
+
+        /// <summary>
+        /// 初始化一个<see cref="UserFriendlyException"/>类型的实例
+        /// </summary>
+        /// <param name="serializationInfo">序列化信息</param>
+        /// <param name="context">流上下文</param>
+        public UserFriendlyException(SerializationInfo serializationInfo, StreamingContext context)
+            : base(serializationInfo, context)
+        {
+        }
+    }
+}