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

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 -> {
                      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
    @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.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	复杂场景	自动映射、处理特殊字符	需引入第三方库
反射动态映射	动态字段	灵活	性能低、类型安全差