Apache-Commons家族的八兄弟（下）

文接上回：Apache-Commons家族的八兄弟（上）

Apache Commons包含了很多开源的工具，用于解决平时编程经常会遇到的问题，减少重复劳动。篇幅很长所以拆分为两篇。

老四：commons-configuration

Apache Common-Configuration 工具可以从Properties文件，XML文件,JNDI,JDBC数据源，System Properties,Applet parameters,Servlet Parameters等读取相应信息。

具体的使用方式：

1. 引入jar包。引入commons-configuration（版本1.XX和2.XX的使用方式稍有区别）和commons-beanutils两个依赖；

2. 初始化配置

版本1.XX

# 使用有参构造来加载配置文件
Configuration config = new PropertiesConfiguration("usergui.properties");
# 使用无参构造初始化，然后通过load()方法来加载配置文件
Configuration config = new PropertiesConfiguration();

版本2.XX

Configurations configs = new Configurations();
try{
  Configuration config = configs.properties(new File("config.properties"));
  // access configuration properties
  String dbHost = config.getString("database.host");
  String dbPassword = config.getString("database.password", "secret");  // provide a default
  int dbPort = config.getInt("database.port");
  long dbTimeout = config.getLong("database.timeout");
  ...
  }catch (ConfigurationException cex){
   // Something went wrong
}

注意：access configuration properties的异常

在获取properties文件的内容时:  

如果key不存在，且获取的类型为String类型时，那么返回值为null;

如果key不存在，且获取的类型为非String类型时，那么将抛出一个Exception: java.util.NoSuchElementException

还可以指定一个默认的值，在找不到指定key的时候，Configuration将使用这个默认值, Configuration为每个取值的方法都提供了重载的方法。

 3.扫描规则

    版本1.XX

   i 如果指定的是绝对路径按绝对路径扫描

   ii 如果指定的是相对路径，那么按如下顺序扫描

1. in the current directory

2. in the user home directory

3. in the classpath

    版本2.XX

在Version 2.0开始，对于文件扫描策略，用接口FileLocationStrategy来实现，该接口只有一个单一的方法locate()

URL locate(FileSystem fileSystem, FileLocator locator);

一共提供了如下几个实现类，分别来应对不同的场景。 

ProvidedURLLocationStrategy, 

FileSystemLocationStrategy, 

AbsoluteNameLocationStrategy, 

BasePathLocationStrategy, 

HomeDirectoryLocationStrategy, 

ClasspathLocationStrategy, 

CombinedLocationStrategy。

同时, 这些实现类可以构成一个扫描链来进行按照其顺序进行组合扫描。假设我们期望按照如下的顺序进行扫描我们的配置文件：

1. by their URL

2. by the file system (which will evaluate base path and file name)

3. on the classpath  

代码实现如下:

List<FileLocationStrategy> subs = Arrays.asList(
new ProvidedURLLocationStrategy(),
new FileSystemLocationStrategy(),
new ClasspathLocationStrategy());
FileLocationStrategy strategy = new CombinedLocationStrategy(subs);

4.自动重载配置文件

我们都希望我们的系统是高可用的，在我们修改配置文件的以后，不期望去重新启动服务，而希望其能够自动的重新加载。Commons-Configuration提供了一些组件来实现这一功能。

组件一:ReloadingDetector Interface

组件二:ReloadingController Class , ReloadingListener Interface

因为Commons-Configuration无法得知每个用户的期望触发重新加载的机制，所以其设计一个基于Timer的方案，作为一个最灵活的方式，同时它有提供了一个自定义触发器( a custom component triggering)组件的方法来适配各种不同的重载需求。

老五：commons-io

ommons-io是一款处理io流的工具，封装了很多处理io流和文件的方法，可以大大简化我们处理io流和操作文件的代码。从common-io的官方使用文档可以看出，它主要分为工具类、尾端类、行迭代器、文件过滤器、文件比较器和扩展流，它包含有：

1.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字符串对象。

2.FileUtils

 FileUtils 包含一些工具类,它们基于File对象工作，包括读，写，拷贝和比较文件。例如逐行读取整个文件你可以使用:

File file = new File("/commons/io/project.properties");
List lines = FileUtils.readLines(file, "UTF-8");

3.FilenameUtils

FilenameUtils包含一些工具类,它们基于文件名工作而不是File对象。这个类旨在 在Unix和Windows环境下保持一致,帮助在两个环境下过渡(如从开发环境到生成环境)。例如，正常化文件名，删除片段：

