サーバー側のカスタマイズ server-side-customization

Java™ API java-apis

SocialComponent インターフェイス socialcomponent-interface

SocialComponents は、AEM Communities機能のリソースを表す POJO です。 各 SocialComponent は、リソースが正確に表されるように、クライアントにデータを提供する公開された GETters を持つ特定の resourceType を表すのが理想的です。 必要に応じて、すべてのビジネスロジックとビューロジックが SocialComponent にカプセル化されます。サイト訪問者のセッション情報も含まれます。

このインターフェイスは、リソースを表すのに必要な GETter の基本的なセットを定義します。 重要な点は、インターフェイスがマップを規定することです<string object=""> Handlebars テンプレートをレンダリングし、リソースのGETJSON エンドポイントを公開するために必要な getAsMap() および String toJSONString() メソッド。

すべての SocialComponent クラスがインターフェイスを実装する必要があります com.adobe.cq.social.scf.SocialComponent

SocialCollectionComponent インターフェイス socialcollectioncomponent-interface

SocialCollectionComponent インターフェイスは、 SocialComponent インターフェイスを拡張して、他のリソースの集まりであるリソースをより適切に表すようにします。

すべての SocialCollectionComponent クラスは、インターフェイスcom.adobe.cq.social.scf.SocialCollectionComponent を実装する必要があります

SocialComponentFactory インターフェイス socialcomponentfactory-interface

SocialComponentFactory（ファクトリ）は、SocialComponent をフレームワークに登録します。 ファクトリは、複数の SocialComponent が識別された場合に、特定の resourceType に対して使用可能な SocialComponents と、その優先度のランクをフレームワークに知らせる手段を提供します。

SocialComponentFactory は、選択した SocialComponent のインスタンスを作成し、ID プラクティスを使用して SocialComponent が必要とするすべての依存関係をファクトリから挿入できるようにします。

SocialComponentFactory は OSGi サービスで、コンストラクターを通じて SocialComponent に渡すことができる他の OSGi サービスにアクセスできます。

すべての SocialComponentFactory クラスがインターフェイスを実装する必要があります com.adobe.cq.social.scf.SocialComponentFactory

SocialComponentFactory.getPriority() メソッドを実装すると、getResourceType() で返される、指定された resourceType に対して使用されるファクトリの最大値が返されます。

SocialComponentFactoryManager インターフェイス socialcomponentfactorymanager-interface

SocialComponentFactoryManager（マネージャー）は、フレームワークに登録されているすべての SocialComponents を管理し、特定のリソース (resourceType) に使用する SocialComponentFactory を選択する役割を果たします。 特定の resourceType にファクトリが登録されていない場合、マネージャは指定されたリソースに最も近いスーパータイプを持つファクトリを返します。

SocialComponentFactoryManager は OSGi サービスで、コンストラクターを通じて SocialComponent に渡すことができる他の OSGi サービスにアクセスできます。

OSGi サービスへのハンドルは、を呼び出すことで取得されます。 com.adobe.cq.social.scf.SocialComponentFactoryManager

HTTP API -POSTリクエスト http-api-post-requests

PostOperation クラス postoperation-class

HTTP APIPOSTエンドポイントは、 SlingPostOperation インターフェイス（パッケージ） org.apache.sling.servlets.post) をクリックします。

The PostOperation エンドポイント実装セット sling.post.operation を、操作の応答先の値に設定します。 :operation パラメーターがその値に設定されたすべてのPOSTリクエストが、この実装クラスに委任されます。

The PostOperation を呼び出します。 SocialOperation は、操作に必要なアクションを実行します。

The PostOperation 次から結果を受信： SocialOperation を呼び出し、適切な応答をクライアントに返します。

SocialOperation クラス socialoperation-class

各 SocialOperation endpoint は AbstractSocialOperation クラスを拡張し、メソッドをオーバーライドします。 performOperation(). このメソッドは、操作を完了し、 SocialOperationResult または OperationException. その場合、通常の JSON 応答または成功 HTTP ステータスコードの代わりに、メッセージが付いた HTTP エラーステータスが返されます（使用可能な場合）。

拡張ガイド AbstractSocialOperation ～の再利用を可能にする SocialComponents をクリックして JSON 応答を送信します。

SocialOperationResult クラス socialoperationresult-class

The SocialOperationResult クラスは、 SocialOperation およびは、 SocialComponent、HTTP ステータスコード、および HTTP ステータスメッセージ。

The SocialComponent は、操作の影響を受けたリソースを表します。

作成操作の場合、 SocialComponent 次に含まれる SocialOperationResult 作成されたリソースを表し、「更新」操作の場合は、操作によって変更されたリソースを表します。 いいえ SocialComponent は、削除操作に対して返されます。

使用される成功 HTTP ステータスコードは次のとおりです。

OperationException クラス operationexception-class

An OperationExcepton リクエストが有効でないか、その他のエラーが発生した場合、操作の実行時にがスローされます。 例えば、内部エラー、無効なパラメーター値、不適切な権限などです。 An OperationException は、HTTP ステータスコードとエラーメッセージで構成され、 PostOperatoin.

OperationService クラス operationservice-class

ソーシャルコンポーネントフレームワークでは、操作を実行するビジネスロジックを SocialOperation クラスに委任する代わりに、OSGi サービスに委任することもできます。 ビジネスロジックに OSGi サービスを使用すると、 SocialComponentに基づいて、 SocialOperation エンドポイント（他のコードと統合され、異なるビジネスロジックが適用される）

すべて OperationService クラスを拡張する AbstractOperationServiceを使用すると、実行中の操作に関連付けることのできる追加の拡張機能を使用できます。 サービス内の各操作は、 SocialOperation クラス。 The OperationExtensions クラスは、操作の実行中に、メソッドを呼び出すことで呼び出すことができます

OperationExtension クラス operationextension-class

The OperationExtension クラスは、操作に挿入できるカスタムコードで、ビジネスニーズに合わせて操作をカスタマイズできます。 コンポーネントの消費者は、動的かつ増分的にコンポーネントに機能を追加できます。 拡張/フックパターンを使用すると、開発者は拡張機能自体にのみ焦点を当て、操作やコンポーネント全体をコピーして上書きする必要がなくなります。

サンプルコード sample-code

サンプルコードは、 Adobe Experience Cloud GitHub リポジトリ。 次のいずれかのプレフィックスが付いたプロジェクトを検索します。 aem-communities または aem-scf.

ベストプラクティス best-practices

次を表示： コーディングのガイドライン AEM Communities開発者向けの様々なコーディングガイドラインおよびベストプラクティスに関する節を参照してください。

関連トピック UGC 用ストレージリソースプロバイダー (SRP) ユーザー生成コンテンツへのアクセスについて説明します。