装饰器模式属于结构型设计模式的一种，核心目标是遵循开闭原则，在不修改原有类代码的基础上，通过组合的方式动态为对象添加新的功能。在C#开发中，当我们需要给某个类扩展能力，但又不想通过继承产生大量子类时，装饰器模式是非常合适的选择。
装饰器模式的核心角色
理解装饰器模式首先需要明确它的几个核心角色，每个角色的职责划分非常清晰：
- 抽象组件（Component）：定义对象的公共接口，是装饰器和被装饰对象的共同父类，保证装饰后的对象和被装饰对象可以统一使用。
- 具体组件（ConcreteComponent）：抽象组件的具体实现类，也就是我们需要被装饰的原始对象，包含了核心的基础功能。
- 抽象装饰器（Decorator）：同样继承抽象组件，内部持有一个抽象组件的引用，是所有具体装饰器的父类，负责转发请求到被装饰对象。
- 具体装饰器（ConcreteDecorator）：继承抽象装饰器，在转发请求的同时，添加自己的额外逻辑，实现对功能的增强。
基础实现示例
我们以日志输出功能为例，原始功能是输出普通文本，现在需要动态添加时间戳、输出级别等增强功能，演示装饰器模式的实现过程。
1. 定义抽象组件
首先定义所有日志输出类的公共接口：
// 抽象组件：日志输出接口
public interface ILogger
{
void Log(string message);
}
2. 实现具体组件
实现基础的日志输出功能，也就是被装饰的原始对象：
// 具体组件：基础日志输出类
public class BasicLogger : ILogger
{
public void Log(string message)
{
Console.WriteLine(message);
}
}
3. 定义抽象装饰器
抽象装饰器继承抽象组件，并持有抽象组件的引用，负责将请求转发给被装饰对象：
// 抽象装饰器：日志装饰器基类
public abstract class LoggerDecorator : ILogger
{
// 持有被装饰的日志对象
protected ILogger _logger;
public LoggerDecorator(ILogger logger)
{
_logger = logger;
}
public virtual void Log(string message)
{
// 转发请求到被装饰对象
_logger.Log(message);
}
}
4. 实现具体装饰器
编写两个具体装饰器，分别实现添加时间戳和添加日志级别的功能：
// 具体装饰器：添加时间戳的日志装饰器
public class TimestampLoggerDecorator : LoggerDecorator
{
public TimestampLoggerDecorator(ILogger logger) : base(logger)
{
}
public override void Log(string message)
{
// 先执行增强逻辑：添加时间戳
string decoratedMessage = $"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] {message}";
// 再调用被装饰对象的原方法
base.Log(decoratedMessage);
}
}
// 具体装饰器：添加日志级别的装饰器
public class LevelLoggerDecorator : LoggerDecorator
{
private string _level;
public LevelLoggerDecorator(ILogger logger, string level) : base(logger)
{
_level = level;
}
public override void Log(string message)
{
// 先执行增强逻辑：添加日志级别
string decoratedMessage = $"[{_level}] {message}";
// 再调用被装饰对象的原方法
base.Log(decoratedMessage);
}
}
5. 调用测试
通过组合不同的装饰器，动态为对象添加功能：
class Program
{
static void Main(string[] args)
{
// 创建基础日志对象
ILogger basicLogger = new BasicLogger();
// 只添加时间戳装饰
ILogger timestampLogger = new TimestampLoggerDecorator(basicLogger);
timestampLogger.Log("这是基础日志加时间戳的输出");
// 同时添加时间戳和日志级别装饰
ILogger fullLogger = new TimestampLoggerDecorator(
new LevelLoggerDecorator(basicLogger, "INFO")
);
fullLogger.Log("这是同时加时间戳和日志级别的输出");
}
}
进阶用法：多层装饰与功能组合
装饰器模式的优势在于可以灵活组合多个装饰器，实现复杂的功能增强。上面的示例已经演示了两层装饰，我们可以根据需求叠加更多装饰器，比如再添加一个输出到文件的装饰器：
// 具体装饰器：输出到文件的日志装饰器
public class FileLoggerDecorator : LoggerDecorator
{
private string _filePath;
public FileLoggerDecorator(ILogger logger, string filePath) : base(logger)
{
_filePath = filePath;
}
public override void Log(string message)
{
// 先执行原逻辑
base.Log(message);
// 增强逻辑：写入文件
File.AppendAllText(_filePath, message + Environment.NewLine);
}
}
调用时只需要将文件装饰器加入组合即可：
class Program
{
static void Main(string[] args)
{
ILogger logger = new FileLoggerDecorator(
new TimestampLoggerDecorator(
new LevelLoggerDecorator(new BasicLogger(), "DEBUG")
),
"log.txt"
);
logger.Log("这是输出到控制台并写入文件的日志");
}
}
装饰器模式的使用场景
在C#开发中，以下场景适合使用装饰器模式：
- 需要在不修改原有类代码的前提下，动态给对象添加功能，且这些功能可以灵活组合、撤销。
- 用继承扩展功能会导致子类数量爆炸，比如一个类有5个可选扩展功能，继承需要2^5=32个子类，而装饰器只需要5个装饰器类即可组合。
- 需要在运行时动态决定给对象添加哪些功能，而不是编译期就固定扩展逻辑。
注意事项
使用装饰器模式时需要注意几个问题：
- 装饰器的顺序会影响最终效果，比如先加级别再加时间戳，和先加时间戳再加级别的输出格式是不同的，需要根据需求调整组合顺序。
- 装饰器类需要尽可能保持和抽象组件接口一致，避免因为接口差异导致装饰后的对象无法和原对象统一使用。
- 如果装饰层次过多，会增加代码的调试难度，需要合理控制装饰的层数。