.net微信公众号开发——快速入门【转载】

最近在学习微信公众号开发,将学习的成果做成了一个类库,方便重复使用。

现在微信公众号多如牛毛,开发微信的高手可以直接无视这个系列的文章了。

使用该类库的流程及寥寥数行代码得到的结果如下。

本文的源代码主要在:http://git.oschina.net/xrwang2/xrwang.weixin.PublicAccount/blob/master/xrwang.net/WeixinInterface.ashx以及http://git.oschina.net/xrwang2/xrwang.weixin.PublicAccount/blob/master/xrwang.net/Global.asax

1 引用微信公众号类库

引用xrwang.weixin.PublicAccount。

2 添加公众号信息

添加提供服务的公众号的信息,包括:原始id、AppId、AppSecret、EncodingAESKey。代码如下:

AccountInfoCollection.SetAccountInfo(new AccountInfo("YourOriginalId", "AppId", "AppSecret", "Token", "EncodingAESKey"));

如果需要同时给多个公众号提供服务,重复上面这行代码就可以了。

注:由于微信服务器的原因,如果在一个站点中要同时给多个公众号提供服务,有两种方法:如果用同一页面处理多个公众号,那么Token必须一致(1)可以在接口配置信息的URL中加入区分公众号的参数(例如:http://www.xrwang.net/WeixinInterface.ashx?username=gh_5dbae931ec49);(2)针对每个公众号单独建立一个页面来处理。我目前采用了第一种方式,这样更简便。

我喜欢将添加公众号信息的工作放到Gobal.asax的Application_Start方法中。

3 与微信服务器通信

我添加了名为“WeixinInterface.ashx”的一般处理页,并在其中与微信服务器进行通信,包括:校验请求、处理请求、回复适当的响应。代码如下:

    public void ProcessRequest(HttpContext context)

    {

        string result = string.Empty;

        if (Validate(context))

        {

            if (context.Request.HttpMethod == WebRequestMethods.Http.Get)

                result = HandleGet(context);

            else if (context.Request.HttpMethod == WebRequestMethods.Http.Post)

                result = HandlePost(context);

        }

        else

            Message.Insert(new Message(MessageType.Exception, "校验消息失败。\r\n地址:" + context.Request.RawUrl));

        context.Response.Write(result);

    }

与微信服务器通信

3.1 校验请求

首先,我们需要校验接收到的请求是否来自微信服务器,方法如下:

    /// <summary>

    /// 验证消息的有效性

    /// </summary>

    /// <param name="context"></param>

    /// <returns>如果消息有效,返回true;否则返回false。</returns>

    private bool Validate(HttpContext context)

    {

        string token = AccountInfoCollection.First.Token;   //由于在校验微信签名时,微信未传入公众号,因此这里用第一个公众号的TOKEN

        string signature = RequestEx.TryGetQueryString("signature");

        string timestamp = RequestEx.TryGetQueryString("timestamp");

        string nonce = RequestEx.TryGetQueryString("nonce");

        if (string.IsNullOrWhiteSpace(signature) || string.IsNullOrWhiteSpace(timestamp) || string.IsNullOrWhiteSpace(nonce))

            return false;

        return xrwang.weixin.PublicAccount.Utility.CheckSignature(signature, token, timestamp, nonce);

    }

校验请求

当然,如果你对世界充满爱,相信没有欺骗;如果你厉行节约,急需提高性能;不校验也是可以的。

3.2 处理请求

校验完请求之后,我们分两种情况处理请求:

(1)微信服务器的GET请求,用来验证我们的服务器是否正在工作,我们直接返回echostr就可以了;

    /// <summary>

    /// 处理微信的GET请求,校验签名

    /// </summary>

    /// <param name="context"></param>

    /// <returns>返回echostr</returns>

    private string HandleGet(HttpContext context)

    {

        return RequestEx.TryGetQueryString("echostr");

    }

处理GET请求

(2)微信服务器的POST请求,这是服务器分发给我们的消息,我们需要解析消息。

RequestMessageHelper helper = new RequestMessageHelper(context.Request);

3.3 回复响应

解析完微信服务器分发给我们的消息之后,我们要做出回应。我这里把收到的消息直接发回去,偷懒~\(≧▽≦)/~啦啦啦

    /// <summary>

    /// 处理微信的POST请求

    /// </summary>

    /// <param name="context"></param>

    /// <returns>返回xml响应</returns>

    private string HandlePost(HttpContext context)

    {

        RequestMessageHelper helper = new RequestMessageHelper(context.Request);

        if (helper.Message != null)

        {

            ResponseBaseMessage responseMessage = HandleRequestMessage(helper.Message);

            return responseMessage.ToXml(helper.EncryptType);

        }

        else

            return string.Empty;

    }

    /// <summary>

    /// 处理请求消息,返回响应消息

    /// </summary>

    /// <returns>返回响应消息</returns>

    private ResponseBaseMessage HandleRequestMessage(RequestBaseMessage requestMessage)

    {

        ResponseTextMessage response = new ResponseTextMessage(requestMessage.FromUserName, requestMessage.ToUserName,

            DateTime.Now, string.Format("自动回复,请求内容如下:\r\n{0}", requestMessage));

        response.Content += "\r\n<a href=\"http://www.cnblogs.com\">博客园</a>";

        return response;

    }

回复响应

当然了,正常情况下,我们需要兵来将挡水来土掩,根据不同的请求,回复对应的响应。如果需要对请求排队,再一一回复客服消息,可以先直接回复空字符串。回复客服消息的方法请看后面的文章。

4 微信公众号类库简介

xrwang.weixin.PublicAccount是一套简化微信公众号开发的类库,由王先荣开发,并且正在添砖加瓦中。采用MIT开源协议,大家可以随便用,别删掉我的名字就可以啦。

源代码的地址是:http://git.oschina.net/xrwang2/xrwang.weixin.PublicAccount

如果发现BUG,请在博客中留言,或者给我发电子邮件:xrwang(a)126.com。

千万不要用QQ或者阿里旺旺聊天,打扰我玩游戏,我会骂人的  >.<

5 体验测试号

下面分别是我的测试号和公众号,您可以对照文章来体验哦。


测试号



测试号权限多,几乎可以测试公众平台的所有功能。


我的公众号

xrwang



个人订阅号,功能较少,不过我会特别优化。

好了,感谢您看完本文,希望对您有所帮助。本文来自xrwang的博客http://xrwang/cnblogs.com,欢迎在不篡改作者的前提下转载以传播知识。

时间: 2024-11-01 17:56:16

.net微信公众号开发——快速入门【转载】的相关文章

.net微信公众号开发——快速入门

作者:王先荣 最近在学习微信公众号开发,将学习的成果做成了一个类库,方便重复使用. 使用该类库的流程及寥寥数行代码得到的结果如下.   1 引用微信公众号类库 引用xrwang.weixin.PublicAccount. 2 添加公众号信息 添加提供服务的公众号的信息,包括:原始id.AppId.AppSecret.EncodingAESKey.代码如下: AccountInfoCollection.SetAccountInfo(new AccountInfo("YourOriginalId&q

php微信公众号开发,入门篇(实现了关注公众号发送欢迎信息,发关键词自回复)

大致效果如下图所示! 一.入门经历 首先我看的慕课网的视频,理论的东西还不错,可是跟着把代码敲一遍的时候就没懵逼了,除了验证服务器通过之外, 关注公众号根本不会自动回复,着急呀,再找其他的,敲完代码,再测试依然不行,折磨人呀!于是我重新来排查一遍, 说下都排查了哪些些: 第一:用的订阅号没问题(有在关注时回复信息的功能) 第二:开发用的服务器的公网开发地址(要直接指向自己的程序)要配置好 第三:服务器上的文件目录要和第二部的网址对应起来,检测也没问题 然后我就各种检查代码,结果一次次失败,关注公

微信公众号开发入门心得(一)

一.前言 为了快速了解微信公众号开发过程,我选择了php语言来进行微信公众号开发,选择php的原因有两点,一是网上有很多用php开放微信公众号的教程,可以减少学习成本:二是php也比较容易学习,学习门槛低. 学习php开发微信公众号,开发者需要有一点php基础.对于学过其他编程语言的童鞋,了解一些基本的php语法就可以开始了.我的 PHP基础学习笔记(一) 二.微信公众号开发的步骤 三.微信公众号开发步骤详解   + 微信公众号开发入门可以参考 微信公众平台开发入门教程 教程中用的新浪云做的服务

微信公众号可快速创建“门店小程序” 不用开发

“门店小程序”是啥?“门店小程序”是小程序的一项新能力.无需开发,商户就可在微信公众号后台快速创建“门店小程序”.这个小程序类似一张“店铺名片”,可以展示线下门店名称.简介.营业时间.联系方式.地理位置和图片等门店信息,并支持在公众号自定义菜单.图文消息和模板消息等场景中使用. 它长这样: (左侧为“门店小程序”示意图,将来商户可根据需要为门店小程序快速配置卡券.支付功能) “门店小程序”和你们平时用到的小程序不同点在于: 页面标准化——便于用户识别:指向性明确——是一个“门店”:创建简单——公

微信公众号开发入门笔记(一):知识及技术路线图

注:本系列博客所使用的编程语言为Java,内容主要来自于慕课网课程:初识Java微信公众号开发(课程链接:http://www.imooc.com/learn/368)的学习收获和总结. 因为微信的大规模普及性,微信公众号开发可以开发出跨平台使用的功能,并且使用起来简单方便.个人使用Java作为工作语言,对Java比较熟悉,所以本系列的笔记采用Java语言来进行开发.此外,慕课网的课程"初识Java微信公众号开发"为我带来了很大的启发,很适合想要做微信公众平台开发的朋友们的入门. 那么

JAVA微信公众号开发入门

好久没进博客,最近应某人的要求,要每周写一篇博客,故此今天就把我这周刚学的微信公众号开发的知识在此总结总结,以供后人查阅.我写博客都是简要白话文,勿喷. 1.为什么要学微信公众号开发 微信的用户量庞大,微信公众号的完善和不断的开放力度,企业市场对公众号开发的需求不断增加 2.如何搭建微信开发平台 开发工具什么的就不说了,因为微信是要外网访问的,所有你必须有个网上的服务器资源,而且你必须申请一个微信公众号. 2.1申请微信公众号 公众号有3种:订阅号,服务号,企业号 区别是企业号适合内部人使用,因

微信公众号开发入门笔记(四):开发环境搭建

(一)Eclipse+Tomcat本地服务器的搭建及Servlet程序的创建 我们主要在Servlet程序中实现业务逻辑,自然要先熟悉Servlet程序开发环境的搭建及程序的创建. 详见博文:微信公众号开发技术基础(一):Eclipse+Tomcat搭建本地服务器并跑通HelloWorld程序 (二)外网映射工具的准备 从上一篇博文中的数据交互原理中可以看出,我们的本地后台服务器是需要直接和微信服务器进行交互的,而微信服务器必须访问一个公网的地址,无法访问我们本地的地址.因此,需要一个外网映射工

带领技术小白入门——基于java的微信公众号开发(包括服务器配置、java web项目搭建、tomcat手动发布web项目、微信开发所需的url和token验证)

微信公众号对于每个人来说都不陌生,但是许多人都不清楚是怎么开发的.身为技术小白的我,在闲暇之余研究了一下基于java的微信公众号开发.下面就是我的实现步骤,写的略显粗糙,希望大家多多提议! 一.申请服务器 1.我购买的是阿里云服务器,购买后要设置一下服务器密码,默认用户名是administrator,购买好后如下: 2.申请好后,copy一下此服务器的IP地址(公有),在本地ping一下看看是否可用,j键盘Win+R,输入cmd,输入ping+IP回车,如下即为成功: 二.配置服务器 1.下载远

微信公众号开发总结

最近公司用到了微信公众平台,所以研究了一下微信公众号的开发技术,总体来说比较简单,结合现有的平台核技术,实现起来非常方便. 首先先来了解一下微信公众平台. "微信,是一个生活方式" ,这是微信的自我评价,是不是觉得如果那天不在朋友圈里分享一下自己的最新状态, 并且收到几个赞和评价的话,会觉得空虚寂寞呢?它实实在在的改变了我们的生活方式. " 微信,也是一个生意方式 ",在微信成为我们日常必备之app的同时,它同样具备巨大的的商业 或许不应该称为潜力,因为有很多人已经