微信小程序开发全攻略:从SpringBoot后端构建到Linux部署上线

2025-01-20 工具与资源 147次阅读

刚开始做小程序项目搭建,可能会觉得步骤挺多。但只要一步一步做,并不会很难。项目需要关注的地方挺多,像是用Springboot来构建后端架构,小程序怎么调用API,还有编写RESTful接口,这些都是需要注意的要点。

Springboot后端架构构建

微信开发工具代码版本控制

   
  
    org.springframework.boot
    spring-boot-starter-parent
    1.5.9.RELEASE
  
  
    
    
    
      org.springframework.boot
      spring-boot-starter-freemarker
    
    
    
      org.springframework.boot
      spring-boot-starter-web
    
    
    
    
      org.springframework.boot
      spring-boot-starter-web
      
        
          org.springframework.boot
          spring-boot-starter-tomcat
        
      
    
    
      org.apache.tomcat.embed
      tomcat-embed-jasper
    
  

在后端架构搭建过程中,Springboot是一个不错的选择。它能够迅速搭建所需的后端环境。在启动新项目时,它能显著减少配置所需的时间。开发者无需从头开始构建框架,只需根据实际需求添加相应的组件。而且,Springboot社区提供了详尽的文档和示例代码,有助于解决遇到的问题。Springboot遵循约定优于配置的原则,许多默认配置已经由开发者预先设定,这大大减轻了开发者的工作负担。

#jsp支持
spring.mvc.view.suffix=.jsp
spring.mvc.view.prefix=/WEB-INF/jsp/
#this is set port
#server.port=80
server.port=443
#添加ssl证书
#ssl证书文件名
server.ssl.key-store=classpath:xxxxxxx.pfx
server.ssl.key-store-password=xxxxxxxx
server.ssl.keyStoreType=xxxxxxxx

Springboot配备了丰富的插件,这大大丰富了我们的功能。例如,监控插件让我们能清晰看到项目运行中的各种状况,包括内存使用率等关键信息。有了这些实时数据,我们可以灵活调整项目的优化方案。


@ComponentScan(basePackages= "com.bin")//添加扫包@ComponentScan(basePackages= "")
@EnableAutoConfiguration
public class App{
  //启动springboot
  public static void main(String[] args) {
    SpringApplication.run(App.class, args);
  }
}

小程序项目构建

小程序项目的搭建,框架设计独特,功能丰富。开发过程中,要注意域名配置。不少新手一开始没有自己的服务器和域名,这时应在开发工具的“详细”选项里,在“项目设置”里选择“不校验域名安全性”。这样做能避免因域名问题耽误开发。小程序的布局设计很重要,它直接影响到用户的使用体验。要依据具体功能合理规划页面布局,并在设计初期就充分考虑关键页面的交互流程。

@RestController
@SpringBootApplication
public class ControllerText {
  
  @RequestMapping("getUser")
  public Map getUser(){
    System.out.println("微信小程序正在调用。。。");
    Map map = new HashMap();
    List list = new ArrayList();
     list.add("zhangsan");
     list.add("lisi");
     list.add("wanger");
     list.add("mazi");
     map.put("list",list);
    System.out.println("微信小程序调用完成。。。");
    return map;
  }
  
  @RequestMapping("getWord")
  public Map getText(String word){
    Map map = new HashMap();
    String message = "我能力有限,不要为难我";
    if ("后来".equals(word)) {
      message="正在热映的后来的我们是刘若英的处女作。";
    }else if("微信小程序".equals(word)){
      message= "想获取更多微信小程序相关知识,请更多的阅读微信官方文档,还有其他更多微信开发相关的内容,学无止境。";
    }else if("西安工业大学".equals(word)){
      message="西安工业大学(Xi'an Technological University)简称”西安工大“,位于世界历史名城古都西安,是中国西北地区唯一一所以兵工为特色,以工为主,理、文、经、管、法协调发展的教学研究型大学。原中华人民共和国兵器工业部直属的七所本科院校之一(“兵工七子”),陕西省重点建设的高水平教学研究型大学、陕西省人民政府与中国兵器工业集团、国防科技工业局共建高校、教育部“卓越工程师教育培养计划”试点高校、陕西省大学生创新能力培养综合改革试点学校。国家二级保密资格单位,是一所以\"军民结合,寓军于民\"的国防科研高校。";
    }
    map.put("message", message);
    return map;
  }
  
  @RequestMapping("")
  public String getText(){
    return "hello world";
  }
}

小程序的设计需注重外观与功能。以电商小程序为例,商品展示页面需既吸引眼球,又便于用户快速获取所需信息。为此,分类图标需布局合理,文字描述需清晰易懂。




    姓名:{{item}}
  

