Sling アダプターの使用 using-sling-adapters

Sling には、Adaptable インターフェイスを実装するオブジェクトを便利に変換できるアダプターパターンが用意されています。このインターフェイスは、オブジェクトを引数として渡されるクラスタイプに変換する汎用の adaptTo() メソッドを提供します。

例えば、リソースオブジェクトを対応するノードオブジェクトに変換するには、次の操作を実行します。

Node node = resource.adaptTo(Node.class);

ユースケース use-cases

次のようなユースケースがあります。

戻り値 Null null-return-value

adaptTo() は null を返す場合があります。

null が返されるには、次のような様々な理由があります。

null ケースを適切に処理することが重要です。JSP レンダリングの場合、コンテンツの一部が空になると、JSP の失敗が許容される場合があります。

キャッシュ caching

パフォーマンスを改善する目的で、各実装では obj.adaptTo() 呼び出しから返されたオブジェクトを自由にキャッシュできます。obj が同じであれば、返されるオブジェクトも同じです。

このキャッシュ処理は、すべての AdapterFactory ベースのケースで実行されます。

ただし、一般的なルールはなく、オブジェクトは新しいインスタンスでも既存のインスタンスでもかまいません。したがって、どちらの動作にも依存できません。重要なのは、特に AdapterFactory 内部において、このシナリオでオブジェクトが再利用可能であるということです。

仕組み how-it-works

Adaptable.adaptTo() の実装には、様々な方法があります。

最初のケースでは、Java™ docs に何の adaptTo-targets が可能かが示されます。ただし、JCR ベースのリソースなどの特定のサブクラスでは、多くの場合、これは不可能です。後者の場合、AdapterFactory の実装は通常、バンドルのプライベートクラスの一部なので、クライアント API で公開されず、Java™ docs にも表示されません。理論的には、OSGi サービスランタイムからすべての AdapterFactory 実装にアクセスし、「アダプタブル」（ソースとターゲット）の設定を調べることは可能ですが、相互にマッピングすることはできません。最終的には、これは内部ロジックに依存し、ドキュメントに記載する必要があります。従って、参照はこちらです。

参照 reference

Sling sling

Resource は次の項目に適応します。

ResourceResolver は次の項目に適応します。

SlingHttpServletRequest は次の項目に適応します。

現時点ではターゲットはありませんが、Adaptable を実装し、カスタムの AdapterFactory 内でソースとして使用することは可能です。

SlingHttpServletResponse は次の項目に適応します。

WCM wcm

Page は次の項目に適応します。

Component は次の項目に適応します。

Template は次の項目に適応します。

セキュリティ security

Authorizable、User および Group は次に適応します。

DAM dam

Asset は次の項目に適応します。

タグ付け tagging

Tag は次の項目に適応します。

その他 other

さらに、Sling、JCR、OCM では、カスタム OCM（AdapterFactoryObject Content Mapping）オブジェクト用の も提供しています。