Carp介绍和配置

    Carp，是一个微信公众平台二次开发的SDK。

    微信公众平台给出了公众号的开发接口和协议；

    Carp把微信公布的接口和协议进行了封装，同时把公众号的关注人、分组、图片、音视频文件、通信信息等内容保存到了本地，从而可以更加方便的处理用户信息；使用Carp，可以方便的开发出微信离线客服，智能回复，针对性分发信息，数据分析，客户分析等微信应用。

    下面介绍一下Carp的基本使用方法：

    一、Carp的下载

    点击这里进入下载页面。

    Carp_SRC_0.0.1.zip包含了一个的源码内容和所需类库

    carp_BIN_0.0.1.zip 包含了变异后的jar包

    二、Carp的配置和数据库创建

    下载 carp_BIN_0.0.1.zip后解压缩，获得文件如图：

     

•    创建数据库

   carp目前提供了两种数据库支持：firebird和mysql，sql脚本在db文件夹内；

•     修改配置文件
  

   carp的hibernate的数据库配置文件为db.config.xml ，一样提供了两种链接配置，请修改hibernate.connection.url和hibernate.connection.username、hibernate.connection.password三个属性；

    修改weixin.task.xml，找到如下内容：

<task> <name>token</name> <url><![CDATA[https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=AppId&secret=AppSecret]]></url> <work>com.voa.weixin.work.TokenWork</work> <instance>single</instance> </task>

  修改“AppId”和“AppSecret”为公众平台为您分配的值（在“功能－－高级功能”内能查看到）。

    微信收发消息是两种方式，一种是客服消息，属于主动发送，一种是回复用户的消息，属于被动发送； 

    到这里，就已经能够进行客服消息的发送和获取人员列表了。下载Carp_SRC_0.0.1.zip源码包，在demo中有一个

GetAllFans的测试类，可以获得公众号全部的关注用户，并保存到数据库中；

    另外一种方式是被动发送，须要创建一个属于本身的web服务器，部署后便可接受到用户对公众号发发出的消息，而且根据须要进行回复。须要下面的配置：

    三、配置j2EE服务器

    

•     拷贝文件到j2EE服务器

    使用tomcat、reson、jetty、jboss、weblogic、webspere等均可以，将carp.jar拷贝到%APPHOME%/WEB-INF/lib下，把db.config.xml,weinxin.handler.xml,weixin.mission.xml,weixin.task.xml四个文件拷贝到%APPHOME%/WEB-INF/下.

•     修改web.xml文件
  

    为了接收公众平台的信息，在公众平台上会配置一个接收所需的url和验证的token，如图：

   URL，须要使用carp的AuthorFilter映射，AuthorFilter是一个servlet，须要配置到web.xml文件中，相似以下：

<servlet>   <servlet-name>weixin</servlet-name> <servlet-class>com.voa.weixin.filter.AuthorFilter</servlet-class>   <init-param> <param-name>TOKEN</param-name> <param-value>您在公众平台登记的TOKEN</param-value> </init-param> </servlet> <servlet-mapping>   <servlet-name>weixin</servlet-name>   <url-pattern>/weixin</url-pattern>   </servlet-mapping>

    

    启动J2EE服务后，就可以处理用户发送的消息了，可使用源码包的demo中的SendTxtHandler类进行测试，把SendTxtHandler拷贝到您的%APPHOME%/WEB-INF/classes下（不要忘了类的包名的创建～），

    在weixin.handler.xml下有一个屏蔽的配置：

<!--  <handlerclz>com.voa.weixin.demo.SendTxtHandler</handlerclz> -->

打开屏蔽便可，重启服务后，全部用户给您的公众号发送的文本消息，都会收到一个“测试回复”的回复，而且保存信息到数据库。

最后介绍如下demo中例子的做用：

DownloadFile.java ———— 下载文件

GetAllFans.java ———— 得到公众号全部的用户

SendCustomerMessage ———— 发送客服消息到指定用户（注意，须要是48小时活动的用户）

UpdateFile.java ———— 上传文件到公众平台

SendTxtHandler ———— 回复用户的文本消息（须要部署到J2EE服务器）

carp技术群：368193775

相关文章：

carp搭建公众平台（一）——发送客服消息

carp搭建公众平台（二）——得到全部客户信息和自定义任务

carp搭建公众平台（三）——上传下载多媒体文件