1. Java装饰器模式概述
1.1 概念与动机
在软件设计中，装饰器模式是一种通过把对象放在其他对象之上以增强功能的结构型设计模式。它的核心思想是动态组合而非静态继承，从而实现功能的逐步扩展。通过这种方式，可以在不修改原始实现的前提下为对象添加额外行为。可扩展性与解耦性是该模式的关键收益。
当需求变更时，直接改动类层级往往会带来高耦合与难以维护的问题。此时，装饰器模式允许在运行时以多层装饰的方式叠加新特性，且不影响到核心组件的使用接口。灵活性和可组合性成为该模式在Java应用中的主要优势。
interface Component {String operation();
}class ConcreteComponent implements Component {public String operation() { return "Base"; }
}1.2 与继承、代理的关系
与传统的继承相比，装饰器模式提供了运行时的组合能力，可以在不改动原有类的情况下灵活地叠加新行为。它避免了庞大继承层级带来的复杂性。
与代理模式相比，装饰器更关注的是功能的增强而非对访问控制的拦截。装饰器通过包装对象来实现“附加职责”的动态叠加，而代理则多用于对目标对象的控制访问。 职责分离和可组合性是两者的共同点，但应用场景不同。
// 参考：基于同一接口的装饰器-简化示例
interface Component {String operation();
}
class ConcreteComponent implements Component {public String operation() { return "Base"; }
}
2. 设计原理与结构
2.1 角色与职责
组件角色定义被装饰的对象的基本接口，以确保装饰器与原始对象具有一致性。该接口保证了装饰链的可替换性。
装饰器角色实现与目标对象相同的接口，并持有一个指向被装饰对象的引用，从而将请求转发给底层对象，同时可在转发前后添加额外行为。
interface Component {String operation();
}
class ConcreteComponent implements Component {public String operation() { return "Base"; }
}
2.2 运行时装饰链
装饰器通过组合将多个装饰对象连成一条“装饰链”，请求沿着链向下传递，直到到达最终的被装饰对象。链式结构使得功能可以灵活组合和扩展。
每一层装饰都可以在请求进入下一层之前或之后执行自己的逻辑，从而实现前置处理、后置处理和条件性增强等多种行为模式。
abstract class Decorator implements Component {protected Component wrappee;public Decorator(Component c){ this.wrappee = c; }public String operation(){ return wrappee.operation(); }
}
class ConcreteDecoratorA extends Decorator {public ConcreteDecoratorA(Component c){ super(c); }public String operation(){ return "" + wrappee.operation() + ""; }
}
3. Java装饰器模式实现要点
3.1 基本接口与抽象类
实现一个干净的<装饰器框架，先定义统一的
解耦实现与职责分离是设计要点，确保新增装饰器不会影响现有对象的客户端代码。
interface Component {String operation();
}
abstract class Decorator implements Component {protected Component wrappee;public Decorator(Component c){ this.wrappee = c; }public String operation(){ return wrappee.operation(); }
}
3.2 具体装饰器实现
具体装饰器实现需要覆盖operation()，在保留原有行为的基础上添加新的职责。通过这种方式，可以实现按需组合的功能叠加。
设计时应注意避免过度嵌套，保持装饰链的可读性与<可维护性，并确保每一层都对最终结果的形成具有明确贡献。
interface Component {String operation();
}
class ConcreteComponent implements Component {public String operation() { return "Base"; }
}
abstract class Decorator implements Component {protected Component wrappee;public Decorator(Component c){ this.wrappee = c; }public String operation(){ return wrappee.operation(); }
}
class ConcreteDecoratorA extends Decorator {public ConcreteDecoratorA(Component c){ super(c); }public String operation(){return "" + wrappee.operation() + "";}
}
4. 典型应用场景与实战案例
4.1 IO流装饰模式示例
在Java中，IO流经常通过装饰器模式实现功能增强，例如对输入进行编码/解码、对字节流进行缓冲、对读取的数据进行转换等。借助装饰器，可以在不修改核心流实现的情况下添加新行为。
下面给出一个简单的自定义 UpperCaseInputStream 装饰器示例，演示如何在读取时把字节数据转换为大写形式，同时保持原有输入流的接口。注意：这是一个教学示例，实际使用中应优先考虑标准库中的装饰器。
import java.io.*;class UpperCaseInputStream extends FilterInputStream {protected UpperCaseInputStream(InputStream in) { super(in); }@Overridepublic int read() throws IOException {int c = super.read();return (c == -1) ? -1 : Character.toUpperCase((char) c);}@Overridepublic int read(byte[] b, int off, int len) throws IOException {int r = super.read(b, off, len);if (r == -1) return -1;for (int i = off; i < off + r; i++) {b[i] = (byte) Character.toUpperCase((char) b[i]);}return r;}
}
实现要点在于将自定义装饰器与底层输入流协同工作，确保请求沿着装饰链传递并且对数据进行可控的转换。通过该模式，可以在不修改原始输入流类的情况下实现多种数据处理组合。
4.2 日志与数据处理装饰
除了IO流，装饰器也广泛用于日志记录、性能监控、数据格式化等场景。将日志逻辑从核心业务中抽离出来，可以在运行时叠加或移除。可观测性和可追溯性因此成为重要收益。
在实现中，可以定义一个简单的日志装饰器，在调用前后输出日志信息，然后将请求转发给被装饰对象。该方式实现了行为注入而不侵入核心逻辑。
interface Component {String operation();
}
class ConcreteComponent implements Component {public String operation() { return "Base"; }
}
abstract class Decorator implements Component {protected Component wrappee;public Decorator(Component c){ this.wrappee = c; }public String operation(){ return wrappee.operation(); }
}
class LoggingDecorator extends Decorator {public LoggingDecorator(Component c){ super(c); }public String operation(){System.out.println("LOG: before operation");String result = wrappee.operation();System.out.println("LOG: after operation");return result;}
}
5. 实战代码示例：一个简易文本处理装饰器
5.1 设计目标与接口
本案例展示如何通过组合装饰实现文本的前后缀包装。核心接口保持简单，方便组合新的文本格式化效果。可扩展性是主目标。
可读性和
可维护性
在设计时同样重要，避免让装饰链过于复杂。interface TextComponent {String getText();
}
class PlainText implements TextComponent {private String text;public PlainText(String text){ this.text = text; }public String getText(){ return text; }
}
abstract class TextDecorator implements TextComponent {protected TextComponent wrap;public TextDecorator(TextComponent t){ this.wrap = t; }public String getText(){ return wrap.getText(); }
}
class BoldDecorator extends TextDecorator {public BoldDecorator(TextComponent t){ super(t); }public String getText(){return "" + wrap.getText() + "";}
}
class ItalicDecorator extends TextDecorator {public ItalicDecorator(TextComponent t){ super(t); }public String getText(){return "" + wrap.getText() + "";}
}
示例运行结果的组合方式如下所示，演示了多层装饰的效果：PlainText -> BoldDecorator -> ItalicDecorator。
public class Demo {public static void main(String[] args) {TextComponent base = new PlainText("Hello Decorator");TextComponent bold = new BoldDecorator(base);TextComponent boldItalic = new ItalicDecorator(bold);System.out.println(boldItalic.getText());// 输出: Hello Decorator}
}
