Apex 入門
学習の目的
この単元を完了すると、次のことができるようになります。
- Apex プログラミング言語の主要な機能を説明する。
- Apex クラスを保存し、匿名 Apex を使用してメソッドをコールする。
- Web コンソールを使用してデバッグログを調査する。
始める前に
Apex のワクワクする冒険に一緒に出かけましょう。このモジュールでは、プログラミング言語に関する基本的な情報を説明するだけでなく、詳細もすばやく掘り下げていきます。このモジュールで初めて Apex に触れる場合は、まず「クイックスタート: Apex」プロジェクトを参照することを強くお勧めします。その後でまた戻ってきてください。それまでお待ちします。
Apex とは?
Apex は、Java に似た構文を使用し、データベースのストアドプロシージャーのように動作するプログラミング言語です。開発者は Apex を使用して、ボタンのクリックや関連レコードの更新、Visualforce ページなどのシステムイベントにロジックを追加することができます。
言語として、Apex には次のような特徴があります。
-
ホスティング — Apex は、サーバー (Salesforce Platform) 上で保存、コンパイル、実行されます。
-
オブジェクト指向 — Apex は、クラス、インターフェース、継承をサポートします。
-
強い型付け — Apex は、コンパイル時にオブジェクトへの参照を検証します。
-
マルチテナント型 — Apex はマルチテナントプラットフォームで実行されるため、制限を適用して暴走コードから保護します。こうした制限は、コードが共有リソースを独占しないようにするのに役立ちます。
-
データベースとの統合 — レコードに簡単にアクセスして操作できます。Apex では、レコードとその項目に直接アクセスできます。また、それらのレコードを操作するためのステートメントとクエリ言語が提供されます。
-
データ指向 — Apex では、データベースへのトランザクションアクセスが提供されるため、ロールバック操作が可能です。
-
使いやすい — Apex は、使い慣れた Java イディオムに基づいています。
-
テストが容易 — Apex には、単体テストの作成、実行、およびコードカバー率のサポートが組み込まれています。
-
バージョン管理 — カスタム Apex コードは、異なるバージョンの API に対して保存できます。

Apex 言語の特長
ほかのオブジェクト指向プログラミング言語と同様に、Apex では次のような言語構成要素がサポートされます。
- クラス、インターフェース、プロパティ、コレクション (リスト、対応付け、セット)。
- オブジェクトおよび配列表記。
- 式、変数、定数。
- 条件付きステートメント (if-then-else) とフロー制御ステートメント (for ループと while ループ)。
ほかのオブジェクト指向プログラミング言語とは異なり、Apex では次の機能がサポートされます。
- クラウド開発 (Apex はクラウドで保管、コンパイル、および実行されるため)。
- トリガー (データベースシステムのトリガーと類似)。
- 直接データベースコールが可能なデータベースステートメントと、データのクエリと検索を行うためのクエリ言語。
- トランザクションとロールバック。
-
globalアクセス修飾子 (public修飾子よりも権限が高く、名前空間とアプリケーションの全体でアクセスが可能)。
- カスタムコードのバージョン管理。
さらに、Apex では大文字と小文字が区別されません。
開発ツール
Visual Studio Code 向け Salesforce 拡張機能を使用して、クライアントコンピューターで Apex を記述してデバッグできます。「Develop with Ease with Salesforce Extensions (Salesforce 拡張機能で容易に開発)」を参照してください。
また、Salesforce ユーザーインターフェースを使用して、ブラウザーで直接 Apex を記述し、デバッグ情報にアクセスすることもできます。Web コンソールは、旧来のレガシーツールと高オーバーヘッドの開発環境の間のギャップを埋めるために設計された、最新の軽量なブラウザーベースの統合開発環境 (IDE) です。詳細は、「Web Console (Web コンソール)」開発者ドキュメントを参照してください。
クイックアクセスメニュー (
) から Web コンソールを開くことができます。

