アンチパターン: カスタムコードを使用して、またはターゲットとしてプロキシ内でプロキシを呼び出す

Apigee X のドキュメントが表示されています。
Apigee Edge のドキュメントを参照する。

Apigee では、ある API プロキシから別の API プロキシを呼び出せます。この機能は、API プロキシに、他の API プロキシで使用できる再利用可能なコードが含まれている場合に利用できます。

アンチパターン

ターゲットエンドポイントで HTTPTargetConnection を使用するか、カスタム JavaScript コードを使用して、ある API プロキシから別の API プロキシを呼び出すと、追加的なネットワークホップが生じます。

`HTTPTargetConnection` を使用してプロキシ 1 からプロキシ 2 を呼び出す

次のコードサンプルは、HTTPTargetConnection を使用してプロキシ 1 からプロキシ 2 を呼び出します。

<!-- /antipatterns/examples/2-1.xml -->
<HTTPTargetConnection>
  <URL>https://api-test.example.com/proxy2</URL>
</HTTPTargetConnection>

JavaScript コードを使用してプロキシ 1 からプロキシ 2 を呼び出す

次のコードサンプルは、JavaScript を使用してプロキシ 1 からプロキシ 2 を呼び出します。

<!-- /antipatterns/examples/2-2.xml -->
var response = httpClient.send('https://api-test.example.com/proxy2);
response.waitForComplete();

コードのフロー

この方法に本質的なデメリットがある理由を理解するには、次の図に示すように、リクエストが送信されるルートを理解する必要があります。

1）クライアントがプロキシ 1 にリクエストし、2）プロキシ 1 からプロキシ 2 へのリクエストによってネットワークホップが発生し、3）プロキシ 2 からターゲットにリクエストする。 — **図 1**: コードのフロー

図に示すように、リクエストは Router と Message Processor を含む複数の分散コンポーネントを経由します。

上記のコードサンプルでは、プロキシ 1 からプロキシ 2 を呼び出す場合、実行時にリクエストは従来のルート（Router から MP へ）を経由することになります。これにより、クライアントから API を呼び出す場合と同様、複数のネットワークホップが生じてレイテンシの増大につながります。プロキシ 1 のリクエストが MP にすでに到達したことを考慮すると、このホップは不要です。

効果

ある API プロキシから別の API プロキシを呼び出すと、不要なネットワークホップが生じ、リクエストが 1 つの Message Processor から別の Message Processor に渡されることになります。

ベストプラクティス

ある API プロキシから別の API プロキシを呼び出す場合に、プロキシチェーン機能を使用します。プロキシチェーンはローカル接続を使用してターゲットエンドポイント（別の API プロキシ）を参照するため、より効率的です。
コードサンプルは、エンドポイント定義で LocalTargetConnection を使用したプロキシチェーンを示しています。
```

<LocalTargetConnection>
  <APIProxy>proxy2</APIProxy>
  <ProxyEndpoint>default</ProxyEndpoint>
</LocalTargetConnection>
```
呼び出された API プロキシは、同じ Message Processor で実行されます。その結果、次の図に示すようにネットワークホップの発生が回避されます。

図 2: プロキシチェーンのコードフロー

アンチパターン: カスタムコードを使用して、またはターゲットとしてプロキシ内でプロキシを呼び出す