複数ドメインでの Dispatcher の使用 using-dispatcher-with-multiple-domains

NOTE
Dispatcher のバージョンは AEM とは無関係です。AEM または CQ のドキュメントに埋め込まれた Dispatcher のドキュメントへのリンクをたどると、このページにリダイレクトされる可能性があります。

Dispatcher を使用して、次の条件を満たしつつ、複数の web ドメインでページリクエストを処理します。

  • 両方のドメイン用の web コンテンツが単一の AEM リポジトリに保存されている。
  • Dispatcher キャッシュ内のファイルをドメインごとに個別に無効化できる。

例えば、ある会社がブランド A とブランド B という 2 つのブランドの web サイトを公開しているとします。Web サイトページのコンテンツは AEM で作成され、次のように同じリポジトリワークスペースに保存されています。

/
| - content
   | - sitea
       | - content nodes
   | - siteb
       | - content nodes

BrandA.com 用のページは、/content/sitea の下に保存されています。URL https://BrandA.com/en.html に対するクライアント要求には、/content/sitea/en ノード向けにレンダリングされたページが返されます。同様に、BrandB.com 用のページは、/content/siteb の下に保存されています。

Dispatcher を使用してコンテンツをキャッシュする場合は、クライアント HTTP リクエスト内のページ URL、対応するキャッシュされたファイルのパスおよびリポジトリ内の対応するファイルのパスの間に関連付けを作成します。

クライアント要求

クライアントが HTTP リクエストを web サーバーに送信した場合、リクエストされたページの URL を Dispatcher キャッシュ内のコンテンツに解決し、最終的にはリポジトリ内のコンテンツに解決する必要があります。

  1. ドメインネームシステムが、HTTP リクエスト内のドメイン名に対して登録されている web サーバーの IP アドレスを検出します。
  2. HTTP リクエストが web サーバーに送信されます。
  3. HTTP リクエストが Dispatcher に渡されます。
  4. Dispatcher が、キャッシュされたファイルが有効かどうか判断します。有効な場合、キャッシュされたファイルがクライアントに提供されます。
  5. キャッシュされたファイルが有効ではない場合、Dispatcher は AEM パブリッシュインスタンスから新たにレンダリングされたページをリクエストします。

キャッシュの無効化

Dispatcher フラッシュレプリケーションエージェントが、キャッシュされたファイルを Dispatcher が無効化するようにリクエストした場合、リポジトリ内のコンテンツのパスをキャッシュ内のコンテンツに解決する必要があります。

  • a - AEM オーサーインスタンス上でページがアクティベートされ、コンテンツがパブリッシュインスタンスにレプリケートされます。
  • b - Dispatcher フラッシュエージェントが、Dispatcher を呼び出して、レプリケートされたコンテンツのキャッシュを無効にします。
  • c - Dispatcher が 1 つまたは複数の .stat ファイルにアクセスして、キャッシュされたファイルを無効にします。

複数のドメインで Dispatcher を使用するには、AEM、Dispatcher および web サーバーを設定する必要があります。このページで説明する解決方法は一般的なもので、ほとんどの環境に適用できます。AEM トポロジが複雑なときは、特定の問題を解決するために、さらにカスタム設定が必要な場合があります。既存の IT インフラストラクチャおよび管理ポリシーを満たすには、サンプルの適用が必要になる可能性があります。

URL マッピング url-mapping

ドメイン URL とコンテンツパスをキャッシュされたファイルに解決できるようにするには、処理中にファイルパスまたはページ URL を変換する必要があります。次の一般的な戦略について説明します。パスまたは URL の変換はプロセスのさまざまな時点で行われます。

  • (推奨)AEM パブリッシュインスタンスは、リソース解決に Sling マッピングを使用して、内部 URL 書き換えルールを実装します。ドメイン URL は、コンテンツリポジトリのパスに変換されます。詳しくは、AEM による受信 URL の書き換えを参照してください。
  • Web サーバーは、ドメイン URL をキャッシュのパスに変換する内部 URL 書き換えルールを使用します。詳しくは、Web サーバーによる受信 URL の書き換えを参照してください。

