Java如何读取CSV文件并将数据放入对象中详解-海口c网

Java如何读取CSV文件并将数据放入对象中详解

article/2025/6/28 19:33:35

Java如何读取CSV文件并将数据放入对象中详解

CSV（Comma-Separated Values）文件是一种常见的数据存储格式，广泛应用于数据交换、日志记录和表格数据处理。在Java开发中，读取CSV文件并将数据映射到对象中是常见的需求。本文将详细介绍几种常见方法，包括手动解析、使用标准库（BufferedReader）、第三方库（如OpenCSV），以及通过反射实现动态映射，并结合代码示例和流程图说明。

在这里插入图片描述

一、CSV文件的基本结构

CSV文件由多行文本组成，每行代表一条记录，字段之间用逗号（,）分隔。例如：

姓名,年龄,城市
张三,25,北京
李四,30,上海
王五,22,广州

第一行：表头（字段名）。
后续行：数据行，字段值与表头一一对应。

二、手动解析CSV文件（使用`BufferedReader`）

1. 核心思路

通过BufferedReader逐行读取文件，使用split()方法分割字段，并手动将数据映射到对象中。

2. 代码示例

import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;public class CsvReader {public static void main(String[] args) {String csvFile = "data.csv";String line;String csvSplitBy = ",";try (BufferedReader br = new BufferedReader(new FileReader(csvFile))) {// 读取表头if ((line = br.readLine()) != null) {String[] headers = line.split(csvSplitBy);System.out.println("表头: " + String.join(", ", headers));}// 读取数据行while ((line = br.readLine()) != null) {String[] data = line.split(csvSplitBy);Person person = new Person(data[0], Integer.parseInt(data[1]), data[2]);System.out.println(person);}} catch (IOException e) {e.printStackTrace();}}
}class Person {private String name;private int age;private String city;public Person(String name, int age, String city) {this.name = name;this.age = age;this.city = city;}@Overridepublic String toString() {return "Person{name='" + name + "', age=" + age + ", city='" + city + "'}";}
}

3. 流程图说明

[读取CSV文件] → [逐行读取] → [分割字段] → [映射到对象] → [输出结果]

4. 优点与局限

优点：代码简单，无需依赖第三方库。
局限：
- 无法处理字段中的特殊字符（如逗号、换行符）。
- 需要手动处理类型转换（如String转int）。
- 不适合复杂场景（如嵌套对象、动态字段）。

三、使用Java标准库（`Files`和`Stream`）

1. 核心思路

利用Java 8+的Files.lines()和Stream API简化读取过程，结合split()方法分割字段。

2. 代码示例

import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.stream.Stream;public class StreamCsvReader {public static void main(String[] args) {String csvFile = "data.csv";String csvSplitBy = ",";try (Stream<String> stream = Files.lines(Paths.get(csvFile))) {stream.skip(1) // 跳过表头.forEach(line -> {String[] data = line.split(csvSplitBy);Person person = new Person(data[0], Integer.parseInt(data[1]), data[2]);System.out.println(person);});} catch (Exception e) {e.printStackTrace();}}
}

3. 流程图说明

[读取CSV文件] → [跳过表头] → [逐行处理] → [映射到对象] → [输出结果]

4. 优点与局限

优点：代码简洁，适合中小型文件。
局限：同样无法处理字段中的特殊字符。

四、使用第三方库（OpenCSV）

1. 核心思路

OpenCSV是一个专门处理CSV文件的库，支持自动映射到Java对象（POJO），并处理复杂场景（如字段中的逗号、引号）。

2. 添加依赖

Maven配置：

<dependency><groupId>com.opencsv</groupId><artifactId>opencsv</artifactId><version>5.5.2</version>
</dependency>

3. 代码示例

（1）定义POJO类

import com.opencsv.bean.CsvBindByName;public class Person {@CsvBindByName(column = "姓名")private String name;@CsvBindByName(column = "年龄")private int age;@CsvBindByName(column = "城市")private String city;// Getters and Setters@Overridepublic String toString() {return "Person{name='" + name + "', age=" + age + ", city='" + city + "'}";}
}

（2）读取CSV文件

import com.opencsv.bean.CsvToBean;
import com.opencsv.bean.CsvToBeanBuilder;
import java.io.FileReader;
import java.io.IOException;
import java.util.List;public class OpenCsvReader {public static void main(String[] args) {String csvFile = "data.csv";try (FileReader reader = new FileReader(csvFile)) {CsvToBean<Person> csvToBean = new CsvToBeanBuilder<Person>(reader).withType(Person.class).withIgnoreLeadingWhiteSpace(true).build();List<Person> persons = csvToBean.parse();persons.forEach(System.out::println);} catch (IOException e) {e.printStackTrace();}}
}

4. 流程图说明

[读取CSV文件] → [使用OpenCSV解析] → [自动映射到对象] → [输出结果]

5. 优点与局限

优点：
- 自动处理特殊字符（如逗号、引号）。
- 支持注解映射，代码简洁。
- 提供类型安全和错误处理。
局限：需要引入第三方库。

五、通过反射动态映射（高级方法）

1. 核心思路

利用Java反射机制动态获取字段名和值，适用于不确定字段结构的场景（如动态表单数据）。

2. 代码示例

import java.io.BufferedReader;
import java.io.FileReader;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;public class ReflectionCsvReader {public static <T> List<T> readCsv(String csvFile, Class<T> clazz) {List<T> result = new ArrayList<>();String line;String csvSplitBy = ",";try (BufferedReader br = new BufferedReader(new FileReader(csvFile))) {// 读取表头if ((line = br.readLine()) != null) {String[] headers = line.split(csvSplitBy);// 读取数据行while ((line = br.readLine()) != null) {String[] data = line.split(csvSplitBy);T obj = clazz.getDeclaredConstructor().newInstance();Field[] fields = clazz.getDeclaredFields();for (int i = 0; i < fields.length; i++) {Field field = fields[i];field.setAccessible(true);field.set(obj, data[i]);}result.add(obj);}}} catch (Exception e) {e.printStackTrace();}return result;}public static void main(String[] args) {List<Person> persons = readCsv("data.csv", Person.class);persons.forEach(System.out::println);}
}

3. 流程图说明

[读取CSV文件] → [动态获取字段] → [反射设置值] → [输出对象]

4. 优点与局限

优点：适用于动态字段场景，无需硬编码。
局限：
- 类型安全性差（如字段类型不匹配可能导致运行时错误）。
- 性能较低（反射操作较慢）。

六、处理特殊字符和编码问题

1. 字段中的特殊字符

如果字段值包含逗号（如"北京,中国"），需用双引号包裹字段，并手动解析：

姓名,年龄,城市
张三,25,"北京,中国"

2. 编码问题

确保文件编码与读取方式一致（如UTF-8）：

BufferedReader br = new BufferedReader(new InputStreamReader(new FileInputStream(csvFile), StandardCharsets.UTF_8)
);

七、最佳实践总结

方法	适用场景	优点	缺点
手动解析	简单场景	无需依赖库	无法处理复杂数据
`BufferedReader`	中小型文件	代码简单	需手动处理类型转换
OpenCSV	复杂场景	自动映射、处理特殊字符	需引入第三方库
反射动态映射	动态字段	灵活	性能低、类型安全差