{"id":51598830,"url":"https://github.com/wxpusher/wxpusher-sdk-java","last_synced_at":"2026-07-11T20:01:43.816Z","repository":{"id":56445275,"uuid":"234819882","full_name":"wxpusher/wxpusher-sdk-java","owner":"wxpusher","description":"微信消息实时推送服务[WxPusher]的Java版本sdk，可以通过API实时给个人微信推送消息。wechat pusher. ","archived":false,"fork":false,"pushed_at":"2026-06-15T06:35:25.000Z","size":113,"stargazers_count":563,"open_issues_count":11,"forks_count":120,"subscribers_count":5,"default_branch":"master","last_synced_at":"2026-06-15T08:21:26.225Z","etag":null,"topics":["push","wechar","wxpusher"],"latest_commit_sha":null,"homepage":"http://wxpusher.zjiecode.com/demo","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wxpusher.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2020-01-19T01:06:28.000Z","updated_at":"2026-06-15T06:35:29.000Z","dependencies_parsed_at":"2024-03-25T17:36:38.129Z","dependency_job_id":"8f56cf89-26a2-429f-b2aa-3847c83cbfbb","html_url":"https://github.com/wxpusher/wxpusher-sdk-java","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/wxpusher/wxpusher-sdk-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wxpusher%2Fwxpusher-sdk-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wxpusher%2Fwxpusher-sdk-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wxpusher%2Fwxpusher-sdk-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wxpusher%2Fwxpusher-sdk-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wxpusher","download_url":"https://codeload.github.com/wxpusher/wxpusher-sdk-java/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wxpusher%2Fwxpusher-sdk-java/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35374165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-11T02:00:05.354Z","response_time":104,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["push","wechar","wxpusher"],"created_at":"2026-07-11T20:01:43.212Z","updated_at":"2026-07-11T20:01:43.806Z","avatar_url":"https://github.com/wxpusher.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1\u003e \n升级到3.x 的版本，做了很多break change，但是改动不大，2.x版本在\u003ca href=\"https://github.com/wxpusher/wxpusher-sdk-java/tree/version_2.x\"\u003eversion_2.x\u003c/a\u003e分支\n\u003c/h1\u003e\n\n\n# WxPusher\n微信消息实时推送服务[WxPusher]，可以通过API实时给个人微信推送消息.[http://wxpusher.zjiecode.com/admin](http://wxpusher.zjiecode.com/admin)\n\n# 功能介绍说明\n\n请直接访问官方说明文档[http://wxpusher.zjiecode.com/docs](http://wxpusher.zjiecode.com/docs)\n\n## 目录说明\n- client-sdk 目录：JAVA SDK的源代码\n- demo 目录：[http://wxpusher.zjiecode.com/demo](http://wxpusher.zjiecode.com/demo)的源代码\n\n# 其他语言SDK\n- [Go-SDK](https://github.com/wxpusher/wxpusher-sdk-go)\n- [Python-SDK](https://github.com/wxpusher/wxpusher-sdk-python)\n\n如果不存在你需要语言的sdk，请你按照[参考文档](http://wxpusher.zjiecode.com/docs)直接使用http调用，另外，欢迎你贡献更多语言的SDK。\n# Java版本SDK\n\n[ ![version](https://img.shields.io/static/v1.svg?label=version\u0026message=3.0.2\u0026color=brightgreen) ](https://bintray.com/zjiecode/maven/wxpusher-java-sdk)\n## 目录模块说明\n- demo\n\n  官网演示demo源码，开发的时候，可以做参考，demo演示网站地址: [http://wxpusher.zjiecode.com/demo](http://wxpusher.zjiecode.com/demo)\n- sdk \n\n  Java版本SDK源码，开发的时候可以直接使用。\n## 添加依赖\n### gradle中使用\n\n你需要添加Jcenter库，在“build.grade”中配置：\n```groovy\ndependencies {\n    ......\n    implementation 'com.smjcco.wxpusher:client-sdk:3.0.0'//使用上面的版本号\n    ......\n}\n```\n\n###  在maven中使用\n在*pom.xml*文件中添加：\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.smjcco.wxpusher\u003c/groupId\u003e\n  \u003cartifactId\u003eclient-sdk\u003c/artifactId\u003e\n  \u003cversion\u003e3.0.2\u003c/version\u003e\n\u003c/dependency\u003e\n```\n## 系统回调\nWxPusher会提供一些用户事件，比如用户关注、用户上行消息等，我们会通过回调的方式把消息推送给你。\n具体方式请阅读接入文档：https://wxpusher.zjiecode.com/docs/#/?id=callback\n相关的数据模型，已经定义在：com.smjcco.wxpusher.sdk.bean.callback 包下面，也可以可以参考demo模块的实现。\n\n## 功能说明\n具体每个功能的说明，请参考\u003ca href=\"https://wxpusher.zjiecode.com/docs/#/?id=http%e6%8e%a5%e5%8f%a3%e8%af%b4%e6%98%8e\"\u003eAPI说明文档\u003c/a\u003e，这里不再赘述。\n\n不想看文档，可以直接参考[单元测试的用法(client-sdk/src/test/java/com/smjcco/wxpusher/client/sdk/ClientTest.java)](https://github.com/wxpusher/wxpusher-sdk-java/blob/master/client-sdk/src/test/java/com/smjcco/wxpusher/client/sdk/ClientTest.java)\n\n\n\n### 初始化\n如果是你只需要一个实例（一个appToken），可以直接使用default，在使用之前进行初始化；\n```java\nWxPusher.initDefaultWxPusher(\"你自己的应用appToken\");\n```\n在需要使用WxPusher的地方，世界访问default即可，比如下面这样：\n```java\nWxPusher.getDefaultWxPusher().send(xxx);\n```\n\n如果需要同时使用多个实例（appToken）可以直接实例化，自己进行保存：\n```java\nnew WxPusher(\"你自己的应用appToken\");\n```\n\n### 发送消息\n说明：调用此接口，即可把消息推送出去。 如果传递了多个uid或者topic，会返回多个结果。\n```java\nMessage message = new Message();\nmessage.setContent(\"扫描成功，你可以使用demo演示程序发送消息\");\nmessage.setContentType(Message.CONTENT_TYPE_TEXT);\nmessage.setUid(\"UID_XXXX\");\n\nResult\u003cList\u003cMessageResult\u003e\u003e result = WxPusher.getDefaultWxPusher().send(message);\nSystem.out.println(\"发送结果：\" + result.isSuccess() + \", 消息：\" + result.getMsg());\nif (result.isSuccess() \u0026\u0026 result.getData() != null) {\n  for (MessageResult messageResult : result.getData()) {\n    System.out.println(\"发送到UID: \" + messageResult.getUid() + \", 结果：\" + messageResult.getStatus());\n  }\n}\n```\n### 删除消息\n说明：消息发送以后，可以调用次接口删除消息，但是请注意，只能删除用户点击详情查看的落地页面，已经推送到用户的消息记录不可以删除。\n```java\nResult\u003cBoolean\u003e result = WxPusher.getDefaultWxPusher().deleteMessage(messageId);\nSystem.out.println(\"删除结果：\" + result.isSuccess() + \", 状态：\" + result.getData());\n```\n\n### 创建带参数的app临时二维码\n说明：可以用于创建一个二维码，拿到扫码的用户，来和自己系统的用户做关联。\n\n本接口和下面的queryScanUID配合使用，推荐更推荐回调：https://wxpusher.zjiecode.com/docs/#/?id=callback\n```java\nCreateQrcodeReq req = new CreateQrcodeReq();\nreq.setExtra(\"test_extra_data\");\nreq.setValidTime(1800); // 设置有效期为30分钟\n\nResult\u003cCreateQrcodeResp\u003e result = WxPusher.getDefaultWxPusher().createAppTempQrcode(req);\nSystem.out.println(\"创建二维码结果：\" + result.isSuccess() + \", 消息：\" + result.getMsg());\nif (result.isSuccess() \u0026\u0026 result.getData() != null) {\n  CreateQrcodeResp resp = result.getData();\n  System.out.println(\"二维码Code: \" + resp.getCode());\n  System.out.println(\"二维码URL: \" + resp.getUrl());\n  System.out.println(\"二维码短链接: \" + resp.getShortUrl());\n  System.out.println(\"过期时间: \" + resp.getExpires());\n  System.out.println(\"附加数据: \" + resp.getExtra());\n}\n```\n### 查询扫码用户UID\n```java\nString code = \"上面 createAppTempQrcode 接口返回的code\";\n// 注意：实际使用时，应该使用轮询方式，但是轮训时间不可以小于10秒，此处仅为示例\n// 更推荐使用回调的方式 https://wxpusher.zjiecode.com/docs/#/?id=callback\nResult\u003cString\u003e result = WxPusher.getDefaultWxPusher().queryScanUID(code);\n```\n\n### 查询用户\n说明：同一个用户关注多个，可能返回多个数据\n```java\nResult\u003cPage\u003cWxUser\u003e\u003e result = WxPusher.getDefaultWxPusher().queryWxUserV2(1, 10, null, false, UserType.APP);\nSystem.out.println(\"查询用户结果：\" + result.isSuccess() + \", 消息：\" + result.getMsg());\nif (result.isSuccess() \u0026\u0026 result.getData() != null) {\n    Page\u003cWxUser\u003e page = result.getData();\n    System.out.println(\"总用户数: \" + page.getTotal());\n    System.out.println(\"当前页: \" + page.getPage());\n    System.out.println(\"页大小: \" + page.getPageSize());\n\n    if (page.getRecords() != null) {\n        for (WxUser wxUser : page.getRecords()) {\n            System.out.println(\"用户UID: \" + wxUser.getUid());\n            System.out.println(\"用户ID: \" + wxUser.getId());\n            System.out.println(\"应用/主题ID: \" + wxUser.getAppOrTopicId());\n            System.out.println(\"关注类型: \" + wxUser.getType());\n            System.out.println(\"用户是否启用: \" + wxUser.isEnable());\n            System.out.println(\"用户是否拉黑: \" + wxUser.isReject());\n            System.out.println(\"创建时间: \" + wxUser.getCreateTime());\n            System.out.println(\"---------------------\");\n        }\n    }\n}\n```\n### 删除用户\n你可以通过本接口，删除用户对应用，主题的关注。\n\n删除以后，用户可以重新关注，如不想让用户再次关注，可以调用拉黑接口，对用户拉黑。\n```java\nResult\u003cBoolean\u003e result = wxPusher.deleteUser(userId);\nSystem.out.println(\"删除用户结果：\" + result.isSuccess() + \", 状态：\" + result.getData());\n```\n\n### 拉黑用户\n拉黑以后不能再发送消息，用户也不能再次关注，除非你取消对他的拉黑。调用拉黑接口，不用再调用删除接口。\n```java\n // 拉黑用户\nResult\u003cBoolean\u003e result = WxPusher.getDefaultWxPusher().rejectUser(userId, true);\nSystem.out.println(\"拉黑用户结果：\" + result.isSuccess() + \", 状态：\" + result.getData());\n\n//取消拉黑用户\nResult\u003cBoolean\u003e result2 = WxPusher.getDefaultWxPusher().rejectUser(userId, false);\nSystem.out.println(\"取消拉黑用户结果：\" + result2.isSuccess() + \", 状态：\" + result2.getData());\n```\n\n使用就是这么简单，有需要就来试试吧。\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwxpusher%2Fwxpusher-sdk-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwxpusher%2Fwxpusher-sdk-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwxpusher%2Fwxpusher-sdk-java/lists"}