Hutool 之 CsvUtil
发表于：2023-11-20浏览：22次TAG： #hutool
## 介绍
逗号分隔值（Comma-Separated Values，CSV，有时也称为字符分隔值，因为分隔字符也可以不是逗号），其文件以纯文本形式存储表格数据（数字和文本）。
Hutool针对此格式，参考FastCSV项目做了对CSV文件读写的实现(Hutool实现完全独立，不依赖第三方)
`CsvUtil`是CSV工具类，主要封装了两个方法：
* getReader 用于对CSV文件读取
* getWriter 用于生成CSV文件
这两个方法分别获取`CsvReader`对象和`CsvWriter`，从而独立完成CSV文件的读写。
#### 读取为CsvRow
```java
CsvReader reader = CsvUtil.getReader();
//从文件中读取CSV数据
CsvData data = reader.read(FileUtil.file("test.csv"));
List rows = data.getRows();
//遍历行
for (CsvRow csvRow : rows) {
//getRawList返回一个List列表，列表的每一项为CSV中的一个单元格（既逗号分隔部分）
Console.log(csvRow.getRawList());
}
```
`CsvRow`对象还记录了一些其他信息，包括原始行号等。
#### 读取为Bean列表
首先测试的CSV：`test_bean.csv`:
```
姓名,gender,focus,age
张三,男,无,33
李四,男,好对象,23
王妹妹,女,特别关注,22
```
2. 定义Bean：
```java
// lombok注解
@Data
private static class TestBean{
// 如果csv中标题与字段不对应，可以使用alias注解设置别名
@Alias("姓名")
private String name;
private String gender;
private String focus;
private Integer age;
}
```
3. 读取
```java
final CsvReader reader = CsvUtil.getReader();
//假设csv文件在classpath目录下
final List result = reader.read(
ResourceUtil.getUtf8Reader("test_bean.csv"), TestBean.class);
```
4. 输出：
```
CsvReaderTest.TestBean(name=张三, gender=男, focus=无, age=33)
CsvReaderTest.TestBean(name=李四, gender=男, focus=好对象, age=23)
CsvReaderTest.TestBean(name=王妹妹, gender=女, focus=特别关注, age=22)
```
### 生成CSV文件
```java
//指定路径和编码
CsvWriter writer = CsvUtil.getWriter("e:/testWrite.csv", CharsetUtil.CHARSET_UTF_8);
//按行写出
writer.write(
new String[] {"a1", "b1", "c1"},
new String[] {"a2", "b2", "c2"},
new String[] {"a3", "b3", "c3"}
);
```
