この実験（Lab）では、Java で CSV（Comma-Separated Values、カンマ区切り値）ファイルを読み込む方法を学びます。CSV は、スプレッドシートやデータベースのエクスポートなど、表形式のデータを保存するために使用される一般的なファイル形式です。CSV ファイルの各行はデータの行を表し、列はカンマで区切られています。
Java で CSV ファイルを読み込むための 3 つの異なるアプローチを検討します。
java.ioパッケージのBufferedReaderクラスを使用するjava.utilパッケージのScannerクラスを使用するこの実験（Lab）の終わりには、特定の要件に基づいて、Java アプリケーションで CSV ファイルを読み込むための最も適切な方法を選択できるようになります。
CSV ファイルを読み始める前に、プロジェクトが適切に設定されていることを確認しましょう。このステップでは、CSV ファイルの構造を調べ、メインの Java クラスを作成します。
CSV（Comma-Separated Values、カンマ区切り値）ファイルは、表形式のデータをプレーンテキストで保存します。各行は 1 つの行を表し、列はカンマで区切られています。CSV ファイルは、Excel、Google Sheets、データベースシステムなど、多くのアプリケーションとの互換性とシンプルさから、データ交換に広く使用されています。
この実験（Lab）環境には、すでに~/project/sample.csvにサンプル CSV ファイルが含まれています。まず、その内容を見てみましょう。
cat ~/project/sample.csv次のような出力が表示されるはずです。
name,age,city
John,25,New York
Alice,30,Los Angeles
Bob,28,Chicago
Eve,22,Bostonこの CSV ファイルには、人々の名前、年齢、都市に関する情報を含む 4 行のデータ（ヘッダー行を含む）が含まれています。
次に、この実験（Lab）全体で使用するsrcディレクトリに、CSVReaderDemo.javaという名前の新しい Java クラスを作成しましょう。
VSCode で、サイドバーの Explorer アイコンをクリックし、~/project/srcディレクトリに移動し、右クリックして「New File」を選択します。ファイル名をCSVReaderDemo.javaとします。
ファイルに次の基本的な構造を追加します。
public class CSVReaderDemo {
public static void main(String[] args) {
System.out.println("CSV Reader Demo");
// We will add CSV reading code here in the next steps
}
}
すべてが正しく設定されていることを確認するために、Java クラスをコンパイルして実行しましょう。
cd ~/project
javac -d . src/CSVReaderDemo.java
java CSVReaderDemo次のような出力が表示されるはずです。
CSV Reader Demo素晴らしい！これでプロジェクト構造の準備ができました。次のステップでは、CSV ファイルを読み込むためのさまざまなメソッドを実装します。
このステップでは、java.ioパッケージのBufferedReaderクラスを使用して CSV ファイルを読み込む最初の方法を実装します。これは、Java でテキストファイルを読み込むための一般的で簡単な方法です。
BufferedReaderは、文字入力ストリームからテキストを読み込み、文字をバッファリングして、文字、配列、および行を効率的に読み込むクラスです。バッファサイズを指定することも、デフォルトサイズを使用することもできます。
CSVReaderDemo.javaファイルを更新して、BufferedReader を使用して CSV ファイルを読み込みましょう。ファイルのすべての内容を次のコードに置き換えます。
import java.io.BufferedReader;
import java.io.FileReader;
import java.io.IOException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
public class CSVReaderDemo {
public static void main(String[] args) {
System.out.println("Reading CSV using BufferedReader");
// Path to our CSV file
String csvFile = "sample.csv";
// Lists to store our data
List<List<String>> data = new ArrayList<>();
// Try-with-resources to ensure the reader gets closed automatically
try (BufferedReader br = new BufferedReader(new FileReader(csvFile))) {
String line;
// Read each line from the file
while ((line = br.readLine()) != null) {
// Split the line by comma and convert to a List
String[] values = line.split(",");
List<String> lineData = Arrays.asList(values);
// Add the line data to our main list
data.add(lineData);
}
// Print the data we read
System.out.println("\nData read from CSV file:");
for (int i = 0; i < data.size(); i++) {
List<String> row = data.get(i);
System.out.println("Row " + i + ": " + String.join(", ", row));
}
} catch (IOException e) {
System.err.println("Error reading the CSV file: " + e.getMessage());
e.printStackTrace();
}
}
}
更新されたコードをコンパイルして実行しましょう。
cd ~/project
javac -d . src/CSVReaderDemo.java
java CSVReaderDemo次のような出力が表示されるはずです。
Reading CSV using BufferedReader
Data read from CSV file:
Row 0: name, age, city
Row 1: John, 25, New York
Row 2: Alice, 30, Los Angeles
Row 3: Bob, 28, Chicago
Row 4: Eve, 22, Bostonsample.csv）を定義します。List<List<String>>を作成します。BufferedReaderを自動的に閉じるために、try-with-resources ブロックを使用します。br.readLine()を使用して、ファイルから各行を読み込みます。line.split(",")を使用してカンマで分割し、Listに変換します。BufferedReaderアプローチは、CSV ファイルを含むテキストファイルを読み込むためにシンプルで効率的です。ただし、引用符で囲まれたカンマや改行を含むフィールドなど、より複雑な CSV フォーマットを扱う場合には制限があります。
次のステップでは、Scannerクラスを使用した別の方法を検討します。
このステップでは、java.utilパッケージのScannerクラスを使用して CSV ファイルを読み込む 2 番目の方法を実装します。Scanner クラスは、さまざまなソースからフォーマットされた入力を読み込むための便利な方法を提供します。
Scannerクラスは、区切り文字パターンを使用して入力をトークンに分割します。デフォルトでは、これは空白に一致します。次に、さまざまなnextメソッドを使用して、結果のトークンをさまざまな型の値に変換できます。
CSVReaderDemo.javaファイルを更新して、Scanner を使用して CSV ファイルを読み込みましょう。ファイルのすべての内容を次のコードに置き換えます。
import java.io.File;
import java.io.FileNotFoundException;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.List;
import java.util.Scanner;
public class CSVReaderDemo {
public static void main(String[] args) {
System.out.println("Reading CSV using Scanner");
// Path to our CSV file
String csvFile = "sample.csv";
// Lists to store our data
List<List<String>> data = new ArrayList<>();
try (Scanner scanner = new Scanner(new File(csvFile))) {
// Read each line from the file
while (scanner.hasNextLine()) {
String line = scanner.nextLine();
// Split the line by comma and convert to a List
String[] values = line.split(",");
List<String> lineData = Arrays.asList(values);
// Add the line data to our main list
data.add(lineData);
}
// Print the data we read
System.out.println("\nData read from CSV file:");
for (int i = 0; i < data.size(); i++) {
List<String> row = data.get(i);
System.out.println("Row " + i + ": " + String.join(", ", row));
}
} catch (FileNotFoundException e) {
System.err.println("CSV file not found: " + e.getMessage());
e.printStackTrace();
}
}
}更新されたコードをコンパイルして実行しましょう。
cd ~/project
javac -d . src/CSVReaderDemo.java
java CSVReaderDemo次のような出力が表示されるはずです。
Reading CSV using Scanner
Data read from CSV file:
Row 0: name, age, city
Row 1: John, 25, New York
Row 2: Alice, 30, Los Angeles
Row 3: Bob, 28, Chicago
Row 4: Eve, 22, Bostonsample.csv）を定義します。List<List<String>>を作成します。Scannerを自動的に閉じるために、try-with-resources ブロックを使用します。scanner.hasNextLine()が true を返す限り、scanner.nextLine()を使用してファイルから各行を読み込みます。line.split(",")を使用してカンマで分割し、Listに変換します。Scannerアプローチは、BufferedReaderアプローチと似ていますが、さまざまな種類のデータを解析するためのより便利なメソッドを提供します。ただし、BufferedReaderと同様に、複雑な CSV フォーマットを扱う場合には制限があります。
次のステップでは、より複雑な CSV フォーマットをより効果的に処理する OpenCSV ライブラリを使用した、より堅牢なアプローチを検討します。
このステップでは、OpenCSV ライブラリを使用して CSV ファイルを読み込む 3 番目の方法を実装します。OpenCSV は、引用符で囲まれたカンマや改行を含むフィールドなど、複雑なシナリオを処理する、堅牢な CSV 解析機能を提供するサードパーティライブラリです。
OpenCSV は、すべての基本的な CSV 形式のバリエーションをサポートする、Java 用の CSV パーサーライブラリです。これまでの方法とは異なり、OpenCSV は、カンマ、改行、およびその他の特殊文字を含む引用符で囲まれたフィールドを適切に処理します。これらの文字は、そうでない場合は、カンマによる単純な分割を壊してしまいます。
まず、OpenCSV ライブラリとその依存関係をダウンロードしましょう。
cd ~/project
mkdir -p lib
curl -L -o lib/opencsv-5.7.1.jar https://repo1.maven.org/maven2/com/opencsv/opencsv/5.7.1/opencsv-5.7.1.jar
curl -L -o lib/commons-lang3-3.12.0.jar https://repo1.maven.org/maven2/org/apache/commons/commons-lang3/3.12.0/commons-lang3-3.12.0.jar
curl -L -o lib/commons-text-1.10.0.jar https://repo1.maven.org/maven2/org/apache/commons/commons-text/1.10.0/commons-text-1.10.0.jar
curl -L -o lib/commons-beanutils-1.9.4.jar https://repo1.maven.org/maven2/commons-beanutils/commons-beanutils/1.9.4/commons-beanutils-1.9.4.jar
curl -L -o lib/commons-collections-3.2.2.jar https://repo1.maven.org/maven2/commons-collections/commons-collections/3.2.2/commons-collections/3.2.2.jar
curl -L -o lib/commons-logging-1.2.jar https://repo1.maven.org/maven2/commons-logging/commons-logging/1.2/commons-logging-1.2.jarカンマを含む引用符で囲まれたフィールドを含む、より複雑な CSV ファイルを作成しましょう。
echo 'name,description,price
"Laptop","High-performance laptop, with SSD",999.99
"Smartphone","Latest model, with dual camera",499.99
"Headphones","Noise-canceling, wireless",149.99' > ~/project/products.csv次に、CSVReaderDemo.javaファイルを更新して、OpenCSV を使用して CSV ファイルを読み込みましょう。ファイルのすべての内容を次のコードに置き換えます。
import com.opencsv.CSVReader;
import com.opencsv.exceptions.CsvValidationException;
import java.io.FileReader;
import java.io.IOException;
public class CSVReaderDemo {
public static void main(String[] args) {
System.out.println("Reading CSV using OpenCSV");
// Path to our CSV file with complex data
String csvFile = "products.csv";
try (CSVReader reader = new CSVReader(new FileReader(csvFile))) {
// Read and print the header
String[] header = reader.readNext();
if (header != null) {
System.out.println("\nHeader: " + String.join(", ", header));
}
// Read and print each line
String[] nextLine;
int rowNumber = 1;
System.out.println("\nData read from CSV file:");
while ((nextLine = reader.readNext()) != null) {
System.out.println("Row " + rowNumber + ":");
for (int i = 0; i < nextLine.length; i++) {
System.out.println(" " + header[i] + ": " + nextLine[i]);
}
rowNumber++;
System.out.println();
}
} catch (IOException | CsvValidationException e) {
System.err.println("Error reading the CSV file: " + e.getMessage());
e.printStackTrace();
}
}
}更新されたコードをコンパイルして実行しましょう。
cd ~/project
javac -cp ".:lib/*" -d . src/CSVReaderDemo.java
java -cp ".:lib/*" CSVReaderDemo次のような出力が表示されるはずです。
Reading CSV using OpenCSV
Header: name, description, price
Data read from CSV file:
Row 1:
name: Laptop
description: High-performance laptop, with SSD
price: 999.99
Row 2:
name: Smartphone
description: Latest model, with dual camera
price: 499.99
Row 3:
name: Headphones
description: Noise-canceling, wireless
price: 149.99products.csv）を定義します。CSVReaderオブジェクトを作成します。reader.readNext()を使用してヘッダー行を読み込み、後で使用するために保存します。reader.readNext()を使用して、行がなくなるまでループで各行を読み込みます。OpenCSV ライブラリは、引用符で囲まれたカンマを含むフィールドを正しく解析し、複雑な CSV フォーマットを自動的に処理します。これにより、複雑なデータを含む可能性のある実際の CSV ファイルに最適です。
OpenCSV は、基本的な方法よりもいくつかの利点を提供します。
CSV ファイルを扱うほとんどの実際のアプリケーションでは、OpenCSV のような専用ライブラリを使用することが推奨されるアプローチです。
この実験では、Java で CSV ファイルを読み込むための 3 つの異なるアプローチを検討しました。
各アプローチには、それぞれの強みとユースケースがあります。
これらの異なるアプローチを理解することで、特定の要件と CSV データの複雑さに基づいて、最も適切な方法を選択できます。
CSV ファイルは、データ処理、データ交換、およびデータ統合のシナリオで広く使用されています。CSV ファイルを読み込んで処理する能力は、Java 開発者にとって、特にデータ中心のアプリケーションや他のシステムとの統合において、貴重なスキルです。
