KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #typescript #developer-tools #claude-code #ai-agent #codex #deepseek-harness #ai-agents #cli #react #mcp

weixinmp4java

★ 81 Open GitHub ↗

包含微信公众平台全部功能的JAVA版API实现（weixinmp4java、wechat4java）

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

微信公众平台API接口JAVA版
=============
  - 别名：weixinmp4java、wechat4java
  - 这个包是微信公众平台纯API接口实现，除了一个gson的jar包以外，没有任何业务代码。
  - 支持公众号（包括订阅号和服务号）的所有主动接口和被动接口。
  - 支持小店接口v1.4

最近更新
=============
###2014.07.07
   - 将代码切换为maven管理
   - 原代码保留在no_maven目录中

###2014.07.06  v91
  - 小店API 1.4完成【警告：小店代码仅在本地进行模拟测试，没有经过微信服务器测试，欢迎有条件的同学反馈BUG】
     - cjc.weixinmp包增加了7个以Merchant开头的类，分别对应API手册的7个功能接口，每个方法对应一个功能
     - 增加cjc.weixinmp.merchant.bean包，存放与小店有关实体
     - 增加cjc.weixinmp.merchant.builder包，因为小店的数据实体比较复杂（很多字段很多结构），所有特设数据构造器，非常好用！
     - AbstractUserOperate增加onMerchantOrderPayEvent接口，为小店的订单支付推送事件
     - 详细测试例子查看cjc.weixinmp.test.WeixinmpTestXiaodianServlet，部署test项目后打开首页可以看到连接。
  - 内建模拟测试服务器，是本屌在封装小店接口时，因为没有小店测试权限特别开发的本地模拟测试模式。
     - 开关在cjc.weixinmp.test.Engine的contextInitialized方法，默认关，见注释。

项目介绍
=============
    /weixinmp          实现代码主项目，可以输出为jar包使用。注意依赖gson.jar。
    /weixinmp.test     示例&测试项目，看这里快速上手。需要依赖/weixinmp项目，
                       注意不是把代码复制过来用，而是在Eclipse或者MyEclipse是两个project的形式。

软件包介绍
=============
##cjc.weixinmp
包含事件分发、主动调用、通讯，解析json，解析xml，日志储存，读取配置文件，读取帮助文件信息等功能。

##cjc.weixinmp.bean
接口通讯中涉及到的数据格式（xml或者json），已被封装为实体。

##cjc.weixinmp.merchant.bean
存放与小店有关实体

##cjc.weixinmp.merchant.builder
因为小店的数据实体比较复杂（很多字段很多结构），所有特设数据构造器，非常好用！

配置文件
=============
##/weixinmp.default.properties
框架基本设置，请复制一份并重命名为weixinmp.properties存放在你的src根目录下。
  - 公众号的基本信息（token、appid、appsecret等）
  - 公众平台API接口配置（各种URL）
  - 代理设置（支持通过代理上网的环境）

##/weixinmp_helps.xml
帮助信息文件，请复制一份weixinmp_helps.xml存放在你的src目录下。
  - 帮助信息配置文件，由controller.getHelp(key)获得内容。

接口介绍
=============

##cjc.weixinmp.AbstractUserOperate
由微信服务器对你的服务器进行调用的接口称之为被动接口。
例如：发送文本消息、语音消息、订阅事件、退订事件、点击菜单事件等。
该接口已包含了所有开放的接口，选择需要的方法进行重写，并编写自己的业务代码即可。

// 用户主动发送文本消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onTextMessage(TextRequest text) 
    
    // 用户主动发图片消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onImageMessage(ImageRequest image)
    
    // 用户主动发语音消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onVoiceMessage(VoiceRequest voice)
    
    // 用户主动发视频消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onVideoMessage(VideoRequest video)
    
    // 用户主动发位置消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onLocationMessage(LocationRequest location)
    
    // 用户主动发链接消息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onLinkMessage(LinkRequest link) 
    
    // 用户订阅事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onSubscribeEvent(SubscribeEventRequest event)
    
    // 用户退订事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onUnsubscribeEvent(SubscribeEventRequest event)
    
    // 用户扫描参数二维码事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onScanEvent(ScanEventRequest event) 
    
    // 自动上报位置信息事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onLocationEvent(LocationEventRequest event) 
    
    // 用户点击自定义菜单事件
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onClickEvent(ClickEventRequest click) 
    
    // 小店支付通知
    AbstractResponse cjc.weixinmp.AbstractUserOperate.onMerchantOrderPayEvent(OrderPayEventRequest orderPayEvent) 
    
