• 提高生产力:文件和IO操作(ApacheCommonsIO-汉化分享)


           复制、移动、删除、比较、监控、文件读写 等文件和IO操作是编程中比较常用的功能。
           幸运的是,Apache Commons IO等开源组件已经帮我们实现了。
           我们可以不用重复造轮子了。

    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:监听一个线程,当线程超时的时候打断它。

    更多介绍,请参考

    http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/package-summary.html

    3.2输入流


    BOMInputStream:第1个字节写入BOM字节的流。
    BrokenInputStream:损坏的输入流。该流的任何方法都会抛出IOException,主要用来测试“错误处理代码”的正确性。
    CountingInputStream:一个字节输入流的包装类,用来统计经过该流的字节数。
    CharSequenceInputStream:可以从String, StringBuffer, StringBuilder和CharBuffer读取数据的字节流。
    CharSequenceReader:以从String, StringBuffer, StringBuilder和CharBuffer读取数据的字符流。

    该流的一个典型的用途是调试,确保读取的数据是期待的。

    更多介绍,请参考

    http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/input/package-summary.html

    3.3输出流


    BrokenOutputStream:损坏的输出流。该流的任何方法都会抛出IOException,主要用来测试“错误处理代码”的正确性。
    CountingOutputStream:一个字节输出流的包装类,用来统计经过该流的字节数。
    StringBuilderWriter:Writer的实现类,输出数据到StringBuilder。
    这个实现类是StringWriter之外的另一种选择,提供非同步的实现,为了更好的性能。
    多线程环境的安全用途,应该使用StringWriter。
    WriterOutputStream:OutputStream实现类,使用指定的编码,传送字节数据到字符流,写入结果流到Writer。

    更多介绍,请参考

    http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/output/package-summary.html

    3.4过滤器


    特别说明:"过滤/Filter"这个词存在歧义,本处的意思是"保留符合条件的文件",而不是"排除符合条件的文件"。


    AgeFileFilter:基于cutoff时间的文件过滤器,能够过滤任何时间更新/更老/相等的文件。
    EmptyFileFilter:过滤空的文件和目录。
    SizeFileFilter:基于大小的过滤器,能够过滤小于/等于/大于指定大小的文件。
    NameFileFilter:过滤文件名满足一定条件的文件。

    CanReadFileFilter:这个过滤器接受“可读”的文件。
    CanWriteFileFilter:这个过滤器接受“可写”的文件。

    DirectoryFileFilter:这个过滤器接受“目录”文件。
    FileFileFilter:这个过滤器接受“文件,非目录”文件。
    HiddenFileFilter:这个过滤器接受“隐藏”文件。

    AndFileFilter:提供条件"且"逻辑,如果每一个filter否返回true,则返回true。
    类似的还有:OrFileFilter/NotFileFilter。

    RegexFileFilter:基于正则表达式的过滤器。
    WildcardFileFilter:基于通配符的过滤器。

    PrefixFileFilter:过滤文件名"前缀"满足一定条件的文件。
    SuffixFileFilter:过滤文件名"后缀"满足一定条件的文件。

    更多介绍,请参考

    http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/filefilter/package-summary.html

    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创建、改变和删除事件。

    更多介绍,请参考

    http://commons.apache.org/proper/commons-io/javadocs/api-release/index.html?org/apache/commons/io/monitor/package-summary.html


    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

    原文参见 提高生产力:文件和IO操作(ApacheCommonsIO-汉化分享)

  • 相关阅读:
    12套有用的免费 PSD 格式 Android UI 素材
    使用 Canvas 和 JavaScript 创建逼真的下雨效果
    在网页设计中使用漂亮字体的16个优秀例子
    Koala – 开源的前端预处理器语言图形编译工具
    BackgroundCheck – 根据图片亮度智能切换元素样式
    经典网页设计:18个示例展示图片在网页中的使用
    TogetherJS – 酷!在网站中添加在线实时协作功能
    30个令人惊叹的灵感来自自然风光的网站设计《下篇》
    太有才了!创新的街头涂鸦手绘欣赏【中篇】
    15款美丽的设备模板,帮助展示你的 APP
  • 原文地址:https://www.cnblogs.com/qitian1/p/6463657.html
Copyright © 2020-2023  润新知