wechat core

WeChat-ядро

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

Введение в проект

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-кода
  • Пример кода процессора сообщений о событиях перехода в пользовательское меню
  • Пример кода обработчика сообщения о событии щелчка пользовательского меню
  • Пример кода процессора сообщений о событиях push-кода сканирования
  • Пример кода обработчика сообщений о событиях, который сканирует QR-код для отправки события и отображает всплывающее окно с подсказкой «Получение сообщения».

Демонстрация эффекта

Отсканируйте QR-код ниже и подпишитесь на официальный аккаунт, чтобы испытать эту функцию.

Список реализованных функций

1. Прием и ответ на основные типы сообщений (текст, изображения, аудио, видео, местоположение, короткое видео, сообщение со ссылкой) и сообщения о событиях (подписка, отмена подписки, загрузка географического местоположения, сканирование QR-кода и сообщения о событиях пользовательского меню). Инкапсуляция.
2. Для инкапсуляции access_token обратитесь к AccessTokenService.
3. Для инкапсуляции всего API пользовательского интерфейса обратитесь к WechatUserService.

Связаться с автором

Электронная почта: [email protected], ошибки и предложения приветствуются.

Ищу работу

Онлайн-резюме: https://151376liujie.github.io/resume/