AEM への貢献

開発方法

AEM は、大規模なオープンソースのプロジェクトで一般的に実施される、実績ある方法に従って開発されます。AEM のテクノロジースタックの多くのコア要素は、実際は Sling や Jackrabbit のようなアクティブなオープンソースプロジェクトとして保守され、Apache Software Foundation に貢献しました。AEM に存在するこの精神における重要な側面は、利用可能なメーリングリストやオンラインフォーラムを活用した開発チームとの直接のやり取りが奨励されているということです。

AEM のコンポーネントに貢献する場合は、オープンソースプロジェクトに貢献する場合と同様に AEM に関する知識を深め、このようなプロジェクトに貢献しようとする場合と同様に既存のコアチームとコミュニケーションを取る必要があります。

必要な経験

HyperText Transfer Protocol(HTTP)は、すべての作業の中心となります。したがって、AEM に貢献する前に、HTTP について深く理解する必要があります。スレッドプーリングを使用してマルチスレッド HTTP サーバーの Java 実装を独自で記述できるレベルが理想です。また、HTTP/1.1 のキープアライブ動作についても理解する必要があり、JavaScript によるサーバー/クライアント側のインタラクション、特に、AJAX によって表現される非同期スタイルのインタラクションに関する深い知識も必要です。

ページダイナミズムとインタラクティブなコンテンツが WM 体験では重要なので、Document Object Model について、またこれを使用してイベントに対する応答をプログラムによって操作する可能性についても、かなり深く理解しておくことが不可欠です。例えば、リアルタイムの DOM 操作や、複数のブラウザードキュメントにまたがったドラッグ&ドロップ動作(iframe を使用するなど)についても、ある程度の知識が必要です。

最高レベルでは、以下について確実に理解する必要があります。

  • HTTP/1.1 プロトコル
  • HTML(HTML5 が望ましい)
  • カスケーディングスタイルシート
  • Extensible Markup Language(XML)
  • Asynchronous JavaScript and XML(AJAX)設計パターン
  • JavaScript Object Notation(JSON)
  • Document Object Model
  • ステートフルインタラクションとステートレスインタラクション
  • Uniform Resource Identifier
  • ブラウザーの cookie
  • その他の最新の Web 開発概念

Adobe Experience Managerのテクノロジースタックは、Apache Sling Webフレームワークを備えたApache Felix OSGIコンテナに基づいており、Apache Jackrabbitに基づいてJavaコンテンツリポジトリ(JCR)を埋め込みます。これらの個々のプロジェクトと、投稿する予定の領域で使用されるその他のオープンソースコンポーネント(Apache Luceneなど)について理解しておく必要があります。

業界知識

一定の概念や指針は、以前の Day 社の文化に深く根ざしています。ここでは、「DNA に深く埋め込まれている」問題の中で注意すべきものをいくつか示します。

すべてがコンテンツである

コンテンツには、Webアプリケーションが保持するすべてのデータが含まれるだけではありません。あらゆる種類のプログラムコード、ライブラリ、スクリプト、テンプレート、HTML、CSS、画像、アーティファクトは、すべてコンテンツリポジトリに保持され、パッケージマネージャーとパッケージ共有を介して読み込み/書き出しされます。

David's Model

Javaコンテンツリポジトリでのコンテンツのモデル化方法は、リレーショナル世界でのデータモデリングのソフトウェア業界で一般的に行われる考え方とは全く異なる考え方が必要です。コンテンツ管理に新規参加者にとって、JCRの方法はDavidのモデルです。コンテンツモデリングのガイド

RESTful であること

REST アプローチは、作業内容に深く根ざしています。つまり、何よりも、ステートフルなインタラクションを回避すること、また、URI がコンテンツおよびサービスの確定的なアドレスであることを心に留めておくことです。

REST(REpresentational State Transfer)は、World Wide Web の基礎となっているソフトウェアアーキテクチャスタイルを示します。Web を機能させるための重要な要素について説明するものであり、Web ベースのソフトウェアの設計方法について一連の原則を提供します。したがって、Web 経由で使用する API を設計するときは、これらの「ベストプラクティス」を順守することが合理的です。

REST は非常に多くの作業の背景に指針となる考え方を提供するので、RESTful な設計の教義を熟知しておくことが不可欠と考える必要があります。手始めとしてふさわしいのは、Roy Fielding 氏の論文です。

Sling の要求解決

AEM について理解する上で重要な点は、受信要求がコンテンツおよびアプリケーションの動作とどのように関連付けられるか、コンテンツリポジトリでのコンテンツの構造、および要求処理のためのアプリケーションロジックを AEM がどこで検索するかです。Apache Sling の URL の分解について、また、REST アーキテクチャスタイルおよびそのステートレスでキャッシュ可能な階層化システムの制約を実施する方法について学習してください。

