Ok-calls Weixin: сверхбыстрое развитие

Ok-calls Weixin — это проект, основанный на открытом исходном коде jfinal-weixin. Автор считает, что в проекте слишком много устаревшего кода, который не соответствует правилам Alibaba, а дизайн устарел и содержит некоторые неразумные решения. На этом основании была проведена его переработка.

Данный фреймворк позволяет быстро разрабатывать SDK для публичных аккаунтов. Для этого достаточно просмотреть демонстрационный код.

Возможности фреймворка:

• упрощение конфигурации WeChat и запуска проверки;
• упрощённый процесс подключения к API WeChat;
• перечисление большинства событий обратного вызова WeChat, использование фреймворка позволяет самостоятельно переписать логику обработки событий (путем наследования WxWxMsgDefaultDispatcher и переопределения необходимых событий);
• предоставление API для подписи и проверки.

Управление версиями в pom можно перенести на сайт https://gitee.com/e-starter/estart-dependencies.

Быстрое использование

Пример проекта можно найти в данном проекте под названием ok-wx-demo.

0. Координаты Maven

  		<dependency>
            <groupId>com.noriental</groupId>
            <artifactId>ok-wx-core</artifactId>
            <version>0.1-SNAPSHOT</version>
        </dependency>

1. Конфигурация WeixinConfig

Подробности использования см. в примере com.noriental.okcalls.config.CustomWxConfig.

WxWxMsgDefaultDispatcher должен быть реализован пользователем для получения соответствующих событий и последующей работы с ними. В демоверсии по умолчанию dispatcher только выводит сообщения обратного вызова.

  @PostConstruct
    public void afterPropertiesSet() throws Exception {
        log.info("start loading");

        ApiConfig wxConfig = new ApiConfig();
        WxApiConfigInstance.devMode = false;
        wxConfig.setAppId("wx5f0e1f1c8446efaf");
        wxConfig.setAppSecret("ef0488561ee140d7c8b507da7b30a84b");
        wxConfig.setEncodingAesKey("");
        wxConfig.setToken("");
        wxConfig.setEncryptMessage(false);
        WxApiConfigInstance.apiConfig = wxConfig;

        log.info("wxConfig is {}", JSON.toJSONString(WxApiConfigInstance.apiConfig));

    }

 WxMsgDispatchCenter demoDispatchCenter() {
        log.info("start loading custom dispatch center");

        WxMsgDispatchCenter wxMsgDispatchCenter = new WxMsgDispatchCenter();
        wxMsgDispatchCenter.setWxMsgDispatcher(new WxWxMsgDefaultDispatcher());
        return wxMsgDispatchCenter;
    }

2. CallbackController

Демонстрация обратного вызова WeChat см. com.noriental.okcalls.controller.WxCallbackController.

@PostMapping(value = "/callBack")
    public String recMsg(@RequestBody String xml, HttpServletRequest req) {
        String s = req.getParameter("s");
        log.info("msg is  {},security is {}", JSONObject.toJSONString(MsgAdapter.analysisMsg(xml)), s);
        demoDispatchCenter.dispatch(xml);
        return "ok";
    }

3. PayController

Демонстрацию оплаты через WeChat H5 см. com.noriental.okcalls.controller.WxPayController.

См. исходный код com/noriental/okcalls/controller/WxPayController.java:42

Для получения результатов, упакованных в объект ApiResult, необходимо вызвать соответствующие методы MenuApi, UserApi и т. д. Результаты можно быстро вывести с помощью методов render.

4. WeChat API

Демоверсию WeChat API см. com/noriental/okcalls/test/TestWechatApi.java:28.

5. WIKI находится в процессе постоянного обновления

WIKI: https://gitee.com/e-starter/ok-wx/wikis Приглашаем больше коллег присоединиться и помочь улучшить!

6. Настройка среды разработки

Информация будет добавлена позже.

7. Дополнительная поддержка

Информация будет добавлена позже.