- Communities 안내서
- AEM Communities 소개
- 배포
- 관리
- AEM Communities의 사용자 및 UGC 관리 서비스
- 커뮤니티 사이트
- 커뮤니티 콘솔
- 커뮤니티 기능에 대한 Analytics 구성
- 메시징 구성
- 커뮤니티 컨텐츠 중재
- 이메일 구성
- 커뮤니티 알림
- 커뮤니티 구독
- 커뮤니티 점수 및 배지
- 사용자 및 사용자 그룹 관리
- 커뮤니티 그룹 콘솔
- facebook 및 Twitter을 사용한 소셜 로그인
- SRP - 커뮤니티 콘텐츠 저장소
- 커뮤니티 사이트 콘솔
- 구성원 및 그룹 관리 콘솔
- 관리 콘솔
- 커뮤니티 도구
- 사이트 템플릿
- 그룹 템플릿
- 커뮤니티 기능
- 저장소 구성
- 배지 콘솔
- 보고서 콘솔
- 커뮤니티에 대한 FFmpeg
- 컨텍스트 내 중재
- 고급 점수 및 배지
- ASRP - Adobe 저장소 리소스 제공자
- MSRP - MongoDB 저장소 리소스 공급자
- 데모용 MongoDB를 설정하는 방법
- DSRP - 관계형 데이터베이스 저장소 리소스 제공자
- DSRP에 대한 MySQL 구성
- JSRP - JCR 저장소 리소스 제공자
- SRP에 대한 Solr 구성
- 사용자 생성 컨텐츠 태깅
- 사용자 생성 콘텐츠 번역
- 커뮤니티 사용자 동기화
- 구성원 기여도 제한
- 개발
- 개발 커뮤니티
- 소셜 구성 요소 프레임워크
- 커뮤니티 구성 요소 안내서
- 구성 요소, 기능 및 기능 핵심 사항
- 튜토리얼
- 문제 해결
- 코딩 지침
- 서버측 사용자 지정
- 클라이언트측 사용자 정의
- SCF Handlebars 도우미
- 저장소 리소스 공급자 개요
- 커뮤니티 사이트 기본 사항
- 활동 스트림 Essentials
- 블로그 기본 사항
- 달력 기본 사항
- 커뮤니티 구성 요소에 대한 Clientlibs
- 댓글 기본 사항
- 커뮤니티 구성 요소에 대한 OSGi 이벤트
- 주요 콘텐츠 핵심 사항
- 파일 라이브러리 기본 사항
- 포럼 기본 사항
- 커뮤니티 그룹 기본 사항
- 관념화 기본 사항
- 리더보드 기본 사항
- 좋아요 기본 사항
- Messaging 기본 사항
- QnA 기본 사항
- 등급 기본 사항
- 리뷰 Essentials
- 리치 텍스트 편집기 핵심 사항
- 채점 및 배지 핵심 사항
- Essentials 검색
- 구성 요소 사이드로드
- 소셜 그래프 기본 사항
- SRP 및 UGC 필수 패키지
- 태그 기본 사항
- Tally 기본 사항
- 투표 기본 사항
- 웹 사이트 구조 설정
- SCF 샌드박스 만들기
- 초기 샌드박스 애플리케이션
- 초기 샌드박스 콘텐츠
- 샌드박스 애플리케이션 개발
- 샌드박스 콘텐츠 개발
- Clientlibs 추가
- 오버레이 주석 구성 요소
- 댓글 만들기 페이지
- 노드 만들기
- 모양 변경
- 구성 요소 만들기
- 샘플 페이지에 주석 추가
- 주석 구성 요소 확장
- 모양 변경(HBS)
- 샘플 페이지 만들기
- SRP를 사용하여 UGC에 액세스
- Maven for Communities 사용
- 이름 지정 규칙
- SocialUtils 리팩터링
- 작성
서버측 사용자 지정
| ⇐ 기능 기본 사항 | 클라이언트측 사용자 지정 ⇒ |
|---|---|
| SCF Handlebars 도우미 ⇒ |
Java API
Communities API의 패키지 위치는 한 주요 릴리스에서 다음 릴리스로 업그레이드할 때 변경될 수 있습니다.
SocialComponent 인터페이스
SocialComponents는 AEM Communities 기능에 대한 리소스를 나타내는 POJO입니다. 이상적으로 각 SocialComponent는 리소스에 정확하게 표현되도록 클라이언트에 데이터를 제공하는 노출된 GETter가 있는 특정 resourceType을 나타냅니다. 모든 비즈니스 논리 및 보기 논리는 필요한 경우 사이트 방문자의 세션 정보를 포함하여 SocialComponent에 캡슐화됩니다.
인터페이스는 리소스를 나타내는 데 필요한 기본 GETter 집합을 정의합니다. 중요한 것은 인터페이스에 맵이 명시되어 있다는 것입니다<string object=""> Handlebars 템플릿을 렌더링하고 리소스에 대한 GET JSON 끝점을 노출하기 위해 필요한 getAsMap() 및 String toJSONString() 메서드입니다.
모든 SocialComponent 클래스는 인터페이스를 구현해야 합니다 com.adobe.cq.social.scf.SocialComponent
SocialCollectionComponent 인터페이스
SocialCollectionComponent 인터페이스는 SocialComponent 인터페이스를 확장하여 다른 리소스의 컬렉션인 리소스를 더 잘 나타냅니다.
모든 SocialCollectionComponent 클래스는 com.adobe.cq.social.scf.SocialCollectionComponent 인터페이스를 구현해야 합니다
SocialComponentFactory 인터페이스
SocialComponentFactory(공장)는 프레임워크에 SocialComponent를 등록합니다. 팩토리는 여러 SocialComponents가 식별될 때 특정 resourceType에 사용할 수 있는 SocialComponents와 해당 우선 순위 순위를 프레임워크에 알려주는 수단을 제공합니다.
SocialComponentFactory는 DI 사례를 사용하여 팩토리에서 SocialComponent에 필요한 모든 종속성을 주입할 수 있도록 선택한 SocialComponent의 인스턴스를 만들 책임이 있습니다.
SocialComponentFactory는 OSGi 서비스이며 생성자를 통해 SocialComponent에 전달할 수 있는 다른 OSGi 서비스에 액세스할 수 있습니다.
모든 SocialComponentFactory 클래스는 인터페이스를 구현해야 합니다. com.adobe.cq.social.scf.SocialComponentFactory
SocialComponentFactory.getPriority() 메서드를 구현하면 getResourceType()에서 반환된 대로 지정된 resourceType에 팩토리를 사용하려면 가장 높은 값이 반환됩니다.
SocialComponentFactoryManager 인터페이스
SocialComponentFactoryManager(관리자)는 프레임워크에 등록된 모든 SocialComponents를 관리하며 지정된 리소스(resourceType)에 사용할 SocialComponentFactory를 선택합니다. 특정 resourceType에 등록된 공장이 없으면 관리자는 지정된 리소스에 대해 가장 가까운 상위 유형의 공장을 반환합니다.
SocialComponentFactoryManager는 OSGi 서비스이며 생성자를 통해 SocialComponent에 전달할 수 있는 다른 OSGi 서비스에 액세스할 수 있습니다.
OSGi 서비스에 대한 핸들은 com.adobe.cq.social.scf.SocialComponentFactoryManager
HTTP API - POST 요청
PostOperation 클래스
HTTP API POST 끝점은 를 구현하여 정의된 PostOperation 클래스입니다. SlingPostOperation 인터페이스(패키지) org.apache.sling.servlets.post).
다음 PostOperation 끝점 구현 집합 sling.post.operation 작업이 응답할 값으로 을 설정합니다. 해당 값으로 설정된 an:operation 매개 변수를 사용하는 모든 POST 요청이 이 구현 클래스에 위임됩니다.
다음 PostOperation 호출 SocialOperation 작업에 필요한 작업을 수행합니다.
다음 PostOperation 에서 결과를 수신합니다. SocialOperation 적절한 응답을 클라이언트에 반환합니다.
SocialOperation 클래스
각 SocialOperation endpoint가 AbstractSocialOperation 클래스를 확장하고 메서드를 재정의합니다. performOperation(). 이 메서드는 작업을 완료하고 를 반환하는 데 필요한 모든 작업을 수행합니다. SocialOperationResult 또는 throw OperationException이 경우 사용 가능한 경우 일반적인 JSON 응답 또는 성공 HTTP 상태 코드 대신 메시지와 함께 HTTP 오류 상태가 반환됩니다.
확장 AbstractSocialOperation 다음을 재사용 가능 SocialComponents JSON 응답을 보냅니다.
SocialOperationResult 클래스
다음 SocialOperationResult 클래스의 결과는 SocialOperation 및 는 로 구성됩니다. SocialComponent, HTTP 상태 코드 및 HTTP 상태 메시지
다음 SocialComponent 작업의 영향을 받은 리소스를 나타냅니다.
만들기 작업의 경우 SocialComponent 다음에 포함됨: SocialOperationResult 방금 만든 리소스를 나타내며 업데이트 작업의 경우 작업에 의해 변경된 리소스를 나타냅니다. 아니요 SocialComponent 은 삭제 작업에 대해 반환됩니다.
사용되는 성공 HTTP 상태 코드는 다음과 같습니다.
- 만들기 작업용 201
- 업데이트 작업용 200
- 삭제 작업용 204
OperationException 클래스
An OperationExcepton 요청이 유효하지 않거나 내부 오류, 잘못된 매개 변수 값, 부적절한 권한 등과 같은 기타 오류가 발생하는 경우 작업을 수행할 때 throw될 수 있습니다. An OperationException 는 HTTP 상태 코드와 오류 메시지로 구성되며, 클라이언트에 대한 응답으로 반환됩니다. PostOperatoin.
OperationService 클래스
소셜 구성 요소 프레임워크는 작업 수행을 담당하는 비즈니스 논리를 SocialOperation 클래스를 참조하지만 대신 OSGi 서비스로 위임됩니다. 비즈니스 논리에 OSGi 서비스를 사용하면 SocialComponent, 다음에 의해 행동됨: SocialOperation 다른 코드와 통합하고 다른 비즈니스 논리를 적용할 종단점입니다.
모두 OperationService 클래스 확장 AbstractOperationService을 추가하여 수행 중인 작업에 연결할 수 있는 추가 확장을 허용할 수 있습니다. 서비스의 각 작업은 SocialOperation 클래스. 다음 OperationExtensions 클래스는 메서드를 호출하여 작업 실행 중에 호출할 수 있습니다.
-
performBeforeActions()사전 확인/사전 처리 및 유효성 검사 허용
-
performAfterActions()리소스를 추가로 수정하거나 사용자 지정 이벤트, 워크플로우 등을 호출할 수 있습니다.
OperationExtension 클래스
OperationExtension 클래스는 비즈니스 요구 사항에 맞게 작업을 사용자 지정할 수 있도록 작업에 삽입할 수 있는 사용자 지정 코드 조각입니다. 구성 요소의 소비자는 구성 요소에 기능을 동적으로 점증적으로 추가할 수 있습니다. 확장/후크 패턴을 통해 개발자는 확장 자체에만 집중할 수 있으며 전체 작업 및 구성 요소를 복사하고 오버라이드할 필요가 없습니다.
샘플 코드
샘플 코드는에서 사용할 수 있습니다. Adobe Marketing Cloud Github 리포지토리. 다음 중 하나가 접두사로 추가된 프로젝트 검색 aem-communities 또는 aem-scf.
모범 사례
보기 코딩 지침 AEM Communities 개발자를 위한 다양한 코딩 지침 및 모범 사례에 대한 섹션.
참조: UGC용 SRP(저장소 리소스 제공자) 사용자 생성 콘텐츠에 액세스하는 방법에 대해 알아봅니다.
| ⇐ 기능 기본 사항 | 클라이언트측 사용자 지정 ⇒ |
|---|---|
| SCF Handlebars 도우미 ⇒ |
Business.Adobe.com 리소스
