Java开发中常用jar包整理及使用

本文整理了我自己在Java开发中常用的jar包以及常用的API记录。

<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
        <dependency>
            <groupId>org.apache.commons</groupId>
            <artifactId>commons-lang3</artifactId>
            <version>3.8</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
        <dependency>
            <groupId>commons-io</groupId>
            <artifactId>commons-io</artifactId>
            <version>2.6</version>
        </dependency>
        <!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <version>1.18.8</version>
            <scope>provided</scope>
        </dependency>
        <dependency>
            <groupId>log4j</groupId>
            <artifactId>log4j</artifactId>
            <version>1.2.17</version>
        </dependency>

common-lang3

简介

一个现在最为常用的jar包，封装了许多常用的工具包

在线API
依赖：

<!-- https://mvnrepository.com/artifact/org.apache.commons/commons-lang3 -->
<dependency>
	<groupId>org.apache.commons</groupId>
	<artifactId>commons-lang3</artifactId>
	<version>3.4</version>
</dependency>

主要常见的类如下：

• 数组工具类 ArrayUtils
• 日期工具类 DateUtils DateFormatUtils
• 字符串工具类 StringUtils
• 数字工具类 NumberUtils
• 布尔工具类 BooleanUtils
• 反射相关工具类 FieldUtils、MethodUtils、MemberUtils、TypeUtils、ConstructorUtils
• 对象工具类 ObjectUtils
• 序列化工具类 SerializationUtils

API介绍

这里我只介绍经常使用的几个工具类及方法，ArrayUtils，StringUtils，NumberUtils，DateUtils，其他的请查看官方API文档吧

1.ArrayUtils

方法名	说明
add
remove
clone	复制数组
addAll
removeAll	第二个参数传入需要删除的下标（可以指定多个下标）
toObject	把数值（int[],double[]）转为包装类(Int[],Double[])
indexOf	在数组按顺序查找，找到第一个满足对应的数值的下标
lastIndexOf	在数组按顺序查找，找到最后一个满足对应的数值的下标
contains	数组是否包含某个值
isEmpty	判断数组是否为空
isNotEmpty	判断数组是否不为空
reverse	数组反转
subarray	指定区间截取数组，区间为半开区间，不包含末尾
toArray	接收一个多个对象，把这几个对象转为对应类型的数组
toMap	将一个二维数组转为Map

2.NumberUtils

方法名	说明
min	比较三个数，返回最小值 或比较指定的几个数，返回最小值
max	比较三个数，返回最大值 或比较指定的几个数，返回最大值
createInt	从传入的String中创建对应类型的数值，createDouble,createFloat...
toInt	将指定字符串转为Int类型，可以选择指定默认数值，如果字符串为null则返回默认数值，除此之外，还有toDouble,toLong...等转为不同类型的方法
compare	比较两个同类型数值的大小
isDigits	判断字符串是否只包含数字
isParsable	判断字符串是否可转换为Long,Int等类型
isNumber	判断字符串是否为数值（0x,0X开头等进制数值）

3.DateUtils

方法名	说明
parseDate	将Date对象转为字符串
isSameDay	判断两个Dated对象是否为同一天
isSameDay	判断两个Dated对象是否为同一天
addHour	将指定的Date对象加上指定小时，除此之外，还有addMonth,addDay..等

DateFormatUtils正如其名，是用来把时间转为字符串，这里就不再多说

4.StringUtils

