微信公众号开发（一）前期配置

最新推荐文章于 2024-11-01 14:48:20 发布

weixin_30675247

最新推荐文章于 2024-11-01 14:48:20 发布

阅读量115

点赞数

文章标签： java

原文链接：http://www.cnblogs.com/xyabk/p/5776317.html

版权

微信公众号开发步骤：

一：有一个公众号，可以是测试公众号，也可以是客户提供的已经申请好的公众号

申请测试公众号的网址：http://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

申请步骤比较简单，这里就不多阐述了。

我开发的主要是客户提供的公众号，一些特殊权限（支付）已经得到开通，可以直接使用，关于测试公众号的某些特殊权限，本人并没有经验。

二：登录到微信公众平台进行开发配置，在登录时可能需要管理员授权，这个就自己联系你们的客户，管理员授权，你才能登录。

登录网址： https://mp.weixin.qq.com/（微信公众平台--官网）

管路员授权之后，我们就可以开始配置了，首先是“基本配置”

首先，来到开发-->基本配置，这里我在初次开发的时候，不知道这里的url应该怎样填写，经过测试，这里的路径主要是一个外界能访问的路径。我的后台开发框架是springMVC，用户访问主要是通过controller，于是我新建了一个项目叫做WXTest,配置好springMVC之后写了一个controller,里面有一个方法叫Test,它的value值是"test"，至于如何配置springMVC的项目，这里就不阐述了，如果有需要，我会单独写一篇文章阐述如何搭建一个简单的springNVC的框架。

好了，配置好controller之后，我们可以通过本地访问：http://127.0.0.1:8080/WXTest/test 这样就可以访问到了，但是如何能让微信服务器访问我的controller,如果没有公网，可以通过花生壳的内网映射，如果有公网，可以直接通过公网的ip（开通了80端口的）访问，这里使用的是花生壳，壳域名就是http://uranusyiju.6655.la,通过花生的内网映射，我可以将其映射到我的8080端口，于是http://uranusyiju.6655.la就相当于我的http://127.0.0.1:8080，所以我这里的url配置就填写http://uranusyiju.6655.la/WXTest(项目名)/test（controller的方法路径），配置好url之后，至于token，主要是用于url的验证，你配置了之后，微信访问你的controller的时候会将这个数据发送于你的后台，你根据token判断是否是微信服务器在访问你，然后返回相应的数据，下面会提到，所以这里的token就是一个双方请求的标识而已，不必过于复杂。填写完token之后，下面的EncodingAESKey可以随机生成，然后确认没问题，点击提交，这里就会开始验证了，所以前期需要将你的框架搭建好，确保路径可以正确访问，以及返回正确的交互数据（如果你controller里的方法写得不对，则无法验证通过验证（下面会提到如何写controller的方法），验证通过了，最后，也是最重要的一个地方，请在外面选择“启用”。

***下面是controller的代码：

@Controller

