刚开始做小程序项目搭建,可能会觉得步骤挺多。但只要一步一步做,并不会很难。项目需要关注的地方挺多,像是用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命令查看较庞大的文本档案,面对信息量大的文件,它允许你逐页查看,相比在文本编辑器中查找,这个操作更为简单快捷。
在制作个人小程序时,你是否遇到过文中没有提到的其他挑战?欢迎你分享你的经历。