Описание

Mica Maven release — это JFinal Weixin Spring Boot starter. Этот стартер предназначен для того, чтобы упростить использование JFinal Weixin для пользователей Spring Boot.

Для ознакомления с конкретным примером использования можно обратиться к демонстрационному проекту mica-weixin-demo и документации JFinal-Weixin на сайте Gitee.

Рекомендации по открытым исходным кодам

• Spring boot микросервисы, эффективный инструмент разработки MICA: https://gitee.com/596392912/mica.
• Avue — настраиваемый фреймворк на основе Vue: https://gitee.com/smallweigit/avue.
• Pig — самый мощный микросервис во вселенной (обязательный для архитекторов): https://gitee.com/log4j/pig.
• SpringBlade — комплексное решение для онлайн-проектов (обязательно для корпоративных разработчиков): https://gitee.com/smallc/SpringBlade.
• IJPay — платёжный SDK, который делает платежи доступными: https://gitee.com/javen205/IJPay.

Совместимость

Информация о версии

Зависимость от jar-пакетов (последняя)

<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-weixin</artifactId>
    <version>3.0.0</version>
</dependency>

Использование

Сообщения

Общественный аккаунт

1. Наследовать класс DreamMsgControllerAdapter и реализовать необходимые методы обработки сообщений.
2. Добавить аннотацию @WxMsgController к классу, указав в качестве значения аннотации адрес вашего сообщения, используя /weixin/wx. Аннотации @RequestMapping и @Controller уже объединены.

Мини-программа

1. Наследуйте класс DreamWxaMsgController и реализуйте необходимые методы обработки сообщений.
2. Добавьте аннотацию @WxMsgController к классу, указав в качестве значения аннотации адрес вашего сообщения, используя /weixin/wxa. Аннотации @RequestMapping и @Controller уже объединены.

API

Добавьте аннотацию @WxApi к классу, указав в качестве значения аннотации адрес вашего сообщения, используя /weixin/api. Аннотации @RequestMapping и @Controller уже объединены.

Кэш токенов доступа

Вы можете настроить mica-caffeine или mica-redis для реализации кэширования токенов доступа.

Конфигурация

Примечание: — В демонстрационном файле application.yml:

dream:
  weixin:
    dev-mode: true
    wx-configs:
      - appId: wx9803d1188fa5fbda
        appSecret: db859c968763c582794e7c3d003c3d87
      - appId: wxc03edcd008ad1e70
        appSecret: 11ed9e2b8e3e3c131e7be320a42b2b5a
        token: 123456
        encodingAesKey: xxx
        messageEncrypt: true
    wxa-configs:
      - app-id: wx4f53594f9a6b3dcb
        app-secret: eec6482ba3804df05bd10895bace0579

— Рекомендуется установить срок действия access-token-cache равным 7100 секунд.

Пользовательская конфигурация для публичных аккаунтов и мини-приложений

Обратите внимание: для этого необходимо реализовать WxConfigLoader. Можно получить данные из базы данных.

/**
 * Класс конфигурации загрузчика конфигурации WeChat, используемый для пользовательской реализации
 *
 * @author L.cm
 */
@Configuration
public class WxConfigDatabaseLoader implements WxConfigLoader {

    @Override
    public List<ApiConfig> loadWx() {
        // Публичный аккаунт
        ApiConfig wxConf = new ApiConfig();
        wxConf.setAppId("wxc03edcd008ad1e70");
        wxConf.setAppSecret("11ed9e2b8e3e3c131e7be320a42b2b5a");
        wxConf.setToken("123456");
        return Collections.singletonList(wxConf);
    }

    @Override
    public List<WxaConfig> loadWxa() {
        // Мини-приложение
        return Collections.emptyList();
    }
}

Обновление информации

2022-12-11 3.0.0 — Обновление до Java 17. — Обновление Spring Boot до 3.x. — Обновление jfinal до 5.0.8. — Обновление lombok до 1.18.24.

2021-11-22 2.1.2 — Микронастройка, поддержка большего количества версий, тестирование совместимости Spring Boot 2.6.0. — Обновление jfinal до 4.9.17. — Обновление jfinal-weixin до 3.4, поддержка черновиков и публикации интерфейсов. — Обновление lombok до 1.18.22.

2021-07-14 2.1.1 — Обновление jfinal-weixin до 3.2.

2021-04-27 2.1.0 — Объекты Spring cache теперь создаются при каждом чтении, caffeine будет обновляться, а ссылки станут нулевыми. — Обновление jfinal-weixin до 3.1.

2020-03-20 2.0.6 — Обновление jfinal-weixin до 3.0. Встроен @EnableCaching.

Изменить имя кэша на dreamWeixinCache#7100s, чтобы было удобно использовать его вместе с mica-redis.

Обновить версии jfinal и jfinal-weixin.

2020-05-01 v1.4.0

• Поддержка нескольких сообщений мини-программ, внимание: ключ конфигурации yml изменён с dream.weixin.wxa-config на dream.weixin.wxa-configs.
• Поддержка пользовательской загрузки конфигурации публичных аккаунтов и мини-программ для использования при загрузке конфигурации из базы данных и других источников.
• Обновить версии jfinal, jfinal-weixin.

2019-08-01 v1.3.6

• Обновление версий jfinal, jfinal-weixin, okhttp.

2019-03-17 v1.3.5

• Устранена ошибка сообщения под одним публичным аккаунтом.

2019-03-17 v1.3.4

• Решена проблема с мини-программами: включение и настройка проверки конфигурации сообщений не проходили.

2019-03-07 v1.3.3

• Обновлён gradle до версии 5.2.1.
• Обновлена версия JFinal до 3.6.
• Обновлена версия JFinal Weixin до 2.3.
• Использован mica-auto для генерации конфигураций spring.factories и devtools.
• Объект сообщения InMsg хранится в request, удалена конфигурация Scope в @WxMsgController, контроллер сообщений восстановлен как синглтон.

2018-12-23 v1.3.2

• Исправлена проблема отсутствия конфигурации SpringAccessTokenCache, спасибо за обратную связь qq: A梦的小C.

2018-12-23 v1.3.1

• WeixinAppConfig теперь реализует SmartInitializingSingleton.

2018-05-03 v1.3.0

• Отказаться от @EnableDreamWeixin, просто импортируйте jar-пакет, чтобы использовать.
• Маршрутизация сообщений передана spring.