以“用户订阅事件”为例：

AbstractResponse cjc.weixinmp.AbstractUserOperate.onSubscribeEvent(SubscribeEventRequest event){
        // 从帮助信息文件（weixinmp_helps.xml）中加载。也可以自己new TextResponse对象。
        String help = controller.findHelp("欢迎关注"); 
        // 这个是内置的一个快速构建“文本回复”的方法，这里意思是向用户回复“欢迎关注”的文字。
        return buildTextResponse(help); 
    }

##cjc.weixinmp.AbstractWeixinmpController
这个是API的总控制器，包含主动接口和被动接口。
这个控制器应该在Application上下文的生命周期内只创建一个实例，并接管某一个Servlet的doPost和doGet请求。

####AbstractUserOperate cjc.weixinmp.test.WeixinmpController.getUserOperate(String FromUserName)
这个抽象方法为每次用户主动发送消息时调用，一般返回与用户绑定的AbstractUserOperate对象，这样保证用户会话不被串线。

####void cjc.weixinmp.test.WeixinmpController.logInfo(String msg)
这是框架默认的记录日志方法，你可以重写它以及其他几个日志方法，用你自己的记录方式，例如log4j。

####主动接口
由你的服务器对微信服务器进行主动调用的接口称之为主动服务。
例如：自定义菜单、客户消息用户管理等。

以下为可用的接口（注意：这些主动接口大部分为高级接口，需要服务号才能使用）：

// 自定义菜单接口
    CustomerMenuService cjc.weixinmp.AbstractWeixinmpController.getCustomMenuService()
    
    // 上传下载接口
    MediaLibraryService cjc.weixinmp.AbstractWeixinmpController.getMediaLibraryService()
    
    // 客户消息接口
    MessageService cjc.weixinmp.AbstractWeixinmpController.getMessageService()
    
    // 参数二维码接口
    QRCodeService cjc.weixinmp.AbstractWeixinmpController.getQrCodeService()
    
    // 用户管理接口
    UserManagerService cjc.weixinmp.AbstractWeixinmpController.getUserManagerService()

// 商品管理接口
    MerchantProductService cjc.weixinmp.AbstractWeixinmpController.getMerchantProductService();

// 库存管理接口
    MerchantStockService cjc.weixinmp.AbstractWeixinmpController.getMerchantStockService();

// 邮费模板管理接口 
    MerchantExpressService cjc.weixinmp.AbstractWeixinmpController.getMerchantExpressService();

// 商品分组管理接口 
    MerchantGroupService cjc.weixinmp.AbstractWeixinmpController.getMerchantGroupService();

// 货架管理接口
    MerchantShelfService cjc.weixinmp.AbstractWeixinmpController.getMerchantShelfService();

// 订单管理接口
    MerchantOrderService cjc.weixinmp.AbstractWeixinmpController.getMerchantOrderService();

以创建自定义菜单为例：

CustomButton button = new CustomButton();
    button.addButton(CustomMenu.TYPE.click, "空按钮", "anniu1", null);
    button.addButton(CustomMenu.TYPE.view, "百度", null, "http://www.baidu.com");
    button.addButton(CustomMenu.TYPE.click, "菜单", "anniu1", null) //
            .addSubButton(CustomMenu.TYPE.click, "按钮一", "anniu1", null) //
            .addSubButton(CustomMenu.TYPE.click, "按钮二", "anniu2", null) //
            .addSubButton(CustomMenu.TYPE.view, "视频", null, "http://v.qq.com");
    AbstractWeixinmpController.getCustomMenuService().updateMenu(button);

联系方式
==========================================
这里是唯一的代码仓库。

欢迎加入QQ群讨论：289709908(在线即解决问题，代码更新更快，欢迎报告BUG和技术交流)

专用Email：github@caijianqing.cn

有任何疑问请优先使用QQ群获得帮助，同时接受微信公众号定制开发。

weixinmp4java

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README