JMessageUtils

JMessage 实用工具类详解
本文介绍了一个实用的 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;
    }

}

 

**项目名称:** 基于Vue.js与Spring Cloud架构的博客系统设计与开发——微服务分布式应用实践 **项目概述:** 本项目为计算机科学与技术专业本科毕业设计成果,旨在设计并实现一个采用前后端分离架构的现代化博客平台。系统前端基于Vue.js框架构建,提供响应式用户界面;后端采用Spring Cloud微服务架构,通过服务拆分、注册发现、配置中心及网关路由等技术,构建高可用、易扩展的分布式应用体系。项目重点探讨微服务模式下的系统设计、服务治理、数据一致性及部署运维等关键问题,体现了分布式系统在Web应用中的实践价值。 **技术架构:** 1. **前端技术栈:** Vue.js 2.x、Vue Router、Vuex、Element UI、Axios 2. **后端技术栈:** Spring Boot 2.x、Spring Cloud (Eureka/Nacos、Feign/OpenFeign、Ribbon、Hystrix、Zuul/Gateway、Config) 3. **数据存储:** MySQL 8.0(主数据存储)、Redis(缓存与会话管理) 4. **服务通信:** RESTful API、消息队列(可选RabbitMQ/Kafka) 5. **部署与运维:** Docker容器化、Jenkins持续集成、Nginx负载均衡 **核心功能模块:** - 用户管理:注册登录、权限控制、个人中心 - 文章管理:富文本编辑、分类标签、发布审核、评论互动 - 内容展示:首页推荐、分类检索、全文搜索、热门排行 - 系统管理:后台仪表盘、用户与内容监控、日志审计 - 微服务治理:服务健康检测、动态配置更新、熔断降级策略 **设计特点:** 1. **架构解耦:** 前后端完全分离,通过API网关统一接入,支持独立开发与部署。 2. **服务拆分:** 按业务域划分为用户服务、文章服务、评论服务、文件服务等独立微服务。 3. **高可用设计:** 采用服务注册发现机制,配合负载均衡与熔断器,提升系统容错能力。 4. **可扩展性:** 模块化设计支持横向扩展,配置中心实现运行时动态调整。 **项目成果:** 完成了一个具备完整博客功能、具备微服务典型特征的分布式系统原型,通过容器化部署验证了多服务协同运行的可行性,为云原生应用开发提供了实践参考。 资源来源于网络分享,仅用于学习交流使用,请勿用于商业,如有侵权请联系我删除!
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值