小程序API调用后台RESTful接口

/**
   * 页面的初始数据
   */
  data: {
    list: '',
    word: '',
    message:''
  },
  houduanButton1: function () {
    var that = this;
    wx.request({
      url: 'http://localhost:443/getUser',
      method: 'GET',
      header: {
        'content-type': 'application/json' // 默认值
      },
      success: function (res) {
        console.log(res.data)//打印到控制台
        var list = res.data.list;
        if (list == null) {
          var toastText = '数据获取失败';
          wx.showToast({
            title: toastText,
            icon: '',
            duration: 2000
          });
        } else {
          that.setData({
            list: list
          })
        }
      }
    })
  }

这是小程序与服务器连接的关键步骤。API的设计必须清晰且规范,包括对接口功能的详细说明、参数的类型及其应用领域。在实际对接过程中,数据传输的准确性至关重要。比如,在用户登录功能的API应用中,小程序发送的用户名和密码信息必须精确无误地传递到服务器,服务器按照既定的规则进行核实,然后提供相应的状态信息。

 
  
  
    {{message}}
  

RESTful接口的设计使得数据查询与回应过程既清晰又快捷。以GET为例,它用于检索信息;而POST则用于添加新内容。这样的设计让前端与后端间的交流变得直观易懂,无论是日常的维护还是将来功能的更新,都大大提高了操作的便利性。

//获取输入框的内容
  houduanTab_input: function (e) {
    this.setData({
      word: e.detail.value
    })
  },
  // houduanButton2的网络请求
  houduanButton2: function () {
    var that = this;
    wx.request({
      url: 'http://localhost:443/getWord',
      data:{
        word: that.data.word
      },
      method: 'GET',
      header: {
        'content-type': 'application/json' // 默认值
      },
      success: function (res) {
        console.log(res.data)//打印到控制台
        var message = res.data.message;
        if (message == null) {
          var toastText = '数据获取失败';
          wx.showToast({
            title: toastText,
            icon: '',
            duration: 2000
          });
        } else {
          that.setData({
            message: message
          })
        }
      }
    })
  }

编写测试Controller实现通信

微信开发工具代码版本控制

控制器在小程序与Java后端的无缝对接中起着至关重要的作用。以微信小程序为例,在编写代码时,要关注注解的正确使用。比如@RestController这个注解非常实用,它相当于将两个注解的功能合二为一,可以将后端的数据以JSON格式发送到前端页面,如网页,便于前端进行数据处理。在实际操作中,编写的控制器需要不断进行测试,确保各个模块传来的数据都能得到正确处理并有效反馈。

微信开发工具代码版本控制

在编写Controller时,要留意异常情况的处理细节。比如,当前端传来的数据不合法时,后端应当能够识别并反馈相应的错误信息,从而保障通信的稳定性和可信度。

Linux下部署上线

在Linux环境下部署应用,得先确保服务器已准备好。若项目是用Springboot开发的,建议打包成Jar格式来部署。服务器上要安装对应版本的JDK,然后把打包好的文件上传到服务器上。为了提高安全性,可以考虑购买域名并申请免费的SSL证书。在application.properties配置文件里,可以加入证书的pfx文件来设置。部署步骤不复杂,比如用命令java -jar helloworld.jar来执行。而且,在命令最后加上&符号,就能生成nohup.out日志文件,方便查看。

运行命令: nohup java -jar helloworld.jar &

确保项目顺畅进行,检查记录显得尤为重要。在Linux环境下,有多种工具可以帮助我们查看日志,比如tail、cat、tac等。掌握其中几项技能,就能快速找到问题所在。举例来说,通过执行tail -fn 10 test.log这条命令,可以持续跟踪test.log文件中的最后10行日志,这样便于实时监控项目状态。

开发中的小技巧

除了之前提到的重点,还有一些小技巧能提高工作效率。以Linux系统为例,vi编辑器可以让我们直接通过文件名来编辑和查看文件,这在处理配置文件时尤为方便。另外,tail命令可以显示文件末尾的几行内容,非常实用。还有more命令,它能够分页显示屏幕上的文本。合理使用这些小工具,可以让我们的开发工作更加得心应手。

运用more命令查看较庞大的文本档案,面对信息量大的文件,它允许你逐页查看,相比在文本编辑器中查找,这个操作更为简单快捷。

在制作个人小程序时,你是否遇到过文中没有提到的其他挑战?欢迎你分享你的经历。

声明:演示站所有作品(图文、音视频)均由用户自行上传分享,仅供网友学习交流。若您的权利被侵害,请联系
微信扫码,联系我们