저장소 리소스 공급자 개요

소개

AEM Communities 6.1부터, 일반적으로 사용자 생성 컨텐츠(UGC)라고 하는 커뮤니티 컨텐츠는 스토리지 리소스 공급자(SRP)가 제공하는 단일 공용 저장소에 저장됩니다.

여러 가지 SRP 옵션이 있으며, 모두 새 AEM Communities 인터페이스를 통해 UGC에 액세스하는 SRP 옵션인 SocialResourceProvider API(SRP API)는 CRUD(만들기, 읽기, 업데이트 및 삭제) 작업을 모두 포함합니다.

모든 SCF 구성 요소는 SRP API를 사용하여 구현되므로 기본 토폴로지 또는 UGC 위치를 모르더라도 코드를 개발할 수 있습니다.

SocialResourceProvider API는 AEM Communities의 라이센스 고객만 사용할 수 있습니다.

노트

사용자 지정 구성 요소:AEM Communities의 라이센스를 소유한 고객의 경우 SRP API는 기본 토폴로지에 관계없이 UGC에 액세스할 수 있도록 사용자 지정 구성 요소 개발자가 사용할 수 있습니다. SRP 및 UGC 필수 항목을 참조하십시오.

참고 항목:

  • SRP 및 UGC Essentials - SRP 유틸리티 방법 및 예.
  • SRP - 코딩 가이드라인을 사용하여 UGC 액세스
  • SocialUtils 리팩토링 - 사용되지 않는 유틸리티 메서드를 현재 SRP 유틸리티 메서드에 매핑합니다.

저장소 정보

SRP를 이해하려면 AEM 커뮤니티 사이트에서 AEM 저장소(OAK)의 역할을 이해하는 데 유용합니다.

JCR(Java Content Repository)
이 표준은 컨텐츠 저장소를 위한 데이터 모델 및 JCR API(Application Programming Interface)를 정의합니다. 기존 파일 시스템의 특징과 관계형 데이터베이스의 특성을 결합하며 컨텐츠 애플리케이션에 자주 필요한 많은 추가 기능을 추가합니다.

JCR의 한 구현은 AEM 저장소인 OAK입니다.

OAK(Apache Jackrabbit Oak)
은 컨텐츠 중심 애플리케이션을 위해 특별히 설계된 데이터 스토리지 시스템인 JCR 2.0의 구현입니다. 비정형 데이터와 반정형 데이터를 위해 설계된 계층적 데이터베이스 유형입니다. 저장소에는 사용자 대상 컨텐츠뿐만 아니라 응용 프로그램에서 사용하는 모든 코드, 템플릿 및 내부 데이터가 저장됩니다. 콘텐츠에 액세스하기 위한 UI는 CRXDE Lite입니다.

JCR과 OAK 모두 일반적으로 AEM 저장소를 참조하는 데 사용됩니다.

비공개 작성 환경에서 사이트 컨텐츠를 개발한 후 공개 게시 환경에 복사해야 합니다. 이 작업은 종종 replication​이라는 작업을 통해 수행됩니다. 이 작업은 작성자/개발자/관리자의 제어하에 수행됩니다.

UGC의 경우 컨텐츠는 공개 게시 환경에서 등록된 사이트 방문자(커뮤니티 구성원)에 의해 입력됩니다. 이것은 무작위로 발생합니다.

관리 및 보고를 위해 비공개 작성 환경에서 UGC에 액세스하는 것이 유용합니다. SRP를 사용하면 제작자가 UGC에 액세스할 때 게시 간 역 복제가 필요하지 않으므로 작성자가 액세스할 때 보다 일관되고 성능이 향상됩니다.

SRP 정보

UGC를 공유 스토리지에 저장할 때 대부분의 배포에서 작성 환경과 게시 환경 모두에서 액세스할 수 있는 단일 멤버 컨텐츠 인스턴스가 있습니다. SRP 선택(MSRP, ASRP, JSRP)에 상관없이 SRP API를 사용하여 프로그래밍 방식으로 모든 항목에 액세스해야 합니다.

노트

샘플 코드 및 추가 세부 사항은 SRP 및 UGC Essentials을 참조하십시오.

코딩 시 모범 사례를 보려면 SRP로 UGC 액세스를 참조하십시오.

ASRP

ASRP의 경우 UGC는 JCR에 저장되지 않으며 Adobe에서 호스팅하고 관리하는 클라우드 서비스에 저장됩니다. ASRP에 저장된 UGC는 CRXDE Lite을 통해 보거나 JCR API를 사용하여 액세스할 수 없습니다.

ASRP - Adobe 저장소 리소스 공급자를 참조하십시오.

개발자가 UGC에 직접 액세스할 수는 없습니다.

ASRP는 쿼리에 Adobe 클라우드를 사용합니다.

MSRP

