学习之路--微信公众号开发(一)

时间:2022-06-06 10:43:53

一、开发前的准备

  1、打开网址:https://mp.weixin.qq.com/debug/cgi-bin/sandbox?t=sandbox/login

  2、微信公众平台测试号系统测试号申请,登录进去,配置相关信息。

  3、①接口配置信息:url设置,Token设置;②js接口安全域名:域名设置;③体验接口权限表:网页服务:网页账号:授权回调页面域名设置。

  4、扫描测试号二维号,关注自己的测试公众号。

  5、记住自己的测试号信息:appID,appsecret。要复制到项目中。

  6、使用公司的ngrok,启动,把本地url(127.0.0.1:8080)映射到测试号的接口配置url。(就是把项目映射到外网,然后要和3①接口配置的url一致)

  7、下载项目开发工具-->微信web开发者工具,用于页面调试,当然,用别的工具也可以,只不过是缺少了一些微信专属的功能罢了。

二、项目的配置

  1、一般来讲,微信项目不做功能,微信项目的背后总会有一个很大的后台项目默默支持着。因此,微信开发需要两个项目。微信开发相当于是寄生在后台大项目下的小项目。

  2、由公司大牛们创建svn地址(一般公司的svn地址的管理维护都在高层手中,然后给我们这些小学生分配权限)

    学习之路--微信公众号开发(一)

 

  3、复制现有的能满足项目大部分需求的项目,粘贴过来,两个项目都这样。(节省环境配置,项目搭建和基础功能开发等所耗的时间,没有得复制就只能从头开发了)

  4、删除大部分不需要的文件和代码(甚至可以把所有不是框架的代码都干掉)(有能满足项目需求的代码和公共类的代码留下)

  5、项目用的是ssh框架,干掉代码后,开始后台项目的开发(数据库,po,dao,service,action),简单的创建文件,让项目能跑起来。

  6、微信开发,同样的删旧项目代码,然后开发。

  7、配置文件:WeixinConfig extends JFinalConfig。这块我不会,主要代码是: PropKit.use("dev.txt");

  8、dev.txt,就是配置信息文件,名字不重要,可以随意起名,跟WeixinConfig 匹配上就行。下面上图:(#表示注释)(因为有上传文件的需求,所以接入了和后台项目配置一样的mongo数据库)

    学习之路--微信公众号开发(一)

  9、对于所需要引入的jar包,自己在pom.xml文件上修改,一般公司的maven库中都有。

  10、一般项目都有一个Controller,继承于jfinal中的ApiController,实现很多公众号功能,比如:(这些是原项目有的功能,我就只改了个创建菜单的菜单名称和链接)(很多功能在jfinal-weixin-1.7.jar都有)

    获取公众号菜单,创建菜单,获取公众号关注用户,获取用户信息,发送模板消息,获取参数二维码,获取客服聊天记录,获取微信服务器IP地址,添加多客服,长链接转成短链接,支持多公众账号

三、项目的开发

  1、微信项目用的Jfinal,这个我不懂。开发的思路:如果我没猜错,这应该是个订阅号,因为并没有什么乱七八糟的功能,基本上是信息展示。

  2、开发的思路①,用一个Controller来做所有页面的跳转(分开用几个也行,主要是我的项目小)。我将它命名为HomeLinkController.java,虽然我也觉得这个命名有点傻,但是就将就着用吧。

 1 /**
 2  * 功能: 微信--xxx项目--微官网--所有链接.<br/>
 3  * date: 2017年6月29日 上午11:24:34 <br/>
 4  *
 5  * @author @xxx.com
 6  * @version
 7  * @since JDK 1.8
 8  */
 9 @ControllerBind(controllerKey = "/home-link", viewPath = "/WEB-INF/jsp/first-skin")
10 public class HomeLinkController extends Controller {
11 
12     public void index() {
13         renderJsp("portal/index.jsp");
14     }
15 
16     public void toNews() {
17         renderJsp("portal/news/page.jsp");
18     }
19     //……
20 }

 

  3、开发的思路②,用一个Controller来做所有ajax请求的接收和发送。

 1 /**
 2  * 功能: 微信--xxx项目--微官网.<br/>
 3  * date: 2017年6月29日 上午11:24:34 <br/>
 4  * companyDetail
 5  * 
 6  * @author xxx@xxx.com
 7  * @version
 8  * @since JDK 1.8
 9  */
10 @ControllerBind(controllerKey = "/home-ajax", viewPath = "/WEB-INF/jsp/first-skin")
11 public class HomeAjaxController extends WebApiController {
12 
13     /**
14      * 轮播图
15      */
16     public void swiper() {
17         currUrl = "/home-news-pic-api!page";
18         commonOper();
19     }
20 
21     /**
22      * 新闻列表
23      */
24     public void newsList() {
25         currUrl = "/home-information-release-api!page";
26         commonOper();
27     }
28     //……
29 }

  4、在继承的公共类里面写点代码:

 1     /**
 2      * 功能: 具体操作由 currUrl 决定<br/>
 3      * date: 2017年9月16日 下午7:53:18 <br/>
 4      *把参数全都扔给后台项目的接口
 5      * @author zhaijunfeng
 6      */
 7     public void commonOper() {
 8         paraMap = genParaMap();
 9         putOtherInfo(paraMap);
10         String jsonResult = HttpHelper.post(this.currUrl, paraMap);
11         renderJson(jsonResult);
12     }
13 
14     /**
15      * 功能: 获取 (String, String>)类型约束的request.getParameterMap()
16      * ,其主要目的是把参数发给服务器,不作处理,如须处理,请重写<br/>
17      * date: 2017年9月16日 下午7:27:46 <br/>
18      *
19      * @author xxx
20      * @return
21      */
22     protected Map<String, String> genParaMap() {
23         Map<String, String> map = Maps.newHashMap();
24         Map<String, String[]> reMap = getParaMap();
25         for (String key : reMap.keySet()) {
26             map.put(key, StringUtils.join(reMap.get(key), ","));
27         }
28         return map;
29     }

 

   5、引入工具类HttpHelper.java,调用了JFinal中的HttpKit.class,实现了后台项目的接口请求,强调了json格式,Constants.MEN_HU就是dev.txt中门户地址(我写错了,应该是后台地址)下面那句.

1 public class HttpHelper {
2     private static String CHARSET = "UTF-8";
3 
4     public static String post(String method, Map<String, String> parm) {
5         String json = HttpKit.post(Constants.MEN_HU + method, parm, "", Constants.header);
6         return json;
7     }
8     //……
9 }

 

   6、后台项目的action层,新建一个包,专门放置微信的接口,包里的所有action完全对外开放(微信公众号不需要注册功能嘛,所以把拦截器干掉)

 1 /**
 2  * 功能: 信息发布管理<br/>
 3  * date: 2017-4-8 11:50:08 <br/>
 4  *
 5  * @author robot
 6  * @version
 7  * @since JDK 1.8
 8  */
 9 @Scope("prototype")
10 @ParentPackage(value = "struts-default")  //就是这个,之前是struts-default-authority,至于是在哪设置的我就不知道了,拦截器我不会
11 @Namespace(value = "/")
12 @Results({
13         @Result(name = "toAddOrUpdate", location = "/WEB-INF/jsp/gateway-menu-manage/home-information-release/create.jsp"),
14         @Result(name = "toPage", location = "/WEB-INF/jsp/gateway-menu-manage/home-information-release/page.jsp") })
15 public class HomeInformationReleaseApiAction extends AbstractCrudAction<HomeInformationRelease> {
16   //……
17 }

 

  7、前后台开发者之间开会,需求分析,讨论商量,约定接口(都是我来干,所以我就不用开会了)

  8、后台项目开发者写后台功能,微信前端开发者写前端页面(这些跟微信就没啥关系了,原来的后台java怎么写就怎么写,原来的移动端web开发怎么写就怎么写)

  9、特殊功能开发,可能跟微信有关,在这里就不详细说明了。可通过浏览我别的学习微信开发的文章了解。

  10、完成项目,收工。