在 java 字节流与字符流中,filterwriter 是用于包装已有 writer 并添加额外功能的基类。要使用它,你需要继承 filterwriter 并重写需要修改行为的 write 方法,然后在构造时传入一个具体的 writer 实例。这样可以在不改变原有写入逻辑的前提下,对写入的数据进行过滤、转换或增强。

如何自定义一个带缓冲的 FilterWriter
通过继承 FilterWriter 并重写 write 方法,可以实现一个简单的缓冲写入器。当数据量较小时,可以将其暂存起来,达到一定阈值后再一次性写入底层 Writer,从而减少 I/O 操作次数。

import java.io.FilterWriter;
import java.io.IOException;
import java.io.Writer;
public class BufferedFilterWriter extends FilterWriter {
private StringBuilder buffer = new StringBuilder();
private final int bufferSize;
public BufferedFilterWriter(Writer out, int bufferSize) {
super(out);
this.bufferSize = bufferSize;
}
@Override
public void write(int c) throws IOException {
buffer.append((char) c);
if (buffer.length() >= bufferSize) {
flushBuffer();
}
}
@Override
public void write(char[] cbuf, int off, int len) throws IOException {
buffer.append(cbuf, off, len);
if (buffer.length() >= bufferSize) {
flushBuffer();
}
}
@Override
public void write(String str, int off, int len) throws IOException {
buffer.append(str, off, len);
if (buffer.length() >= bufferSize) {
flushBuffer();
}
}
@Override
public void flush() throws IOException {
flushBuffer();
super.flush();
}
@Override
public void close() throws IOException {
flushBuffer();
super.close();
}
private void flushBuffer() throws IOException {
if (buffer.length() > 0) {
out.write(buffer.toString());
buffer.setLength(0);
}
}
}
上述代码定义了一个 BufferedFilterWriter,它在每次写入时检查缓冲区大小,若达到设定阈值则调用 flushBuffer() 将内容写入底层 out。这种方式适用于需要批量写入的场景,能有效降低系统调用频率。
如何实现一个自动转大写的 FilterWriter
除了缓冲功能外,还可以利用 FilterWriter 对写入内容进行实时转换。例如,将所有写入的小写字母自动转换为大写,这在日志记录或数据标准化场景中非常有用。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

import java.io.FilterWriter;
import java.io.IOException;
import java.io.Writer;
public class UpperCaseFilterWriter extends FilterWriter {
public UpperCaseFilterWriter(Writer out) {
super(out);
}
@Override
public void write(int c) throws IOException {
out.write(Character.toUpperCase((char) c));
}
@Override
public void write(char[] cbuf, int off, int len) throws IOException {
for (int i = off; i <p>该实现中,<code>UpperCaseFilterWriter</code> 在每个 <code>write</code> 方法中将字符转为大写后再传递给底层 <code>out</code>。这种设计保持了接口一致性,同时实现了透明的大写转换功能。</p><h2>当写入空字符串时 FilterWriter 的行为是什么</h2><p>当向 <code>FilterWriter</code> 的子类写入空字符串时,其行为取决于具体实现。以 <code>BufferedFilterWriter</code> 为例,由于空字符串不会触发缓冲区刷新,因此不会有任何实际写入操作发生。而 <code>UpperCaseFilterWriter</code> 同样不会执行任何转换或写入动作,因为循环范围为空。这表明,在大多数基于 <code>FilterWriter</code> 的实现中,空输入通常被安全忽略,不会引发异常或副作用。</p>
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