Apache Sling の要求解決に関しては、コンテンツリポジトリの特定のリソースに要求が最初にマップする方法、コンテンツをレンダリングする際にどのアプリケーションコードを呼び出すかを要求する追加プロパティとこれらのコンテンツオブジェクトのプロパティによって決定する方法、および /apps 内のコードで /libs 内のコードを上書きする方法を理解することが重要です。

クイックスタート

手順 3 がない:インストールして実行するには、クイックスタート JAR ファイルをダウンロードしてダブルクリックするだけです。手順 3 はありません。オプションの機能を追加する場合も、パッケージ共有から該当するパッケージをインストールするだけです。

クイックスタートのサイズが小さい:クイックスタートJARファイルのサイズは最小限に抑えます。ライブラリの使用を最適化し、オプション機能をパッケージ共有に移行する。

起動時間が短い:起動時間に影響する可能性のある変更をおこなう場合は、長くなるのではなく、短くなるようにします。

無駄なくすっきり

アドビでは、軽量でサイズが小さく、高速かつ洗練されたコードやプロジェクトを優先します。「十分に良い」では本当に十分ではありません。

コードの再利用:OSGi ベースの製品アーキテクチャと「すべてがコンテンツである」という考え方は、コードおよびアーティファクトを再利用する、いつにない好機が与えられているということを意味します。アドビでは、この事実を可能な限り利用して、無駄なくすっきりした機能を維持しようとしています。

疎結合:アドビでは、厳密な依存関係や「不要な密接さ」よりも、疎結合のインタラクションを優先します。疎結合により、より多くのコードの再利用も可能になります。

デモを無効にしない

デモで最もよく表示されるデモスクリプトと製品機能を理解します。少なくとも、「デモスクリプト」機能を無効にする必要はありません。開発中でも、コア製品は必ずデモに対応する必要があります。

信頼できる設計

アドビでは、フェイルソフトな方法で機能を設計およびコード化するよう努めています。これにより、例えば 1 つの DOM 要素の問題が原因でページ全体がレンダリングされなくなることはありません。つまり、致命的とするべきことは致命的とし、その他はすべて存続可能にして、製品を「寛容に」するということです。

異常は新たな正常

シャットダウンフックに依存しないで、起動時にクリーンアップを行ってください。異常終了は正常終了です。

shutdown == kill -9 == power outage

弾性クラスター化に備える

常に弾性クラスタリングに対応し、常にクラスタリングが存在すると仮定します。原則として、コンテンツリポジトリ内のすべての要素を維持することは、組み込みのクラスタリングサポートを意味します。

下位互換性に対応する設計

お客様の古いコードを破ることはありません。 アップグレード時に更新できる製品コードを含める場合は、/libsのみを検討してください。 リポジトリの/appsセクションはプロジェクトコードで、 /etcセクションには保持する必要があるカスタム設定が含まれています。 通常は、/apps/contentおよび/home内の設定を上書きしないでください。 アップグレード後は、古いプロジェクトコード、設定およびコンテンツは、アップグレード前と同じように引き続き機能します。

後方互換性を保つための設計では、アップグレードの経験が初期インストールのシンプルさと一致するようになります。AEMを停止し、Quickstart JARファイルを置き換えて、AEMを再起動するだけで十分です。急速に増え続けるインストール・ベースでは、アップグレードの効率性がますます大きなメリットとなります。

より新しく、より高度な機能に置き換えられると、既存の API は廃止とマークを付けることができ、またそうする必要がありますが、以前の 5.x リリースで公開された API はすべて、カスタムアプリケーションコードで使用される可能性があるので、引き続き機能する必要があります。そのような API は削除しないでください。

下位互換性は、コンテンツ構造とユーザー体験の全体的な一貫性という意味でも、心に留めておく必要があります。

中心概念

オーサーインスタンス — 通常、セキュリティ、ガバナンス、その他の理由により、実稼動サイトではAEMのインスタンスがオーサーインスタンスとパブリッシュインスタンスに分割されます。デプロイメントアーキテクチャ(オーサー/パブリッシュインスタンスを含む)について詳しくは、AEMインスタンスに関するドキュメントを参照してください。

キャッシュ、フライ、ベイク — 従来、ベーク処理とフライ処理の概念は、異なるWebコンテンツ管理システム間の重要な区別です。CMSの用語では、「焼く」とは、パブリッシュ時に静的ファイルにデータをコミットする概念を指し、「焼く」とは、リクエスト時(即ち、時間内)に最終プレゼンテーション用のデータを処理する概念を指します。