方法名	说明
join	将指定的数组连接成字符串，并添加指定的分割字符
containOnly	字符串是否只包含某个字符串
substringBefore	截取指定字符串前面的内容
substringAfter	截取指定字符串后面的内容（不包括指定字符串）
substringBetween	截取字符串某区间内容，如substringBetween("abcde","a","e")="bcd"
difference	比较两个字符串，返回两个字符串不同的内容，具体可以看API文档给出的示例
isBlank	判断字符串是否为空白，null,""," "这三个结果都是为true
isEmpty	判断字符串是否为空(只要不为null，或传入的String对象的长度不为0即为true)
countMatches	判断指定的字符串在某个字符串中出现的次数
deleteWhitespace	删除字符串中的空格
defaultIfBlank	如果字符串为空白，则返回一个指定的默认值(null或某个String)
defaultIfEmpty	如果字符串为空，则返回一个指定的默认值(null或某个String)
capitalize	将指定字符串首字母大写
abbreviate	将指定字符串的后面三位转为...
swapCase	将字符串中的字母大小写反转,如aBc变为AbC
lowerCase	将字符串的字母全部转为小写
upperCase	将字符串的字母全部转为大写
left	取字符串左边几个字符，如left("hello",3)="hel"，right与此相反
leftPad	字符串的长度不够，则使用指定字符填充指定字符串，如leftPad("hel",5,"z")="zzhel",rightPad方法与此相反
prependIfMissing	指定字符串不以某段字符串开头，则自动添加开头，如prependIfMissing("hello","li")="lihello"
prependIfMissing	指定字符串不以某段字符串开头(忽略大小写)，则自动添加开头
getCommonPrefix	获得多个字符串相同的开头内容，接收参数为多个字符串
removeEnd	删除字符串中结尾（满足是以某段内容结尾），如removeEnd("hello","llo")="he"
removeEndIgnoreCase	与上面一样，忽略大小写
removeStart	与上面的相反
remove	删除字符串中的指定内容，如remove("hello","l")="heo"
removeIgnoreCase	删除字符串中的指定内容，如remove("hello","l")="heo"
strip	清除字符串开头和末尾指定的字符(第二个参数为null,用来清除字符串开头和末尾的空格)，如strip(" abcxy","xy")=" abc",strip(" abcxy","yx")=" abc"
stripStart	清除字符串开头指定字符
stripEnd	清除字符串末尾指定的字符

common-io

简介

常用的IO流工具包
在线API

<!-- https://mvnrepository.com/artifact/commons-io/commons-io -->
<dependency>
	<groupId>commons-io</groupId>
	<artifactId>commons-io</artifactId>
	<version>2.6</version>
</dependency>

API

我们主要关心的就是Utils后缀的那几个类即可，可以看到，common-io库提供了FileUtils,FileSystemUtils,FileNameUtils,FileFilterUtils,IOUtils

FileUtils

• 写出文件
• 读取文件
• 创建一个有父级文件夹的文件夹
• 复制文件和文件夹
• 删除文件和文件夹
• URL转文件
• 通过过滤器和扩展名来筛选文件和文件夹
• 比较文件内容
• 文件最后修改时间
• 文件校验

FileSystemUtils

关于文件系统的相关操作，如查看C盘的大小，剩余大小等操作

IOUtils

字面意思，是封装了IO流的各种操作的工具类

Log4j

简介

Log4J 是 Apache 的一个开源项目，通过在项目中使用 Log4J，我们可以控制日志信息输出到控制台、文件、GUI 组件、甚至是数据库中。

我们可以控制每一条日志的输出格式，通过定义日志的输出级别，可以更灵活的控制日志的输出过程，方便项目的调试。

依赖：

<dependency>
    <groupId>log4j</groupId>
    <artifactId>log4j</artifactId>
    <version>1.2.17</version>
</dependency>

结构

Log4J 主要由 Loggers (日志记录器)、Appenders（输出端）和 Layout（日志格式化器）组成。

其中Loggers 控制日志的输出级别与日志是否输出；
Appenders 指定日志的输出方式（输出到控制台、文件等）；
Layout 控制日志信息的输出格式。

日志级别：

级别	说明
OFF	最高日志级别，关闭左右日志
FATAL	将会导致应用程序退出的错误
ERROR	发生错误事件，但仍不影响系统的继续运行
WARN	警告，即潜在的错误情形
INFO	一般和在粗粒度级别上，强调应用程序的运行全程
DEBUG	一般用于细粒度级别上，对调试应用程序非常有帮助
ALL	最低等级，打开所有日志记录

我们主要使用这四个：Error>Warn>Info>Debug

使用

我们可以使用两种方式来运行Log4j，一种是java代码方式，另外一种则是配置文件方式

例子（Java方式）

public class Log4JTest {
    public static void main(String[] args) {   
        //获取Logger对象的实例（传入当前类）         
        Logger logger = Logger.getLogger(Log4JTest.class);
        //使用默认的配置信息，不需要写log4j.properties
        BasicConfigurator.configure();
        //设置日志输出级别为WARN，这将覆盖配置文件中设置的级别，只有日志级别低于WARN的日志才输出
        logger.setLevel(Level.WARN);
        logger.debug("这是debug");
        logger.info("这是info");
        logger.warn("这是warn");
        logger.error("这是error");
        logger.fatal("这是fatal");
    }
}

例子（配置文件方式）

上面的例子，我们想要实现打印Log，但是每次都要写一遍，浪费时间和精力，所以，Log4j提供了另外一种方式来配置好我们的信息

创建一个名为log4j.properties的文件，此文件需要放在项目的根目录（约定），如果是maven项目，直接放在resources文件夹中即可

log4j.properties