MSRP의 경우 UGC는 JCR에 저장되지 않으며 MongoDB에 저장됩니다. MSRP에 저장된 UGC는 CRXDE Lite을 통해 보거나 JCR API를 사용하여 액세스할 수 없습니다.

MSRP - MongoDB 저장소 리소스 공급자를 참조하십시오.

MSRP는 ASRP와 비교할 수 있지만 모든 AEM 서버 인스턴스가 동일한 UGC에 액세스하고 있으므로 MongoDB에 저장된 UGC에 직접 액세스하는 데 공통 도구를 사용할 수 있습니다.

MSRP는 쿼리에 Solr를 사용합니다.

JSRP

JSRP는 단일 AEM 인스턴스에서 모든 UGC에 액세스하는 기본 공급자입니다. MSRP 또는 ASRP를 설정하지 않고도 AEM Communities 6.1을 빠르게 경험할 수 있습니다.

JSRP - JCR 저장소 리소스 공급자를 참조하십시오.

JSRP의 경우, UGC는 JCR에 저장되고 CRXDE Lite 및 JCR API를 통해 액세스할 수 있는 경우, JCR API를 사용하지 않는 것이 좋습니다. 그렇지 않으면 향후 변경 사항이 사용자 지정 코드에 영향을 줄 수 있습니다.

또한 작성 및 게시 환경에 대한 저장소가 공유되지 않습니다. 게시 인스턴스 클러스터가 공유된 게시 리포지토리를 만드는 동안 게시에 입력된 UGC는 작성자에게 표시되지 않으므로 작성자의 UGC를 관리할 수 없습니다. UGC는 입력한 인스턴스의 AEM 저장소(JCR)에만 보관됩니다.

JSRP는 쿼리에 Oak 인덱스를 사용합니다.

JCR의 그림자 노드 정보

UGC 경로를 모방하는 그림자 노드는 다음 두 가지 목적을 위해 로컬 저장소에 있습니다.

  1. 액세스 제어(ACL)
  2. 존재하지 않는 리소스(NER)

SRP 구현과 관계없이 실제 UGC는 그림자 노드와 같은 위치에 표시되지 *않습니다.

액세스 제어(ACL)의 경우

ASRP 및 MSRP와 같은 일부 SRP 구현은 ACL 확인을 제공하지 않는 데이터베이스에 커뮤니티 콘텐츠를 저장합니다. 그림자 노드는 로컬 저장소의 ACL을 적용할 수 있는 위치를 제공합니다.

SRP API를 사용하는 모든 SRP 옵션은 모든 CRUD 작업 전에 그림자 위치를 동일하게 확인합니다.

ACL 검사는 리소스의 UGC에 적용된 권한을 확인하는 데 적합한 경로를 반환하는 유틸리티 메서드를 사용합니다.

샘플 코드는 SRP 및 UGC Essentials을 참조하십시오.

존재하지 않는 리소스(NER)의 경우

일부 커뮤니티 구성 요소는 스크립트 내에서 포함할 수 있으므로 커뮤니티 기능을 지원하기 위해 Sling 주소 지정 가능 노드가 필요합니다. 포함된 구성 요소를 기존 리소스(NER)가 아닌 리소스입니다.

그림자 노드는 저장소에서 Sling 주소 지정 가능한 위치를 제공합니다.

주의

섀도 노드의 사용이 여러 개인 경우 그림자 노드가 있으면 not​은(는) 해당 구성 요소가 NER임을 암시합니다.

저장소 위치

다음은 커뮤니티 구성 요소 안내서에서 주석 구성 요소를 사용하는 그림자 노드의 예입니다.

  • 구성 요소는 다음 위치의 로컬 저장소에 있습니다.

    /content/community-components/en/comments/jcr:content/content/includable/comments

  • 해당 그림자 노드는 다음 로컬 저장소에 있습니다.

    /content/usergenerated/content/community-components/en/comments/jcr:content/content/includable/comments

그림자 노드 아래에 UGC가 없습니다.

기본 동작은 관련 하위 트리가 읽기 또는 쓰기에 대해 참조될 때마다 게시 인스턴스에 그림자 노드를 설정하는 것입니다.

예를 들어 배포가 TarMK 게시 팜이 있는 MSRP라고 가정합니다.

멤버가 pub1(MongoDB에 저장됨)에 UGC를 게시하면 shadow 노드가 pub1의 JCR에 생성됩니다.

UGC를 pub2에서 처음 읽을 때 설정된 항목이 없으면 기본 비헤이비어는 그림자 노드를 만드는 것입니다.

기본 비헤이비어 이외의 다른 비헤이비어를 원하는 경우 작성 인스턴스에서 설정하고 모든 게시 인스턴스로 롤포워드해야 합니다. 이 인스턴스는 일반적으로 수동 프로세스입니다.

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now