- 别名：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：[email protected]
有任何疑问请优先使用QQ群获得帮助，同时接受微信公众号定制开发。