【Salesforce】ApexでSwitch文を各方法｜具体例付き

✔以下の疑問をお持ちの方へ向けた記事です

「Salesforce ApexにおけるSwitch文の使用方法は？」
「Switch文の基本的な構文とはどのようなものか？」
「ApexでSwitch文を使用する際の具体的なコーディング例を見てみたい」

✔当記事を読むことで得られる知識

• Salesforce ApexにおけるSwitch文の基本構文
• Switch文の効果的な使用方法
• ApexでのSwitch文を使用した具体的なコード例

当記事では、Salesforceの開発言語であるApexにおけるSwitch文の使い方について詳しく解説します。

Switch文は、複数の条件分岐を扱う際に役立ち、コードの可読性と効率を高められるもの。

Salesforce開発者やApexを学び始めた方々にとって、実践的なガイドとなる内容です。

ぜひ最後までご覧ください。

Switchステートメントの基本

こちらでは、Switchステートメントの基本について解説します。

とくにApexにおけるプログラミング時に重要な役割を果たすSwitchステートメントの理解は、条件分岐を行う際に非常に役立つでしょう。

• Switchステートメントとは何か
• ApexにおけるSwitchの役割と重要性
• SwitchとIf-Elseステートメントの比較

Switchステートメントとは何か

Switchステートメントは、特定の値に基づいて、適したコードブロックを実行するための条件分岐文です。

例えば、ある変数dayが週の各曜日を表す文字列を保持している場合の例を見てみましょう。

以下のようにSwitchステートメントを使用して、曜日ごとに異なるアクションを実行できます。

String day = 'Monday';
switch on day {
  when 'Monday' {
    // 月曜日の処理
  }
  when 'Tuesday' {
    // 火曜日の処理
  }
  // ...
  when else {
  }
}

Switchステートメントは、複数の値に対する処理を一箇所にまとめられるため、コードの可読性と管理を大幅に向上させます。

ApexにおけるSwitchの役割と重要性

Apexでのプログラム開発において、Switchステートメントは非常に有用です。

なぜならビジネスロジックを表現する際に、それぞれの条件下で異なる動作をさせたいときが多いからです。

例えば、あるフィールドでユーザーの状態を保存しているとします。

Switch文によって、ユーザーのステータスによるコードを実行しましょう。

String userStatus = 'Application';
switch on userStatus {
  when 'Application' {
    // 申込み時の処理
  }
  when 'Registration' {
    // 登録時の処理
  }
  // ...
}

このようにSwitchステートメントを使用することで、Apexコードの可視性と保守性を高められます。

SwitchとIf-Elseステートメントの比較

SwitchステートメントとIf-Elseステートメントは、どちらも条件に応じて異なるコードを実行するものですが、いくつかの違いがあります。

• Switch: 単一の変数に対して多くの値をチェックする場合に適しています
• If-Else: より複雑な条件式や範囲のチェックに優れています

例えば、成績に応じて評定を表示するケースを考えると、Switchステートメントは次のように記述できます。

String grade = 'A';
switch on grade {
  when 'A' {
    // A評定の場合の処理
  }
  when 'B' {
    // B評定の場合の処理
  }
  // ...
}

If-Elseステートメントを使用する場合は、次のようになります。

String grade = 'A';
if (grade == 'A') {
  // A評定の場合の処理
} else if (grade == 'B') {
  // B評定の場合の処理
} // ...

Switchステートメントは値を一括して管理し、コードの可読性を高めますが、If-Elseはより複雑な条件や論理結合が必要な場合に強みを発揮します。

Switchステートメントの基本構文

Switchステートメントの基本構文について学ぶことは、Apexにおける効率的なプログラムの作成に不可欠です。

正しく構文を理解し使用することで、コードの整理と簡略化に寄与します。

• Switchステートメントの書き方
• ケースとデフォルトの使用
• 複数条件のハンドリング

Switchステートメントの書き方

Switchステートメントを書く際には、特定の書式に従いましょう。

以下は基本的なSwitchステートメントの構造を表しています。

switch on expression {
  when value1 {
    // expressionがvalue1と一致した時の処理
  }
  when value2 {
    // expressionがvalue2と一致した時の処理
  }
  // 他のケース...
  when else {
    // いずれの値にも一致しなかった時の処理
  }
}

ここでexpressionは評価される式を、value1, value2はexpressionと比較される値を表します。

when elseはどのケースにも該当しない場合のデフォルト処理となります。

ケースとデフォルトの使用

Switchステートメントの中心的な要素は「ケース」と「デフォルト」です。

• 「ケース」: 指定された値に応じて特定のコードを実行する部分を指す
• 「デフォルト」: どのケースにも該当しない時に実行されるコードを意味する

