C# 中的“智能枚举”：如何在枚举中增加行为

荣军

目录

• 枚举的基本用法回顾
  
• 枚举常见的设计模式运用
  
  
  
  • 介绍
    
  
  
• 智能枚举
  
  
  
  • 代码示例
    
  • 业务应用
    
  
  
• 小结
  

枚举的基本用法回顾

以下是一个常见的 C# 枚举（enum）的示例：

1. enum Weekday
2. {
3.     Monday,
4.     Tuesday,
5.     Wednesday,
6.     Thursday,
7.     Friday,
8.     Saturday,
9.     Sunday
10. }

复制代码

1. class Program
2. {
3.     static void Main(string[] args)
4.     {
5.         Weekday today = Weekday.Tuesday;
7.         Console.WriteLine("今天是" + today.ToString() + "。");
8.         Console.WriteLine("明天是" + (Weekday)(((int)today + 1) % 7) + "。");
9.         Console.WriteLine("昨天是" + (Weekday)(((int)today + 6) % 7) + "。");
10.     }
11. }

复制代码

在这个示例中，我们定义了一个名为 Weekday 的枚举，其中包括每个星期的日子。然后在 Main 方法中，我们将 today 变量设置为 Tuesday，并使用 ToString() 方法将其转换为字符串。
接下来，我们计算并输出明天和昨天的日子。我们使用强制类型转换将枚举值转换为整数，然后在取模 7 意义下加或减 1 或 6，以便正确地计算出前一天或后一天的日子。
输出结果应该是这样的：

1. 今天是 Tuesday。
2. 明天是 Wednesday。
3. 昨天是 Monday。

复制代码

枚举常见的设计模式运用

enum 可以应用在许多种设计模式下：

• 状态模式
  
• 策略模式
  
• 工厂模式
  
• 观察者模式
  

介绍

• 状态模式
  

状态模式用于根据对象的内部状态来改变其行为。enum 可以很好地表示对象的状态，因此它是实现状态模式的常见选择。在 C# 中，您可以使用 switch 语句来根据不同的 enum 值执行不同的操作。

• 策略模式
  

策略模式允许您根据运行时条件选择不同的算法或行为。enum 可以很好地表示这些条件，因此它是实现策略模式的常见选择。在 C# 中，您可以使用 switch 语句或 if-else 语句来根据不同的 enum 值选择不同的算法或行为。

• 工厂模式
  

工厂模式允许您使用一个共同的接口来创建不同的对象。enum 可以很好地表示这些对象的类型，因此它是实现工厂模式的常见选择。在 C# 中，您可以使用 switch 语句或 if-else 语句来根据不同的 enum 值创建不同的对象。

• 观察者模式
  

观察者模式用于建立对象之间的松散耦合关系。enum 可以很好地表示观察者对象的状态，因此它是实现观察者模式的常见选择。在 C# 中，您可以使用 enum 来表示观察者对象的状态，并使用委托或事件来通知观察者对象。
智能枚举

什么是智能枚举？智能枚举不是官方的一个称谓，而是作者定义的一个名词。
这种带行为的一种枚举，简单的可以定义为：智能枚举 = 枚举 + 丰富的行为。
它由原来的 enum 类型（值类型）改变成了 class 类型（引用类型），允许您将行为和方法绑定到每个枚举类型上。这意味着您可以在枚举类型上调用方法和属性，就像在类实例上调用它们一样。
智能枚举跟设计模式的意义一样，可以帮助您避免重复的代码，并提高代码的可读性和可维护性。它们还可以使您的代码更加类型安全，因为编译器可以验证您是否使用了正确的枚举值。
代码示例

首先，我们先定义一个抽象的类型，方便后续重用：

1. public abstract class Enumeration<TEnum> : IEquatable<Enumeration<TEnum>> where TEnum : Enumeration<TEnum>
2. {
3.     private static readonly Dictionary<int, TEnum?> Enumerations = GetEnumerations();
5.     /// <summary>
6.     /// 枚举类型
7.     /// </summary>
8.     private static readonly Type EnumType = typeof(TEnum);
10.     protected Enumeration(int value, string name)
11.     {
12.         Value = value;
13.         Name = name;
14.     }
16.     /// <summary>
17.     /// 名称
18.     /// </summary>
19.     public string Name { get; protected init; }
21.     /// <summary>
22.     /// 值
23.     /// </summary>
24.     public int Value { get; protected init; }
26.     public static TEnum? FromName(string name) => Enumerations.Values.SingleOrDefault(x => x.Name == name);
28.     public static TEnum? FromValue(int value) => Enumerations.TryGetValue(value, out var enumeration) ? enumeration : default;
30.     public bool Equals(Enumeration<TEnum>? other) => other is not null && GetType() == other.GetType() && Value == other.Value;
32.     public override bool Equals(object? obj) => obj is Enumeration<TEnum> other && Equals(other);
34.     public override int GetHashCode() => HashCode.Combine(Value, Name);
36.     private static Dictionary<int, TEnum?> GetEnumerations() => EnumType
37.         .GetFields(BindingFlags.Public | BindingFlags.Static | BindingFlags.FlattenHierarchy)
38.         .Where(x => EnumType.IsAssignableFrom(x.FieldType))
39.         .Select(x => (TEnum?)x.GetValue(default)).ToDictionary(x => x?.Value ?? 0);
40. }

复制代码