Web ページには短い URL を使用することが理想的です。通常、ページ URL は、web コンテンツを格納するリポジトリフォルダーの構造を反映します。ただし、URL には最上位のリポジトリノード(/content など)が表示されません。クライアントは、必ずしも AEM リポジトリの構造を意識しません。

一般的な要件 general-requirements

Dispatcher を複数のドメインで動作させるために、環境を以下のように設定する必要があります。

  • 各ドメイン用のコンテンツをリポジトリの別々のブランチに配置する(以下のサンプルの環境を参照)。
  • Dispatcher フラッシュレプリケーションエージェントを AEM パブリッシュインスタンス上に設定する。(パブリッシュインスタンスからの Dispatcher キャッシュの無効化を参照)。
  • ドメイン名システムは、ドメイン名を web サーバーの IP アドレスに解決します。
  • Dispatcher キャッシュは、AEM コンテンツリポジトリのディレクトリ構造を反映します。Web サーバーのドキュメントルートの下のファイルパスは、リポジトリ内のファイルのパスと同じです。

提供される例の環境 environment-for-the-provided-examples

提供されるソリューションの例は、次の特性を持つ環境に適用されます。

  • AEM オーサーインスタンスとパブリッシュインスタンスは、Linux® システムにデプロイされます。

  • Apache HTTPD は、Linux® システムにデプロイされる web サーバーです。

  • AEM コンテンツリポジトリと Web サーバーのドキュメントルートが、以下のファイル構造を使用している(Apache Web サーバーのドキュメントルートは /usr/lib/apache/httpd-2.4.3/htdocs)):

    リポジトリ

  | - /content
    | - sitea
  |    | - content nodes
    | - siteb
       | - content nodes

Web サーバーのドキュメントルート

  | - /usr
    | - lib
      | - apache
        | - httpd-2.4.3
          | - htdocs
            | - content
              | - sitea
                 | - content nodes
              | - siteb
                 | - content nodes

AEM による受信 URL の書き換え aem-rewrites-incoming-urls

リソース解決の Sling マッピングを使用すると、受信 URL を AEM コンテンツパスに関連付けることができます。AEM パブリッシュインスタンスにマッピングを作成して、Dispatcher からのレンダリングリクエストがリポジトリ内の正しいコンテンツに解決されるようにします。

ページレンダリングの Dispatcher リクエストは、web サーバーから渡された URL を使用してページを識別します。URL にドメイン名が含まれている場合、Sling マッピングで URL をコンテンツに解決します。次の図は、branda.com/en.html の URL と /content/sitea/en ノードのマッピングを示したものです。

Dispatcher キャッシュは、リポジトリのノード構造をミラーリングしています。そのため、ページがアクティベートされたときに送信される、キャッシュされたページの無効化要求では、URL またはパスを変換する必要がありません。

Web サーバー上の仮想ホストの定義 define-virtual-hosts-on-the-web-server

Web サーバー上の仮想ホストを定義して、各 web ドメインに異なるドキュメントルートを割り当てられるようにします。

  • Web サーバーは、各 web ドメインに対して仮想ドメインを定義する必要があります。
  • ドメインごとに、そのドメインの Web コンテンツを格納するリポジトリ内のフォルダーと一致するようにドキュメントルートを設定します。
  • Dispatcher のインストールで説明しているように、各仮想ドメインには Dispatcher 関連の設定も含める必要があります。

以下のサンプルの httpd.conf ファイルでは、1 つの Apache Web サーバーに対して 2 つの仮想ドメインを設定しています。

  • サーバー名(ドメイン名と一致する)は branda.com(16 行目)と brandb.com(30 行目)です。
  • 各仮想ドメインのドキュメントルートは、サイトのページを格納する Dispatcher キャッシュ内のディレクトリです。(17 行目と 31 行目)

この設定を使用すると、https://branda.com/en/products.html に対するリクエストを受信したときに、web サーバーが次のアクションを実行します。

  • URL を ServerNamebranda.com. の仮想ホストと関連付けます。

  • URL を Dispatcher に転送します。

