Messaging 기본 사항

이 페이지는 웹 사이트에 메시징 기능을 포함하기 위해 메시징 구성 요소를 사용한 작업에 대한 세부 정보를 문서화합니다.

클라이언트측 핵심 사항

메시지 작성

메시지 목록

(받은 편지함, 보낸 편지함 및 휴지통의 경우)

참조: 클라이언트측 사용자 지정

서버측 Essentials

• 메시징 구성
• 메시징 클라이언트 API SCF 구성 요소용
• 메시징 API 서비스용
• 메시징 엔드포인트
• 서버측 사용자 지정

valid: mb.setInboxPath( "/mail/inbox" );
 not valid: mb.setInboxPath( "/mail/inbox/" );

커뮤니티 사이트

마법사를 사용하여 만든 커뮤니티 사이트 구조를 선택하면 메시징 기능이 포함됩니다. 다음을 참조하십시오 User Management 설정 커뮤니티 사이트 콘솔.

샘플 코드: 메시지 수신 알림

소셜 메시징 기능은 다음과 같은 작업에 대한 이벤트를 발생시킵니다. send, marking read, marking delete. 이러한 이벤트를 포착하고 이벤트에 포함된 데이터에 대해 조치를 취할 수 있습니다.

다음 예제는 이벤트를 수신하는 이벤트 처리기입니다 message sent 이벤트를 만들고 을(를) 사용하여 모든 메시지 수신자에게 이메일을 보냅니다. Day CQ Mail Service.

서버측 샘플 스크립트를 시도하려면 개발 환경과 OSGi 번들을 빌드하는 기능이 필요합니다.

1. 관리자로 로그인하여 [CRXDE|Lite](https://localhost:4502/crx/de).

2. 만들기 bundle node위치: /apps/engage/install 다음과 같은 임의의 이름 사용:

   • 기호 이름: com.engage.media.social.messaging.MessagingNotification
   • 이름: 시작하기 튜토리얼 메시지 알림
   • 설명: 사용자가 메시지를 받을 때 이메일 알림을 전송하는 샘플 서비스입니다
   • 패키지: com.engage.media.social.messaging.notification

3. 다음으로 이동 /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/src/main/java/com/engage/media/social/messaging/notification, 다음:

   1. 삭제 Activator.java 클래스가 자동으로 만들어졌습니다.
   2. 클래스 만들기 MessageEventHandler.java.
   3. 아래 코드를 복사하여 다음 위치에 붙여넣습니다. MessageEventHandler.java.

4. 모두 저장​을 클릭합니다.

5. 다음으로 이동 /apps/engage/install/com.engage.media.social.messaging.MessagingNotification/com.engage.media.social.messaging.MessagingNotification.bnd및 의 설명에 따라 모든 가져오기 구문 추가 MessageEventHandler.java 코드.

6. 번들을 빌드합니다.

7. 확인 Day CQ Mail ServiceOSGi 서비스가 구성되었습니다.

8. 데모 사용자로 로그인하고 다른 사용자에게 이메일을 전송합니다.

9. 수신자는 새 메시지와 관련된 이메일을 수신하게 됩니다.

MessageEventHandler.java

package com.engage.media.social.messaging.notification;

import org.apache.felix.scr.annotations.Component;
import org.apache.felix.scr.annotations.Properties;
import org.apache.felix.scr.annotations.Property;
import org.apache.felix.scr.annotations.Service;
import org.apache.felix.scr.annotations.Reference;
import org.apache.sling.api.resource.ResourceResolver;
import org.apache.sling.api.resource.ResourceResolverFactory;
import org.apache.sling.api.resource.Resource;
import org.apache.commons.mail.Email;
import org.apache.commons.mail.EmailException;
import org.apache.commons.mail.SimpleEmail;
import org.apache.commons.mail.HtmlEmail;
import java.util.List;
import org.osgi.service.event.Event;
import org.osgi.service.event.EventHandler;
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import com.adobe.cq.social.messaging.api.Message;
import com.adobe.cq.social.messaging.api.MessagingEvent;
import com.day.cq.mailer.MessageGatewayService;
import com.day.cq.mailer.MessageGateway;

@Component(immediate=true)
@Service(EventHandler.class)
@Properties({
        @Property(name = "event.topics", value = "com/adobe/cq/social/message")
})
public class MessagingEventHandler implements EventHandler {
    private Logger logger = LoggerFactory.getLogger(MessagingEventHandler.class);

    @Reference
    ResourceResolverFactory resourceResolverFactory;

    @Reference
    private MessageGatewayService messageGatewayService;

    ResourceResolver resourceResolver=null;
    MessageGateway messageGateway=null;

    public void sendMail(String from, String to,String subject, String content){
        Email email = new SimpleEmail();
        messageGateway = messageGatewayService.getGateway(SimpleEmail.class);
        try {
         email.addTo(to);
            email.addReplyTo(from);
            email.setFrom(from);
            email.setMsg(content);
            email.setSubject(subject);
         messageGateway.send(email);
        } catch(EmailException ex) {
            logger.error("MessageNotificaiton : Error sending email : "+ex.getMessage());
        }
        logger.info("**** MessageNotification **** Mail sent to " + to);
    }

    public void handleEvent(Event event) {
        //Get Message Path and originator User's ID from event
        String messagePath = (String) event.getProperty("path");
        String senderId = (String) event.getProperty("userId");
        MessagingEvent.MessagingActions action = (MessagingEvent.MessagingActions) event.getProperty("action");
        try{
            if(MessagingEvent.MessagingActions.MessageSent.equals(action)){
                resourceResolver = resourceResolverFactory.getAdministrativeResourceResolver(null);

                //Read message
                Resource resource = resourceResolver.getResource(messagePath);
                Message msg = resource.adaptTo(Message.class);

                //Get list of recipient Ids from message
                //For Getting Started Tutorial, Id is same as email. If that is not the case in your site,
                //an additional step is needed to retrieve the email for the Id
                List<String> reclist = msg.getRecipientIdList();
                for(int i=0;i<reclist.size();i++){
                    //Send Email using Mailing Service
                    sendMail("admin@cqadmin.qqq",reclist.get(i),"New message on Getting Started Tutorial", "Hi\nYou have received a new message from  " +  senderId + ". To read it, sign in to Getting Started Tutorial.\n\n-Engage Admin");
                }
            }
        } catch(Exception ex){
            logger.error("Error getting message info : " + ex.getMessage());
        } finally {
            resourceResolver.close();
        }

    }
}