クラスタリングとロードバランシング — 可用性を高め、実稼動環境のパフォーマンスを向上させるために、複数のオーサーインスタンスとパブリッシュインスタンスを(クラスターに)組み合わせ、様々なユーザーグループに公開するか、Dispatcher設定の後ろでロードバランシングします。

また、コンテンツリポジトリの複数のインスタンスを組み合わせて、高可用性 JCRソリューションを作成することもできます。JCRソリューションをAEMソリューションと統合して、ハードウェアやソフトウェアの障害に対する保護を最大化できます。 詳しくは、推奨されるデプロイメントを参照してください。

コンポーネント - AEMでは、コンポーネントはオブジェクトタイプで、通常、サイドキックなどからドラッグ&ドロップすることで作成できます。例えば、AEMに付属している標準のコンポーネントには、テキスト、タイトル、タグクラウド、カルーセル、画像、リストの各コンポーネントが含まれ、実行時にサイドキックから使用できます。

コンテンツファインダー — オーサリングモードでは、コンテンツファインダーはページの左側にある特別なパネル(フレーム)で、上部で選択したタブに応じて、コンテンツファインダーから作業中のページ(右側)にドラッグ&ドロップできる画像、ドキュメント、Flashアセット、ページ、段落またはリポジトリリソースを表示します。

デジタルアセット - AEMでは、デジタルアセットは(通常)画像とリッチメディアファイルです。詳しくは、「 DAMでのデジタルアセットの操作」を参照してください。

Dispatcher - Dispatcherは、キャッシュとロードバランシングの両方のツールで、特定のセキュリティ保護を提供します。

ExtJSウィジェット - AEMのほとんどのユーザーインターフェイス要素は、JavaScriptで記述されたサードパーティのウィジェットライブラリであるExtJSを使用します。ExtJSは、高パフォーマンスでカスタマイズ可能なUIウィジェットと、デザインが整った拡張可能なコンポーネントモデルを備えています。

JCR、Javaコンテンツリポジトリ - Javaコンテンツリポジトリ仕様(JSR-283)は、抽象データモデルとアプリケーションプログラミングインターフェイスの両方を提供し、ファイルシステムとオブジェクトデータベースの機能を組み合わせた大規模な拡張性のNoSQLデータリポジトリを実現します。JSR-283を詳細に理解する必要はありませんが、JCRの基本的な機能と、JCRを基盤とするデータモデルに慣れておく必要があります。JCRがAEMの「すべてがコンテンツ」の理念を可能にする理由だからです。

本質的に、JCR はノードとプロパティのシステムであり、ノードは他のノードからの継承が可能で、すべてのコンテンツはプロパティの値として格納されます。**​通常の継承に加えて、JCR は「mixin」ノードの概念に対応しており、複数の継承をモデル化できます。

JCR には事前に定義されたノードタイプおよびプロパティタイプが多数含まれていますが、一般的にタイピングシステムは非常に柔軟です。実際に、JCR の長所の 1 つは、構造化コンテンツも非構造化コンテンツも同じくらい簡単に格納および管理できることです。つまり、JCR には高度に構造化されたデータを含めることができますが、任意の動的データ構造もスキーマ制約なしで含めることができます。

JCR の Java API に関する JavaDoc は、こちらを参照してください。

JavaDoc または JCR の仕様自体を読む前に、Adobe Experience Services によって実装された JCR の概要にも目を通しておくことをお勧めします。

マルチサイトマネージャー(MSM) - AEMのMSM機能は、多言語および多国籍のコンテンツの処理を支援し、一元化されたブランディングとローカライズされたコンテンツのバランスを取るのに役立ちます。

OSGi - OSGiは、AEMでモジュール化されたJava開発の基盤を提供するサービスベースのランタイムテクノロジーです。これは、コードリソース(バンドルと呼ばれます)の高度に動的な(安全な)クラスの読み込みと実行環境を提供するだけでなく、バンドルによって公開される様々なサービスの表示とライフサイクルを完全に制御するフレームワークです。 サービスレジストリは、ライフサイクルダイナミクス(およびバージョン要件)を考慮したバンドルの連携モデルを提供します。 OSGiは、アプリケーションサーバーが解決しようとしていた多くの問題を解決しますが、軽量で動的な方法で解決し、例えば、ホットデプロイサービスを可能にします(新しいコードをサーバーを再起動せずにすぐに使用可能にします)。

