---
schema_version: "1"
id: 28c4ca77f2f2f7f45dfe7d1b02781fd7073c375e3df90c2c89788293becaa1e9
title: HTTP Connector XML リファレンス
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/http-connector/1.7/http-connector-xml-reference.md
canonical_url: https://docs.mulesoft.com/jp/http-connector/1.7/http-connector-xml-reference
source_site: docs.mulesoft.com
content_type: documentation
content_hash: f8a45ef95a7cc9edda692a5d21141d7015285ca4670a5a5b919d5b96882feeea
description: MuleSoft Documentation Site
release: "1.7"
latest: false
---
# HTTP Connector XML リファレンス

HTTP 用 Anypoint Connector (HTTP Connector) は、イベントのリスンや、HTTP または HTTPS プロトコルに基づいた操作を実行します。HTTPS プロトコルを使用する場合、コネクタには TLS コンテキスト子要素の設定が必要です。次の例は、XML での HTTP Connector のソースと操作の設定を示しています。

## [](#http-listener-の-xml-設定例)HTTP Listener の XML 設定例

`http:listener-config`​ 親要素では、リスン ​`port`​ や ​`tls:context`​ などの接続要素が、子 ​`http:listener-connection`​ 要素内に整理されています。次の例は、XML 設定を示しています。

```xml
<http:listener-config name="lisConfig" basePath="api">
  <http:listener-connection protocol="https" port="${serverPort}" host="localhost" usePersistentConnections="true">
    <tls:context>
      <tls:key-store path="keystore.jks" keyPassword="key" password="pass"/>
    </tls:context>
  </http:listener-connection>
</http:listener-config>
```

次の例は、フロー内の ​`http:listener`​ ソースの XML 設定を示しています。

```xml
<flow name="server">
  <http:listener path="test" allowedMethods="GET" config-ref="lisConfig"/>
  <logger message="HEY"/>
</flow>
```

HTTP リスナー属性にアクセスするには、次の表に示す DataWeave 構文を使用します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15%;">
<col style="width: 45%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">HTTP オブジェクト</th>
<th class="tableblock halign-left valign-top">Mule Runtime Engine 3.x</th>
<th class="tableblock halign-left valign-top">Mule Runtime Engine 4.x</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>メソッド</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.method’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.method]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Path (パス)</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.listener.path’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.listenerPath]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>相対パス</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.relative.path’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.relativePath]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>要求 URI</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.request.uri’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.requestUri]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クエリ文字列</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.query.string’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.queryString]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クエリパラメーター</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.query.params’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.queryParams]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>URI パラメーター</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.uri.params’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.uriParams]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>バージョン</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.version’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.version]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>スキーマ</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.scheme’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.scheme]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ヘッダー</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.headers]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>リモートアドレス</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.remote.address’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.remoteAddress]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>クライアント証明書</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.client.cert’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.clientCertificate]</code></p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#http-request-の-xml-設定例)HTTP Request の XML 設定例

`http:request-config`​ 親要素では、要求の接続要素が、子 ​`http:request-connection`​ 要素内に整理されています。次の例は、XML 設定を示しています。

```xml
<http:request-config name="reqConfig" basePath="api/v2">
  <http:request-connection protocol="HTTP" port="${clientPort}" host="localhost">
    <tls:context>
      <tls:trust-store path="ssltest-cacerts.jks" password="changeit"/>
    </tls:context>
    <http:authentication>
      <http:basic-authentication username="#[user]" password="#[password]" preemptive="#[preemptive]" />
    </http:authentication>
  </http:request-connection>
</http:requester-config>
```

次の例は、フロー内の ​`http:request`​ 操作の XML 設定を示しています。

```xml
<flow name="client">
   <http:request path="/" config-ref="reqConfig"/>
</flow>
```

