java 项目中如何读取和写入 CSV 文件

Java项目中读取和写入CSV文件的关键在于理解CSV格式的基本结构、选择合适的Java库和采取有效的数据处理策略。CSV文件以纯文本形式存储表格数据，其中的数据由逗号分隔，每一行代表表格中的一行数据。在Java中，最常用的库包括Apache Commons CSV和OpenCSV。这些库提供了简单、直观的API来处理CSV文件，使得读取和写入操作变得容易。选择合适的Java库是运用Java处理CSV文件的关键一步，不仅可以简化代码结构，还能提高数据处理的效率和安全性。

在本文中，将以Apache Commons CSV和OpenCSV为例，详细介绍如何在Java项目中读取和写入CSV文件。

一、使用Apache Commons CSV读取CSV文件

Apache Commons CSV是一个处理CSV数据的库，它提供了一系列的工具来轻松读取、解析和写入CSV文件。

1. 添加依赖

首先，需要在项目的pom.xml文件中添加Apache Commons CSV的依赖。

<dependency>

    <groupId>org.apache.commons</groupId>
    <artifactId>commons-csv</artifactId>
    <version>1.8</version>
</dependency>

2. 读取CSV文件

要读取CSV文件，首先需要创建一个CSVParser对象。CSVParser可以从文件、输入流或字符串中解析CSV数据。以下是使用CSVParser从文件中读取数据的示例代码。

import org.apache.commons.csv.CSVFormat;

import org.apache.commons.csv.CSVParser;
import org.apache.commons.csv.CSVRecord;
import java.io.Reader;
import java.nio.file.Files;
import java.nio.file.Paths;
public class CsvReaderExample {
    public static void mAIn(String[] args) {
        try {
            Reader reader = Files.newBufferedReader(Paths.get("your-csv-file-path.csv"));
            CSVParser csvParser = new CSVParser(reader, CSVFormat.DEFAULT.withFirstRecordAsHeader().withIgnoreHeaderCase().withTrim());
            for (CSVRecord csvRecord : csvParser) {
                String columnOne = csvRecord.get("Header1");
                String columnTwo = csvRecord.get("Header2");
                // 处理获取的数据
            }
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

在这个例子中，使用了带有Header的CSV格式。这意味着CSV文件的第一行会被当作头部处理，之后的每一行数据都按照这个头部的顺序来解析。

二、使用OpenCSV写入CSV文件

OpenCSV是另一个流行的库，它支持读取和写入CSV文件。相比Apache Commons CSV，OpenCSV在写入CSV文件时提供了更灵活的操作。

1. 添加依赖

首先，在pom.xml文件中添加OpenCSV的依赖。

<dependency>

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

2. 写入CSV文件

以下是使用OpenCSV将数据写入CSV文件的示例代码。

import com.opencsv.CSVWriter;

import java.io.Writer;
import java.nio.file.Files;
import java.nio.file.Paths;
import java.util.Arrays;
public class CsvWriterExample {
    public static void main(String[] args) {
        try {
            Writer writer = Files.newBufferedWriter(Paths.get("your-output-csv-file-path.csv"));
            CSVWriter csvWriter = new CSVWriter(writer);
            String[] headerRecord = {"Header1", "Header2"};
            csvWriter.writeNext(headerRecord);
            csvWriter.writeNext(new String[]{"Data1", "Data2"});
            csvWriter.writeNext(new String[]{"Data3", "Data4"});
            csvWriter.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

在这个例子中，首先构建了一个CSVWriter对象，并通过传递一个Writer实例来指定写入的文件路径。接着，使用writeNext方法写入数据，该方法接受一个字符串数组作为参数，每次调用都会写入CSV文件的一行。

三、总结与最佳实践

读取和写入CSV文件在Java中是一个相对直观的过程，但仍需要注意几个关键的最佳实践：

• 确保数据格式正确：读取或写入前，验证CSV文件格式是否与预期一致，特别是列名和列的顺序。
• 处理异常：在读取和写入过程中，可能会遇到各种异常，如文件不存在、文件损坏等，应适当处理这些异常，确保程序的健壮性。
• 资源管理：使用try-with-resources语句管理资源，确保打开的文件资源在使用后能够正确关闭。

通过遵循这些最佳实践，并利用Apache Commons CSV或OpenCSV等库，可以高效、安全地在Java项目中处理CSV文件。

相关问答FAQs：

1. 如何在 Java 项目中读取 CSV 文件？

读取 CSV 文件是在 Java 项目中常见的任务之一。可以按照以下步骤来完成：

a. 导入相关的库：首先，确保你的项目中已经添加了 Apache Commons CSV 或 OpenCSV 这些库的依赖。

b. 创建 CSVReader 对象：使用所选的库创建一个 CSVReader 对象，并将 CSV 文件的路径作为参数传递给它。

c. 逐行读取数据：使用 CSVReader 对象的 readNext() 方法，以行为单位读取 CSV 文件中的数据。此方法将返回一个包含当前行数据的字符串数组。

d. 处理数据：使用循环遍历返回的数据数组，以便处理和使用其中的每个元素。

2. 如何在 Java 项目中写入 CSV 文件？

在 Java 项目中写入 CSV 文件也是一项常见的任务。以下是一些指导：

a. 导入相关的库：确保你的项目中已经添加了 Apache Commons CSV 或 OpenCSV 这些库的依赖。

b. 创建 CSVWriter 对象：使用所选的库创建一个 CSVWriter 对象，并将 CSV 文件的路径以及一些配置参数（例如分隔符）传递给它。

c. 准备数据：创建一个包含要写入 CSV 文件的数据的列表或数组。

d. 写入数据：使用 CSVWriter 对象的 writeNext() 方法，将准备好的数据写入 CSV 文件中。

e. 关闭 CSVWriter 对象：完成写入后，不要忘记关闭 CSVWriter 对象以释放资源。

3. 如何处理 CSV 文件中可能存在的空值？

处理 CSV 文件中的空值是一个常见的问题。下面是几种常见的处理方式：

a. 使用默认值：在读取 CSV 文件时，检查数据中是否存在空值。如果存在，则可以选择将其替换为一个默认值，以便在代码中进行处理。

b. 跳过空行：在读取 CSV 文件时，可以选择跳过包含空值的行，只处理非空的行数据。

c. 进行数据清洗：在读取 CSV 文件之前，可以预处理数据，删除或替换特定的空值。例如，可以使用正则表达式或字符串方法来查找和替换空值。

d. 使用特殊标记：在数据中使用某种特殊标记来表示空值，例如 "N/A" 或 "-"。在读取和处理数据时，将特殊标记解释为空值。

最后建议，企业在引入信息化系统初期，切记要合理有效地运用好工具，这样一来不仅可以让公司业务高效地运行，还能最大程度保证团队目标的达成。同时还能大幅缩短系统开发和部署的时间成本。特别是有特定需求功能需要定制化的企业，可以采用我们公司自研的企业级低代码平台：织信Informat。 织信平台基于数据模型优先的设计理念，提供大量标准化的组件，内置AI助手、组件设计器、自动化（图形化编程）、脚本、工作流引擎（BPMN2.0）、自定义API、表单设计器、权限、仪表盘等功能，能帮助企业构建高度复杂核心的数字化系统。如ERP、MES、CRM、PLM、SCM、WMS、项目管理、流程管理等多个应用场景，全面助力企业落地国产化/信息化/数字化转型战略目标。