Apex コードの動作のバージョニング

パッケージ開発者は条件付きロジックを Apex クラスとトリガで使用し、異なるバージョンに異なる動作をさせることができます。こうすることで、パッケージ開発者は、コード開発を続けながら以前のパッケージバージョンのクラスとトリガでの既存の動作をサポートし続けることができます。

登録者が、複数のバージョンのパッケージをインストールし、パッケージ内の Apex クラスまたはトリガを参照するコードを記述する場合、参照しているバージョンを選択する必要があります。パッケージ内で参照している Apex コード内で、参照を作成する Apex コードのコールのバージョン設定に基づき、異なるコードパスを条件付きで実行できます。コール元のコードのパッケージバージョン設定は、パッケージコード内で System.requestVersion メソッドをコールすることによって判断できます。こうすることで、パッケージ開発者は、要求コンテキストを決定し、さまざまなバージョンのパッケージに異なる動作を指定することができます。

次のサンプルでは、System.requestVersion メソッドを使用して System.Version クラスをインスタンス化し、異���るバージョンのパッケージに対して、Apex トリガにさまざまな動作を定義します。

1swfobject.registerObject("clippy.package_version_request", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17trigger oppValidation on Opportunity (before insert, before update) {
18
19    for (Opportunity o : Trigger.new){
20    
21        // Add a new validation to the package
22        // Applies to versions of the managed package greater than 1.0
23        if (System.requestVersion().compareTo(new Version(1,0)) > 0) {
24            if (o.Probability >= 50 && o.Description == null) {
25                o.addError('All deals over 50% require a description');
26            }
27        }
28
29        // Validation applies to all versions of the managed package.
30        if (o.IsWon == true && o.LeadSource == null) {
31            o.addError('A lead source must be provided for all Closed Won deals');
32        }
33    }
34}

パッケージバージョンを処理するメソッドの完全な一覧は、「System クラス」の「Version クラス」および「System.requestVersion メソッド」を参照してください。

インストール済みパッケージ内のあるクラスによってパッケージの別のクラスのメソッドが呼び出される場合、要求コンテキストは維持されます。たとえば、登録者が CountryUtil クラスおよび ContinentUtil Apex クラスを含む GeoReports パッケージをインストールしたとします。登録者は GeoReportsEx クラスを新規作成し、バージョン設定を使用して、GeoReports パッケージのバージョン 2.3 にバインドします。GeoReportsEx が、CountryUtil のメソッドを内部的に呼び出す ContinentUtil のメソッドを���び出すと、要求コンテキストは ContinentUtil から CountryUtil に反映され、CountryUtil 内の System.requestVersion メソッドは、GeoReports パッケージのバージョン 2.3 を返します。