wechat core

위챗코어

一款轻量级的微信消息处理框架,可以让业务代码与微信微信处理框架代码解耦,并且你根本不需要关心消息是如何发送的,你只需要关注你的业务即可.

프로젝트 소개

1. WeChat 메시지 수신 및 전송을 캡슐화하고 주석 기반 개발을 사용하여 메시지 수신 및 메시지 전송의 세부 사항에 주의를 기울이지 않고도 비즈니스 개발을 촉진할 수 있습니다.

2. 메시지 프로세서 추상 클래스는 내부적으로 캡슐화되어 메시지 처리 전 메시지 필터링, 기본 동작 로그 등의 기능을 제공합니다. 사용자는 이 클래스를 상속하여 자신의 비즈니스를 구현할 수 있습니다.

3. 각 유형을 처리하는 메시지 프로세서를 분리하기 위해 주석을 추가하기만 하면 됩니다. 또한 다양한 이벤트 유형에 대한 메시지 프로세서 분리를 지원하므로 비즈니스 로직을 처리하는 코드에서 메시지 유형을 결정하기 위해 if elseif elseif의 큰 섹션을 사용할 필요가 없습니다. . 각 인터페이스의 책임은 명확하고 구현은 더욱 분리되어 있습니다.

주의할 점

• 많은 사람들이 나에게 프로젝트 코드가 불완전한지 묻습니다. 복제된 코드가 항상 오류를 보고하는 이유는 무엇입니까? 프로젝트에서 lombok 플러그인을 사용하기 때문에 IDE(idea, eclipse)에서 이 플러그인을 설치하지 않으면 오류가 보고될 수 있습니다. 따라서 사전에 플러그인을 설치하고 구성해야 합니다.

사용된 기술 소개

1. jdk 1.8, lombok 플러그인을 사용하고, springMVC와 maven 3.0+을 통합하고, 소량의 람다 표현식을 사용하고, 고급 기술을 사용하지 않으며, 코드의 주석도 매우 자세하게 설명되어 있어 독자들이 쉽게 이해할 수 있다고 생각합니다. .

프로젝트 구조 분석

빠른 시작(WeChat 공개 플랫폼 애플리케이션 및 인터페이스 URL, 토큰 및 기타 구성 단계 제외)

1. 클래스 경로의 루트 경로에 wechat.properties 속성 파일을 생성하고 wechat.appId, wechat.appsecret, wechat.token 및 wechat.encodingAESKey를 구성합니다( 이름은 이와 동일해야 함 ). 예제는 다음과 같습니다.

2. 메시지 프로세서 클래스를 작성하고, AbstractMessageHandler 추상 클래스를 상속하고, doHandleMessage 메소드를 구현하고, 클래스에 @MessageProcessor 주석을 추가하고, 처리할 메시지 유형을 지정합니다. messageType 속성은 처리할 메시지 유형을 지정하고, eventType은 처리할 이벤트 유형입니다. 메시지 유형이 일반 메시지인 경우 eventType 속성을 지정할 필요가 없습니다. (지정하더라도 유효하지 않습니다.) 샘플 코드는 다음과 같습니다.

   • 기본 메시지 유형 처리(문자 메시지 프로세서)

    @ Component
   @ MessageProcessor ( messageType = MessageType . TEXT_MESSAGE )    
   public class TextMessageHandlerExample extends AbstractMessageHandler {    
       private static final Logger LOGGER = LoggerFactory . getLogger ( TextMessageHandlerExample . class );    
   
       public BaseResponseMessage doHandleMessage ( BaseRequestMessage requestMessage ) {    
               //在这里实现你自己的业务逻辑    
           TextRequestMessage textRequestMessage = ( TextRequestMessage ) baseRequestMessage ;
           return MessageUtils . buildTextResponseMessage ( baseRequestMessage , textRequestMessage . getContent ());     
       }    
   }    

   • 이벤트 유형의 메시지 처리에 주의

    @ Component
   @ MessageProcessor ( messageType = MessageType . EVENT , eventType = EventType . EVENT_SUBSCRIBE )    
   public class SubscribeEventMessageHandlerExample extends AbstractMessageHandler {    
   
       private static final Logger LOGGER = LoggerFactory . getLogger ( SubscribeEventMessageHandlerExample . class );
          
       @ Override
       public BaseResponseMessage doHandleMessage ( BaseRequestMessage baseRequestMessage ) {
           SubOrUnSubEventRequestMessage subOrUnSubEventRequestMessage = ( SubOrUnSubEventRequestMessage ) baseRequestMessage ;
        //在这里实现你自己的业务逻辑
       }
   }

3. 그냥 응용 프로그램을 실행하십시오!

샘플 코드

독자들이 참고할 수 있도록 다양한 메시지 유형을 수신하고 회신하기 위한 샘플 코드 링크는 다음과 같습니다.

• 기본 메시지 유형

  • 문자 메시지 프로세서 샘플 코드
  • 이미지 메시지 프로세서 샘플 코드
  • 링크 메시지 핸들러 샘플 코드
  • 음성 메시지 처리 샘플 코드
  • 짧은 영상 메시지 처리 샘플 코드
  • 영상 메시지 처리 샘플 코드
  • 위치정보 메시지 처리 샘플 코드

• 이벤트 메시지 유형

  • 이벤트 메시지 핸들러 샘플 코드를 따르세요.
  • 이벤트 메시지 처리기 샘플 코드 팔로우 취소
  • 지리적 위치 이벤트 메시지 프로세서 샘플 코드 업로드
  • QR 코드 이벤트 메시지 핸들러 샘플 코드 스캔
  • 사용자 정의 메뉴 점프 이벤트 메시지 프로세서 샘플 코드
  • 사용자 정의 메뉴 클릭 이벤트 메시지 핸들러 샘플 코드
  • 스캔 코드 푸시 이벤트 메시지 프로세서 샘플 코드
  • QR 코드를 스캔하여 이벤트를 푸시하고 "메시지 수신" 프롬프트 상자를 팝업하는 이벤트 메시지 핸들러의 샘플 코드

효과 시연

아래 QR 코드를 스캔하고 공식 계정을 팔로우하여 기능을 경험해 보세요.

구현된 기능 목록

1. 기본 메시지 유형(텍스트, 사진, 오디오, 비디오, 위치, 짧은 비디오, 링크 메시지) 및 이벤트 메시지(팔로우, 언팔로우, 지리적 위치 업로드, QR 코드 스캔 및 사용자 정의 메뉴 이벤트 메시지)에 대한 수신 및 응답 캡슐화.
2. access_token의 캡슐화에 대해서는 AccessTokenService를 참조하세요.
3. 전체 사용자 인터페이스 API를 캡슐화하려면 WechatUserService를 참조하세요.

저자에게 연락하기

이메일: [email protected], 버그와 제안을 환영합니다.

일자리를 찾고 있어요

온라인 이력서: https://151376liujie.github.io/resume/