lodsve.wechat.api.user.WeChatUserService Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lodsve-all Show documentation
lodsve全部聚合
There is a newer version: 2.7.5-RELEASE
/*
 * Copyright (C) 2018  Sun.Hao
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see .
 */

package lodsve.wechat.api.user;

import com.fasterxml.jackson.core.type.TypeReference;
import lodsve.core.utils.StringUtils;
import lodsve.wechat.beans.User;
import lodsve.wechat.beans.UserQuery;
import lodsve.wechat.core.WeChat;
import lodsve.wechat.core.WeChatRequest;
import lodsve.wechat.core.WeChatUrl;
import lodsve.wechat.enums.Lang;
import org.springframework.stereotype.Component;
import org.springframework.util.Assert;

import java.util.ArrayList;
import java.util.Collections;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

/**
 * 微信用户操作.
 *
 * @author sunhao([email protected])
 * @version V1.0, 16/3/2 上午11:06
 */
@Component
public class WeChatUserService {
    /**
     * 设置备注名
     *
     * @param openId 用户标识
     * @param alias  新的备注名，长度必须小于30字符
     */
    public void updateUserAlias(String openId, String alias) {
        Assert.hasText(alias);
        Assert.isTrue(alias.length() <= 30);
        Assert.hasText(openId);

        Map params = new HashMap<>(2);
        params.put("openid", openId);
        params.put("remark", alias);

        WeChatRequest.post(String.format(WeChatUrl.UPDATE_USER_ALIAS, WeChat.accessToken()), params, new TypeReference() {
        });
    }

    /**
     * 获取用户基本信息
     *
     * @param openId 普通用户的标识，对当前公众号唯一
     * @param lang   返回国家地区语言版本，zh_CN 简体，zh_TW 繁体，en 英语
     * @return 用户
     * @see Lang
     */
    public User getUser(String openId, Lang lang) {
        Assert.hasText(openId);
        if (null == lang) {
            lang = Lang.zh_CN;
        }

        return WeChatRequest.get(String.format(WeChatUrl.GET_USER_INFO, WeChat.accessToken(), openId, lang.toString()), new TypeReference() {
        });
    }

    /**
     * 批量获取用户基本信息
     *
     * @param users 查询条件,只用到openId和language两个字段
     * @return 用户
     */
    public List batchGetUser(List users) {
        Assert.notNull(users);

        List> params = new ArrayList<>();
        for (UserQuery user : users) {
            Map p = new HashMap<>(2);

            p.put("openid", user.getOpenId());
            p.put("lang", user.getLanguage().toString());

            params.add(p);
        }

        return WeChatRequest.post(String.format(WeChatUrl.BATCH_GET_USER_INFO, WeChat.accessToken()), Collections.singletonMap("user_list", params), new TypeReference>>() {
        }).get("user_info_list");
    }

    /**
     * 获取关注者列表
     *
     * @param nextOpenId 第一个拉取的OPENID，不填默认从头开始拉取
     * @return 关注者openId
     */
    @SuppressWarnings("unchecked")
    public List listSubscribe(String nextOpenId) {
        String url = String.format(WeChatUrl.LIST_SUBSCRIBER, WeChat.accessToken(), StringUtils.isEmpty(nextOpenId) ? StringUtils.EMPTY : nextOpenId);
        Map result = WeChatRequest.get(url, new TypeReference>() {
        });

        return (List) ((Map) result.get("data")).get("openid");
    }
}