public class WeixinController {

@Resource

UserSubscribeService userSubscribeService ;

@Resource

UserUnSubscribeService userUnSubscribeService ;

@Resource

UserScanQrCodeService userScanQrCodeService ;

// 唯藌的url、token接口设置(来自微信服务器的消息)

@RequestMapping ( "/test" )

@ResponseBody

public void weixinUrlSet(HttpServletRequest request ,

HttpServletResponse response ) throws IOException {

System. out .println( "进入 test,微信的访问会有2种方式post以及get,get只是做url验证。 " );

boolean isGet = request .getMethod().toLowerCase().equals( "get" );

if ( isGet ) {

System. out .println( "request:" + request .toString());

//get方法，一般用于微信服务器与本机服务器开发的基本配置（就是token验证，确定服务器是你的）

String str = access( request , response );

response .getWriter().write( str );

} else {

//post方法，一般是用户的事件处理（例如：关注/取消关注、点击按钮、发送消息....）

System. out .println( "enter post" );

try {

// 接收消息并返回消息

String str = acceptMessage( request , response );

response .getWriter().write( str );

} catch (IOException e ) {

e .printStackTrace();

}

/**

* 验证URL真实性

* @author morning

* @date 2015年2月17日上午10:53:07

* @param request

* @param response

* @return String

* @throws NoSuchAlgorithmException

* @throws UnsupportedEncodingException

private String access(HttpServletRequest request ,

HttpServletResponse response ) {

// 验证URL真实性

System. out .println( "进入验证access" );

String signature = request .getParameter( "signature" ); // 微信加密签名

String timestamp = request .getParameter( "timestamp" ); // 时间戳

String nonce = request .getParameter( "nonce" ); // 随机数

String echostr = request .getParameter( "echostr" ); // 随机字符串

List<String> params = new ArrayList<String>();

// WeixinStaticData. TOKEN就是配置时的token

params .add(WeixinStaticData. TOKEN );

params .add( timestamp );

params .add( nonce );

// 1. 将token、timestamp、nonce三个参数进行字典序排序

Collections. sort( params , new Comparator<String>() {

@Override

public int compare(String o1 , String o2 ) {

return o1 .compareTo( o2 );

}

});

// 2. 将三个参数字符串拼接成一个字符串进行sha1加密

String str = params .get(0) + params .get(1) + params .get(2);

MessageDigest crypt ;

try {

crypt = MessageDigest. getInstance( "SHA-1" );

crypt .reset();

try {

crypt .update( str .getBytes( "UTF-8" ));

String temp = WeixinTool. batySHA1( crypt .digest());

if ( temp .equals( signature )) {

System. out .println( "成功返回 echostr：" + echostr );

return echostr ;

} else {

System. out .println( "失败认证" );

}

} catch (UnsupportedEncodingException e1 ) {

// TODO Auto-generated catch block

e1 .printStackTrace();

}

} catch (NoSuchAlgorithmException e1 ) {

// TODO Auto-generated catch block

e1 .printStackTrace();

}

return null ;

}

private String acceptMessage(HttpServletRequest request ,

HttpServletResponse response ) throws IOException {

Map<String, String> reqMap = MessageUtil. parseXml( request );

System. out .println( "reqMap:" + reqMap .toString());

String fromUserName = reqMap .get( "FromUserName" );

String toUserName = reqMap .get( "ToUserName" );

String msgType = reqMap .get( "MsgType" );

BaseMsg msg = null ; // 要发送的消息

// 事件推送

if ( msgType .equals(ReqType. EVENT )) {

// 事件类型

String eventType = reqMap .get( "Event" );

// 二维码事件

String ticket = reqMap .get( "Ticket" );

if ( ticket != null ) {

String eventKey = reqMap .get( "EventKey" );

QrCodeEvent event = new QrCodeEvent( eventKey , ticket );

buildBasicEvent( reqMap , event );

msg = handleQrCodeEvent( event );

}

// 关注

if ( eventType .equals(EventType. SUBSCRIBE )) {

//根据reqMap 可以判断用户是否扫带有有参数的二维码

BaseEvent event = new BaseEvent();

buildBasicEvent( reqMap , event );

msg = handleSubscribe( event , reqMap );

}

// 取消关注

else if ( eventType .equals(EventType. UNSUBSCRIBE )) {

BaseEvent event = new BaseEvent();

buildBasicEvent( reqMap , event );

msg = handleUnsubscribe( event );

}

// 点击菜单拉取消息时的事件推送

else if ( eventType .equals(EventType. CLICK )) {

System. out .println( "点击菜单拉取消息时的事件推送" );

String eventKey = reqMap .get( "EventKey" );

MenuEvent event = new MenuEvent( eventKey );

buildBasicEvent( reqMap , event );

msg = handleMenuClickEvent( event );

}

// 点击菜单跳转链接时的事件推送

else if ( eventType .equals(EventType. VIEW )) {

System. out .println( "点击菜单跳转链接时的事件推送" );

String eventKey = reqMap .get( "EventKey" );

MenuEvent event = new MenuEvent( eventKey );

System. out .println( "event：" + event .toXml().toString());

buildBasicEvent( reqMap , event );

msg = handleMenuViewEvent( event );

}

// 上报地理位置事件

else if ( eventType .equals(EventType. LOCATION )) {

double latitude = Double.parseDouble( reqMap .get( "Latitude" ));

double longitude = Double.parseDouble( reqMap .get( "Longitude" ));

double precision = Double.parseDouble( reqMap .get( "Precision" ));

LocationEvent event = new LocationEvent( latitude , longitude ,

precision );

buildBasicEvent( reqMap , event );

msg = handleLocationEvent( event );

}

} else { // 接受普通消息

// 文本消息

if ( msgType .equals(ReqType. TEXT )) {

String content = reqMap .get( "Content" );

TextReqMsg textReqMsg = new TextReqMsg( content );

buildBasicReqMsg( reqMap , textReqMsg );

msg = handleTextMsg( textReqMsg );

}

// 图片消息

else if ( msgType .equals(ReqType. IMAGE )) {

String picUrl = reqMap .get( "PicUrl" );

String mediaId = reqMap .get( "MediaId" );

ImageReqMsg imageReqMsg = new ImageReqMsg( picUrl , mediaId );

buildBasicReqMsg( reqMap , imageReqMsg );

msg = handleImageMsg( imageReqMsg );

}

// 音频消息

else if ( msgType .equals(ReqType. VOICE )) {

String format = reqMap .get( "Format" );

String mediaId = reqMap .get( "MediaId" );

String recognition = reqMap .get( "Recognition" );

VoiceReqMsg voiceReqMsg = new VoiceReqMsg( mediaId , format ,

recognition );

buildBasicReqMsg( reqMap , voiceReqMsg );

msg = handleVoiceMsg( voiceReqMsg );

}

// 视频消息

else if ( msgType .equals(ReqType. VIDEO )) {

String thumbMediaId = reqMap .get( "ThumbMediaId" );

String mediaId = reqMap .get( "MediaId" );

VideoReqMsg videoReqMsg = new VideoReqMsg( mediaId , thumbMediaId );

buildBasicReqMsg( reqMap , videoReqMsg );

msg = handleVideoMsg( videoReqMsg );

}

// 地理位置消息

else if ( msgType .equals(ReqType. LOCATION )) {

double locationX = Double.parseDouble( reqMap .get( "Location_X" ));

double locationY = Double.parseDouble( reqMap .get( "Location_Y" ));

int scale = Integer.parseInt ( reqMap .get( "Scale" ));

String label = reqMap .get( "Label" );

LocationReqMsg locationReqMsg = new LocationReqMsg( locationX ,

locationY , scale , label );

buildBasicReqMsg( reqMap , locationReqMsg );

msg = handleLocationMsg( locationReqMsg );

}

// 链接消息

else if ( msgType .equals(ReqType. LINK )) {

String title = reqMap .get( "Title" );

String description = reqMap .get( "Description" );

String url = reqMap .get( "Url" );

LinkReqMsg linkReqMsg = new LinkReqMsg( title , description , url );

buildBasicReqMsg( reqMap , linkReqMsg );

msg = handleLinkMsg( linkReqMsg );

}

if ( msg == null ) {

// 回复空串是微信的规定，代表不回复

return "" ;

}

msg .setFromUserName( toUserName );

msg .setToUserName( fromUserName );

return msg .toXml();

}

/*******************************************下面为处理每个请求的具体逻辑入口*******************************/

/**

* 处理文本消息

protected BaseMsg handleTextMsg(TextReqMsg msg ) {