例として、業務の優先順位に応じた通知処理をSwitchステートメントを使って実装する場合は以下のようになります。

String priority = 'High';
switch on priority {
  when 'High' {
    // 高優先度の通知処理
  }
  when 'Medium' {
    // 中優先度の通知処理
  }
  when 'Low' {
    // 低優先度の通知処理
  }
  when else {
    // 特定の優先度に該当しない場合の処理
  }
}

このようにケースごとに処理を分け、「when else」を用いて例外的な状況も対処できます。

複数条件のハンドリング

Switchステートメントでは、ひとつのケースに複数の値を指定することが可能です。

これにより、異なる入力値でも同じ処理を実行するケースを簡単に記述できます。

例えば、休日かどうかに応じた挨拶メッセージを出力するコードは次のようになります。

String day = 'Saturday';
switch on day {
  when 'Saturday', 'Sunday' {
    System.debug('週末です。');
  }
  when else {
    System.debug('平日です。');
  }
}

このコードではSaturdayとSundayは週末を意味し、どちらの場合も「週末です。」というメッセージを出力します。

それ以外の日は「平日です。」と出力されます。

Switchステートメントの応用例

Switchステートメントは単に値の比較だけに限定されず、実際の開発現場においてさまざまな応用が可能です。

ここではとくにビジネスロジックの分岐処理、複雑な条件式の簡素化、およびパフォーマンスと可読性の向上に焦点を当ててみましょう。

• ビジネスロジックの分岐処理
• 複雑な条件式の簡素化
• Enumを活用したロジックの実現
• パフォーマンスと可読性の向上

ビジネスロジックの分岐処理

Switchステートメントは、ビジネスロジック内での決定木の構築に適しています。

例えば、商品の種類によって異なる価格計算ロジックを適用する必要がある場合、Switchステートメントを使用して次のように記述できます。

String productType = 'Book';
Double price;
switch on productType {
  when 'Book' {
    price = basePrice * 0.9;
  }
  when 'Electronics' {
    price = basePrice * 0.8;
  }
  when 'Clothing' {
    price = basePrice + 10.0;
  }
  when else {
    price = basePrice;
  }
}
System.out.println('The price is: ' + price);

商品ごとに異なる価格計算のロジックが導入されており、その結果を出力しています。

複雑な条件式の簡素化

Switchステートメントを使うことで、通常のif-else文を使った場合よりもより簡潔に複雑な条件式を表現することが可能です。

例えば、ユーザーの権限レベルに応じてアクセス可能な機能を制御する場合、次のようにSwitchステートメントを利用します。

String userRole = 'Manager';
switch on userRole {
  when 'Admin', 'Manager' {
    // 管理者とマネージャーがアクセス可能な機能
  }
  when 'Staff' {
    // スタッフがアクセス可能な機能
  }
  when else {
    // その他のユーザーがアクセス可能な機能
  }
}

このケースではAdminとManagerが同じアクセス権限を持ち、Staff以下のロールでは限定されたアクセス権限が設定されます。

Enumを活用したロジックの実現

Enumを活用して、ビジネスロジックを構築します。

ステップとしては以下の3ステップです。

1. ステートとしてのEnumを定義
2. Enum作成の条件分岐
3. Enumを受取り、条件ごとの処理（Switch文）

ステートとしてのEnumを定義

まずはステートとしてのEnumを定義します。

public enum Status {
    NEW, IN_PROGRESS, COMPLETED, ON_HOLD
}

Enum作成の条件分岐

条件に応じたEnumを返す関数を定義しましょう。

以下はリードのStatusを受け取る処理にしています。

public static Status evaluateStatus(Lead lead){
    if (Lead.Status == 'Something NEW'){
        return Status.NEW;
    } else if (Lead.Status == 'Something IN PROGRESS'){
        return Status.IN_PROGRESS;
    } //このまま続けます
}

Enumを受取り、条件ごとの処理（Switch文）

Swtich文でEnumにより適切なコードを実行します。

public static void updateTaskStatus(Lead lead) {
    switch on evaluateStatus(lead) {
        when NEW {
            // 新しいタスクの処理
            System.debug('Processing new task');
        }
        when IN_PROGRESS {
            // 進行中のタスクの処理
            System.debug('Processing task in progress');
        }
        when COMPLETED {
            // 完了したタスクの処理
            System.debug('Processing completed task');
        }
        when ON_HOLD {
            // 保留中のタスクの処理
            System.debug('Processing task on hold');
        }
        when else {
            // 未定義のステータス
            System.debug('Unknown status');
        }
    }
}

