文章目录
一、基础文件配置
1. pom.xml文件配置
POM是项目对象模型(Project Object Model)的简称,它是Maven项目中的文件,使用XML表示,名称叫做pom.xml。作用类似ant的build.xml文件,功能更强大。该文件用于管理:源代码、配置文件、开发者的信息和角色、问题追踪系统、组织信息、项目授权、项目的url、项目的依赖关系等等。在开发项目之前将所用到的包导入,如下:
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<parent>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-parent</artifactId>
<version>2.5.3</version>
<relativePath/> <!-- lookup parent from repository -->
</parent>
<groupId>com.englishtest</groupId>
<artifactId>demo</artifactId>
<version>0.0.1-SNAPSHOT</version>
<name>englishtest</name>
<description>Demo project for Spring Boot</description>
<properties>
<java.version>1.8</java.version>
</properties>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.mybatis.spring.boot</groupId>
<artifactId>mybatis-spring-boot-starter</artifactId>
<version>1.3.2</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>8.0.17</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.13</version>
</dependency>
<!-- http请求-->
<dependency>
<groupId>org.apache.httpcomponents</groupId>
<artifactId>httpclient</artifactId>
<version>4.5.5</version>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
<build>
<plugins>
<plugin>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
</plugin>
</plugins>
</build>
</project>
2. application.properties文件配置
在此处连接到数据库,并配置端口号为8080。
#数据库配置
spring.datasource.url=jdbc:mysql://47.116.131.251:3306/easyenglish?characterEncoding=UTF-8&&serverTimezone=UTC
spring.datasource.username=easyenglish
spring.datasource.password=zyx
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
mybatis.mapper-locations=classpath:mapper/*.xml
server.port=8080
logging.level.com.zyx.easyenglish.Mapper=debug
二、简单的后端逻辑
在创建一个后台文件时,编译器会自动为我们创建一个启动类,当启动项目时会自动运行此类。
package com.englishtest.zyx;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.ComponentScan;
@SpringBootApplication
@ComponentScan(value = "com.englishtest.zyx.*")
@MapperScan(value = "com.englishtest.zyx.Mapper")
public class EnglishtestApplication {
public static void main(String[] args) {
SpringApplication.run(EnglishtestApplication.class, args);
}
}
做完了以上的准备工作,接下来我们要考虑的就是如何从数据库中查询到值并且以json格式返回呢?
实际上从数据库中查值并返回涉及到了前后台交互,其查询流程如下所示:
我们简单的测试以下该流程,初始时将框架目录(Controller层、Service层、Mapper)搭建好,如下:
注:该小程序项目无需使用Dao层。
1. Controller层
@RestController
作用等同于@Controller + @ResponseBody。在一个类上添加@Controller注解,表明了这个类是一个控制器类。@ResponseBody表示方法的返回值直接以指定的格式写入Http response body中,而不是解析为跳转路径。如果要求方法返回的是json格式数据,而不是跳转页面,可以直接在类上标注@RestController,而不用在每个方法中标注@ResponseBody,简化了开发过程。
@RequestMapping
是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。
package com.englishtest.zyx.Controller;
import com.englishtest.zyx.Service.TestService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.stereotype.Repository;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.HashMap;
import java.util.Map;
@RestController
@RequestMapping("/test")
public class TestController {
//@Autowired注解是按类型装配依赖对象,默认情况下它要求依赖对象必须存在。通俗来讲,本来是需要通过new一个对象,加上该注解后只需定义这个类型(接口)的变量即可直接使用。
@Autowired
private TestService testService; //在Controller中定义TestService类的属性对象
//此处使用get请求
@GetMapping("/testzhai")
public Map TestZhai(){
Map res = testService.testzhai(); //用Map类型接收调用TestService 类的testzhai()方法的返回值
return res; //返回Map类型的res值
}
}
2. Service层
首先定义一个TestService的接口类,并在其中创建testzhai()方法,具体实现如下:
package com.englishtest.zyx.Service;
import java.util.Map;
public interface TestService { //这是一个接口
public Map testzhai();
}
在接口实现类TestServiceImpl中实现该testzhai()方法。
package com.englishtest.zyx.Service.Impl;
import com.englishtest.zyx.Mapper.TestMapper;
import com.englishtest.zyx.Service.TestService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.HashMap;
import java.util.Map;
@Service
public class TestServiceImpl implements TestService {
@Autowired
private TestMapper testMapper;
@Override
public Map testzhai(){ //定义一个返回值为Map类型的方法
Map result = new HashMap(); //用result接收Map类型的值
String res = testMapper.testzhai(); //res接收的是Mapper返回的String类型的值
result.put("testresult", res); //将String类型的结果作为value与前面的key一起作为键值对写入result
return result; //该方法返回键值对
}
}
3. Mapper
在前面的Service类中res接收的是Mapper中String类型的返回值。所以相应地我们在TestMapper接口中定义一个testzhai()方法。
import org.springframework.stereotype.Component;
import java.util.Map;
@Component
public interface TestMapper {
String testzhai();
}
Mapper的接口类无需实现。我们可以创建一个Mapper的映射文件TestMapper
。MyBatis 的真正强大在于它的映射语句,也是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。
<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
<mapper namespace="com.englishtest.zyx.Mapper.TestMapper">
<!--select中的id对应TestMapper接口中的方法名,resultType表示返回值是String类型-->
<select id="testzhai" resultType="String">
select word from words where wid = 2;
</select>
</mapper>
在Controller层中我们注解使用的是Get请求,我们可以在url中获取测试结果。
注意此时的请求路径为:http://www.localhost:8080/test/testzhai
,是沿着我们的请求路径一层一层找下来的。
若想要实现通过动态输入参数值依据参数值去数据库中取值,那我们就要定义一个带参数的方法并将数映射文件中的select语句稍作调整,其余的实现逻辑与上述类似。
TestController类:
@RestController
@RequestMapping("/test")
public class TestController {
@Autowired
private TestService testService;
@GetMapping("/testzhang")
public Map TestZhang(Integer t){ //注意这里使用的是Integer,而不是int
Map res = testService.testzhang(t); //多了个参数
return res;
}
}
TestService接口:
package com.englishtest.zyx.Service;
import java.util.Map;
public interface TestService {
Map testzhang(int t); //多了个参数
}
TestServiceImpl实现类:
@Override
public Map testzhang(int t) { //方法中增加参数
Map result = new HashMap();
String res = testMapper.testzhang(t);
result.put("testres", res);
return result;
}
TestMapper接口:
@Component
public interface TestMapper {
String testzhang(int t);
}
TestMapper.xml:
<select id="testzhang" resultType="String">
<!--动态设置值使用#{}来获取-->
select word from words where wid = #{t};
</select>
在url中输入动态参数的格式如下,?t=1
代表此时想要从数据库中取wid=1的值。
同样的,?t=3
表示从数据库中取wid=3的值。
三、GET和POST请求
在HTTP/1.1协议中,定义了8种发送http请求的方法GET、POST、OPTIONS、HEAD、PUT、DELETE、TRACE、CONNECT、PATCH。根据HTTP协议的设计初衷,不同的方法对资源有不同的操作方式:PUT :增、DELETE :删、POST:改、GET:查
。最常用的是GET和POST(实际上GET和POST都能做到增删改查)
1. GET请求
在请求URL后面以?的形式跟上发给服务器的参数,多个参数之间用&隔开,比如 http://ww.test.com/login?username=123&pwd=234&type=JSON
由于浏览器和服务器对URL长度有限制,因此在URL后面附带的参数是有限制的,通常不能超过1KB。上述例子便使用到了GET请求:
2. POST请求
POST请求:发给服务器的参数全部放在请求体(HTTPBody)中。理论上,POST传递的数据量没有限制(具体还得看服务器的处理能力)
上述例子亦可以改成使用POST请求:
@PostMapping("/testzhang")
public Map TestZhang(Integer t){
Map res = testService.testzhang(t);
return res;
}
利用POSTMAN软件测试结果,在请求体中设置参数为t=1,这与GET明显不同,测试结果如下:
3. GET和POST的建议
- 如果要传递大量数据,比如文件上传,只能用POST请求
- GET的安全性比POST要差些,如果包含机密、敏感信息,建议用POST
- 如果仅仅是索取数据(数据查询),建议使用GET
- 如果是增加、修改、删除数据,建议使用POST