#控制台
log4j.appender.Console=org.apache.log4j.ConsoleAppender
log4j.appender.Console.layout=org.apache.log4j.PatternLayout
log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

#log jdbc
log4j.logger.java.sql.ResultSet=INFO
log4j.logger.org.apache=WARN
log4j.logger.java.sql.Connection=DEBUG
log4j.logger.java.sql.Statement=DEBUG
log4j.logger.java.sql.PreparedStatement=DEBUG

#log mybatis设置
#log4j.logger.org.apache.ibatis=DEBUG
log4j.logger.org.apache.ibatis.jdbc=error
log4j.logger.org.apache.ibatis.io=info
log4j.logger.org.apache.ibatis.datasource=info

#springMVC日志
log4j.logger.org.springframework.web=WARN

# 文件输出配置
log4j.appender.A = org.apache.log4j.DailyRollingFileAppender
log4j.appender.A.File = D:/log.txt #指定日志的输出路径
log4j.appender.A.Append = true
log4j.appender.A.Threshold = DEBUG
log4j.appender.A.layout = org.apache.log4j.PatternLayout #使用自定义日志格式化器
log4j.appender.A.layout.ConversionPattern = %-d{yyyy-MM-dd HH:mm:ss}  [ %t:%r ] - [ %p ]  %m%n #指定日志的输出格式
log4j.appender.A.encoding=UTF-8 #指定日志的文件编码

#指定日志的输出级别与输出端
log4j.rootLogger=DEBUG,Console,A

#指定某个包名日志级别（不能超过上面定义的级别，否则日志不会输出）
log4j.logger.com.wan=DEBUG

之后使用的话就比较简单了

//Logger的初始化（这个推荐定义为全局变量，方便使用）
Logger logger = Logger.getLogger(Log4JTest.class);
//输出Log
logger.info("这是info");

参考链接：Log4j入门教程

lombok

简介

平常我们创建实体类的时候，需要get/set方法，极其麻烦，虽然IDEA等IDE都是有提供了快捷生成，不过，最好的解决方法还是省略不写

而lombok就是这样的一个框架，实现省略get/set方法，当然，lombok的功能不只有此，还有equal，toString方法也可以由此框架自动生成

lombok的原理是使用注解，之后就会在编译过程中，给Class文件自动加上get/set等方法

不过IDEA似乎无法识别，代码检查还是会报错，所以，使用IDEA的时候还得安装一个插件，在plugin搜索lombok，之后安装重启即可，如图

之后为Java项目添加依赖

<!-- https://mvnrepository.com/artifact/org.projectlombok/lombok -->
<dependency>
	<groupId>org.projectlombok</groupId>
	<artifactId>lombok</artifactId>
	<version>1.18.8</version>
	<scope>provided</scope>
</dependency>

使用示例

1.实体类省略get/set
估计Kotlin中的data关键字就是参照着lombok实现的

//这里我们只需要为类添加Data注解，就会自动生成对应属性的get/set方法，toString，equal等方法
@Data
public class User {
    private String username;
    private String password;
}

2.需要无参构造以及get/set方法

@Getter
@Setter
@NoArgsConstructor
public class User {
    private String username;
    private String password;
}

3.链式调用set方法

@Data
@Accessors(chain = true)
public class User {
    private String username;
    private String password;
}

//使用
User user = new User();
user.setUsername("helo").setPassword("123");

4.参数不为空

//如果调用此方法，就会抱一个空指针错误
public String print(@NotNull String str){
	...
}

5.只需要toString

@ToString(callSuper=true, includeFieldNames=true)
public class User {
    private String username;
    private String password;
	//省略的get/set方法
}

6.builder模式创建实体类对象

@Data
@Builder
public class User {
    private String username;
    private String password;
}
//使用
User user1 = User.builder().username("user1").password("123").build();

7.工具类

@UtilityClass
public class MyUtils{
	//会将此方法自动转为静态方法
	public void print(String str){
		...
	}
}
//使用
MyUtils.print("hello");

8.自动关闭流

public static void main(String[] args) throws Exception {
	//使用Cleanup会自动调用close方法
	@Cleanup InputStream in = new FileInputStream(args[0]);
	@Cleanup OutputStream out = new FileOutputStream(args[1]);
	byte[] b = new byte[1024];
	while (true) {
		int r = in.read(b);
		if (r == -1) break;
		out.write(b, 0, r);
	}
}

9.省略Logger时的初始化

@Log4j
@Log
public class User{
	//会自动添加此语句
	//Logger logger = Logger.getLogger(User.class);
	...
}

参考：
Lombok介绍、使用方法和总结
Lombok的使用详解