ファクトリ メソッドのサブクラスの登録

  • [アーティクル]

クラス継承は、他のオブジェクト指向言語と同様に、X++ の中心的概念です。 オブジェクト指向戦略パターンは、X++ ビジネス ロジック全体で使用されます。 このパターンでは、動作のバリエーションをサブクラスでカプセル化することができ、業務プロセスが抽象基本クラスまたはインターフェイスを使用します。 ファクトリ メソッドは、特定のサブクラスのインスタンスを作成することによって、使用されるバリエーションを決定します。

この記事では、独自のバリエーションを工場に登録する方法について説明します。

X++ では、ファクトリはリフレクションを使用して、次のタスクを実行します。

  • 正しいサブクラスを検索します。 ファクトリは、拡張フレームワークを使用して、階層内のすべてのサブクラスで特定の属性セットを検索します。 サブクラスを修飾する属性がファクトリに渡されたパラメータと一致する場合、その特定のクラスが使用されます。
  • インスタンスを作成します。 正しいタイプが識別された後、リフレクションを使用してクラスのインスタンスを作成します。

次の図は、一般的な装飾階層を示しています。

各サブクラスが属性で装飾されている、3 つのサブクラスを持つクラス階層。

X++ では、2 つの拡張フレームワークは同じ目的で機能します。 ファクトリ メソッドの実装担当者は、使用する拡張フレームワークを決定します。

  • SysExtension

    • この拡張フレームワークは、利用しやすくするためにカスタム属性を使用します。
    • 同じインスタンスが繰り返し作成されるときに、パフォーマンスを多少節約する単一をサポートします。 この拡張フレームワークは、ステートレスなサブクラスに特に便利です。
    • バリアントを決定するために頻繁に使用される拡張可能な列挙をシームレスにサポートしています。

  • SysPlugin

    • この拡張フレームワークは、Managed Extension Framework に基づいています。 マネージ拡張フレームワークは、SysPlugin 拡張フレームワークを非 X++ コードで使用できるようにします。
    • ExportMetadataAttribute 属性を使用してバリアントを修飾し、文字列ベースとなります。
    • ExportAttribute 属性を使用してバリアントを見つけやすくします。

新しいバリアントの導入

  1. 実装する必要があるバリアントの基本クラス (またはインタフェース) を特定します。

  2. 基本クラスの新しいサブクラスを作成し、バリエーションを実装します。

  3. クラスを登録するために必要となる属性を識別します。 次の 2 つのアプローチがあります。

    • 階層内のその他のサブクラスで定義されている属性を検索します。
    • ファクトリ メソッドの実装を確認します。 その実装には、ファクトリ メソッドが検索する属性が含まれます。

  4. バリエーションに一致するために使用された属性でサブクラスを修飾します。

SysExtension 例

[WHSWorkExecuteMode(WHSWorkExecuteMode::About)]
class WHSWorkExecuteDisplayAbout extends WHSWorkExecuteDisplay
{
    // Your code here.
}

SysPlugin 例

[ExportMetadataAttribute('CaseIAssociation', 'Lead'),
ExportAttribute('Dynamics.AX.Application.CaseIAssociation')]
class smmLeadCaseAssociationProvider implements CaseIAssociation
{
    // Your code here.
}