パフォーマンスと可読性の向上

Switchステートメントは実行効率が高いため、多数の条件分岐が必要な場合にもパフォーマンスを落とさずに処理が可能。

またコードの可読性も向上するため、複数人での開発や後期の保守時にもメリットがあります。

ユーザーからの入力に応じたメッセージ応答をSwitchステートメントで対応する場合は以下のようになります。

String userInput = 'Help';
switch on userInput {
  when 'Start', 'Go' {
    // 開始関連の処理
  }
  when 'Stop', 'End' {
    // 停止関連の処理
  }
  when 'Help' {
    // ヘルプ表示
  }
  when else {
    // その他の入力に対するデフォルトの応答
  }
}

ここで、異なる語彙が同じ意味を持つ（例：’Start’と’Go’）場合でも、Switchステートメントはそれを効率的に処理します。

Switchステートメントのベストプラクティス

Switchステートメントを使用する際には、適切なベストプラクティスに従うことが、コードの質の保持と効率的な開発につながります。

• Switchの使用時の注意点
• メンテナンスと拡張性の考慮
• リファクタリングとコード最適化

Switchの使用時の注意点

Switchステートメントを使用する際には、特定の点に注意する必要があります。

• ケースごとにbreakステートメント（Apexの場合は不要）を忘れずに記述する
• 意図的なフォールスルー（一つのケースに続いて次のケースも実行させること）をおこなわない
• 可能な限りwhen elseブロックを用いて、予期せぬ入力への対策を施す

メンテナンスと拡張性の考慮

Switchステートメントを設計する際は、将来的な拡張や改修を容易にするために、柔軟性と保守性を考慮することが望ましいです。

できるだけ各ケースは独立性を持たせ、共有されるべきロジックは別のメソッドに抽出し、再利用性と可読性を高められます。

リファクタリングとコード最適化

コードベースが成熟するにつれて、定期的にリファクタリングをおこない、Switchステートメントの効率をさらに高められます。

• 未使用のケースの削除
• より効率的なデータ構造への変更

また、パターンマッチング等の新しいプログラミング機能を活用して、より効率的なコードへと最適化することも考えられます。

Switchステートメントのトラブルシューティング

Switchステートメントは便利なツールではありますが、場合によってはエラーや不具合の原因にもなり得ます。

• 一般的なSwitch関連のエラー
• デバッグとエラー処理
• コーディングミスとその回避

一般的なSwitch関連のエラー

Switchステートメントを使用する際には、特定の一般的なエラーに注意する必要があります。

そのひとつが「case」や「when」の節で想定外の値を扱った場合のエラーです。

また、Apexの場合「when」ブロックが予期せずエラーを起こしたとき、別の問題があることを示しているかもしれません。

例えば、以下のようなコードではNullPointerExceptionが発生する可能性があります。

String someVariable = null;
switch on someVariable {
  when 'ValueA' {
    // 何かの処理
  }
  // ...
  when else {
    // デフォルトの処理
  }
}

コードにnull対策がない場合、NullPointerExceptionがスローされます。

Switchステートメントを実装する前に、変数がnullでないことを確認するなどのエラーハンドリングが重要です。

デバッグとエラー処理

Switchステートメントで発生するエラーをデバッグするためには、以下のような方法でエラー箇所の特定が可能です。

• Apexのデバッグログやシステムのトレース機能を活用
• 「System.debug」を使用して変数の状態をログに記録する

例えば、ステートメントが期待通りに機能していない場合は、以下のようにデバッグステートメントを挿入、問題の特定に役立てます。

String userRole = 'Admin';
switch on userRole {
  when 'Admin' {
    System.debug('Admin Access Granted');
    // 管理者アクセスの処理
  }
  // ...
  when else {
    System.debug('Default Access');
    // デフォルトのアクセス処理
  }
}

デバッグログを確認することで、Switchステートメントが正確にどのケースを実行し、どれをスキップしたかを知れるでしょう。

コーディングミスとその回避

Switchステートメントのコーディングミスを回避するためには、コードレビューを定期的におこないましょう。

一貫性のあるコーディング標準に従うことが効果的といえます。

ケース値をハードコードする代わりに、Enumなどを活用すれば、タイプミスなども減らせます。

まとめ

SwitchステートメントはApexにおけるプログラミングの基本的な構造のひとつです。

その柔軟性と効率性により、さまざまな状況において便利なツールとなります。

初心者から経験豊富な開発者まで、Switchステートメントにより、堅牢で読みやすいコードを書けるでしょう。

また、Switchステートメントの使用に当たっては適切なエラーハンドリングとデバッグが不可欠であり、これによりコードの信頼性を高められます。