String filename = "C:/commons/io/../lang/project.xml";
String normalized = FilenameUtils.normalize(filename);

4.FileSystemUtils

FileSystemUtils包含一些工具类，基于文件系统访问功能不被JDK支持。目前，只有一个方法就是得到驱动器空余空间。注意这使用命令行而不是 native code。例如得到驱动器空余空间:

long freeSpace = FileSystemUtils.freeSpace("C:/");
Endian classes

不同的计算机架构对应字节序采用不同的约定,在所谓的”小端”架构(例如Intel)，低位字节被存储在内存的最低字节,之后的字节在高地址。对于”大端”架构(如Motoroal),情况相反。在这个包中有两个相关联的类:

EndianUtils 包含静态方法来交换Java基本类型和流的字节序

SwappedDataInputStream实现了DataInput接口。可以从文件中读取非本地字节序。

5.Line iterator

org.apache.commons.io.LineIterator类提供类灵活的方式操作基于行的文件。通过FileUtils 或 IOUtils中的工厂方法,可以直接创建一个实例。推荐的使用方法是：

LineIterator it = FileUtils.lineIterator(file, "UTF-8");
try{
  while(it.hasNext()){
    String line = it.nextLine();
    }finally{
    LineIterator.closeQuietly(iterator);
    }
}

6.File filters

org.apache.commons.io.filefilter包定义了一个接口 (IOFileFilter),同时继承了 java.io.FileFilter 和 java.io.FilenameFilter接口。除此之外还提供了一系列可以使用的IOFileFilter接口实现，包括允许你组合其他过滤器。这些过滤器可以用来遍历文件或在FileDialog中使用。详情见 filefilter 包的Javadoc。

7.File comparators

org.apache.commons.io.comparator包为java.io.File提供一些java.util.Comparator实现。这些比较器可以用来排序列表和文件数字。详情见 comparator 包的Javadoc。

8.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 – 使用锁文件提供写入同步

老六：commons-lang

静态类

在org.apache.commons.lang包中提供了一些有用的包含static方法的Util类。除了6个Exception类和2个已经deprecated的数字类之外，commons.lang包共包含了17个实用的类。

老七：commons-logging

Commons-logging（JCL）是apache最早提供的日志的门面接口。提供简单的日志实现以及日志解耦功能。JCL能够选择使用Log4j（或其他如slf4j等）还是JDK Logging，但是他不依赖Log4j，JDK Logging的API。如果项目的classpath中包含了log4j的类库，就会使用log4j，否则就使用JDK Logging。使用commons-logging能够灵活的选择使用那些日志方式，而且不需要修改源代码。（类似于JDBC的API接口）。

使用方法

1）将common-logging.jar 包加入到环境变量或者classpath。 

2）导入org.apache.commons.logging.Log; org.apache.commons.logging.LogFactory;及相关包 

3）在需要使用logging的地方获取Log实例。

private static Log log = LogFactory.getLog(Test.class);

4）使用Logger对象的debug,info,fatal…方法。

log.debug("Debug info.");

Apache Commons Net™库实现了许多基本Internet协议的客户端。该库的目的是提供基本协议访问，而不是更高级别的抽象。因此，一些设计违反了面向对象的设计原则。我们的理念是尽可能使协议的全局功能可访问（例如，TFTP发送文件和接收文件），但也提供对适用的基本协议的访问，以便程序员可以构建自己的自定义实现（例如，TFTP）数据包类和TFTP数据包的发送和接收方法都是公开的）。老八：commons-net

支持协议：

• FTP / FTPS

• FTP over HTTP（实验性）

• NNTP 网络新闻传输协议

• SMTP（S）简单邮件传输协议

• POP3（S）邮件协议版本3

• IMAP（S）邮件访问协议

• telnet 远程登录

• TFTP 简单文件传输协议

• finger

• whois 用来查询域名的IP以及所有者等信息的传输协议

• REXEC / RCMD /远程登录

• daytime（rdate）和白天

• echo

• discard

• NTP / SNTP 网络时间协议

小知识复习

TCP和UDP的区别：

1.基于连接与无连接；

2.对系统资源的要求（TCP较多，UDP少）；

3.UDP程序结构较简单；

4.流模式与数据报模式 ；

5.TCP保证数据正确性，UDP可能丢包，TCP保证数据顺序，UDP不保证。

原文：https://www.imooc.com/article/273893

作者：皮县豆福脑

推荐阅读

1. Java 必须掌握的Spring 注解

2. 值得关注的9个公众号

3. Spring 中的设计模式

4. Apache-Commons家族