微信(企业微信/公众号)开发实战

整个九月闲了一个月,然后10月就开始忙的晕头转向,在连续加班2个星期的情况下,总算把微信公众号后台开发完成了。现在忙里偷闲,总结一波先。
项目需求的背景是源于微信公众号一配置服务器地址后,自动回复和菜单管理两个模块就不可用了,所以需要这两个模块单独拎出来做,感觉就是模仿公众号平台的操作页面,再做一遍。
一开始我是按照开发者文档,自己用HTTP请求调接口去实现,域名问题用本机ngrok内网穿透解决,资源自己百度,然后先申请一个未认证的个人号再申请一个测试号即可(不知道为什么测试号没有操作台很不直观而且感觉接口限制很多),流程就是,请求素材接口,然后组装菜单数据直接推送到公众号,当然自动回复模块的内容都要自己保存,微信回调到我们系统时按文档组装成微信需要的XML格式返回给微信端,这里对接微信,理解文档,定义相关实体类,表结构等等老花时间还做的不忍直视。好吧,我想应该不会只有我一个开发这种平台,果然一百度出来一堆插件,一开始只是用了部分fastweixin的实体类和部分实现方式去改善自己的代码,后来干脆直接接入weixin-java-tool,和微信端的事情就都交给这个SDK了。然后重写demo里的redis的实现,存储token到redis,其实可以就用demo里存在内存的实现,毕竟不是分布式。然后就是调用SDK实现类实现业务功能
企业微信也是一样,不过要注意的是weixin-java-tool调用查询部门成员详情接口时少了个is_leader_in_dept字段,需要自己去调接口实现,如下:

                departments.add(new Department(depart.getId(), depart.getName(), depart.getParentId(), 1, depart.getOrder()));
                String url = "https://qyapi.weixin.qq.com/cgi-bin/user/list?department_id=" + depart.getId();
                String params = "&fetch_child=" + "1";
                String responseContent = wxCpService.get(url, params);
                List<WxUser> wxUserList = JSON.parseObject(responseContent, WxUserListResult.class).getUserlist();

首先要在pom文件引入weixin-java-tool,weixin-java-cp是企业微信,weixin-java-mp是微信公众平台:

 <!--weixin-java-tool-->
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-common</artifactId>
            <version>3.3.7.B</version>
        </dependency>
        <dependency>
            <groupId>com.github.binarywang</groupId>
            <artifactId>weixin-java-cp</artifactId>
            <version>3.3.7.B</version>
        </dependency>

然后是配置:

import me.chanjar.weixin.cp.config.WxCpInMemoryConfigStorage;
import org.apache.commons.lang3.StringUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Component;

@Component
public class WxCpConfigStorage extends WxCpInMemoryConfigStorage {
    @Autowired
    private IRedisTemplateLoader redisTemplateLoader ;
    private static final String ACCESS_TOKEN_KEY = "work_wechat_access_token_";
    private static final String JSAPI_TICKET_KEY = "work_wechat_jsapi_ticket_";
    private String accessTokenKey = ACCESS_TOKEN_KEY;
    private String jsapiTicketKey = JSAPI_TICKET_KEY;

    @Override
    public String getAccessToken() {
        return redisTemplateLoader.get(this.accessTokenKey);
    }

    @Override
    public boolean isAccessTokenExpired() {
        return StringUtils.isEmpty(redisTemplateLoader.get(this.accessTokenKey));
    }

    @Override
    public synchronized void updateAccessToken(String accessToken, int expiresInSeconds) {
        redisTemplateLoader.set(this.accessTokenKey, accessToken, expiresInSeconds);
    }

    @Override
    public void expireAccessToken() {
        redisTemplateLoader.set(this.accessTokenKey, "", 1);
    }

    @Override
    public String getJsapiTicket() {
        return redisTemplateLoader.get(this.jsapiTicketKey);
    }

    @Override
    public boolean isJsapiTicketExpired() {
        return StringUtils.isEmpty(redisTemplateLoader.get(this.jsapiTicketKey));
    }

    @Override
    public synchronized void updateJsapiTicket(String jsapiTicket, int expiresInSeconds) {
        redisTemplateLoader.set(this.jsapiTicketKey, jsapiTicket, expiresInSeconds);
    }

