JMessageUtils

本文介绍了一个实用的 JMessage 工具类,涵盖了用户管理、消息推送和状态查询等功能。通过该工具类,开发者可以轻松实现用户注册、密码修改、用户信息获取等操作,同时提供了批量用户在线状态查询和黑名单管理功能。

import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.core.env.Environment;
import org.springframework.http.HttpMethod;
import org.springframework.stereotype.Component;

import javax.annotation.PostConstruct;

import net.iharder.Base64;

import java.io.IOException;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

@Component
public class JMessageUtils {

    public final static String JMESSAGE_URL = "https://api.im.jpush.cn";

    private static String appKey;
    private static String masterSecret;

    @Autowired
    private Environment environment;

    @PostConstruct
    public void init() {
        JMessageUtils.appKey = environment.getProperty("config.jpush.appkey");
        JMessageUtils.masterSecret = environment.getProperty("config.jpush.mastersecret");
    }

    /**
     * 注册用户:一次批量注册最多支持500个用户
     * <p>
     * username	用户登录名(必填)
     * password	登录密码(必填)
     * appkey	用户所属于的应用的appkey
     * nickname	用户昵称
     * birthday	生日	yyyy-MM-dd HH:mm:ss
     * gender	性别 0 - 未知, 1 - 男 ,2 - 女
     * signature	用户签名
     * region	用户所属地区
     * address	用户详细地址
     * ctime	用户创建时间
     * mtime	用户最后修改时间
     * extras
     */
    public String insertUser(JSONArray users) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/users/";
        return httpPostOrGet(url, users.toJSONString());
    }

    /**
     * 管理员注册 (管理员api发送消息接口的权限)
     */
    public String adminRegister(JSONObject admin) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/admins/";
        return httpPostOrGet(url, admin.toJSONString());
    }

    /**
     * 获取应用管理员列表
     *
     * @param start 起始记录位置 从0开始
     * @param count 查询条数 最多支持500条
     */
    public String getAdminsListByAppkey(Integer start, Integer count) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/admins?start=" + start + "&count=" + count;
        return httpPostOrGet(url);
    }

    /**
     * 获取用户信息
     */
    public String getUserInfo(String username) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/users/" + username;
        return httpPostOrGet(url);
    }

    /**
     * 用户在线状态查询(不适用于多端在线)
     *
     * @return {"login": true,"online": false}
     */
    public String getUserStat(String username) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/users/" + username + "/userstat";
        return httpPostOrGet(url);
    }

    /**
     * 批量用户在线状态查询
     *
     * @return [{ "devices": [],"username": "caiyh01"},
     * {"devices": [{"login": false, "online": false,"platform": "a" }],"username": "Rauly" }]
     * <p>devices: 设备登陆状态数组,没有登陆过数组为空; platform: SDK各平台:a-Android,i-iOS,j-JS,w-Windows</p>
     */
    public String getUserStat(String... username) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v1/users/userstat";
        return httpPostOrGet(url, username);
    }

    /**
     * 批量用户在线状态查询2
     *
     * @return [{"devices": [], "username": "caiyh01","statusmsg": "no_exist", "statuscode": 1 // 用户不存在,会有statusmsg }, {
     * "devices": [{ "login": false, "online": false,"platform": "a" }], "username": "Rauly", "statuscode": 0 // 用户存在}]
     */
    public String getUserStat2(String... username) throws IOException, Exception {
        String url = JMESSAGE_URL + "/v2/users/statuser";
        return httpPostOrGet(url, username);
    }

    /**
     * 修改密码
     */
    public String updatePassword(String username, String newPassword) throws IOException, Exception {
        // PUT
        String url = JMESSAGE_URL + "/v1/users/" + username + "/password";
        JSONObject password = new JSONObject();
        password.put("new_password", newPassword);
        return httpPostOrGet(url, password.toJSONString());
    }

    /**
     * 删除用户
     */
    public String deleteUser(String username) throws IOException, Exception {
        // DELETE
        String url = JMESSAGE_URL + "/v1/users/" + username;
        return httpPostOrGet(url);
    }

    /**
     * 删除用户(最多支持同时删除100个用户)
     */
    public String deleteUsers(String... username) throws IOException, Exception {
        // DELETE
        String url = JMESSAGE_URL + "/v1/users/";
        return httpPostOrGet(url, username);
    }

    /**
     * 添加黑名单
     */
    public String addUserBlacklist(String username) throws IOException, Exception {
//        HttpMethod.PUT
        // PUT
        String url = JMESSAGE_URL + "/v1/users/" + username + "/blacklist";
        return httpPostOrGet(url);
    }

    /**
     * 添加黑名单
     */
    public String addUserBlacklist(String... username) throws IOException, Exception {
        // PUT
        String url = JMESSAGE_URL + "/v1/users/" + username + "/blacklist";
        return httpPostOrGet(url);
    }

    private String httpPostOrGet(String url) throws IOException, Exception {
        return httpPostOrGet(url, null);
    }

    /**
     * @param url     请求URL
     * @param payload 请求体为null 时,使用 GET请求方式
     */
    private String httpPostOrGet(String url, Object payload) throws IOException, Exception {
        Map<String, String> headers = new HashMap<>();
        headers.put("Authorization", Base64.encodeObject(appKey + ":" + masterSecret));
        String response;
        if (null == payload) {
            response = HttpUtils.get(url, headers);
        } else {
            response = HttpUtils.postBody(url, headers, "application/json", payload);
        }
        return response;
    }

}

 

Java是一种具备卓越性能与广泛平台适应性的高级程序设计语言,最初由Sun Microsystems(现属Oracle公司)的James Gosling及其团队于1995年正式发布。该语言在设计上追求简洁性、稳定性、可移植性以及并发处理能力,同时具备动态执行特性。其核心特征与显著优点可归纳如下: **平台无关性**:遵循“一次编写,随处运行”的理念,Java编写的程序能够在多种操作系统与硬件环境中执行,无需针对不同平台进行修改。这一特性主要依赖于Java虚拟机(JVM)的实现,JVM作为程序与底层系统之间的中间层,负责解释并执行编译后的字节码。 **面向对象范式**:Java全面贯彻面向对象的设计原则,提供对封装、继承、多态等机制的完整支持。这种设计方式有助于构建结构清晰、模块独立的代码,提升软件的可维护性与扩展性。 **并发编程支持**:语言层面集成了多线程处理能力,允许开发者构建能够同时执行多项任务的应用程序。这一特性尤其适用于需要高并发处理的场景,例如服务器端软件、网络服务及大规模分布式系统。 **自动内存管理**:通过内置的垃圾回收机制,Java运行时环境能够自动识别并释放不再使用的对象所占用的内存空间。这不仅降低了开发者在内存管理方面的工作负担,也有效减少了因手动管理内存可能引发的内存泄漏问题。 资源来源于网络分享,仅用于学习交流使用,请勿用于商业,如有侵权请联系我删除!
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值