--- schema_version: "1" id: d501839225520f0efb139b7b6d9f84f9dc43569174078bc17b752a2447e330e2 title: 拡張動作での汎用パラメーターの使用 collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-sdk/1.1/subtypes-mapping.md canonical_url: https://docs.mulesoft.com/jp/mule-sdk/1.1/subtypes-mapping source_site: docs.mulesoft.com content_type: documentation content_hash: 1f0eb380627b3b05a59ebd9d7e0d8a568cb94b8bfaff6d66abd035427ab5f7a1 description: MuleSoft Documentation Site release: "1.1" latest: false --- # 拡張動作での汎用パラメーターの使用 モジュール API の型定義は、ユーザーに提供する操作に影響します。型を適切に構成すると、ユーザーに公開する API を大幅に簡素化できます。 ## [](#subtypemapping-を使用した-ux-の簡素化)SubTypeMapping を使用した UX の簡素化 パラメーターが ​`authentication`​ や ​`destination`​ などの汎用コンポーネントを表している場合、複数の有効な設定セットが許可されます。認証にはさまざまな型 (​`basic`​、​`digest`​、​`ntlm`​、​`oauth`​) を使用できますが、各認証のすべてのパラメーターを一度に使用可能にすると、ユーザーの操作が困難なものになります。 たとえば、​`basic`​、​`digest`​、および ​`ntlm`​ をサポートする認証を 1 つのパラメーターに含めると、Authentication クラスは短くなりますが、混乱も招きます。 ```java public class Authentication { @Parameter private boolean useDigest; (1) @Parameter private String username; @Parameter @Password private String password; @Parameter @Optional private String domain; (2) @Parameter @Optional private String workstation; } ```
1パラメーター ​useDigest​ は ​basic​ と ​digest​ を区切るためにのみ存在します。
2domain​ と ​workstation​ は ​ntlm​ 設定にのみ関連するため、​useDigest​ が無関係になります。
必要なパラメーターが 4 つのみの正しい設定でも、ユーザーは容易に混乱してしまいます。 代わりに ​`@SubTypeMapping`​ を使用すると、コード自体から型の使用方法を容易に理解でき、値の宣言がより簡潔になります。 ```java @Extension(name = "HTTP") @SubTypeMapping(baseType = Authentication.class, (1) subTypes = {BasicAuthentication.class, DigestAuthentication.class, NtlmAuthentication.class}) public class HttpConnector { } public interface Authentication { (2) void authenticate(HttpRequestBuilder builder); } public class BasicAuthentication implements Authentication { (3) @Parameter private String username; @Parameter @Password private String password; } public class DigestAuthentication implements Authentication { (4) @Parameter private String username; @Parameter @Password private String password; } public class NtlmAuthentication implements Authentication { (5) @Parameter private String username; @Parameter @Password private String password; @Parameter @Optional private String domain; @Parameter @Optional private String workstation; } ```
1SubTypeMapping​ の宣言
2汎用 ​Authentication​ インターフェース
3Authentication​ の ​basic​ としての実装
4Authentication​ の ​digest​ としての実装
5Authentication​ の ​ntlm​ としての実装
次に汎用型 ​`Authentication`​ のパラメーターを宣言します。 ```java @Alias("request") public class HttpRequesterProvider implements CachedConnectionProvider { @Parameter private Authentication authentication; } ``` これでユーザーは、より簡潔で一貫した方法で、3 つの可能な値のそれぞれを宣言できます。 ```xml > ``` ## [](#モジュール設定を使用した動作の拡張)モジュール設定を使用した動作の拡張 モジュールで独自の認証方法を提供する必要がある場合、​`@Import`​ と ​`@SubTypeMapping`​ の組み合わせを使用します。 次の例では、​`oauth`​ 認証を ​`http`​ モジュールに追加しています。 ```java @Extension(name = "OAuth") @Import(type = HttpRequestAuthentication.class) (1) @SubTypeMapping(baseType = Authentication.class, (2) subTypes = {DefaultAuthorizationCodeGrantType.class, ClientCredentialsGrantType.class}) public class OAuthExtension { } ```
1HTTP 認証種別からインポートを定義します。
2OAuth 拡張から認証種別へのその他のサブタイプマッピングを追加します。
これで、2 つの新しい認証方法が実装されると、元の拡張 ​`HTTP`​ のコードを変更せずに、それらをパラメーター化して任意のアプリケーションの HTTP Connector に渡すことができます。つまり、上記の同じアプリケーションに対して、新しい認証方法を追加できます。 ```xml (1) ```
1authentication​ 要素は同じですが、その要素には新しい要素 ​authorization-code-grant-type​ が含まれます。
2要素 ​authorization-code-grant-type​ は ​oauth​ 名前空間から取得されます。