Java实现读取CSV文件并将数据放入对象

目录

• 一、CSV文件的基本结构
• 二、手动解析CSV文件（使用BufferedReader）
• 三、使用Java标准库（Files和Stream）
• 四、使用第三方库（OpenCSV）
• 五、通过反射动态映射（高级方法）
• 六、处理特殊字符http://www.devze.com和编码问题
• 1. 字段中的特殊字符
• 2. 编码问题
• 七、最佳实践总结
• 八、总结

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;
    }

    @Override
    public 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 -&编程gt; {
                      String[] data = line.split(csvSplitBy);
                      Person person = new Person(data[0], In编程客栈teger.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
    @Override
    public 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.FileReade编程r;
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)
);

七、最佳实践总结

八、总结

读取CSV文件并将数据映射到对象中是Java开发中的常见需求。根据项目需求选择合适的方法：

• 简单场景：使用BufferedReader或Stream API。
• 复杂场景：优先使用OpenCSV等第三方库。
• 动态字段：结合反射实现动态映射。

通过合理处理特殊字符和编码问题，开发者可以高效完成CSV数据的解析与对象化，为后续的数据处理和分析提供坚实基础。

到此这篇关于Java实现读取CSV文件并将数据放入对象的文章就介绍到这了,更多相关Java读取CSV内容请搜索编程客栈(www.devze.com)以前的文章或继续浏览下面的相关文章希望大家以后多多支持编程客栈(www.devze.com)！