[转]Commons IO 官方文档
原文地址:http://ifeve.com/commons-io/
本文翻译自 Commons IO 官方文档 译者:MagicWolf
Common IO 是一个工具库,用来帮助开发IO功能 它包括6个主要部分
- Utility classes – 包括一些静态方法来执行常用任务
- Input –
InputStream
和Reader
实现 - Output –
OutputStream
和Writer
实现 - Filters – 多种文件过滤器实现(定义了
IOFileFilter
接口,同时继承了FileFilter
和FilenameFilter
接口) - Comparators – 用于文件比较的多种
java.util.Comparatot
实现
发行版本
- Commons IO 2.5 (requires JDK 1.6+)
- Commons IO 2.4 (requires JDK 1.6+)
- Commons IO 2.2 (requires JDK 1.5+)
用户指南
Commons-IO 包括 工具类 (utility classes
), 字节序列类 (endian classes
), 行迭代器 (line iterator
), 文件过滤器 (file filters
),文件比较器 (file comparators
) 和 流实现 (stream implementations
).
Utility classes
IOUtils
IOUtils 包含一些工具类,用于处理读,写和拷贝,这些方法基于 InputStream
, OutputStream
, Reader
和 Writer
工作.
例如,思考一个任务,从URL中读取byte数据,并打印。通常会这样做:
InputStream in = new URL( "http://commons.apache.org" ).openStream();
try {
InputStreamReader inR = new InputStreamReader( in );
BufferedReader buf = new BufferedReader( inR );
String line;
while ( ( line = buf.readLine() ) != null ) {
System.out.println( line );
}
} finally {
in.close();
}
使用 IOUtils
类,可以这样:
InputStream in = new URL( "http://commons.apache.org" ).openStream();
try {
System.out.println( IOUtils.toString( in ) );
} finally {
IOUtils.closeQuietly(in);
}
在某些应用领域,例如IO操作中是很常见的,这个类可以节省很多时间。并且你可以依赖于经过全面测试的代码。
对于这类的代码,灵活性和速度是最重要的。然而你也应该明白这么做的限制。使用以上的方式读取一个1GB的文件将会试图创造一个1GB字符串对象
FileUtils
FileUtils 包含一些工具类,它们基于File
对象工作,包括读,写,拷贝和比较文件
例如逐行读取整个文件你可以使用:
File file = new File("/commons/io/project.properties");
List lines = FileUtils.readLines(file, "UTF-8");
FilenameUtils
FilenameUtils包含一些工具类,它们基于文件名工作而不是File
对象。这个类旨在 在Unix和Windows环境下保持一致,帮助在两个环境下过渡(如从开发环境到生成环境)
例如,正常化文件名,删除..
片段:
String filename = "C:/commons/io/../lang/project.xml";
String normalized = FilenameUtils.normalize(filename);
// result is "C:/commons/lang/project.xml"
FileSystemUtils
FileSystemUtils包含一些工具类,基于文件系统访问功能不被JDK支持。目前,只有一个方法就是得到驱动器空余空间。注意这使用命令行而不是 native code。
例如得到驱动器空余空间:
long freeSpace = FileSystemUtils.freeSpace("C:/");
Endian classes
不同的计算机架构对应字节序采用不同的约定,在所谓的”小端”架构(例如Intel),低位字节被存储在内存的最低字节,之后的字节在高地址。对于”大端”架构(如Motoroal),情况相反。
在这个包中有两个相关联的类:
- EndianUtils 包含静态方法来交换Java基本类型和流的字节序
- SwappedDataInputStream实现了
DataInput
接口。可以从文件中读取非本地字节序。
Line iterator
org.apache.commons.io.LineIterator
类提供类灵活的方式操作基于行的文件。通过FileUtils
或 IOUtils
中的工厂方法,可以直接创建一个实例。推荐的使用方法是:
LineIterator it = FileUtils.lineIterator(file, "UTF-8");
try {
while (it.hasNext()) {
String line = it.nextLine();
/// do something with line
}
} finally {
LineIterator.closeQuietly(iterator);
}
File filters
org.apache.commons.io.filefilter
包定义了一个接口 (IOFileFilter),同时继承了 java.io.FileFilter
和 java.io.FilenameFilter
接口。除此之外还提供了一系列可以使用的IOFileFilter
接口实现,包括允许你组合其他过滤器。这些过滤器可以用来遍历文件或在FileDialog
中使用。
详情见 filefilter 包的Javadoc。
File comparators
org.apache.commons.io.comparator
包为java.io.File
提供一些java.util.Comparator
实现。这些比较器可以用来排序列表和文件数字。
详情见 comparator 包的Javadoc。
Streams
org.apache.commons.io.input
和 org.apache.commons.io.output
包中包含一些有用的流实现。他们包括:
- Null output stream – 默默吸收所有发给它的数据
- Tee output stream – 发送输出数据给两个流而不是一个
- Byte array output stream – 这是一个比JDK更快的版本
- Counting streams – 计算通过的字节数
- Proxy streams – 在代理中委托正确的方法
- Lockable writer – 使用锁文件提供写入同步
最佳实践
本文档提供一些在IO领域的最佳实践
java.io.File
通常,你要处理文件和文件名。有很多地方可能出错:
- 一个类在Uinx下正常工作但是在Windows下不工作(反之亦然)
- 由于重复或丢失路径分隔符造成无效的文件名
- 等等
这些都是不使用字符串类型文件名的充分理由。使用 java.io.File
可以很好的处理上述情况。因此,我们的最佳实践建议对文件名使用 java.io.File
代替字符串来避免平台依赖。
commons-io 1.1开始包含一个专门用于文件名的处理类 – FilenameUtils。这会处理很多这类文件名问题,但是我们仍然建议尽可能的使用 java.io.File
对象
让我们来看一个例子:
public static String getExtension(String filename) {
int index = filename.lastIndexOf('.');
if (index == -1) {
return "";
} else {
return filename.substring(index + 1);
}
}
很容易?是的,但是如果传入一个全路径而不只是文件名会发生什么?考虑一下,完全合法的路径: “C:\Temp\documentation.new\README”。这个方法将会返回”new\README”,绝对不是你想要的
请使用 java.io.File
代替字符串作为文件名。这个类提供的方法经过了良好的测试。在 FileUtil
你会发现其他关于 java.io.File
有用的工具方法。
String tmpdir = "/var/tmp";
String tmpfile = tmpdir + System.getProperty("file.separator") + "test.tmp";
InputStream in = new java.io.FileInputStream(tmpfile);
替代
File tmpdir = new File("/var/tmp");
File tmpfile = new File(tmpdir, "test.tmp");
InputStream in = new java.io.FileInputStream(tmpfile);
Buffering streams
IO性能很多情况下取决于缓冲策略。通常以512或1024比特读取数据块会相当快,因为这些大小的数据块和硬盘在文件系统中的数据块大小或文件系统缓存很搭配。但是如果你只需要读取结果字节那么性能会有显著下降
确保你在读取或写入流时正确的进行缓冲,特别是使用文件时,只在 BufferedInputStream
上包装 FileInputStream
InputStream in = new java.io.FileInputStream(myfile);
try {
in = new java.io.BufferedInputStream(in);
in.read(.....
} finally {
IOUtils.closeQuietly(in);
}
注意不要缓冲一个已经被缓冲的流。一些组件例如 XML 解析器可能自己缓冲,所以装饰传递给 XML 解析器的InputStream
只会拖慢的代码。如果你使用我们的 CopyUtils
或者 IOUitls
你不需要另外缓冲,你使用的代码在复制过程的已经缓冲。经常检查Javadocs中的信息。另一种情况,当你向ByteArrayOutputStream
中写入时,缓冲不是必须的,因为你只写入内存。
原创文章,转载请注明: 转载自并发编程网 – ifeve.com本文链接地址: Commons IO 官方文档
[转]Commons IO 官方文档的更多相关文章
- Spring Data Commons 官方文档学习
Spring Data Commons 官方文档学习 -by LarryZeal Version 1.12.6.Release, 2017-07-27 为知笔记版本在这里,带格式. Table o ...
- hbase官方文档(转)
FROM:http://www.just4e.com/hbase.html Apache HBase™ 参考指南 HBase 官方文档中文版 Copyright © 2012 Apache Soft ...
- HBase官方文档
HBase官方文档 目录 序 1. 入门 1.1. 介绍 1.2. 快速开始 2. Apache HBase (TM)配置 2.1. 基础条件 2.2. HBase 运行模式: 独立和分布式 2.3. ...
- 【Java架构:基础技术】一篇文章搞掂:Spring Boot 官方文档解读
本文篇幅较长,建议合理利用右上角目录进行查看(如果没有目录请刷新). 本文内容大部分是翻译和总结官方文档,可以到https://docs.spring.io/spring-boot/docs查看(此地 ...
- Spring 通读官方文档
Spring 通读官方文档 这部分参考文档涵盖了Spring Framework绝对不可或缺的所有技术. 其中最重要的是Spring Framework的控制反转(IoC)容器.Spring框架的Io ...
- Spark官方文档 - 中文翻译
Spark官方文档 - 中文翻译 Spark版本:1.6.0 转载请注明出处:http://www.cnblogs.com/BYRans/ 1 概述(Overview) 2 引入Spark(Linki ...
- Spring 4 官方文档学习 Spring与Java EE技术的集成
本部分覆盖了以下内容: Chapter 28, Remoting and web services using Spring -- 使用Spring进行远程和web服务 Chapter 29, Ent ...
- Spring 4 官方文档学习(十四)WebSocket支持
个人提示:如果需要用到页面推送,高频且要低延迟,WebSocket无疑是最佳选择.否则还是轮询和long polling吧. 做了一个小demo放在码云上,有兴趣的可以看一下,简单易懂:websock ...
- Spring 4 官方文档学习(十三)集成其他web框架
重点是通用配置,非常建议看一下!有助于理解Spring的ApplicationContext与Servlet Container的关系! 1.介绍 Spring Web Flow SWF目标是成为we ...
随机推荐
- 关于解锁美版Play市场
关于解锁美版Play市场(本帖已经突破了G+的500评论上限,如有问题请转载留言) 我对这个问题思考的很深刻也思考了很久,作为一个深度google脑残粉怎么能用不完整的Play Store呢?那人生岂 ...
- Block(二)内存管理与其他特性-b
一.block放在哪里 我们针对不同情况来讨论block的存放位置: 1.栈和堆 以下情况中的block位于堆中: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 ...
- 关于try catch
说明try块中有return语句时,仍然会首先执行finally块中的语句,然后方法再返回. 如果try块中存在System.exit(0);语句,那么就不会执行finally块中的代码,因为Syst ...
- Android中五种常用的menu
Android Menu在手机的应用中起着导航的作用,作者总结了5种常用的Menu. 1.左右推出的Menu 前段时间比较流行,我最早是在海豚浏览器中看到的,当时耳目一新.最早使用左右推出菜单的,听说 ...
- [转]IC行业的牛人
转载的: 说来惭愧,我所了解的牛人也只是大学教授,工业界的高手了解的还太少,虽然我对教育界的牛人了解的也不多,但这里也要牢骚几句,论坛上的人好像只是认识Gray,Razavi,Allen,Lee, ...
- js 数组的深度递归搜索
- [置顶] app后端设计--总目录
版权声明:本文为博主原创文章,未经博主允许不得转载. 做了3年app相关的系统架构,api设计,先后在3个创业公司中工作,经历过手机网页端,Android客户端,iphone客户端,现就职于app云后 ...
- zookeeper 启动脚本
#!/bin/bash export JAVA_HOME=/usr/java/latest export JRE_HOME=/usr/java/latest/jre zoo=/data/package ...
- 用原生JavaScript写AJAX
//原生js写ajax就像打电话 //打电话分下面4步//1.拿出手机//2.拨号//3.说话//4.听对方说话 //ajax也分下面4步//1.创建ajax对象//2.连接到服务器//3.发送请求( ...
- Android 性能优化总结
App 流畅运行,是用户体验的第一步.App 流程运行,涉及到性能优化,主要涉及到布局优化, 绘制优化,内存泄漏优化,响应速度优化,列表展示优化,Bitmap 优化,线程优化,包大小优化. 布局优化 ...