データ型の概要
Apex では、Salesforce 固有のデータ型 (sObject データ型) を含む、さまざまなデータ型がサポートされます。
Apex では、次のデータ型がサポートされます。
- Integer、Double、Long、Date、Datetime、String、ID、Boolean などのプリミティブ。
-
sObject。汎用 sObject または特定の sObject (Account、Contact、MyCustomObject__c など) のいずれかになります (sObject については後の単元で学習します)。
- 次のものを含むコレクション
-
リスト - 順序とインデックスを持つ要素のコレクション。リストの要素には、プリミティブ型、コレクション、sObject、ユーザー定義型、システム提供 (組み込み) の Apex 型など、あらゆるデータ型を使用できます。
-
セット - 順序を持たない要素のコレクション。セットの要素もあらゆるデータ型を使用できますが、重複する値を含めることはできません。
-
マップ - あらゆるデータ型を使用できるキーと値のペアのコレクション。
-
列挙型と呼ばれる型付けされた値のリスト
- ユーザー定義 (カスタム) の Apex クラス
- システム提供 (組み込み) の Apex クラス
Apex コレクション: List
リストは、同じ型のデータの順序付けられたコレクションを保持します。
次の 2 つの宣言は同等です。colors 変数が List 構文を使用して宣言されています。
List<String> colors = new List<String>();
または、colors 変数は配列表記を使用して宣言することもできます。
String[] colors = new List<String>();
List.add() メソッドを使用して新しい要素を追加すると、必要に応じてコレクションを増やすことができます。コレクション内の既存の要素をインデックスで参照するには、角括弧の配列表記を使用できます。ただし、角括弧の配列表記で要素を追加することはできません。
次の例は、リスト作成時に要素を追加し、add() メソッドを使用してさらに要素を追加する方法を示しています。
// Create a list and add elements to it in one step
List<String> colors = new List<String> { 'red', 'green', 'blue' };
// Add elements to a list after it has been created
List<String> moreColors = new List<String>();
moreColors.add('orange');
moreColors.add('purple');List 要素は、角括弧 (配列表記とも呼ばれる) で囲まれたインデックスを指定することで読み込めます。また、get() メソッドを使用して List 要素を読み込むこともできます。次の例は、前の例で作成されたリストに基づいており、いずれかのメソッドを使用して List 要素を読み込む方法を示します。また、list 要素の反復処理方法も示します。
// Get elements from a list
String color1 = moreColors.get(0);
String color2 = moreColors[0];
System.assertEquals(color1, color2);
// Iterate over a list to read elements
System.debug('Print out the colors in moreColors:');
for(String color : moreColors) {
// Write value to the debug log
System.debug(color);
}高度な操作
Apex は、ほかにも 2 つのコレクション型、Set と Map がサポートされます。これらの型については、『Apex 開発者ガイド』の「Collections」セクションを参照してください。
Apex クラス
Apex クラスの利点の 1 つはコードを再利用できることです。クラスメソッドは、トリガーとほかのクラスからコールできます。以降のチュートリアルでは、サンプルのクラスを組織に保存し、そのクラスを使用して取引先の説明を更新して、デバッグログを調べます。
Apex クラスを保存する
AccountProcessor クラスには、updateAccountDescriptions() という公開メソッドがあります。このメソッドは取引先のリストを受け取り、applyStandardFormatting() 非公開ヘルパーメソッドで指定された形式に従って説明を更新します。非公開ヘルパーメソッドは外部からコールすることはできません。クラス内からコールする必要があります。AccountProcessor クラスには、データベースの更新操作の結果を検査する inspectResults() 非公開ヘルパーメソッドも含まれています。
Trailhead 組織に AccountProcessor クラスを保存します。
- クイックアクセスメニュー (
) から Web コンソールを開きます。
- Web コンソールで、Ctrl+Shift+P (Windows) または ⌘+Shift+P (macOS) を押してコマンドパレットを開きます。
-
SFDX: Create Apex Class(SFDX: Apex クラスを作成) と入力し、Enter キーを押します。
- テンプレートの種別に [DefaultApexClass] を選択し、Enter キーを押します。
- クラス名に
AccountProcessorと入力し、Enter キーを押します。
- 出力ディレクトリに [force-app/main/default/classes] を選択し、Enter キーを押します。
- デフォルトのクラス本文を、
AccountProcessorクラスの例で置き換えます。
public with sharing class AccountProcessor {
/**
* Applies a standard formatting to the descriptions of accounts in the list,
* and updates each account.
*/
public void updateAccountDescriptions(List<Account> acctList) {
if (acctList == null || acctList.isEmpty()) {
System.debug('Account list is null or empty.');
return;
}
for (Account acc : acctList) {
applyStandardFormatting(acc);
}
Database.SaveResult[] srList = Database.update(acctList,
false,
AccessLevel.USER_MODE);
inspectResults(srList);
}
/**
* Private helper method to handle the description formatting logic.
*/
private static void applyStandardFormatting(Account acc) {
String timestamp = String.valueOf(Datetime.now());
if (String.isBlank(acc.Description)) {
acc.Description = 'Account updated on: ' + timestamp;
} else {
acc.Description += ' | Last processed: ' + timestamp;
}
}
/*
* Private helper method to inspect the returned results.
*/
private static void inspectResults(Database.SaveResult[] results) {
for (Database.SaveResult sr : results) {
if (sr.isSuccess()) {
System.debug('Successfully updated account. Account ID: ' + sr.getId());
} else {
for (Database.Error err : sr.getErrors()) {
System.debug('The following error has occurred.');
System.debug(err.getStatusCode() + ': ' + err.getMessage());
System.debug('Account fields that affected this error: ' +
err.getFields());
}
}
}
}
}- クラスを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。
クラスを保存すると Salesforce によってコンパイルされてリリースされます。
高度な操作
保存したクラスでは、オブジェクト指向プログラミング (OOP) を利用します。このクラスは、メールの管理に関連するメソッドをカプセル化します。完全な OOP の例にするには、クラスにメンバー変数 (属性) とそのような属性にアクセスするためのアクセス機構メソッドも含める必要がありますが、ここでは簡略化のために省略しています。
メソッドをコールして取引先の説明を更新する
公開メソッドを呼び出しましょう。ここでは、匿名 Apex 実行を使用して呼び出します。匿名 Apex を使用すると、コード行をその場で実行でき、特に機能のテストなどで Apex を呼び出す場合に便利です。ほかの Apex 実行と同様に、結果としてデバッグログが生成されます。
- Web コンソールで、Ctrl+Shift+P (Windows) または Cmd+Shift+P (macOS) を押してコマンドパレットを開きます。
-
SFDX: Create Anonymous Apex Script(SFDX: 匿名 Apex スクリプトを作成) と入力し、Enter キーを押します。
- クラス名に
UpdateAccountsと入力し、Enter キーを押します。
- 出力ディレクトリに [scripts/apex] を選択し、Enter キーを押します。
- 次のコードを入力します。
// Create new accounts
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Second New Account'));
// Insert them into the database
try {
insert as user newAccts;
System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Instantiate an AccountProcessor object
AccountProcessor myAcctProcessor = new AccountProcessor();
// Pass the original list to update the account descriptions
myAcctProcessor.updateAccountDescriptions(newAccts);- スクリプトを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。
- スクリプトを実行するには、テキストエディターで右クリックし、[SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX: 現在開いているエディターで匿名 Apex を実行)] を選択します。
- Salesforce で、My New Account と My Second New Account のレコード詳細ページを開きます。
My New Account の [Description (説明)] 項目は Original Description | Last processed: 2026-01-01 00:00:00、My Second New Account の [Description (説明)] 項目は Account updated on: 2026-01-01 00:00:00 となっているはずです。ただし、タイムスタンプはいずれも、匿名 Apex トランザクションを実行した日時に変わります。
デバッグログを調べる
デバッグログは、コードをデバッグするのに便利です。Apex メソッドが実行されると、コールはデバッグログに記録されます。また、独自のデバッグメッセージをログに書き出すことができ、エラーがある場合のコードのデバッグに役立ちます。updateAccountDescriptions() からコールされる inspectResults() ヘルパーメソッドは、System.debug() メソッドを使用して、データベースの更新操作が成功したかエラーになったかを示すメッセージをログに書き出します。メソッドを実行したときに生成されたデバッグログでこれらのメッセージを検索できます。
- Web コンソールで UpdateAccounts スクリプトを実行したら、[Output (出力)] パネルを開きます。
-
[Debug Only (デバッグのみ)] を選択して、
System.debug()ステートメントのログ行のみが表示されるようにログを絞り込みます。
- [Output (出力)] パネル上部の [filter (検索条件)] 項目に
USER_DEBUGと入力し、System.debug()ステートメントのログ行のみが表示されるようにログを絞り込みます。
- デバッグログは .sfdx/tools/debug/logs ディレクトリでも確認できます。