httpd.conf httpd-conf

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 0
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

仮想ホストは、メインサーバーセクションで設定された DispatcherConfig プロパティ値を継承します。仮想ホストに DispatcherConfig プロパティを含めて、メインサーバー設定をオーバーライドできます。

複数ドメインを処理するように Dispatcher を設定 configure-dispatcher-to-handle-multiple-domains

ドメイン名と対応する仮想ホストを含む URL をサポートするには、次の Dispatcher ファームを定義します。

  • 各仮想ホストに対して Dispatcher ファームを設定します。これらのファームが各ドメインの Web サーバーからの要求を処理し、キャッシュされたファイルを確認し、レンダーからページを要求します。
  • コンテンツが属するドメインに関係なく、キャッシュのコンテンツの無効化に使用する Dispatcher ファームを設定します。このファームは、フラッシュ Dispatcher レプリケーションエージェントからのファイルの無効化リクエストを処理します。

仮想ホスト用の Dispatcher ファームの作成

クライアント HTTP 要求内の URL を Dispatcher キャッシュ内の適切なファイルに解決できるよう、仮想ホスト用の仮想ファームには以下の設定が必要です。

  • /virtualhosts プロパティをドメイン名に設定します。このプロパティを使用すると、Dispatcher でこのプロパティを使用してファームとドメインを関連付けることができます。

  • /filter プロパティは、ドメイン名部分の後ろを切り捨てた要求 URL のパスへのアクセスを許可します。例えば、https://branda.com/en.html という URL の場合 /en.html として解釈されるので、フィルターはこのパスへのアクセスを許可する必要があります。

  • /docroot プロパティは、ルートディレクトリのパスに設定されます。つまり、Dispatcher キャッシュ内にあるドメインのサイトコンテンツのルートディレクトリです。このパスは、元の要求から連結された URL のプレフィックスとして使用されます。例えば、/usr/lib/apache/httpd-2.4.3/htdocs/sitea の docroot は、/usr/lib/apache/httpd-2.4.3/htdocs/sitea/en.html ファイルを解決するために https://branda.com/en.html を要求します。

また、AEM パブリッシュインスタンスを仮想ホストのレンダーとして指定する必要があります。必要に応じて、その他のファームプロパティを設定します。次のコードは、branda.com ドメインの省略したファーム設定です。

/farm_sitea  {
    ...
    /virtualhosts { "branda.com" }
    /renders {
      /rend01  { /hostname "127.0.0.1"  /port "4503" }
    }
    /filter {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/en*" }
      ...
     }
    /cache {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs/content/sitea"
      ...
   }
   ...
}

キャッシュ無効化のための Dispatcher ファームの作成

Dispatcher ファームは、キャッシュされたファイルを無効にするリクエストの処理に必要です。このファームは、各仮想ホストの docroot ディレクトリ内の.stat ファイルにアクセスできる必要があります。

次のプロパティ設定を使用すると、Dispatcher はキャッシュ内のファイルから AEM コンテンツリポジトリ内のファイルを解決できます。

  • /docroot プロパティは、web サーバーのデフォルトの docroot に設定されます。一般的に、/docroot は、/content フォルダーが作成されるディレクトリです。Linux® 上の Apache の場合の値の一例は、/usr/lib/apache/httpd-2.4.3/htdocs になります。
  • /filter プロパティは、/content ディレクトリの下にあるファイルへのアクセスを許可します。

/statfileslevel プロパティには、各仮想ホストのルートディレクトリに .stat ファイルを作成できるだけの高さが必要です。このプロパティを使用して、各ドメインのキャッシュを個別に無効化できます。サンプルの設定として、/statfileslevel の値が 2 の場合、*docroot*/content/sitea ディレクトリと *docroot*/content/siteb ディレクトリに .stat ファイルが作成されます。

また、パブリッシュインスタンスを仮想ホストのレンダーとして指定する必要があります。必要に応じて、その他のファームプロパティを設定します。次のコードは、キャッシュの無効化に使用するファームの省略された設定です。

