こんコンポーネントを使ってREST型のサービスをプロキシしてローカルESB Muleコンポーネントに見せされることができます。 org.mule.components.rest.RESTServiceWrapper にサービスURLを設定することができます。以下のプロパティを設定してパラメータやエラー状態をサービスに設定することができます。|| プロパティ || 説明 || 必須 ||
| serviceUrl |
呼び出すRESTサービスのURL。URLにパラメータが指定されている場合は、呼び出されるときに送られます。 |
○,ただし urlFromMessage が設定されている場合は× |
| urlFromMessage |
呼び出すRESTサービスのURLをメッセージから取得するか。する場合は、メッセージに rest.service.url プロパティを設定します。 |
× |
| requiredParams |
RESTサービスURLに設定する必須のパラメータのMap。明示的に serviceUrl に設定するか、パラメータをメッセージにプロパティとして設定します。 |
× |
| optionalParams |
サービスURLに設定するオプションのパラメータ。メッセージにパラメータが設定されていない場合でもエラーになりません。 |
× |
| httpMethod |
サービスを呼び出すHTTPメソッド。 |
×. デフォルトはGETです。 |
| payloadParameterName |
メッセージ・ペイロードに設定されるサービスURLに設定するパラメータの名前。設定されていない場合でも、メッセージ・ペイロードはリクエストの本文として送られます。このパラメータは_payloadParameterNames_ に置き換えられました。 |
× |
| payloadParameterNames |
パラメータ名の一覧。RestServiceWrapperはメッセージ・ペイロードにObject[]を受け取れます。その場合は、payloadParameterNamesから名前パラメータ x を抽出し、Object[]内の項目 x と対応付けます。ペイロードが基本オブジェクトの場合は、RestServiceWrapperはpayloadParameterNamesから最初の要素を取得してペイロードと対応付けます。ESB Mule 1.4.2以降で対応。 |
× |
| errorFilter |
RESTサービスを呼び出すときにRESTServiceWrapperはデフォルトで正規表現フィルタ(Regular Expression filter)を使ってエラーが起こたか確認をします。ただし、 errorFilter を設定して他フィルタを使って結果にエラーがあるかを確認することもできます。 |
× |
| errorExpression |
エラーが起きたか確認するための正規表現式。 |
× (if the errorFilter is set explicitly) |
RESTServletWrapperの設定の例に付いては株価サンプルを参照してください。例は、http://www.webservicex.netのASPX株価サービスを呼び出します。