「取消済みの注文が、返金確認一覧に出ていません」。取り込んだCSVを見ると、注文A-104の状態はCANCELLEDです。テストで同じ文字を直接書いて渡すと、一覧に出ます。注文状態の判定に==を使っていると、同じ文字が入っていても、値をどこから受け取ったかで結果が変わることがあります。
文字列の中身で判定するなら、Javaではequals()を使います。取消かどうかを確かめるなら"CANCELLED".equals(status)。台帳とCSVのように両方の値が変わる比較では、両方がnullのときも「同じ」としてよいかを先に決めます。
この記事でわかること
- 直書きのテストは通るのに、CSVから読んだ
CANCELLEDが==で漏れる理由 - 固定値との比較と、
nullになり得る二つの値の比較をどう書くか - 取消・支払済み・未入力の3件で、修正を確かめる方法
注文状態の比較を手元で試す
ZIPにはOrderStatusComparison.javaとREADMEを収録しています。JDK 17でjava OrderStatusComparison.javaを実行すると、直書き・CSV・空欄の比較結果を確認できます。コードの全文と実行結果は本文にも掲載しています。
ファイル名はjava-string-equals-comparison-sample.zipです。
直書きのテストは通るのに、CSVの取消注文が一覧から漏れる
この取込処理では、状態がCANCELLEDの注文だけを、経理が確認する一覧に載せます。PAIDは対象外で、状態が空欄の注文は情報不足です。空欄をnullとして取り込む前提で、まず3件の期待結果を決めます。
| 注文 | CSVの状態 | 返金確認一覧 |
|---|---|---|
| A-104 | CANCELLED | 載せる |
| A-105 | PAID | 載せない |
| A-106 | 空欄 | 載せず、入力不備として扱う |
もとの判定はstatus == CANCELLEDです。CANCELLEDはソース内で文字列リテラル"CANCELLED"を代入した定数です。テストも状態に同じリテラルを直接渡すとtrueになり、一覧に載ります。ところが配布サンプルでCSVの行A-104,CANCELLEDを分け、取り出した状態を渡すとfalseになります。
このケースでは、比較の直前に注文番号と状態を確認すると、どちらも文字はCANCELLEDです。まず見るべきなのは状態を取り出す行と、一覧に入れる条件です。CSVの値を手入力に差し替えると再現が消えるので、確認には実際の取込経路を通った値を残します。
==は同じ参照か、Stringのequalsは文字が同じかを確かめる
Stringの変数は、文字列オブジェクトを参照します。==が確かめるのは、二つの変数が同じオブジェクトを指すかどうかです。同じリテラル同士は同じオブジェクトを指します。CSVから読んだ値は、文字が同じでも、定数と同じオブジェクトを指すとは限りません。String.equals()は、別のオブジェクトでも文字の並びが同じならtrueです。
定数と、テストに直書きした値
同じ1つの参照先== true equals true
定数と、CSVから読んだ値
別々の参照先に同じ文字== false equals true
「CSVの値をもう一度定数に代入してから比べる」といった処理は要りません。画面入力や他システムから得たStringでも、注文状態として必要なのは文字の一致です。この例では大文字・小文字も区別するため、cancelledを同じ状態と認めるかどうかは別途、入力仕様で決めます。
取消かどうかは、固定値CANCELLEDからequalsを呼んで判定する
取消判定の修正前と修正後(比較式を取り出した説明例)
配布コードのprintRefundCandidateでは、status == CANCELLEDとCANCELLED.equals(status)をSystem.out.printfの引数へ直接渡しています。ここでは判定式だけに注目できるよう、結果をrefundCandidateへ代入する形で示します。
// 修正前
boolean refundCandidate = status == CANCELLED;
// 修正後
boolean refundCandidate = CANCELLED.equals(status);固定値CANCELLEDはnullにならないので、その側からequals()を呼びます。A-104はtrueになり、一覧に載ります。A-105のPAIDとA-106のnullはfalseで、一覧には載りません。
反対向きにstatus.equals(CANCELLED)と書くと、A-106ではnullからメソッドを呼ぶのでNullPointerExceptionになります。今回のサンプルは一覧の条件を検証します。実際の取込では、A-105の「支払済み」とA-106の「状態が空欄」を同じ結果として記録すると、後から不足データを追えません。入力不備を記録する処理は、取消かどうかの判定とは分けて置きます。
台帳とCSVを照合するときは、両方の空欄を一致に数えるか決める
取込前の台帳に記録された状態と、CSVで受け取った状態の差分を見るとします。Objects.equals(previousStatus, incomingStatus)なら、双方がnullでも例外にならず、trueを返します。「どちらも未入力なので、値に差はない」とみなす用途に合います。
一方、経理が「記録済みの状態を照合できた注文」だけにチェックを付けるなら、双方が空欄の行は確認済みにしません。台帳の値がnullでないことを確認し、その値からequals()を呼びます。CSV側だけがnullなら、そのequals()がfalseを返します。
記録済みの状態だけを照合する判定(抜粋)
return previousStatus != null && previousStatus.equals(incomingStatus);| 台帳 | CSV | Objects.equals | 記録済みの状態が一致 |
|---|---|---|---|
CANCELLED | CANCELLED | true | true |
CANCELLED | null | false | false |
null | null | true | false |
配布コードで、取消1件と対象外2件を確認する
ZIPを展開し、JDK 17でOrderStatusComparison.javaがあるフォルダを開きます。java OrderStatusComparison.javaを実行すると、直書きとCSV3件の判定に続けて、台帳とCSVの照合結果が出ます。外部ライブラリやデータベースは使いません。
OrderStatusComparison.javaの全文
import java.util.Objects;
public class OrderStatusComparison {
private static final String CANCELLED = "CANCELLED";
public static void main(String[] args) {
String cancelledFromCsv = readStatus("A-104,CANCELLED");
String paidFromCsv = readStatus("A-105,PAID");
String missingFromCsv = readStatus("A-106,");
printRefundCandidate("直書きのテスト値", "CANCELLED");
printRefundCandidate("CSVのA-104", cancelledFromCsv);
printRefundCandidate("CSVのA-105", paidFromCsv);
printRefundCandidate("CSVのA-106", missingFromCsv);
System.out.println("記録済みの取消とCSVの取消の値は同じ: "
+ Objects.equals(CANCELLED, cancelledFromCsv));
System.out.println("片方だけ未入力の場合、値は同じ: "
+ Objects.equals(CANCELLED, missingFromCsv));
System.out.println("両方未入力の場合、値は同じ: "
+ Objects.equals(null, missingFromCsv));
System.out.println("両方未入力の場合、記録済みの値が一致: "
+ hasSameRecordedStatus(null, missingFromCsv));
System.out.println("両方に取消の記録がある場合、記録済みの値が一致: "
+ hasSameRecordedStatus(CANCELLED, cancelledFromCsv));
}
private static String readStatus(String csvRow) {
// 練習用の2列。引用符やフィールド内のカンマは扱わない。
String[] fields = csvRow.split(",", -1);
return fields[1].isEmpty() ? null : fields[1];
}
private static void printRefundCandidate(String source, String status) {
System.out.printf("%s(%s): == %b / equals %b%n",
source, status, status == CANCELLED, CANCELLED.equals(status));
}
private static boolean hasSameRecordedStatus(String previousStatus, String incomingStatus) {
return previousStatus != null && previousStatus.equals(incomingStatus);
}
}実行結果9行
直書きのテスト値(CANCELLED): == true / equals true
CSVのA-104(CANCELLED): == false / equals true
CSVのA-105(PAID): == false / equals false
CSVのA-106(null): == false / equals false
記録済みの取消とCSVの取消の値は同じ: true
片方だけ未入力の場合、値は同じ: false
両方未入力の場合、値は同じ: true
両方未入力の場合、記録済みの値が一致: false
両方に取消の記録がある場合、記録済みの値が一致: true2行目を見てください。A-104は== false / equals trueです。判定を修正する前は漏れ、修正後は載ることを、この1行で確認できます。続くA-105・A-106のequals falseは、対象外の注文が増えていないことの確認です。A-106の入力不備を記録する部分はサンプルに含めていません。
同じファイルでCANCELLED.equals(status)をstatus == CANCELLEDに戻すと、A-104の後半もfalseになります。元に戻し、今度はstatus.equals(CANCELLED)にすると、A-106でNullPointerExceptionが出ます。どちらも確認したら、固定値から呼ぶ形に戻してください。
readStatusは、学習用の2列から状態を取り出すだけです。split(",", -1)で末尾の空欄を残し、空文字をnullにしています。実際のCSVにカンマや改行を含む項目がある場合は、プロジェクトで使っているCSVパーサーで列を取得してから同じ比較を行います。
レビューでは、どこから来た値を試し、空欄をどう扱ったか伝える
画面の確認だけで終えると、一覧に出なかった注文を見落としやすくなります。レビューには入力行と期待結果を添えます。「A-104のCANCELLEDはCSVから取り込んでも一覧に出る、A-105は支払済みなので出さない、A-106は状態が未入力なので一覧とは別に確認する」と言えば、比較と運用の両方を確認できます。
- 直書きの値だけでなく、取込経路から得た
CANCELLEDで確認した。 - 状態が空欄でも例外にならず、入力不備として追える扱いを決めた。
- 台帳もCSVも空欄のとき、値の差分と確認済みの判定を区別した。
Stringの参照と内容の違いから復習したい場合は、『スッキリわかるJava入門 第5版』で、変数に参照を入れる意味を確認してから、このCSV例に戻るとつながります。
スッキリわかるJava入門 第5版
変数・条件分岐から、クラスの基本まで学ぶ一冊。
豊富な図とサンプルで、変数、条件分岐、クラス、例外処理まで順番に学べます。Javaの最初の教科書を探している人向けです。
- Javaを基礎から体系的に学びたい
- Java 25 LTS対応の入門書を選びたい
当サイトはAmazonアソシエイト・プログラムの参加者です。価格・在庫・配送条件はAmazonでご確認ください。
この記事とあわせて読みたい
Stringの中身はequalsで比べ、未入力の扱いは仕様で決める
取消かどうかを判定するにはCANCELLED.equals(status)。台帳とCSVの差分では、両方が空欄なら「差はない」と扱うのか、「まだ照合できない」と扱うのかを先に決めます。修正後は、CSVから読んだ取消注文と、支払済み・空欄の注文を一緒に試してください。



