Web后端开发_01

Web后端开发

请求响应

SpringBoot提供了一个非常核心的Servlet =》DispatcherServlet，DispatcherServlet实现了servlet中规范的接口

请求响应：

• 请求（HttpServletRequest）：获取请求数据
• 响应（HttpServletResponse）：设置相应数据
• B/S架构：Browser/Server，浏览器/服务器架构模式。客户端只需要浏览器，应用程序的逻辑和数据都存储在服务端。（维护方便、体验一般）
  例如：京东、淘宝、天猫等网站使用的都是B/S架构。
• C/S架构：Client/Server，客户端/服务器端架构模式。（开发、维护麻烦，体验不错）
  例如：QQ、微信、网易云音乐等软件使用的是C/S架构。

请求

Postman

Postman是一款功能强大的网页调试与发送网页HTTP请求的Chrome插件。

作用：常用于进行接口测试

下载地址：https://www.postman.com/downloads/

由于Postman是纯英文的，根本看不懂，所以我选择Apipost来代替Postman

Apipost下载地址：https://www.apipost.cn/download.html

进入私有团队管理https://console.apipost.cn/project/adec77a3-cdcb-471b-9d14-c2bcc6a5b003/lately

创建一个私有项目

在客户端选择刚创建的项目 =》新建接口

启动上次创建springboot-web-quickstart项目

GET =》URL =》发送 =》得到响应数据

发送调试接口后，可以看到实时响应的数据：Hello World~

简单参数

• 原始方式（比较麻烦，了解即可）

  在原始的web程序中，获取请求参数，需要通过HttpServletRequest对象手动获取。

  @RestController
  public class RequestController {//原始方法@RequestMapping("/simpleParam")public String simpleParam(HttpServletRequest request) {//获取请求参数String name = request.getParameter("name");String ageStr = request.getParameter("age");int age = Integer.parseInt(ageStr);System.out.println(name + ":" + age);return "OK";}
  }
  

  发送请求

  

  • springboot方式

      //SpringBoot方法@RequestMapping("/simpleParam")public String simpleParam(String name,Integer age) {System.out.println(name + ":" + age);return "OK";}
  

  发送POST请求

  

  • springboot方式，简单参数：如果方法形参名称与请求参数名称不匹配，可以使用@RequestParam完成映射。

      @RequestMapping("/simpleParam")public String simpleParam(@RequestParam(name = "name") String username, Integer age) {System.out.println(username + ":" + age);return "OK";}
  

  注意事项：

  • @RequestParam中的required属性默认为true，代表该请求参数必须传递，如果不传递将报错，如果该参数是可选的，可以将required属性设置为false

实体参数

• 简单实体对象：请求参数与形参对象属性名相同，定义Pojo接收即可

  

  User实体类

  public class User {private String name;private Integer age;
  }
  

  请求方法

      @RequestMapping("/simplePojo")public String simplePojo(User user){System.out.println(user);return "OK";}
  

• 复杂实体对象：

  

  User实体类

  public class User {private String name;private Integer age;private Address address;
  }
  

  Address实体类

  public class Address {private String province;private String city;
  }
  

  定义一个请求方法

      //复杂实体参数@RequestMapping("/simplexPojo")public String simplexPojo(User user){System.out.println(user);return "OK";}
  

  发送请求后，打印出的数据

  

• 实体对象参数

  规则：请求参数名与形参对象属性名相同，即可直接通过POJO接收

数组集合参数

复选框组件需要用到数组集合参数

例如：https://element-plus.gitee.io/zh-CN/component/form.html

<el-checkbox label="Online activities" name="type" />

• 数组参数：请求参数名与形参数组名称相同且请求参数为多个，定义数组类型形参即可接收参数

  

  使用数组完成参数封装

      @RequestMapping("/arrayParam")public String arrayParam(String[] hobby) {System.out.println(Arrays.toString(hobby));return "OK";}
  

  发送GET请求，后台得到该封装后的数据

  

