--- schema_version: "1" id: c5680d9b31b2f7d99d23a27a2a9e700555041d59d7791a89476966e0ca4701c2 title: パラメーター collection: mulesoft version: current locale: ja-jp portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/mule-sdk/1.1/parameters.md canonical_url: https://docs.mulesoft.com/jp/mule-sdk/1.1/parameters source_site: docs.mulesoft.com content_type: documentation content_hash: f56f44d8d8057393a4d3516e81243d9e7a0ed0a746002dfb2e548cb443febc5e description: MuleSoft Documentation Site release: "1.1" latest: false --- # パラメーター パラメーターとは、特定のコンポーネントに属する設定可能な引数です。 ​[設定](https://docs.mulesoft.com/jp/mule-sdk/1.1/configs)​、​[コンポーネント](https://docs.mulesoft.com/jp/mule-sdk/1.1/module-structure#components)​、そして​[接続プロバイダー](https://docs.mulesoft.com/jp/mule-sdk/1.1/connections)​は、それぞれパラメーターで設定できるため、​_パラメーター化可能_​であると言います。 パラメーターは、コンポーネントが適切に機能するために必要な情報を提供します。各パラメーターには以下の情報が含まれます。 - パラメーターが持つことのできる値の種類を制限する型。 - パラメーターを一意に識別する名前。 簡単な例を次に示します。 ```java @Parameter private String foo; ``` パラメーターは、対象とするコンポーネントの種類により、クラスの項目またはメソッドの引数として定義できます。 たとえば、​[操作](https://docs.mulesoft.com/jp/mule-sdk/1.1/operations)​パラメーターは、操作を宣言するメソッドの引数と同じように定義します。​`@Parameter`​ アノテーションを付加する必要はありません。 次の ​`foo`​ の例を見てください。 ```java public void method(String foo){} ``` ## [](#複雑な型の使用)複雑な型の使用 次の例では、文字列や整数のような単純な型ではない複雑なパラメーターを使用しています。 ```java @Parameter @Optional private Options options; ``` `Options`​ は POJO オブジェクトで、次のように定義されます。 ```java public class Options { @Parameter public String color; @Parameter @Optional public String mode; public String getColor(){ return color; } public void setColor(String color){ this.color = color; } public String getMode(){ return mode; } public void setMode(String mode){ this.mode = mode; } } ``` この例について、以下の点に注意してください。 - `Options`​ パラメーター全体が省略可能なパラメーターとして使用されるため、使用する場合は ​`Options`​ 内のすべての必須パラメーターが設定されていることを確認する必要があります。 - `Options`​ を設定しないと、値は ​`null`​ になります (この動作を変更する方法については「​[NullSafe](https://docs.mulesoft.com/jp/mule-sdk/1.1/null-safe)​」を参照してください)。 - `Options`​ パラメーターは、Java Bean プロパティである必要があります (つまり、項目名と一致する setter と getter が必要です)。 ### [](#複雑な型の-dsl)複雑な型の DSL 複雑な型は、通常のパラメーターから分離する必要があります。複雑な型のすべての属性を要素特有のパラメーターとマージしても意味がありません。 そのため、複雑な型では子定義が作成されます。次の例は、​[設定](https://docs.mulesoft.com/jp/mule-sdk/1.1/configs)​の複雑な ​`Options`​ 型を示しています。 ```xml ``` `module:options`​ は ​`name`​ および ​`someConfigAttribute`​ パラメーターから分離されています。 ## [](#修飾子)修飾子 パラメーターは柔軟にカスタマイズできます。このセクションでは、パラメーターを定義する際に使用してパラメーターの動作や制限を指定する、いくつかの修飾子について説明します。 ### [](#式のサポート)式のサポート `ExpressionSupport`​ は、設定値が DataWeave 式である場合のパラメーターの動作を指定します。 3 つの値があります。 - `REQUIRED`​: パラメーターは、式のみを受け入れます。 - `SUPPORTED`​ (デフォルト): パラメーターは、式と単純な値の両方を受け入れます。 - `NOT_SUPPORTED`​: パラメーターは、静的な値を要求します。式は受け入れません。 これらの値は ​`@Expression`​ アノテーションを付加するだけで設定できます。 ```java @Parameter @Expression(SUPPORTED) private String foo; ``` 上記の例では、​`foo`​ という名前の ​`String`​ 型のパラメーターを定義しており、静的な値 (例: `"bar"`​) または式 (例: `"\#[vars.foo]"`​) の両方を受け入れます。 ### [](#選択可能)選択可能 パラメーターには必須と省略可能の 2 種類があります。 パラメーターには、実行しようとしている操作にとって非常に重要な情報、つまり、それを設定しなければ処理を続行できないような情報 (HTTP 要求でのホスト名など) を指定するものがあります。一方で、それがなくても処理を実行できる、あるいはデフォルト値 (HTTP リスナーのポート 80 など) が使用されるような情報を指定するパラメーターもあります。 `@Optional`​ アノテーションを付加しない限り、パラメーターは必須となります。次に例を示します。 ```java @Parameter @Optional(defaultValue="80") private Integer port; ``` 省略可能なパラメーターにはデフォルト値を設定できます。 `@Optional`​ は ​`String`​ 値のみを受け入れますが、SDK はパラメーターの型に合わせて自動的に値を変換します。また、パラメーターが式をサポートしている場合は、デフォルト値として式を使用することもできます。 ### [](#alias-の使用)@Alias の使用 各パラメーターは、定義時に項目で指定された名前を持ちます。この名前は ​`@Alias`​ アノテーションで上書きできます。 ```java @Parameter @Optional @Alias("class") private String clazz; ``` `@Alias`​ を使用することで、Java の予約語 (​`class`​ など) をパラメーター名に使用できます。項目名に予約語を使用することはできません。 ### [](#パラメーター-dsl-のカスタマイズ)パラメーター DSL のカスタマイズ `@ParameterDsl`​ アノテーションを使用して、DSL でのパラメーターの表示と動作をカスタマイズできます。 このアノテーションは、生成される XML DSL の構文とセマンティクスに関連したディレクティブを設定し、モデル内の任意のパラメーターに適用できます。 `@ParameterDsl`​ アノテーションには設定可能な要素が 2 つあります。 - `allowInlineDefinition`​: 関連付けられているパラメーターが子要素などのインライン定義をサポートするかどうかを指定します。 複雑な型のパラメーターの DSL をカスタマイズする場合、特に、無効な項目 (​`name`​ など) を持つためにインライン定義を回避する必要がある場合や、構造が複雑過ぎてインラインで表現する意味がない場合などに使用します。 たとえば、​[設定](https://docs.mulesoft.com/jp/mule-sdk/1.1/configs)​で ​`Options`​ 型を使用して、​`@ParameterDsl(allowInlineDefinition=false)`​ でパラメーターを宣言した場合は、子要素を定義できなくなります。 ```xml ``` - `allowReferences`​: 関連付けられているパラメーターが ​`String`​ を受け取る際にレジストリ参照をサポートするかどうかを指定します。 このアノテーションにより、パラメーターの型だけでは参照サポートを自動設定するのに十分な情報を提供できない場合に、設定時のパラメーターの動作を制御できます。 たとえば、JMS Connector で、レジストリからオブジェクトを ​`ConsumerType`​ 設定としてユーザーが挿入することを回避させる場合には、参照をサポートしないと宣言します。 ```java @Parameter @Optional @Expression(NOT_SUPPORTED) @ParameterDsl(allowReferences = false) private ConsumerType consumerType; ``` ## [](#groups)パラメーターグループ `@ParameterGroup`​ アノテーションは、特別なリレーションを共有しているためにまとめた方が便利なパラメーターをグループ化します。 このようなパラメーターは、どのように見極めたらよいでしょうか? 常に​**一緒に移動する**​パラメーターは、​`@ParameterGroup`​ でグループ化した方がよいでしょう。 また、​`@ParameterGroup`​ を使用することで、グループ内のすべてのパラメーターが同じボックスにまとめられ、グループに属さない他のパラメーターとは別に表示されるため、UI 表示でも便利です。次に例を示します。 ![パラメーターグループ](/mulesoft/current/ja-jp/mule-sdk/1.1/_images/group.png) 上記の画像を見ると、​`Connection`​ グループには 4 つのパラメーターがあり、そのグループには属さないパラメーター (​`Soap Version`​ など) もあります。このように、目的ごとにパラメーターを分けることができます。 このパラメーターグループの簡単な定義例を示します。 ```java public class ConnectionProperties { @Parameter public String host; @Parameter @Optional(defaultValue="80") public Integer port; public String getHost(){ return host; } public void setHost(String host){ this.host = host; } public Integer getPort(){ return port; } public void setPort(Integer port){ this.port = port; } } ``` 上記の例は次のように使用できます。 ```java @ParameterGroup("Connection") private ConnectionProperties properties; ``` `"Connection"`​ は ​`@ParameterGroup`​ の名前であり、UI に表示される名前です。 `@ParameterGroup`​ プロパティを定義するクラスは、​`properties`​ という名前のパラメーターを持ちません。 代わりに、​`ConnectionProperties`​ の内部で定義されているパラメーターを持ちます。 - `host`​ という必須パラメーター。 - `port`​ という省略可能なパラメーター。 つまり、パラメーターグループを定義するクラスは、これらの追加パラメーターによって拡張され、​`ConnectionProperties`​ 内で定義されているパラメーターと、クラスで宣言されている他のすべてのパラメーターを持つことになります。 `@ParameterGroup`​ アノテーションが付加された各項目は、Java Bean プロパティである必要があります (つまり、項目名と一致する setter と getter が必要です)。 ## [](#pojo-とパラメーターグループの違い)POJO とパラメーターグループの違い `@ParameterGroup`​ は、それを宣言したコンポーネント内で定義するのではなく、DSL で子要素として記述できるように設定できます。 たとえば、次のような操作を考えてください。 ```java public void execute(@ParameterGroup ConnectionProperties properties) { ... } ``` 上記の操作用の DSL は次のようになります。 ```xml ``` ただし、​`@ParameterGroup(showInDsl=true)`​ を使用してパラメーターグループを設定すると、DSL は次のようになります。 ```xml ``` POJO ​`@Parameter`​ を定義しても同じ DSL が得られるため、どのような状況において ​`@ParameterGroup`​ アノテーション付きの POJO ではなく POJO を使用すべきなのか迷うかも知れません。 これらの 2 つの概念には微妙な違いがあります。型を全体として捉えて、その型が提供する構造が重要である場合は、必ず POJO を使用してください。 たとえば、​`ConnectionProperties`​ (上記) は、常に一緒に設定される 2 つのパラメーターを一緒に扱っています。この場合、これらのパラメーターはモジュールのドメインでエンティティを表現しません。​`@ParameterGroup`​ は、関連するパラメーターを一緒に扱って UI で一緒に表示するための便利な手段にすぎません。 上記で定義されている ​`Options`​ POJO は、オブジェクトのパラメーターだけではなくオブジェクト自身も重要です。たとえば、各オブジェクトはそれ自身で意味があるため (オブジェクト指向プログラミングのように) ​`Options`​ のリストを定義することは有効です。一方、モジュールのドメインでは特定の意味を持たず、パラメーターを一緒に表示するためだけにクラスを使用する場合には、パラメーターグループを使用した方がよいでしょう。 ## [](#パラメーターの型の制限)パラメーターの型の制限 `org.mule.runtime.core.api.source.scheduler.Scheduler`​ 型または ​`org.mule.runtime.api.scheduler.SchedulingStrategy`​ 型のパラメーターまたは POJO は追加できません。