/farm_flush {
    ...
    /virtualhosts   { "invalidation_only" }
    /renders  {
      /rend01  { /hostname "127.0.0.1" /port "4503" }
    }
    /filter   {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }
      ...
      }
    /cache  {
       /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
       /statfileslevel "2"
       ...
   }
   ...
}

Web サーバーを起動すると、Dispatcher ログ(デバッグモード)に、すべてのファームの初期化が示されます。

Dispatcher initializing (build 4.1.2)
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_sitea].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_siteb].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
[Fri Nov 02 16:27:18 2012] [D] [24974(140006182991616)] farms[farm_flush].cache.docroot = /usr/lib/apache/httpd-2.4.3/htdocs
[Fri Nov 02 16:27:18 2012] [I] [24974(140006182991616)] Dispatcher initialized (build 4.1.2)

リソース解決のための Sling マッピングの設定 configure-sling-mapping-for-resource-resolution

ドメインベースの URL が AEM パブリッシュインスタンス上のコンテンツに解決されるように、リソースの解決に Sling マッピングを使用します。リソースマッピングは、Dispatcher から(元はクライアント HTTP 要求)の受信 URL をコンテンツノードに変換します。

Sling リソースマッピングについて詳しくは、Sling のドキュメントの Mappings for Resource Resolutionを参照してください。

一般的に、次のリソースにはマッピングが必要ですが、他のマッピングが必要な場合もあります。

  • コンテンツページのルートノード(/content の下)
  • ページが使用するデザインノード(/etc/designs の下)
  • /libs フォルダー

コンテンツページのマッピングを作成した後、さらに必要なマッピングを検出するには、web ブラウザーを使用して web サーバー上のページを開きます。パブリッシュインスタンスの error.log ファイルで、見つからないリソースに関するメッセージを探します。以下のサンプルメッセージは、/etc/clientlibs に対するマッピングが必要であることを示しています。

01.11.2012 15:59:24.601 *INFO* [10.36.34.243 [1351799964599] GET /etc/clientlibs/foundation/jquery.js HTTP/1.1] org.apache.sling.engine.impl.SlingRequestProcessorImpl service: Resource /content/sitea/etc/clientlibs/foundation/jquery.js not found
NOTE
デフォルトの Apache Sling リライターのリンクチェック変換サービスでは、リンクが壊れるのを防ぐために、ページ内のハイパーリンクを自動的に変更します。ただし、リンクの書き換えは、リンクのターゲットが HTML または HTM ファイルの場合にのみ実行されます。他のファイルタイプへのリンクを更新するには、変換サービスコンポーネントを作成して、HTML リライターパイプラインに追加します。

リソースマッピングノードの例

branda.com ドメイン用のリソースマッピングを実装するノードを以下の表に示します。同様のノードが brandb.com 用にも作成されます(例:/etc/map/http/brandb.com)。どの場合でも、HTML ページ内の参照が Sling のコンテキストで正しく解決されない場合にはマッピングが必要です。

ノードパス
タイプ
プロパティ
/etc/map/http/branda.com
sling:Mapping
Name: sling:internalRedirect Type: String Value: /content/sitea
/etc/map/http/branda.com/libs
sling:Mapping
Name: sling:internalRedirect <br/>Type: String <br/>Value: /libs
/etc/map/http/branda.com/etc
sling:Mapping
/etc/map/http/branda.com/etc/designs
sling:Mapping
Name: sling:internalRedirect <br/>VType: String <br/>VValue: /etc/designs
/etc/map/http/branda.com/etc/clientlibs
sling:Mapping
Name: sling:internalRedirect <br/>VType: String <br/>VValue: /etc/clientlibs

Dispatcher フラッシュレプリケーションエージェントの設定 configuring-the-dispatcher-flush-replication-agent

