リソースマッピング

リソースマッピングは、リダイレクト、バニティー URL および AEM 用の仮想ホストを定義するために使用します。

例えば、これらのマッピングを使用すると次のことが可能です。

  • すべてのリクエストの先頭にプレフィックスを付けます。 /content 内部構造は、Web サイトの訪問者に対して非表示になります。
  • リダイレクトを定義して、 /content/en/gateway Web サイトのページがにリダイレクトされます。 https://gbiv.com/.

HTTP マッピングの一例として、localhost:4503 に対するすべての要求に /content というプレフィックスを指定します。このようなマッピングを使用すると、Web サイトの訪問者に対して内部構造を非表示にすることができます。例えば、次のページにアクセスできます。

localhost:4503/content/geometrixx/en/products.html

マッピング前のページは次のとおりです。

localhost:4503/geometrixx/en/products.html

マッピングによってプレフィックスが自動的に追加されるので /content から /geometrixx/en/products.html.

注意

バニティー URL は regex パターンをサポートしません。

メモ

詳しくは、Sling のドキュメントと「Mappings for Resource Resolution」と「Resources」を参照してください。

マッピング定義の確認

マッピングでは 2 つのリストが作成されます。JCR Resource Resolver は、これらのリストを(トップダウン)評価して一致項目を探します。

これらのリストは、(設定情報と共に) JCR ResourceResolver Felix コンソールのオプション例: https://<host>:<port>/system/console/jcrresolver:

  • 設定

    現在の設定を表示します ( Apache Sling Resource Resolver.

  • 設定テスト

    URL またはリソースパスを入力できます。「Resolve」または「Map」をクリックして、システムによるエントリの変換方法を確認します。

  • Resolver Map Entries
    URL をリソースにマップするために ResourceResolver.resolve メソッドが使用するエントリのリストです。

  • Mapping Map Entries
    リソースパスを URL にマップするために ResourceResolver.map メソッドが使用するエントリのリストです。

2 つのリストには、アプリケーションでデフォルトとして定義されたエントリを含む様々なエントリが表示されます。これらのエントリの目的は、多くの場合、ユーザーのために URL を簡略化することです。

リストでは、パターン(要求に適合する正規表現)と​リプレースメント(適用するリダイレクトを定義します)がペアになっています。

例えば、次のパターンがあるとします。

パターン ^[^/]+/[^/]+/welcome$

このパターンは次のリプレースメントを呼び出します。

代替機能 /libs/cq/core/content/welcome.html.

これにより、次の要求がリダイレクトされます。

http://localhost:4503/welcome

リダイレクト先は次のとおりです。

http://localhost:4503/libs/cq/core/content/welcome.html

新しいマッピング定義がリポジトリ内に作成されます。

メモ

正規表現の定義方法を説明するリソースが多数あります。例: https://www.regular-expressions.info/.

AEM でのマッピング定義の作成

AEM の標準インストールには、次のフォルダーがあります。

/etc/map/http

これは、HTTP プロトコル用のマッピングを定義する場合に使用する構造です。その他のフォルダー ( sling:Folder) は以下に作成できます。 /etc/map マッピングする他のプロトコルに対して。

/content への内部リダイレクトの設定

http://localhost:4503/への要求の先頭に「 /content:

  1. CRXDE を使用して、に移動します。 /etc/map/http.

  2. 新しいノードを作成します。

    • sling:Mapping

      このノードタイプは、このようなマッピングを対象としていますが、使用が必須ではありません。

    • 名前 localhost_any

  3. すべて保存」をクリックします。

  4. このノードに次のプロパティを​追加​します。

    • 名前 sling:match

      • String
      • localhost.4503/
    • 名前 sling:internalRedirect

      • String
      • /content/
  5. すべて保存」をクリックします。

これは、次のようなリクエストを処理します。
localhost:4503/geometrixx/en/products.html
次のように:
localhost:4503/content/geometrixx/en/products.html
が要求されていた

メモ

使用可能な sling のプロパティとその設定方法について詳しくは、Sling のドキュメントの「Resources」を参照してください。

メモ

以下を使用できます。 /etc/map.publish パブリッシュ環境の設定を保持する。 次に、これらを複製し、新しい場所 ( /etc/map.publish) が マッピング場所Apache Sling Resource Resolver パブリッシュ環境の

このページ