この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Version クラス

Version メソッドを使用して、登録者の管理パッケージのバージョンを取得して、パッケージのバージョンを比較します。

名前空間

System

使用方法

パッケージバージョンは、パッケージでアップロードされる一連のコンポーネントを特定する番号です。バージョン番号の形式は majorNumber.minorNumber.patchNumber (例: 2.1.3) です。メジャー番号とマイナー番号は、メジャーリリース時に選択した値に増えます。patchNumber は、パッチリリースにのみ生成および更新されます。

コールされたコンポーネントは、System.requestVersion メソッドを使ってコンパイルされたコール元のバージョンを確認し、コール元が想定した動作に応じ��動作を変化できます。このため、コードを更新しながらも、クラスとトリガの既存の動作を以前のパッケージバージョンでサポートし続けることができます。

System.requestVersion メソッドが返す値は、メジャー番号とマイナー番号の 2 つの番号で構成されたバージョン番号が付加された、このクラスのインスタンスです。System.requestVersion メソッドはパッチ番号を返さないため、返される Version オブジェクトのパッチ番号は null です。

System.Version クラスは、パッチ番号を含む 3 つの番号で構成されるバージョン番号も保持できます。

この例では、このクラスのメソッドおよび requestVersion メソッドを使用して、パッケージをコールするコードの管理パッケージバージョンを判定する方法を示します。
1if (System.requestVersion() == new Version(1,0))
2{
3    // Do something
4}
5if ((System.requestVersion().major() == 1) 
6     && (System.requestVersion().minor() > 0)
7     && (System.requestVersion().minor() <=9))
8{
9    // Do something different for versions 1.1 to 1.9
10}
11else if (System.requestVersion().compareTo(new Version(2,0)) >= 0)
12{
13    // Do something completely different for versions 2.0 or greater
14}

Version コンストラクタ

Version のコンストラクタは次のとおりです。

Version(major, minor)

指定されたメジャーバージョン番号とマイナーバージョン番号を使用して、2 つの番号で構成されたパッケージバージョンとして、Version クラスの新しいインスタンスを作成します。

署名

public Version(Integer major, Integer minor)

パラメータ

major
型: Integer
メジャーバージョン番号。
minor
型: Integer
マイナーバージョン番号。

Version(major, minor, patch)

指定されたメジャーバージョン番号とマイナーバージョン番号、さらにパッチバージョン番号を使用して、3 つの番号で構成されたパッケージバージョンとして、Version クラスの新しいインスタンスを作成します。

署名

public Version(Integer major, Integer minor, Integer patch)

パラメータ

major
型: Integer
メジャーバージョン番号。
minor
型: Integer
マイナーバージョン番号。
patch
型: Integer
パッチバージョン番号。

Version メソッド

Version のメソッドは次のとおりです。すべてインスタンスメソッドです。

compareTo(version)

現在のバージョンを指定されたバージョンと比較します。

署名

public Integer compareTo(System.Version version)

パラメータ

version
型: System.Version

戻り値

型: Integer

次のいずれかの値を返します。

  • ゼロ。現在のパッケージバージョンが指定されたパッケージバージョンと同じである場合。
  • 0 より大きい整数値。現在のパッケージバージョンが指定されたパッケージバージョンより大きい場合。
  • 0 より小さい整数値。現在のパッケージバージョンが指定されたパッケージバージョンより小さい場合。

使用方法

2 つの番号で構成されたバージョンが 3 つの番号で構成されたバージョンと比較される場合、パッチ番号は無視されます。したがって、比較は、メジャー番号とマイナー番号のみに基づいて行われます。

major()

コール元のコードのメジャーパッケージバージョンを返します。

署名

public Integer major()

戻り値

型: Integer

minor()

コール元のコードのマイナーパッケージバージョンを返します。

署名

public Integer minor()

戻り値

型: Integer

patch()

コール元のコードのパッチパッケージバージョンを返します。パッチバージョンがない場合は、null を返します。

署名

public Integer patch()

戻り値

型: Integer