AEM パブリッシュインスタンス上の Dispatcher フラッシュレプリケーションエージェントは、無効化リクエストを適切な Dispatcher ファームに送信する必要があります。ファームをターゲットにするには、Dispatcher フラッシュレプリケーションエージェント(「トランスポート」タブ内)の URI プロパティを使用します。キャッシュを無効化するために設定されている Dispatcher ファームの /virtualhost プロパティの値を含めます。

https://*webserver_name*:*port*/*virtual_host*/dispatcher/invalidate.cache

例えば、前の例の farm_flush ファームを使用する場合、URI は https://localhost:80/invalidation_only/dispatcher/invalidate.cache になります。

Web サーバーによる受信 URL の書き換え the-web-server-rewrites-incoming-urls

ドメインベースの URL を Dispatcher キャッシュ内のファイルパスに変換するには、web サーバーの内部 URL 書き換え機能を使用します。例えば、https://brandA.com/en.html ページに対するクライアント要求は、Web サーバーのドキュメントルート内にある content/sitea/en.html ファイルに変換されます。

Dispatcher キャッシュは、リポジトリのノード構造をミラーリングしています。そのため、ページがアクティベートされたときに送信される、キャッシュされたページの無効化要求では、URL またはパスを変換する必要がありません。

Web サーバー上での仮想ホストおよび書き換えルールの定義 define-virtual-hosts-and-rewrite-rules-on-the-web-server

Web サーバー上で次の要素を設定します。

  • Web ドメインごとに仮想ホストを定義します。
  • ドメインごとに、そのドメインの Web コンテンツを格納するリポジトリ内のフォルダーと一致するようにドキュメントルートを設定します。
  • 仮想ドメインごとに、受信 URL をキャッシュされたファイルのパスに変換する URL 名変更ルールを作成します。
  • Dispatcher のインストールで説明しているように、各仮想ドメインには Dispatcher 関連の設定も含める必要があります。
  • Dispatcher モジュールは、Web サーバーが書き換えた URL を使用するように設定する必要があります。(Dispatcher のインストールDispatcherUseProcessedURL プロパティを参照。)

以下のサンプル httpd.conf ファイルでは、1 つの Apache Web サーバーに対して 2 つの仮想ホストを設定しています。

  • サーバー名(ドメイン名と一致する)は brandA.com(16 行目)と brandB.com(32 行目)です。

  • 各仮想ドメインのドキュメントルートは、サイトのページを格納する Dispatcher キャッシュ内のディレクトリです。(20 行目と 33 行目)

  • 各仮想ドメインの URL 書き換えルールは、正規表現です。正規表現は、リクエストされたページのパスに接頭辞として付加します。キャッシュ内のページのパスを接頭辞として付加します。(19 行目と 35 行目)

  • DispatcherUseProcessedURL プロパティを 1 に設定します。(10 行目)

例えば、Web サーバーは、https://brandA.com/en/products.html という URL を持つ要求を受信した場合、次のアクションを実行します。

  • URL を ServerNamebrandA.com. の仮想ホストと関連付けます。
  • URL を /content/sitea/en/products.html. に書き換えます。
  • URL を Dispatcher に転送します。

httpd.conf httpd-conf-1

# load the Dispatcher module
LoadModule dispatcher_module modules/mod_dispatcher.so
# configure the Dispatcher module
<IfModule disp_apache2.c>
 DispatcherConfig conf/dispatcher.any
 DispatcherLog    logs/dispatcher.log
 DispatcherLogLevel 3
 DispatcherNoServerHeader 0
 DispatcherDeclineRoot 0
 DispatcherUseProcessedURL 1
 DispatcherPassError 0
</IfModule>

# Define virtual host for brandA.com
<VirtualHost *:80>
  ServerName branda.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/sitea/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/sitea>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# define virtual host for brandB.com
<VirtualHost *:80>
  ServerName brandB.com
  DocumentRoot /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb
  RewriteEngine  on
  RewriteRule    ^/(.*)\.html$  /content/siteb/$1.html [PT]
   <Directory /usr/lib/apache/httpd-2.4.3/htdocs/content/siteb>
     <IfModule disp_apache2.c>
       SetHandler dispatcher-handler
       ModMimeUsePathInfo On
     </IfModule>
     Options FollowSymLinks
     AllowOverride None
   </Directory>