先简单解读一下。
这是一个通用的 C# 抽象类，用于实现枚举的高级功能。它使用泛型类型 TEnum 来表示枚举类型，并继承自 IEquatable 接口，以支持比较操作。
这个抽象类包含了一些常用的枚举操作方法，例如 FromName 和 FromValue，它们可以通过名称或值来获取枚举值。它还重写了 Equals 和 GetHashCode 方法，以便可以比较两个枚举值是否相等。
该类中的核心方法是 GetEnumerations，它使用反射获取当前枚举类型中的所有字段，并将它们转换为枚举值。在这个过程中，它还会检查字段的类型是否与枚举类型相同，并将值存储在一个字典中，以便以后可以快速地访问它们。
通过继承这个抽象类，您可以轻松地实现自己的枚举类型，并获得许多有用的功能，例如通过名称和值获取枚举值，并支持比较操作。
业务应用

我们通常会将枚举类型这样定义，而在触发业务逻辑时会使用 switch 来执行不同的行为，这样就很容易会将逻辑分散在不同的地方。

1. /// <summary>
2. /// 信用卡类型
3. /// </summary>
4. public enum CreditCardType
5. {
6.     None = 0,
7.     Standard = 1,
8.     Silver = 2,
9.     Gold = 3,
10. }

复制代码

那么升级后的智能枚举应该是怎样的呢？它到底智能在哪里？

1. /// <summary>
2. /// 信用卡
3. /// </summary>
4. public abstract class CreditCard : Enumeration<CreditCard>
5. {
6.     public static readonly CreditCard Gold = new GoldCreditCard();
7.     public static readonly CreditCard Silver = new SilverCreditCard();
8.     public static readonly CreditCard Standard = new StandardCreditCard();
9.     public static readonly CreditCard None = new NoneCreditCard();
10.    
11.     private CreditCard(int value, string name) : base(value, name)
12.     {
13.     }
15.     /// <summary>
16.     /// 折扣
17.     /// </summary>
18.     public abstract double Discount { get; }
20.     /// <summary>
21.     /// 金卡
22.     /// </summary>
23.     private sealed class GoldCreditCard : CreditCard
24.     {
25.         public GoldCreditCard() : base(3, nameof(Gold))
26.         {
27.         }
29.         public override double Discount => 0.2;
30.     }
32.     private sealed class SilverCreditCard : CreditCard
33.     {
34.         public SilverCreditCard() : base(2, nameof(Silver))
35.         {
36.         }
38.         public override double Discount => 0.1;
39.     }
41.     /// <summary>
42.     /// 标准
43.     /// </summary>
44.     private sealed class StandardCreditCard : CreditCard
45.     {
46.         public StandardCreditCard() : base(1, nameof(Standard))
47.         {
48.         }
50.         public override double Discount => 0.05;
51.     }
53.     /// <summary>
54.     /// 无
55.     /// </summary>
56.     private sealed class NoneCreditCard : CreditCard
57.     {
58.         public NoneCreditCard() : base(0, nameof(None))
59.         {
60.         }
62.         public override double Discount => 0;
63.     }
64. }

复制代码

这里简单解读一下。
这是一个信用卡枚举类型的实现，它继承了之前提到的通用枚举类 Enumeration。其中，GoldCreditCard、SilverCreditCard、StandardCreditCard 和 NoneCreditCard 是四个具体的信用卡子类。
每个子类都重写了父类 CreditCard 中的 Discount 属性，以表示不同信用卡的折扣率。GoldCreditCard 有最高的折扣率，NoneCreditCard 没有任何折扣。
在 CreditCard 类中，Gold、Silver、Standard 和 None 是四个静态实例，表示四种不同的信用卡类型。每个实例都是通过相应的子类创建的，并传入相应的值和名称。值用于标识枚举类型的唯一性，而名称则是该类型的字符串表示。
通过这种方式，我们可以轻松地定义和使用不同类型的信用卡。例如，可以通过 CreditCard.Gold 来引用 Gold 信用卡的实例，并获取它的折扣率。在需要使用信用卡类型的地方，也可以直接使用 CreditCard 类型来表示。
我们平时也可以这样使用，通过 FromName 和 FromValue：

1. public class SmartEnumsTests
2. {
3.     private readonly ITestOutputHelper _testOutputHelper;
5.     public SmartEnumsTests(ITestOutputHelper testOutputHelper)
6.     {
7.         _testOutputHelper = testOutputHelper;
8.     }
10.     /// <summary>
11.     /// 基本用法
12.     /// </summary>
13.     [Fact]
14.     public void Use()
15.     {
16.         var standardCard = CreditCard.FromName("Standard");
17.         var standardCard2 = CreditCard.FromValue(1);
19.         Assert.Equal(standardCard, standardCard2);
20.         _testOutputHelper.WriteLine(standardCard!.ToJson());
21.     }
22. }

复制代码

看完上述的示例代码，智能枚举最明显的好处应该非常直观：就是代码行数增加了亿点点，而不是一点点！
小结

好了，不扯太远了，今天我们就简单总结一下内容吧。
智能枚举 = 枚举 + 丰富的行为。
上述示例内容介绍了一个使用 C# 枚举类型实现信用卡类型的示例。为了更好地实现该功能，我们创建了一个通用枚举类 Enumeration，并在此基础上实现了 CreditCard 类和其四个具体子类，分别表示不同类型的信用卡。
每个子类都包含一个抽象的 Discount 属性，表示该类型信用卡的折扣率。而 CreditCard 类中的静态实例则表示四种不同的信用卡类型。通过这种方式，我们可以轻松地定义和使用不同类型的信用卡，并在需要使用信用卡类型的地方直接使用 CreditCard 类型来表示。

来源:https://www.cnblogs.com/liqingwen/archive/2023/05/17/17407424.html
免责声明：由于采集信息均来自互联网，如果侵犯了您的权益，请联系我们【E-Mail:cb@itdo.tech】 我们会及时删除侵权内容，谢谢合作！