HTTP 要求は ​`HttpResponseAttributes`​ を返します。HTTP 要求属性にアクセスするには、次の表に示す DataWeave 構文を使用します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 15%;">
<col style="width: 45%;">
<col style="width: 40%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">HTTP オブジェクト</th>
<th class="tableblock halign-left valign-top">Mule Runtime Engine 3.x</th>
<th class="tableblock halign-left valign-top">Mule Runtime Engine 4.x</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>状況コード</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.status]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.statusCode]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>理由を示す語句</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties.’http.reason’]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.reasonPhrase]</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>ヘッダー</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[inboundProperties]</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>#[attributes.headers]</code></p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#http-load-static-resource-の-xml-設定例)HTTP Load Static Resource の XML 設定例

次の例は、フロー内の ​`http:load-static-resource`​ 操作の XML 設定を示しています。

```xml
<flow name="server">
   <http:listener path="test" allowedMethods="GET" config-ref="lisConfig"/>
   <http:load-static-resource resourceBasePath="root" defaultFile="index.html"/>
</flow>
```

## [](#http-basic-security-filter-の-xml-設定例)HTTP Basic Security Filter の XML 設定例

次の例は、フロー内の ​`http:basic-security-filter`​ 操作の XML 設定を示しています。

```xml
<flow name="listenerBasicAuth">
   <http:listener config-ref="listenerConfigBasicAuth" path="/basic"/>
   <http:basic-security-filter realm="mule-realm"/>
   <logger message="TestBasicAuthOk"/>
</flow>
```

## [](#http-要求応答エラー応答の本文の-xml-の例)HTTP 要求、応答、エラー応答の本文の XML の例

HTTP 要求、応答、およびエラー応答の本文は、必要に応じて定義します。本文要素を明示的に定義しない場合、要求または応答はデフォルトのペイロードを返します。

次の例は、カスタム ​`body`​、キー/値 ​`query-parameter`​、X-Custom ​`header`​、URI パラメーター ​`uriParam`​ を入力する ​`uriParamsMap`​ 変数を含む ​`uri-params`​ を定義する、​`http:request`​ 操作の XML 設定を示しています。

```xml
<http:request path="/{uriParam}/test"  config-ref="reqConfig">
   <http:body>
       #['Custom body']
   </http:body>
   <http:headers>
       #[{'X-Custom' : 'custom'}]
   </http:headers>
   <http:uri-params>
       #[uriParamsMap]
   </http:uri-params>
   <http:query-params>
       #[{'key’' : 'value’'}]
   </http:query-params>
</http:request>
```

次の例は、定義された ​`body`​ 要素が欠けている ​`http:listener`​ ソースの XML 設定を示しています。返される値は、デフォルトのペイロードです。このペイロードには実行に成功した場合の ​`http:response`​ が定義されており、​`statusCode`​ として ​`200`​、​`reasonPhrase`​ として ​`Ok`​、​`headers`​ の ​`Name`​ に ​`content`​、​`Something`​ に ​`someValue`​ を返します。

```xml
<http:listener path="test" allowedMethods="GET" config-ref="lisConfig">
   <http:response statusCode="200" reasonPhrase="Ok">
       <http:headers>
           #[{"Name" : "content", "Something" : someValue}]
       </http:headers>
   </http:response>
</http:listener>
```

次の例は、実行に失敗した場合の応答を定義する ​`http:listener`​ ソースの XML 設定を示しています。​`statusCode`​ として ​`502`​、​`reasonPhrase`​ として ​`Failure`​、​`headers`​ の ​`Error`​ に ​`FIRE`​、​`body`​ に ​`Oops, something is wrong`​ を返します。

```xml
<http:listener path="test" allowedMethods="GET" config-ref="lisConfig">
   <http:error-response statusCode="502" reasonPhrase="Failure">
       <http:body>
           #[‘Oops, something is wrong’]
       </http:body>
       <http:headers>
           #[{"Error" : "FIRE"}]
       </http:headers>
   </http:error-response>
</http:listener>
```

## [](#関連情報)関連情報

- [HTTP Connector リファレンス](https://docs.mulesoft.com/jp/http-connector/1.7/http-documentation)