</VirtualHost>

# document root for web server
DocumentRoot "/usr/lib/apache/httpd-2.4.3/htdocs"

Dispatcher ファームの設定 configure-a-dispatcher-farm

Web サーバーが URL を書き換える場合、Dispatcher には Dispatcher の設定に応じて定義された単一のファームが必要です。Web サーバーの仮想ホストと URL 名変更ルールをサポートするには、以下の設定が必要です。

  • /virtualhosts プロパティにすべての VirtualHost 定義の ServerName 値を含める必要があります。
  • /statfileslevel プロパティには、各ドメインのコンテンツファイルを格納するディレクトリ内で .stat ファイルを作成できるよう、十分な大きさにする必要があります。

以下のサンプルの dispatcher.any ファイルは、Dispatcher と一緒にインストールされるサンプルの ファイルをベースとしています。以前の httpd.conf ファイルの Web サーバー設定をサポートするには、次の変更が必要です。

  • /virtualhosts プロパティによって、Dispatcher が brandA.com ドメインおよび brandB.com ドメインに対する要求を処理します。(12 行目)
  • ドメインの Web コンテンツを格納する各ディレクトリに stat ファイルを作成できるよう、/statfileslevel プロパティを「2」に設定します(41 行目):/statfileslevel "2"

通常どおり、キャッシュのドキュメントルートは Web サーバーのドキュメントルートと同じです(40 行目):/usr/lib/apache/httpd-2.4.3/htdocs

dispatcher.any dispatcher-any

/name "testDispatcher"
/farms
  {
  /dispfarm0
    {
    /clientheaders
      {
      "*"
      }
    /virtualhosts
      {
      "brandA.com" "brandB.com"
      }
    /renders
      {
      /rend01    {  /hostname "127.0.0.1"   /port "4503"  }
      }
    /filter
      {
      /0001 { /type "deny"  /glob "*" }
      /0023 { /type "allow" /glob "*/content*" }  # disable this rule to allow mapped content only
      /0041 { /type "allow" /glob "* *.css *"   }  # enable css
      /0042 { /type "allow" /glob "* *.gif *"   }  # enable gifs
      /0043 { /type "allow" /glob "* *.ico *"   }  # enable icos
      /0044 { /type "allow" /glob "* *.js *"    }  # enable javascript
      /0045 { /type "allow" /glob "* *.png *"   }  # enable png
      /0046 { /type "allow" /glob "* *.swf *"   }  # enable flash
      /0061 { /type "allow" /glob "POST /content/[.]*.form.html" }  # allow POSTs to form selectors under content
      /0062 { /type "allow" /glob "* /libs/cq/personalization/*"  }  # enable personalization
      /0081 { /type "deny"  /glob "GET *.infinity.json*" }
      /0082 { /type "deny"  /glob "GET *.tidy.json*"     }
      /0083 { /type "deny"  /glob "GET *.sysview.xml*"   }
      /0084 { /type "deny"  /glob "GET *.docview.json*"  }
      /0085 { /type "deny"  /glob "GET *.docview.xml*"  }
      /0086 { /type "deny"  /glob "GET *.*[0-9].json*" }
      /0090 { /type "deny"  /glob "* *.query.json*" }
      }
    /cache
      {
      /docroot "/usr/lib/apache/httpd-2.4.3/htdocs"
      /statfileslevel "2"
      /allowAuthorized "0"
      /rules
        {
        /0000  { /glob "*"     /type "allow"  }
        }
      /invalidate
        {
        /0000  {   /glob "*" /type "deny"  }
        /0001 {  /glob "*.html" /type "allow"  }
        }
      /allowedClients
        {
        }
      }
    /statistics
      {
      /categories
        {
        /html  { /glob "*.html" }
        /others  {  /glob "*"  }
        }
      }
    }
  }
NOTE
単一の Dispatcher ファームが定義されているので、AEM パブリッシュインスタンス上の Dispatcher フラッシュレプリケーションエージェントに特別な設定は必要ありません。