Parsys、段落システム — 段落システム(parsys)は、作成者がページに様々な種類のコンポーネントを追加でき、他の段落コンポーネントを含む複合コンポーネントです。それぞれの段落タイプはコンポーネントとして表されます。段落システム自体もコンポーネントであり、他の段落コンポーネントが含まれます。

Microkernel — リポジトリ内の各ワークスペースは、特定のマイクロカーネル(データの読み取りと書き込みを管理するクラス)を通じてデータを保存するように個別に設定できます。同様に、リポジトリレベルのバージョンストアも、特定のマイクロカーネルを使用するように、個別に設定できます。使用できるマイクロカーネルは多数あります。異なるマイクロカーネルを使用すると、様々なファイル形式やリレーショナルデータベースへのデータ保存に対応できます(例えば、MongoDB、DB2 または Oracle 用の永続性マネージャーがあります)。AEM 用のデフォルトのマイクロカーネルは TarMK です(後述)。

パブリッシュインスタンス — セキュリティ、ガバナンス、その他の理由から、通常、実稼動サイトではAEMのインスタンスをオーサーインスタンスとパブリッシュインスタンスに分割します。デプロイメントアーキテクチャ(オーサー/パブリッシュインスタンスを含む)について詳しくは、AEMインスタンスに関するドキュメントを参照してください。

クイックスタート — 他の多くのプログラムとは異なり、AEMをインストールするには、自己解凍型のJARファイルを1つ使用します。JARファイルを初めてダブルクリックすると、必要なすべてが自動的にインストールされます。 クイックスタートJARには、CRXリポジトリ(管理機能を含む)、仮想リポジトリサービス、インデックスと検索サービス、ワークフローサービス、セキュリティ、Webサーバーに必要なすべてのファイルと、CQサーブレットエンジン(CQSE)とすべてのAEMサービスが含まれます。 インストールするファイルは他にありません:クイックスタートは自己完結型です。

クイックスタートを初めて起動すると、JCR 対応のリポジトリ全体がバックグランドで作成されます。この処理に数分かかる場合があります。この初期起動が完了すると、リポジトリのインフラストラクチャは既に設定されているので、その後の起動処理はごく短時間で済みます。

多くの起動オプション(アクティブなポート番号、問題の AEM インスタンスをパブリッシュインスタンスとオーサーインスタンスのどちらにするか、など)は、クイックスタートファイルの名前を適宜変更することによって制御できます。この点に関するオプションのリストを確認するには、次のように、コマンドラインで「-help」を付けて JAR を実行します。

java -jar <quickstartfilename>.jar -help

レプリケーションエージェント — レプリケーションエージェントは、オーサー環境からパブリッシュ環境にコンテンツを公開(アクティブ化)するメカニズムとしてAEMの中心となります。Dispatcherキャッシュからコンテンツをフラッシュする。パブリッシュ環境からオーサー環境に、ユーザー生成コンテンツ(フォーム入力など)を返します。

基礎モード — 基礎モードを使用すると、ページに必要な構造を反映したフィールドを持つフォーム(基礎モード)を作成し、このフォームを使用して、この構造に基づくページを簡単に作成できます。

セグメント化 — サイト訪問者がサイトに来訪した際の関心や目標は異なります。訪問者の目標を把握し、期待に応えることは、オンラインマーケティングの重要な成功の前提条件です。 セグメント化によって訪問者の詳細を分析し、特徴付けることが成功の実現に役立ちます。

サイドキック — サイドキックは、編集可能なページに表示される、パレットに似たフローティングウィンドウです。編集可能なページから新しいコンポーネントをドラッグし、ページに適用するアクションを実行できます。

Site Catalyst :SiteCatalystは、複数のマーケティングチャネルにわたるすべてのオンラインイニシアチブから、統合されたデータを測定、分析、最適化する1か所をマーケターに提供します。Adobe SiteCatalystを使用して、AEM Webサイトのデータを分析できます。

Tarストレージ(TarMK) - TarMKはAEMのデフォルトの永続性システムです。AEM は、異なる永続化システム(MongoDB など)を使用するように設定できますが、TarMK には、一般的な JCR の使用例向けにパフォーマンスが最適化されており(そのため、非常に高速)、業界標準のデータ形式を使用し、すばやく簡単にバックアップできるという点で明白なメリットがあります。

テンプレート - AEMでは、テンプレートは特定のタイプのページを指定します。ページの構造を定義します(一方、通常はサムネール画像や様々なプロパティも指定します)。 例えば、製品ページ、サイトマップおよび問い合わせ先に、それぞれ別のテンプレートを使用することができます。

ワークフロー - AEM Workflowシステムを使用すると、ページやアセットを含む自動プロセスを作成できます。

このページ