    @Override
    public void expireJsapiTicket() {
        redisTemplateLoader.set(this.jsapiTicketKey, "", 0);
    }

import com.google.common.collect.Maps;
import me.chanjar.weixin.cp.api.WxCpService;
import me.chanjar.weixin.cp.api.impl.WxCpServiceImpl;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.Map;
import java.util.stream.Collectors;


@Configuration
@EnableConfigurationProperties(WxCpProperties.class)
public class WxCpConfiguration {
    private WxCpProperties properties;

    @Autowired
    public WxCpConfiguration(WxCpProperties properties) {
        this.properties = properties;
    }

    @Autowired
    WxCpConfigStorage configStorage;

    private static Map<String, WxCpService> cpServices = Maps.newHashMap();

    public static WxCpService getCpService(String agentId) {
        return cpServices.get(agentId);
    }


    @Bean
    public Object services() {
        cpServices = this.properties.getConfigs()
                .stream()
                .map(a -> {
                    configStorage.setCorpId(a.getCorpId());
                    configStorage.setCorpSecret(a.getCorpSecret());
                    configStorage.setAgentId(Integer.parseInt(a.getAgentId()));
                    configStorage.setToken(a.getToken());
                    configStorage.setAesKey(a.getAesKey());
                    WxCpService service = new WxCpServiceImpl();
                    service.setWxCpConfigStorage(configStorage);
                    return service;
                }).collect(Collectors.toMap(s -> s.getWxCpConfigStorage().getAgentId() + "", a -> a));
        return Boolean.TRUE;
    }

}
import com.google.gson.Gson;
import com.google.gson.GsonBuilder;


public class JsonUtils {
    public static String toJson(Object obj) {
        Gson gson = new GsonBuilder()
            .setPrettyPrinting()
            .create();
        return gson.toJson(obj);
    }
}

import com.uniubi.internal.util.JsonUtils;
import org.springframework.boot.context.properties.ConfigurationProperties;

import java.util.List;


@ConfigurationProperties(prefix = "wx.cp")
public class WxCpProperties {
    private List<CpConfig> configs;

    public List<CpConfig> getConfigs() {
        return configs;
    }

    public void setConfigs(List<CpConfig> configs) {
        this.configs = configs;
    }

    public static class CpConfig {
        /**
         * 设置企业微信的corpId
         */
        private String corpId;

        /**
         * 设置企业微信的corp secret
         */
        private String corpSecret;
        /**
         * 设置微信企业号应用ID
         */
        private String agentId;

        /**
         * 设置微信公众号的token
         */
        private String token;

        /**
         * 设置微信公众号的EncodingAESKey
         */
        private String aesKey;

        public String getCorpId() {
            return corpId;
        }

        public void setCorpId(String corpId) {
            this.corpId = corpId;
        }

        public String getCorpSecret() {
            return corpSecret;
        }

        public void setCorpSecret(String corpSecret) {
            this.corpSecret = corpSecret;
        }

        public String getAgentId() {
            return agentId;
        }

        public void setAgentId(String agentId) {
            this.agentId = agentId;
        }

        public String getToken() {
            return token;
        }

        public void setToken(String token) {
            this.token = token;
        }

        public String getAesKey() {
            return aesKey;
        }

        public void setAesKey(String aesKey) {
            this.aesKey = aesKey;
        }
    }

    @Override
    public String toString() {
        return JsonUtils.toJson(this);
    }
}

最后在application.yml里添上如下配置:


配置.png

就可以愉快的在代码里调用SDK了:


调用.png
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 158,117评论 4 360
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 66,963评论 1 290
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 107,897评论 0 240
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 43,805评论 0 203
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 52,208评论 3 286
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 40,535评论 1 216
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 31,797评论 2 311
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 30,493评论 0 197
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 34,215评论 1 241
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 30,477评论 2 244
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 31,988评论 1 258
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 28,325评论 2 252
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 32,971评论 3 235
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 26,055评论 0 8
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 26,807评论 0 194
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 35,544评论 2 271
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 35,455评论 2 266