后端应用程序可以看作一堆接口的结合体,用于应对网站系统的各种业务处理。
在本小节将要构造的后端应用程序中也会有几个简单的接口。
注意:本小节的例子将以Java作为开发语言,以Spring Boot作为基础框架,以IntelliJ IDEA作为开发工具。本小节的例子不使用数据库,数据库的使用会在本章的后续内容中介绍。
1.新建一个后端应用程序工程
新建一个后端应用程序工程一般需要借助开发工具,这里选用IntelliJIDEA作为开发工具。选择File|New Project命令打开New Project(新建工程)对话框,如图4.17所示,其中,JDK需要选择在4.1.2小节中搭建Web应用服务器安装的JDK。
注意:开发工具可以按照个人偏好选择,在Java后端开发工具里,除了IntelliJ IDEA以外,还有Eclipse、MyEclipse、NetBeans等。其中,IntelliJ IDEA和MyEclipse是收费的。
单击Next(下一步)按钮后,在弹出的对话框中设置工程属性,如图4.18所示。其中,Type、Packaging和Java Version选项的设置需要注意,Type用于选择构建工具,Packaging用于设置打包方式,Java Version为JDK版本。其他属性根据实际情况设置即可。
说明:构建工具是将“源码生成可执行程序的过程”自动化的程序,简单地说,构建工具能简化我们的开发过程,使用构建工具后,我们不需要再关心依赖程序下载、依赖程序引入、编译打包等过程。而比较流行的Java构造工具为Ant、Maven和Gradle,其中Gradle以其优秀的语法特性越来越占主要位置,本篇也以Gradle作为后端应用程序的构造工具。
工程属性配置完之后,可以选择引入一些依赖程序,如图4.19所示。其中,Spring Boot的版本一般选用最新的稳定版即可,依赖程序可根据实际需要引入,这里由于是想要构造简单的后端应用程序,所以只引入了最基本的Spring Web依赖。
注意:依赖程序不是只能在构造工程时引入,因此这里不必担心“引入不全面”等问题。
选择完依赖程序后,进入构造工程的最后一步,即设置工程名和工程目录,如图4.20所示。其中,我们只需要关心Project name(工程名)和Project location(工程目录)选项即可。
配置完工程名和工程目录后,会在指定的工程目录下生成相关文件,如图4.21所示。一般情况下,我们只需要关心图中标识的文件即可。
2.修改build.gradle文件
新建一个后端应用程序工程后,需要修改build.gradle文件。完整的build.gradle配置如代码4.10所示,其中,version中的版本信息需要去掉,否则打包文件的命名中会出现版本信息(如demo.1.0-SNAPSHOT.war),另外,需要在dependencies{}中添加implementation'
com.alibaba:fastjson:1.2.67',因为在程序中需要用到JSONObject类。
代码4.10 build.gradle配置
plugins {
//Spring Boot版本
id 'org.springframework.boot' version '2.2.5.RELEASE'
//依赖程序管理器版本
id 'io.spring.dependency-management' version '1.0.9.RELEASE'
id 'java' //编程语言
id 'war' //打包方式
}
group = 'com.example' //与工程group对应
version = '' //打包版本,这里需要清空
sourceCompatibility = '11' //JDK版本
repositories { //指定依赖程序仓库,可配置国内镜像库
mavenCentral()
}
dependencies { //后端工程的依赖程序
implementation '
com.alibaba:fastjson:1.2.67' //新引入fastjson依赖包implementation 'org.springframework.boot:spring-boot-starter-web'
providedRuntime 'org.springframework.boot:spring-boot-starter-tomcat'
testImplementation('org.springframework.boot:spring-boot-starter
test') {
exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}
}
test {
useJUnitPlatform()
}
修改完build.gradle文件后,需要同步一下,这样依赖包才会被下载到本地。IntelliJ IDEA的同步按钮如图4.22所示。当依赖包下载不正确时会有错误提示。
3.编写接口代码
前期工作准备完毕后,就可以开始写代码了。由于Spring架构提倡把后端应用程序分成Controller、Service和Dao三层,所以先创建3个对应的Java文件,即TestController.java、TestDao.java和TestService.java,如图4.23所示。
TestController.java是Controller层的代码,Controller层负责接收请求、调用Service层的方法和返回结果。这里添加两个接口,一个用于添加数据,一个用于获取数据,如代码4.11所示。
代码4.11 TestController.java
package com.example.demo.controller;
import … //省略引用的类
@Controller //Controller的注解
@RequestMapping("/test") //Controller路由
public class TestController {
@Resource(name = "TestService")
private TestService _TestService;
//接口一:添加数据
@RequestMapping(value="/test", method = RequestMethod.POST) //接口路由
@ResponseBody
public JSONObject create(@RequestBody String requestParam) {
JSONObject returnJson = new JSONObject();
JSONObject requestJson = JSONObject.parseObject(requestParam);
return_TestService.create(requestJson, returnJson);
}
//接口二:获取数据
@RequestMapping(value="/test", method = RequestMethod.GET)@ResponseBody
public JSONObject get(HttpServletRequest request) {
JSONObject returnJson = new JSONObject();
JSONObject requestJson = new JSONObject();
requestJson.put("language", request.getParameter("language"));
return _TestService.get(requestJson, returnJson);
}
}
TestService.java是Service层的代码,Service层负责业务处理和Dao层的方法调用。这里对应TestController.java文件中的两个调用函数,如代码4.12所示。
代码4.12 TestService.java
package com.example.demo.service;
import … //省略引用的类
@Service("TestService")
public class TestService {
@Resource(name = "TestDao")
private TestDao _TestDao;
//接口一调用函数
public JSONObject create(JSONObject requestParam, JSONObject
returnParam){
//调用TestDao.java中的create方法
String message = _TestDao.create(requestParam.get("language").
toString(),
requestParam.get("text").toString());
returnParam.put("message", message);
return returnParam;
}
//接口二调用函数
public JSONObject get(JSONObject requestParam, JSONObject returnParam){
//调用TestDao.java中的get方法
String message = _TestDao.get(requestParam.get("language").
toString());
returnParam.put("message", message);
return returnParam;
}
}
TestDao.java是Dao层的代码,Dao层负责数据处理,这里对应TestService.java文件中的两个函数,如代码4.13所示。
代码4.13 TestDao.java
package com.example.demo. dao;
import … //省略引用的类
@Repository("TestDao")
public class TestDao {
public static HashMap<String, String> dataMap = new HashMap<String,
String>();
public String create(String key, String value){
try{
dataMap.put(key, value);
return "success";
}catch(Exception e){
return "fail";
}
}
public String get(String key){
try{
return dataMap.get(key);
}catch(Exception e){
return "fail";
}
}
}
编写完代码后,可以在开发工具内运行程序。在IntelliJ IDEA中运行程序的方法如图4.24所示。其他开发工具按实际情况操作即可。
4.发布后端应用程序
发布后端应用程序就是将应用程序放到Tomcat上,在复制文件之前,我们需要把后端应用程序打包成War文件。IntelliJ IDEA的打包方式如图4.25所示。其他开发工具按实际情况操作即可。
在不修改输出路径的情况下,编译打包后的War文件在“工程目录/build/libs”下。找到可执行程序后把它复制到Tomcat的webapps目录下即可。在Tomcat正在运行的情况下,可执行程序会自动解压并自动运行程序。以Windows系统中的Tomcat为例,发布后端应用程序的方法如图4.26所示。
注意:在默认设置下,当替换War文件或者删除War文件时,Tomcat自动解压的文件夹会自动删除,不需要用户手动操作。
5.测试
接口测试可以借助一些工具,这里推荐使用Postman,从官网(https://www.postman.com/)上下载即可。下面以Postman作为测试工具进行测试。
首先测试接口一,向后端应用程序添加文字“你好,世界”,这段文字的标识是chinese,如图4.27所示。其中,请求的URL为
http://127.0.0.1:8080/demo/test/test,请求方式为POST。
接着测试接口二,通过标识chinese获取刚通过接口一添加的文字,如图4.28所示。其中,请求的URL为
http://127.0.0.1:8080/demo/test/test?language=chinese,请求方式为GET。