.html または .htm 以外の拡張子を持つファイルへの参照を書き換えるには、Sling リライター変換サービスコンポーネントを作成し、デフォルトのリライターパイプラインに追加します。

Web サーバーコンテキストでリソースパスが正しく解決されない場合は、参照を書き換えます。例えば、画像生成コンポーネントで /content/sitea/en/products.navimage.png などのリンクを作成する場合は、変換サービスが必要です。完全な機能を持つインターネット web サイトの作成方法topnav コンポーネントは、このようなリンクを作成します。

Sling リライターは、Sling の出力を後処理するモジュールです。リライターの SAX パイプライン実装は、1 つのジェネレーター、1 つまたは複数の変換サービス、1 つのシリアライザーで構成されます。

  • ジェネレーター: Sling 出力ストリーム(HTML ドキュメント)を解析し、特定の要素タイプを検出した場合は SAX イベントを生成します。
  • 変換サービス: SAX イベントをリッスンし、イベントターゲット(HTML 要素)を変更します。リライターパイプラインには、0 個以上の変換サービスが含まれます。変換サービスが順に実行され、SAX イベントがシーケンス内の次の変換サービスに渡されます。
  • シリアライザー: ​各変換サービスによる変更を含む、出力をシリアル化します。

AEM のデフォルトのリライターパイプライン the-aem-default-rewriter-pipeline

AEM は、text/html タイプのドキュメントを処理するデフォルトのパイプラインリライターを使用します。

  • ジェネレーターは、HTML ドキュメントを解析し、img、area、form、base、link、script、body の要素を検出した場合に SAX イベントを生成します。ジェネレーターのエイリアスは htmlparser です。
  • パイプラインには、linkcheckermobilemobiledebugcontentsync という変換サービスが含まれます。linkchecker 変換サービスは、リンクが壊れないように、参照される HTML または HTM ファイルへのパスを外部化します。
  • シリアライザーが HTML 出力を書き出します。シリアライザーのエイリアスは、htmlwriter です。

/libs/cq/config/rewriter/default ノードはパイプラインを定義します。

変換サービスの作成 creating-a-transformer

変換サービスコンポーネントを作成してパイプラインで使用するには、次のタスクを実行します。

  1. org.apache.sling.rewriter.TransformerFactory インターフェイスを実装します。このクラスが変換サービスクラスのインスタンスを作成します。transformer.type プロパティ(変換サービスのエイリアス)の値を指定し、クラスを OSGi サービスコンポーネントとして設定します。
  2. org.apache.sling.rewriter.Transformer インターフェイスを実装します。org.apache.cocoon.xml.sax.AbstractSAXPipe クラスを拡張して、作業を最小限に抑えることができます。書き換え動作をカスタマイズするには、startElement メソッドを上書きします。このメソッドは、変換サービスに渡されるすべての SAX イベントに対して呼び出されます。
  3. クラスをバンドルしてデプロイします。
  4. 変換サービスをパイプラインに追加するには、AEM アプリケーションに設定ノードを追加します。
TIP
代わりに、定義されているすべてのリライターに変換サービスを挿入するように、TransformerFactory を設定することもできます。したがって、パイプラインを設定する必要がなくなります。
  • pipeline.mode プロパティを global に設定します。
  • service.ranking プロパティを正の整数に設定します。
  • pipeline.type プロパティを含めないでください。
NOTE
Maven プロジェクトを作成するには、コンテンツパッケージ Maven プラグインの multimodule アーキタイプを使用します。POM はコンテンツパッケージを自動的に作成してインストールします。

次の例では、画像ファイルへの参照を書き換える変換サービスを実装します。

  • MyRewriterTransformerFactory クラスが、MyRewriterTransformer オブジェクトをインスタンス化します。pipeline.type プロパティが、変換サービスのエイリアスに mytransformer を設定します。エイリアスをパイプラインに含めるには、パイプライン設定ノードの変換サービスのリストにこのエイリアスを含める必要があります。
  • MyRewriterTransformer クラスは、AbstractSAXTransformer クラスの startElement メソッドを上書きします。startElement メソッドは、img 要素の src 属性の値を書き換えます。

