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; //数据 data

    public 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);
    }

    @Override
    public 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;
    }

    @Override
    public 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默认是按照名称注入。