URL の外部化 externalizing-urls
AEM の Externalizer は、プログラムによってリソースパス（例：/path/to/my/page）を外部の絶対 URL（例：https://www.mycompany.com/path/to/my/page）に変換できるようにする OSGi サービスであり、その変換はパスに事前設定済みの DNS をプレフィックスとして付けることで実現します。
Web レイヤーの背後で実行されている場合、インスタンスは外部から表示される URL を認識できないので、リクエスト範囲外でリンクを作成する必要がある場合があるので、このサービスを使用して、外部 URL を設定して作成できます。
このページでは、 Externalizer サービスとその使用方法について説明します。 詳しくは、 Javadocs.
Externalizer サービスの設定 configuring-the-externalizer-service
Externalizer サービスでは、プログラムによってリソースパスにプレフィックスを付けるために使用可能な複数のドメインを一元的に定義できます。各ドメインは一意の名前によって識別され、その名前を使用して、プログラムからそのドメインを参照できます。
Externalizer サービスのドメインマッピングを定義するには：
-
で設定マネージャーに移動します。 ツール を、 Web コンソール または、
https://<host>:<port>/system/console/configMgr. -
「Day CQ Link Externalizer」をクリックして設定ダイアログボックスを開きます。
note note NOTE この設定に直接アクセスするためのリンクは https://<host>:<port>/system/console/configMgr/com.day.cq.commons.impl.ExternalizerImplです。
-
ドメインマッピングの定義：マッピングは、ドメイン、スペースおよびドメインを参照するコード内で使用できる一意の名前で構成されます。
<unique-name> [scheme://]server[:port][/contextpath], 条件:- スキーム は通常、http または https ですが、ftp などでもかまいません。;必要に応じて、https を使用して https リンクを強制します。URL の外部化を要求する際に、クライアントコードがスキームを上書きしない場合に使用されます。
- server はホスト名です（ドメイン名または IP アドレス）。
- port（オプション）はポート番号です。
- contextpath（オプション）は、AEM が異なるコンテキストパスの下の Web アプリケーションとしてインストールされている場合に限り設定します。
例：
production https://my.production.instance次のマッピング名は事前定義されており、AEM で使用されるので、常に設定されている必要があります。
- ローカル — ローカルインスタンス
- 作成者 — オーサリングシステムの DNS
- 公開 — 公開ウェブサイト DNS
note note NOTE カスタム設定を使用すると、「production」、「staging」、または「my-internal-webservice」などの外部のAEM以外のシステムでさえ新しいカテゴリを追加でき、プロジェクトのコードベースの様々な場所に URL をハードコーディングするのを避けるのに役立ちます。 -
「保存」をクリックして変更を保存します。
Externalizer サービスの使用 using-the-externalizer-service
この節では、 Externalizer サービスを使用できます。
JSP で Externalizer サービスを取得する：
Externalizer externalizer = resourceResolver.adaptTo(Externalizer.class);
「publish」ドメインを付与してパスを外部化するには：
String myExternalizedUrl = externalizer.publishLink(resolver, "/my/page") + ".html";
ドメインマッピングが「 publish https://www.website.com", myExternalizedUrl が値" https://www.website.com/contextpath/my/page.html".
「author」ドメインを付与してパスを外部化するには：
String myExternalizedUrl = externalizer.authorLink(resolver, "/my/page") + ".html";
ドメインマッピングが「 author https://author.website.com", myExternalizedUrl が値" https://author.website.com/contextpath/my/page.html".
「local」ドメインを付与してパスを外部化するには：
String myExternalizedUrl = externalizer.externalLink(resolver, Externalizer.LOCAL, "/my/page") + ".html";
ドメインマッピングが「 local https://publish-3.internal", myExternalizedUrl が値" https://publish-3.internal/contextpath/my/page.html".
他の例については、関連する Javadoc を参照してください。