例は堅牢ではありません。実稼動環境では使用しないでください。

サンプルの TransformerFactory 実装 example-transformerfactory-implementation

package com.adobe.example;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Property;

import org.apache.sling.rewriter.Transformer;
import org.apache.sling.rewriter.TransformerFactory;

@Component
@Service
public class MyRewriterTransformerFactory implements TransformerFactory {
    /* Define the alias */
    @Property(value="mytransformer")
    static final String PIPELINE_TYPE ="pipeline.type";

    public Transformer createTransformer() {

        return new MyRewriterTransformer ();
    }
}

サンプルの変換サービス実装 example-transformer-implementation

package com.adobe.example;

import java.io.IOException;

import org.apache.cocoon.xml.sax.AbstractSAXPipe;

import org.apache.sling.api.SlingHttpServletRequest;
import org.apache.sling.rewriter.ProcessingComponentConfiguration;
import org.apache.sling.rewriter.ProcessingContext;
import org.apache.sling.rewriter.Transformer;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import org.xml.sax.Attributes;
import org.xml.sax.SAXException;
import org.xml.sax.helpers.AttributesImpl;

import javax.servlet.http.HttpServletRequest;

public class MyRewriterTransformer extends AbstractSAXPipe implements Transformer {

 private static final Logger log = LoggerFactory.getLogger(MyRewriterTransformer.class);
 private SlingHttpServletRequest httpRequest;
 /* The element and attribute to act on  */
 private static final String ATT_NAME = new String("src");
 private static final String EL_NAME = new String("img");

 public MyRewriterTransformer () {
 }
 public void dispose() {
 }
 public void init(ProcessingContext context, ProcessingComponentConfiguration config) throws IOException {
  this.httpRequest = context.getRequest();
  log.debug("Transforming request {}.", httpRequest.getRequestURI());
 }
 @Override
 public void startElement (String nsUri, String localname, String qname, Attributes atts) throws SAXException {
  /* copy the element attributes */
  AttributesImpl linkAtts = new AttributesImpl(atts);
  /* Only interested in EL_NAME elements */
  if(EL_NAME.equalsIgnoreCase(localname)){

   /* iterate through the attributes of the element and act only on ATT_NAME attributes */
   for (int i=0; i < linkAtts.getLength(); i++) {
    if (ATT_NAME.equalsIgnoreCase(linkAtts.getLocalName(i))) {
     String path_in_link = linkAtts.getValue(i);

     /* use the resource resolver of the http request to reverse-resolve the path  */
     String mappedPath = httpRequest.getResourceResolver().map(httpRequest, path_in_link);

     log.info("Tranformed {} to {}.", path_in_link,mappedPath);

     /* update the attribute value */
     linkAtts.setValue(i,mappedPath);
    }
   }

  }
        /* return updated attributes to super and continue with the transformer chain */
 super.startElement(nsUri, localname, qname, linkAtts);
 }
}

リライターパイプラインへの変換サービスの追加 adding-the-transformer-to-a-rewriter-pipeline

変換サービスを使用するパイプラインを定義する JCR ノードを作成します。次のノード定義は、text/html ファイルを処理するパイプラインを作成します。デフォルトの AEM の HTML 用ジェネレーターおよびパーサーを使用しています。

NOTE
変換サービスのプロパティ pipeline.modeglobal に設定した場合、パイプラインを設定する必要はありません。global モードでは、変換サービスがすべてのパイプラインに挿入されます。

リライター設定ノード - XML 表現 rewriter-configuration-node-xml-representation

<?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    contentTypes="[text/html]"
    enabled="{Boolean}true"
    generatorType="htmlparser"
    order="5"
    serializerType="htmlwriter"
    transformerTypes="[mytransformer]">
</jcr:root>

次の図は、ノードの CRXDE Lite での表現を示しています。

recommendation-more-help
ce382601-480f-4a99-8be7-73178d4b6ef5