对OutputStream类的flush()方法的误解

最近使用java的FileOutputStream写文件，调用到了flush()方法。

在Code Review时，同事指出没有调用flush()的必要。

于是查看了FileInputStream类的源代码，发现flush()其实是继承于其父类OutputStream的。

而OutputStream类的flush()却什么也没做，恍然大悟，真是“看源代码者得真相啊”。

其实flush()是Flushable接口的方法，官方文档的对该方法的注释是“Flushes this output stream and forces any buffered output bytes to be written out.”。

OutputStream方法实现了Flushable接口，而又什么也没做，真是让人一头雾水，于是就出现了我的误解。

那么什么时候flush()才有效呢？

答案是：当OutputStream是BufferedOutputStream时。

当写文件需要flush()的效果时，需要

FileOutputStream fos = new FileOutputStream("c:\a.txt");
BufferedOutputStream bos = new BufferedOutputStream(fos);

也就是说，需要将FileOutputStream作为BufferedOutputStream构造函数的参数传入，然后对BufferedOutputStream进行写入操作，才能利用缓冲及flush()。

查看BufferedOutputStream的源代码，发现所谓的buffer其实就是一个byte[]。

BufferedOutputStream的每一次write其实是将内容写入byte[]，当buffer容量到达上限时，会触发真正的磁盘写入。

而另一种触发磁盘写入的办法就是调用flush()了。

google了一下，发现有这个误解的人不在少数，今天特以此文记之。