• 集合参数：请求参数名与形参集合名称相同且请求参数为多个，**@RequestParam**绑定参数关系

  

  使用集合完成参数封装

      @RequestMapping("/listParam")public String listParam(@RequestParam List<String> hobby) {System.out.println(hobby);return "OK";}
  

  发送GET请求，后台得到多个请求参数值，将其封装后的数据直接打印到控制台。

  

日期参数

• 日期参数：使用**@DateTimeFormat**注解完成日期参数格式转换

  

  使用@DateTimeFormat注解指定日期格式，完成日期的封装

  注意：updateTime是LocalDateTime对象，println会带一个’T’分隔符

      @RequestMapping("/dateParam")public String dateParam(@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss") LocalDateTime updateTime) {System.out.println(updateTime);return "OK";}
  

  发送GET请求，后台得到日期，将其格式化后的日期直接打印到控制台。

  

JSON参数

• JSON参数：JSON数据键名与形参对象属性名相同，定义POJO类型形参即可接收参数，需要使用@RequestBody标识

  

  User实体类

  public class User {private String name;private Integer age;private Address address;
  }
  

  Address实体类

  public class Address {private String province;private String city;
  }
  

  请求方法

      @RequestMapping("/jsonParam")public String jsonParam(@RequestBody User user) {System.out.println(user);return "OK";}
  

  发送POST请求，后端将请求数据封装到实体对象中

  

路径参数

• 路径参数：通过请求URL直接传递参数，使用{…}来标识该路径参数，需要使用**@PathVariable**获取路径参数

  

  

  后端请求方法，获取单个路径参数

      @RequestMapping("/path/{id}")public String PathParam(@PathVariable Integer id) {System.out.println(id);return "OK";}
  

  发送请求成功，后台打印出路径的id

  

• 传递多个路径参数

  

  后端请求方法，获取多个路径参数

      @RequestMapping("/path/{id}/{name}")public String PathParams(@PathVariable Integer id, @PathVariable String name) {System.out.println(id + ":" + name);return "OK";}
  

  发送请求成功，后台打印出路径的id

  

响应

相应数据

@ResponseBody

• 类型：方法注解、类注解
• 位置：Controller方法上/类上
• 作用：将方法返回值直接响应，如果返回值类型是实体对象/集合，将会转化为JSON格式响应
• 说明：@RestController = @Controller + @ResponseBody

测试相应数据的方法——功能接口

@RestController
public class ResponseController {@RequestMapping("/hello")public String hello() {System.out.println("Hello World~~~");return "Hello World~";}@RequestMapping("/getAddr")public Address getAddr() {Address addr = new Address();addr.setProvince("广东");addr.setCity("深圳");return addr;}@RequestMapping("/listAddr")public List<Address> listAddr() {List<Address> list = new ArrayList<>();Address address = new Address();address.setProvince("广东");address.setCity("深圳");Address address2 = new Address();address2.setProvince("陕西");address2.setCity("西安");list.add(address);list.add(address2);return list;}
}

• 响应-字符串

  

• 响应-对象json

  

• 响应-集合json

  

  []：表示一个数组

  {}：表示集合中的对象

统一响应结果

Result类，放在pojo包下

result设计模式，二十三钟设计模式中的一种，面试必问。

/*** 统一响应结果封装类*/
public class Result {private Integer code ;//1 成功 , 0 失败private String msg; //提示信息private Object data; //数据 datapublic Result() {}public Result(Integer code, String msg, Object data) {this.code = code;this.msg = msg;this.data = data;}public Integer getCode() {return code;}public void setCode(Integer code) {this.code = code;}public String getMsg() {return msg;}public void setMsg(String msg) {this.msg = msg;}public Object getData() {return data;}public void setData(Object data) {this.data = data;}public static Result success(Object data){return new Result(1, "success", data);}public static Result success(){return new Result(1, "success", null);}public static Result error(String msg){return new Result(0, msg, null);}@Overridepublic String toString() {return "Result{" +"code=" + code +", msg='" + msg + '\'' +", data=" + data +'}';}
}

改造ResponseController

    @RequestMapping("/hello")public Result hello() {System.out.println("Hello World~~~");
//        return new Result(1,"success","Hello World~~");return Result.success("Hello World~~");}@RequestMapping("/getAddr")public Result getAddr() {Address addr = new Address();addr.setProvince("广东");addr.setCity("深圳");return Result.success(addr);}@RequestMapping("/listAddr")public Result listAddr() {List<Address> list = new ArrayList<>();Address address = new Address();address.setProvince("广东");address.setCity("深圳");Address address2 = new Address();address2.setProvince("陕西");address2.setCity("西安");list.add(address);list.add(address2);return Result.success(list);}

重新启动项目，使用Apipost测试接口返回信息

有了统一响应结果后，项目会更方便管理、方便维护

小结

1. @ResponseBody

   • 位置：Controller类上/方法上
   • 作用：将方法返回值直接响应，若返回值类型是 实体对象/集合，转json格式响应

2. 统一响应结果

   Result (code, msg, data)

统一响应结果案例

获取员工数据，返回统一响应结果，在页面渲染展示

• 加载并解析emp.xml文件中的数据，完成数据处理，并在页面展示。

• 在pom.xml文件中引入dom4j的依赖，用于解析XML文件
• 引入资料中提供的解析XML的工具类XMLParserUtils、对应的实体类Emp、XML文件emp.xml
• 引入资料中提供的静态页面文件，放在resources下的static目录下
• 编写Controller程序，处理请求，响应数据

• dom4j坐标

<!-- 解析XML -->
<dependency><groupId>org.dom4j</groupId><artifactId>dom4j</artifactId><version>2.1.3</version>
</dependency>

• 工具类XMLParserUtils

package com.bowen.utils;import org.dom4j.Document;
import org.dom4j.Element;
import org.dom4j.io.SAXReader;
import java.io.File;
import java.lang.reflect.Constructor;
import java.lang.reflect.Field;
import java.util.ArrayList;
import java.util.List;public class XmlParserUtils {public static <T> List<T> parse(String file , Class<T> targetClass)  {ArrayList<T> list = new ArrayList<T>(); //封装解析出来的数据try {//1.获取一个解析器对象SAXReader saxReader = new SAXReader();//2.利用解析器把xml文件加载到内存中,并返回一个文档对象Document document = saxReader.read(new File(file));//3.获取到根标签Element rootElement = document.getRootElement();//4.通过根标签来获取 user 标签List<Element> elements = rootElement.elements("emp");//5.遍历集合,得到每一个 user 标签for (Element element : elements) {//获取 name 属性String name = element.element("name").getText();//获取 age 属性String age = element.element("age").getText();//获取 image 属性String image = element.element("image").getText();//获取 gender 属性String gender = element.element("gender").getText();//获取 job 属性String job = element.element("job").getText();//组装数据Constructor<T> constructor = targetClass.getDeclaredConstructor(String.class, Integer.class, String.class, String.class, String.class);constructor.setAccessible(true);T object = constructor.newInstance(name, Integer.parseInt(age), image, gender, job);list.add(object);}} catch (Exception e) {e.printStackTrace();}return list;}}

• 实体类Emp

package com.bowen.pojo;public class Emp {private String name;private Integer age;private String image;private String gender;private String job;public Emp() {}public Emp(String name, Integer age, String image, String gender, String job) {this.name = name;this.age = age;this.image = image;this.gender = gender;this.job = job;}public String getName() {return name;}public void setName(String name) {this.name = name;}public Integer getAge() {return age;}public void setAge(Integer age) {this.age = age;}public String getImage() {return image;}public void setImage(String image) {this.image = image;}public String getGender() {return gender;}public void setGender(String gender) {this.gender = gender;}public String getJob() {return job;}public void setJob(String job) {this.job = job;}@Overridepublic String toString() {return "Emp{" +"name='" + name + '\'' +", age=" + age +", image='" + image + '\'' +", gender='" + gender + '\'' +", job='" + job + '\'' +'}';}
}

• emp.xml

<?xml version="1.0" encoding="UTF-8" ?>
<emps><emp><name>金毛狮王</name><age>55</age><image>https://web-framework.oss-cn-hangzhou.aliyuncs.com/web/1.jpg</image><!-- 1: 男, 2: 女 --><gender>1</gender><!-- 1: 讲师, 2: 班主任 , 3: 就业指导 --><job>1</job></emp><emp><name>白眉鹰王</name><age>65</age><image>https://web-framework.oss-cn-hangzhou.aliyuncs.com/web/2.jpg</image><gender>1</gender><job>1</job></emp><emp><name>青翼蝠王</name><age>45</age><image>https://web-framework.oss-cn-hangzhou.aliyuncs.com/web/3.jpg</image><gender>1</gender><job>2</job></emp><emp><name>紫衫龙王</name><age>38</age><image>https://web-framework.oss-cn-hangzhou.aliyuncs.com/web/4.jpg</image><gender>2</gender><job>3</job></emp>
</emps>

• emp.html

<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1.0"><title>员工信息</title>
</head><link rel="stylesheet" href="element-ui/index.css">
<script src="./js/vue.js"></script>
<script src="./element-ui/index.js"></script>
<script src="./js/axios-0.18.0.js"></script><body><h1 align="center">员工信息列表展示</h1><div id="app"><el-table :data="tableData" style="width: 100%"  stripe border ><el-table-column prop="name" label="姓名" align="center" min-width="20%"></el-table-column><el-table-column prop="age" label="年龄" align="center" min-width="20%"></el-table-column><el-table-column label="图像" align="center"  min-width="20%"><template slot-scope="scope"><el-image :src="scope.row.image" style="width: 80px; height: 50px;"></el-image></template></el-table-column><el-table-column prop="gender" label="性别" align="center"  min-width="20%"></el-table-column><el-table-column prop="job" label="职位" align="center"  min-width="20%"></el-table-column></el-table></div>
</body><style>.el-table .warning-row {background: oldlace;}.el-table .success-row {background: #f0f9eb;}
</style><script>new Vue({el: "#app",data() {return {tableData: []}},mounted(){axios.get('/listEmp').then(res=>{if(res.data.code){this.tableData = res.data.data;}});},methods: {}});
</script>
</html>

Springboot项目的静态资源(html，css，js等前端资源)默认存放目录为：classpath:/static 、classpath:/public、classpath:/resources

• empController类用来加载员工数据

/*** @ClassName empController* @Description 加载员工数据* @Author Bowen* @Date 2023/11/12 20:51* @Version 1.0**/
@RestController
public class empController {@RequestMapping("/listEmp")public Result list() {//1、加载并解析xml文件String file = this.getClass().getClassLoader().getResource("emp.xml").getFile();System.out.println(file);List<Emp> empList = XmlParserUtils.parse(file, Emp.class);//2、对数据进行转换处理empList.stream().forEach(emp -> {//处理 gender 1: 男, 2: 女String gender = emp.getGender();if ("1".equals(gender)) {emp.setGender("男");} else if ("2".equals(gender)) {emp.setGender("女");}//处理job - 1: 讲师, 2: 班主任 , 3: 就业指导String job = emp.getJob();if ("1".equals(job)) {emp.setJob("讲师");} else if ("2".equals(job)) {emp.setJob("班主任");} else if ("3".equals(job)) {emp.setJob("就业指导");}});//3、响应数据return Result.success(empList);}
}

创建测试接口

通过debug调试，发现返回数据正常

可以看到返回的JSON数据

在浏览器中进入emp.html

http://127.0.0.1:8080/emp.html

解决上述问题controller中出现了大量的数据操作、逻辑处理的代码，虽然实现了功能，但是其功能的复用性、拓展性会很差，会然项目变的难以维护。

分层解耦

三层架构

• controller：控制层，接收前端发送的请求，对请求进行处理，并响应数据。
• service：业务逻辑层，处理具体的业务逻辑。
• dao：数据访问层(Data Access Object)(持久层)，负责数据访问操作，包括数据的增、删、改、查。

对统一响应结果案例按三层架构进行拆分

拆分后更利于程序的复用，每一层的职责比较单一，方便维护和拓展

分层解耦

• 内聚：软件中各个功能模块内部的功能联系
• 耦合：衡量软件中各个层/模块之间的依赖、关联的程度
• 软件设计原则：高内聚低耦合

控制反转：Inversion Of Control，简称IOC。对象的创建控制权由程序自身转移到外部（容器)，这种思想称为控制反转。

依赖注入：Dependency Injection，简称DI。容器为应用程序提供运行时，所依赖的资源，称之为依赖注入。

Bean对象：IOC容器中创建、管理的对象，称之为bean。

IOC & DI入门

1. Service层及Dao层的实现类，交给IOC容器管理。使用@Component注解

   

2. 为Controller及Service注入运行时，依赖的对象，使用@Autowired注解

   

3. 运行测试

   

IOC详解

Bean声明

要把某个对象交给IOC容器管理，需要在对应的类上加上如下注解之一：

注意事项：

• 声明bean的时候，可以通过value属性指定bean的名字，如果没有指定，默认为类名首字母
• 使用以上四个注解都可以声明bean，但是在springboot集成web开发中，声明控制器bean只能用@Controller。

Bean组件扫描

• 前面声明bean的四大注解，要想生效，还需要被组件扫描注解@ComponentScan扫描。
• @ComponentScan注解虽然没有显式配置，但是实际上已经包含在了启动类声明注解@SpringBootApplication中，默认扫搭的范围是启动类所在包及其子包。

小结

1. 声明bean的注解
   • @Component、@Controller、@Service、@Repository
   • @SpringBootApplication具有包扫描作用，默认扫描当前包及其子包

DI详解

Bean注入

• @Autowired注解，默认是按照类型进行，如果存在多个相同的bean，将会出现如下报错：

Field empService in com.bowen.controller.EmpController required a single bean, but 2 were found:- empServiceA: defined in file [E:\java_study\020-Maven\springboot-web-quickstart\target\classes\com\bowen\service\imp\EmpServiceA.class]- empServiceB: defined in file [E:\java_study\020-Maven\springboot-web-quickstart\target\classes\com\bowen\service\imp\EmpServiceB.class]Action:Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed

• 通过以下几种方案来解决：
  • @Primary
  • @Qualifier
  • @Resource

小结

1、依赖注入的注解

• @Autowired：默认按照类型自动装配
• 如果同类型的bean存在多个：
  • @Primary
  • @Autowired+@Qualifier("bean的名称")
  • @Resource(name = "bean的名称")

2、@Resource与@Autowired区别

• @Autowired是spring框架提供的注解，而@Resource是JDK提供的注解。
• @Autowired 默认是按照类型注入，而@Resource默认是按照名称注入。

，将会出现如下报错：

Field empService in com.bowen.controller.EmpController required a single bean, but 2 were found:- empServiceA: defined in file [E:\java_study\020-Maven\springboot-web-quickstart\target\classes\com\bowen\service\imp\EmpServiceA.class]- empServiceB: defined in file [E:\java_study\020-Maven\springboot-web-quickstart\target\classes\com\bowen\service\imp\EmpServiceB.class]Action:Consider marking one of the beans as @Primary, updating the consumer to accept multiple beans, or using @Qualifier to identify the bean that should be consumed

• 通过以下几种方案来解决：
  • @Primary
  • @Qualifier
  • @Resource

小结

1、依赖注入的注解

• @Autowired：默认按照类型自动装配
• 如果同类型的bean存在多个：
  • @Primary
  • @Autowired+@Qualifier("bean的名称")
  • @Resource(name = "bean的名称")

2、@Resource与@Autowired区别

• @Autowired是spring框架提供的注解，而@Resource是JDK提供的注解。
• @Autowired 默认是按照类型注入，而@Resource默认是按照名称注入。