スクリプトがエラーなく実行された場合、絞り込まれたログビューには次のメッセージが表示されます。
DEBUG|Successfully inserted 2 accounts.
DEBUG|Successfully updated account. Account ID: {id}
DEBUG|Successfully updated account. Account ID: {id}静的メソッドをコールする
ここでは、クラスの updateAccountDescriptions() メソッドはクラスメンバー変数にアクセスしないため、インスタンスメソッドである必要はありません。宣言に static キーワードを追加して、静的メソッドに変更しましょう。静的メソッドは、クラスのインスタンスでコールされる必要がなく、クラス名で直接コールできるため、インスタンスメソッドよりもコールが容易です。
- Web コンソールで、
AccountProcessor.clsクラスファイルを開きます。
-
updateAccountDescriptions()定義の最初の行を変更します。変更点はstaticキーワードの追加のみです。
public static void updateAccountDescriptions(List<Account> acctList) {- クラスを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。保存するとクラスが再リリースされます。
-
UpdateAccounts.apex匿名 Apex スクリプトファイルを開きます。
- スクリプトがクラス名で静的メソッドをコールするように、現在のコードを次のコードに置き換えます。
// Create new accounts
// For clarity, use different account names than the ones you used previously
List<Account> newAccts = new List<Account>();
newAccts.add(new Account(Name='My Third New Account', Description='Original Description'));
newAccts.add(new Account(Name='My Fourth New Account'));
// Insert them into the database
try {
insert as user newAccts;
System.debug('Successfully inserted ' + newAccts.size() + ' accounts.');
} catch (Exception e) {
System.debug('An error inserting the records occurred: ' + e.getMessage());
}
// Pass the original list to update the account descriptions
// The static method is called directly on the class
AccountProcessor.updateAccountDescriptions(newAccts);- スクリプトを保存するには、Ctrl+S (Windows) または ⌘+S (macOS) を押します。
- スクリプトを実行するには、テキストエディターで右クリックし、[SFDX: Execute Anonymous Apex with Currently Open Editor (SFDX: 現在開いているエディターで匿名 Apex を実行)] を選択します。これで、このメソッドが実行されました。Salesforce で更新された取引先の説明を確認できます。また、必要に応じて、前のステップと同様にデバッグログも確認できます。
リソース
- Apex 開発者ガイド: Apex の概要
- Apex 開発者ガイド: ループ
- Salesforce 開発者: Use Anonymous Apex (匿名 Apex の使用)
- Web コンソール: Debug Apex Code (Apex コードのデバッグ)
