我们可以不用重复造轮子了。
1.资料地址
1.1官方网站:http://commons.apache.org/proper/commons-io/
1.2下载地址:http://commons.apache.org/proper/commons-io/download_io.cgi
2.简要介绍(官方英文的翻译版)
2.1版本说明-Release Notes
Commons IO是一个Java工具类库的包,类似于java.io包。
这个包中的类被认为非常标准和高度复用,以至于值得加入到java.io包中。
Commons IO库包含了工具类、流实现、文件过滤器、文件比较器、字节序转换等。
2.2概要-Overview
Commons IO是一个帮助开发IO功能的工具库。
主要包括了以下6个领域:
①工具类-使用静态方法执行通用的任务。
②输入-有用的(字节)输入流(Input Stream)和(字符)读取器(Reader)实现。
③输出-有用的(字节)输出流(Output Stream)和(字符)书写器(Writer)实现。
④过滤器-多种多样的的文件过滤器(java.io.FileFilter,java.io.FilenameFilter)实现。
⑤比较器-多种多样的文件比较器(java.util.Comparator)实现。
⑥文件监听器-一个用来监听文件系统事件的组件。
原文出处:Release Notes来自Release-Notes.txt,Overview来自官方网站。
3.详细介绍
3.1工具类
FileUtils:
通用的文件操作工具。
这个类提供了以下领域的功能:
向文件中写入 ;
从文件中读取 ;
创建目录,包括父路径;
拷贝文件和目录;
删除文件和目录;
文件和URL的相互转换;
通过过滤器和扩展名,列出文件和目录;
比较文件内容;
文件最后修改日期;
计算checksum。
FilenameUtils:通用的文件名和文件路径操作工具类。从基于Windows开发环境的机器,移动文件到
基于Unix的生产环境机器时,你可能会遇到关于文件名的问题。这个类的目标就是帮助你避免这些问题。
FileSystemUtils:通用的文件系统工具类。
这个类提供静态的工具方法,为实现通用的文件系统功能(JDK java.io.File没有提供的) 。
目前提供的功能仅限于:获得驱动器的剩余空间。
IOUtils:通用的IO流操作工具类。
这个类提供了输入/输出操作的静态工具方法。
closeQuietly – 这些方法关闭流,忽略null和异常 ;
toXxx/read – 这些方法从流中读取数据 ;
write – 这些方法向流中写入数据;
copy – 这些方法拷贝数据从一个流到另外一个;
contentEquals – 这些方法比较2个流中的内容。
ThreadMonitor:监听一个线程,当线程超时的时候打断它。
更多介绍,请参考
3.2输入流
BOMInputStream:第1个字节写入BOM字节的流。
BrokenInputStream:损坏的输入流。该流的任何方法都会抛出IOException,主要用来测试“错误处理代码”的正确性。
CountingInputStream:一个字节输入流的包装类,用来统计经过该流的字节数。
CharSequenceInputStream:可以从String, StringBuffer, StringBuilder和CharBuffer读取数据的字节流。
CharSequenceReader:以从String, StringBuffer, StringBuilder和CharBuffer读取数据的字符流。
该流的一个典型的用途是调试,确保读取的数据是期待的。
更多介绍,请参考
3.3输出流
BrokenOutputStream:损坏的输出流。该流的任何方法都会抛出IOException,主要用来测试“错误处理代码”的正确性。
CountingOutputStream:一个字节输出流的包装类,用来统计经过该流的字节数。
StringBuilderWriter:Writer的实现类,输出数据到StringBuilder。
这个实现类是StringWriter之外的另一种选择,提供非同步的实现,为了更好的性能。
多线程环境的安全用途,应该使用StringWriter。
WriterOutputStream:OutputStream实现类,使用指定的编码,传送字节数据到字符流,写入结果流到Writer。
更多介绍,请参考
3.4过滤器
特别说明:"过滤/Filter"这个词存在歧义,本处的意思是"保留符合条件的文件",而不是"排除符合条件的文件"。
AgeFileFilter:基于cutoff时间的文件过滤器,能够过滤任何时间更新/更老/相等的文件。
EmptyFileFilter:过滤空的文件和目录。
SizeFileFilter:基于大小的过滤器,能够过滤小于/等于/大于指定大小的文件。
NameFileFilter:过滤文件名满足一定条件的文件。
CanReadFileFilter:这个过滤器接受“可读”的文件。
CanWriteFileFilter:这个过滤器接受“可写”的文件。
DirectoryFileFilter:这个过滤器接受“目录”文件。
FileFileFilter:这个过滤器接受“文件,非目录”文件。
HiddenFileFilter:这个过滤器接受“隐藏”文件。
AndFileFilter:提供条件"且"逻辑,如果每一个filter否返回true,则返回true。
类似的还有:OrFileFilter/NotFileFilter。
RegexFileFilter:基于正则表达式的过滤器。
WildcardFileFilter:基于通配符的过滤器。
PrefixFileFilter:过滤文件名"前缀"满足一定条件的文件。
SuffixFileFilter:过滤文件名"后缀"满足一定条件的文件。
更多介绍,请参考
3.5比较器
DefaultFileComparator: 使用默认的File#compareTo(File)方法比较。
CompositeFileComparator:使用一系列委托比较器比较。
DirectoryFileComparator:使用File#isDirectory()方法比较。
ExtensionFileComparator:根据文件的"扩展名"比较。
LastModifiedFileComparator: 根据最后修改日期/时间比较。
NameFileComparator:根据文件名比较。
PathFileComparator:根据文件路径比较File#getPath()。
ReverseComparator:逆序比较器,把比较结果"倒过来"。
SizeFileComparator:根据文件的长度和大小比较 File#length()和FileUtils#sizeOfDirectory(File)。
更多介绍,请参考
http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/comparator/package-summary.html
3.6文件监听器
FileAlterationListener:接收文件系统变化事件的监听器。
FileAlterationMonitor:文件变化监控器。
产生一个监控线程,以一定的时间间隔,触发注册的FileAlterationObserver。
FileAlterationObserver:文件变化观察者,代表某一根目录下的文件状态,检查文件系统,通知listener创建、改变和删除事件。
更多介绍,请参考
4.一个经典的例子-SpringMVC上传文件
@RequestMapping(value = "uploadLoginSplash", method = RequestMethod.POST)
public String uploadLoginSplash(HttpServletRequest request, @RequestParam("file") MultipartFile file)
throws IOException {
if (!file.isEmpty()) {
String realPath = request.getSession().getServletContext().getRealPath(SPLASH);
//这里不必处理IO流关闭的问题,因为FileUtils.copyInputStreamToFile()方法内部会自动把用到的IO流关掉
FileUtils.copyInputStreamToFile(file.getInputStream(), new File(realPath, SPLASH_JPG));
#org.apache.commons.io.FileUtils
}
return "manager/setting/settingManager";
}
5.总结
ApacheCommonsIO等Apache Commons公共组件,可以大大提高咱们的开发效率,减少软件Bug和提高软件质量, 非常值得在项目中使用。
参考资料:commons-io-2.2-javadoc.jar和commons-io-2.2-sources.jar