【javaWeb 第七篇】后端-Spring

Spring

Spring
springBoot
请求
- 简单参数
- 实体参数
- 数组集合参数
- 日期参数
- JSON参数
- 路径参数
响应数据
分层解耦
- 三层架构
- 解耦操作
- Bean的声明
- Bean组件扫描问题
- DI详解

Spring

详细介绍结合官网查看：https://spring.io/why-spring
Spring发展到今天已经形成一种开发生态圈，spring提供了若干子项目，每个项目用于完成特定的功能
在这里插入图片描述
现在大多数技术大多是用spring全家桶来进行开发并整合，最底层的是spring framework（是一个基础的底层框架）
但是spring Framework配置繁琐，入门难度大，推出的springBoot可以快速的开发一个应用程序更加便捷（简化配置）

springBoot

springBoot 可以帮助我们非常快速的构建应用程序，简化开发，提高效率

首先创建一个springBoot工程，勾选web开发相关依赖

选择spring initiallizr构建spring工程
勾选web开发的依赖
在这里插入图片描述
创建完毕之后，打开pom.xml文件

该标签表示当前SpringBoot工程的父工程的坐标，所有的spring工程都需要继承该工程

 <groupId>com.example</groupId>
    <artifactId>heima</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>heima</name>
    <description>heima</description>
    <properties>
        <java.version>17</java.version>

描述的是项目工程的坐标信息以及一些描述信息，以及jdk的使用版本

    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

该工程中添加的依赖，包括web开发依赖以及测试依赖

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

还定义了一个springboot的maven项目构建插件
SpringBoot工程自定义创建了一个工程启动类

@SpringBootApplication
public class projectApplication {

    public static void main(String[] args) {
        SpringApplication.run(projectApplication.class, args);
    }

}

用于启动spring工程
创建一个请求处理类，输出hello-world

//需要通过注解表示这是一个请求处理类,加上注解之后表示当前是一个请求处理类
@RestController
public class HelloController {
    //通过注解表示需要处理的请求路径
    @RequestMapping("/hello")  //表示当进行请求的时候会调用以下方法
    public String Hello(){
        System.out.println("Hello-world");
        return "Hello-world";
    }
}

编辑好之后进行运行工程，控制台中显示日志：
在这里插入图片描述
上边的图像表示spring的标志，下边是它的版本

里面显示当程序运行起来之后会自动占用一个端口：8080
所以要访问当前程序，需要访问端口号8080

起步依赖：

Spring-boot-starter-web:包含了web应用开发所需要的常见依赖
spring-boot-starter-test:包含了单元测试所需要的常见依赖

在配置好web起步依赖后，其中就包括tomcat的依赖，相当于在tomcat中内置了tomcat服务器，在一般的开发当中通常用的都是内置的tomcat服务器

上述编写的请求处理类是一个简单的java类不能被tomcat识别，tomcat可以识别servlet程序，springboot中提供了一个底层核心的dispatcherServlet

Tomcat并不直接识别Spring类，而是通过整合Spring框架来实现对Spring类的调用和管理。这种整合使得在基于Spring框架的Web应用中，Tomcat能够识别和调用被Spring框架管理的类和方法。
dispatcherServlet的继承体系：
在这里插入图片描述
工作流程：

tomcat服务器对请求信息进行解析，并将所有解析后的请求信息封装到httpSerletRequest对象当中，服务器中的应用程序在该对象当中获取请求数据进行处理，然后在对象httpserletResponse中设置响应的数据，Tomcat根据该对象中的信息响应数据给浏览信息
请求对象：（httpSerletRequest）获取请求数据
响应对象：（httpserletResponse）设置响应数据
上述工作流程称为BS架构：Browser/Server，浏览器/服务器架构模式，客户端只需浏览器，应用程序的逻辑和数据都存储在服务端
除此之外还有CS架构：client/Server，客户端/服务器架构模式（软件的开发，维护繁琐，用户体验感强）

请求

在前后端分离体系下，后端的开发独立，当每次编写完一个功能模块时，需要对该功能进行测试，但是此时前端界面没有
注意：地址栏直接搜索地址发送的请求都是get请求
这是需要借助接口测试工具postman（一款网页调试与发送网页HTTP请求的Chrome插件）常用于进行接口测试，具体情况可以参考第七篇附篇

创建测试地址：http://localhost:8080/hello

获取地址参数

获取地址栏后方的参数

简单参数

在原始的web程序中，获取get请求参数，需要通过HttpServletRequest对象手动获取，该对象中拥有所有的请求数据

@RestController
public class HelloController {
    //通过注解表示需要处理的请求路径
    @RequestMapping("/hello")  //表示当进行请求的时候会调用以下方法
    public String Hello(HttpServletRequest request){
        //获取请求参数
        String name = request.getParameter("name");
        String age = request.getParameter("age");
        int ageint = Integer.parseInt(age);
        System.out.println(name+":"+ageint);
        return "OK";
    }
}

运行工程，在postman中创建测试得出结果：
在这里插入图片描述
在SpringBoot中有更加简便的方法用来简化操作：

@RestController
public class HelloController {
    //通过注解表示需要处理的请求路径
    @RequestMapping("/hello")  //表示当进行请求的时候会调用以下方法
    public String Hello(String name,Integer age){
        //获取请求参数
        System.out.println(name+":"+age);
        return "OK";
    }
}

只需要在参数中添加对应的形参，形参类型与传递参数一致，形参名称也要与传递参数名称一致，会自动转化类型
post请求参数获取方式与上述的springBoot参数获取方式相同

当参数名称不相同的时候会显示为null，如果方法形参名称与请求参数名称不相符，可以使用 @RequestParam完成映射

@RestController
public class HelloController {
    //通过注解表示需要处理的请求路径
    @RequestMapping("/hello")  //表示当进行请求的时候会调用以下方法
    public String Hello(@RequestParam(name = "name") String username, Integer age){
        //获取请求参数
        System.out.println(username+":"+age);
        return "OK";
    }
}

其中“name”表示请求参数中的名称，将该名称映射到username
注意：@RequestParam中的required属性默认为true，代表请求参数必须传递，如果不传递将会报错，如果要不传递该参数可以将required的值设置为false

public String Hello(@RequestParam(name = "name",required = false) String username, Integer age)

实体参数

当请求参数的数量较多时，简单参数已经不合时宜了，我们可以将参数封装到一个实体类当中
原则：实体类的属性名必须与请求的参数名称一样

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

当请求参数与实体类属性名称不相符的时候，会显示null
当出现复杂类的情况时：

public class user{
private String name;
private Student student;
}
public class Student{
private Integer age;
private String mingcheng;
}

请求参数应该为：http://localhost:8080/dara?name=han&student.age=22&student.minghceng=han

数组集合参数

如果时form表单中的数据传递请求参数就会出现同样名称多个值的情况，这个时候使用数组集合参数来获取请求参数

使用数组

请求地址：http://localhost:8080/nihao?hobby=han&hobby=2

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

数组名称需要与请求参数的名称一致

使用集合

请求地址：http://localhost:8080/buhao?hobby=han&hobby=2

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

同样集合名称需要与请求参数名称一致

日期参数

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

请求地址：http://localhost:8080/hello?updatetime=2024-12-12 12:12:12

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

JSON参数

JSON参数：json数据键名与形参对象属性名相同，定义POJO类型形参即可接收参数，需要用 @RequestBody标识
请求应该设置成post形式，json数据必须放在请求体当中
在这里插入图片描述
在服务器端通过实体对象的形式来接受json数据，实体对象的属性名必须与json的数据键名称一致

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

路径参数

通过请求URL直接传递参数，使用{…}来标识该路径参数，需要使用 @PathVariable获取路径参数
通俗来讲就是请求的参数是路径的一部分
例如：http://localhost:8080/path/1

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

路径是可变的，使用@PathVariable注解表示将路径中的id赋值给id
两个路径参数：

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

其中的每一个方法都是一个功能接口

响应数据

@ResponseBody注解响应数据
类型：方法注解，类注解
位置：Controller方法上/类上
作用：将方法返回值直接响应，如果返回值类型是实体对象/集合，将会转换为json数据
说明：@RestController= @controller+@ResponseBody

可以通过统一的响应结果，做到通用便捷

public class Result{
//响应码，1代表成功，0表示失败
private Integer code;
//提示信息
private String msg;
//返回的数据
private Object data;
}

每一个方法都返回一个统一的result类方便管理
Result(code,msg,data)

加载并解析emp.xml文件中的数据，完成数据处理，并在页面展示
在pom.xml文件中引入dom4j的依赖，用于解析xml文件
SpringBoot项目的静态资源（html,css,js等前端资源）默认存放的目录为：classpath:/static,classpath:/public,classpath:/resources

分层解耦

三层架构

在之前写的controller类中，请求解析，逻辑处理，接受请求响应数据在同一个类中，不利于拓展和维护，所以在Web开发中推出了三层架构
Controller：控制层，接受前端发送的请求，对请求进行处理，并相应数据
service：业务逻辑层，处理具体的业务逻辑
dao：数据访问层（Data Access Object）（持久层），负责数据访问操作，包括数据的增删改查
处理流程
前端浏览器首先访问controller，controller在调用业务层进行处理，业务层首先调用数据获取数据再进行业务处理，处理结束返回数据到controller再进行数据响应
优点：复用性强，便于维护，利于拓展

解耦操作

内聚：软件中各个功能模块内部的功能关系
耦合：衡量软件中各个层次/模块之间的依赖，关联的程度
如何理解内聚：

假如在处理类中有有一个处理数据的类，处理数据的方法只存在于这个类之中，说明这个类的内聚程度越高

如何理解耦合：

Controller层调用service层处理数据就会创建service层对象进行逻辑处理，这样就相当于你中有我，我中有你

软件设计原则：高内聚低耦合

那么如何才能做到高内聚低耦合呢？
如果在类之间不必直接创建对象，而是通过一个容器将对象都保存进去，让其他类随取所用，这样就不会被其他的对象所牵制，而如何实现将对象放入容器，以及从容器中取出对象呢？就要用到控制反转以及依赖注入

控制反转与依赖注入
控制反转：简称IOC,对象的创建控制权由程序自身转移到外部（容器），这种思想称为控制反转（这是Spring框架的第一大核心）
依赖注入：简称DI，容器为应用程序提供运行时，所依赖的资源，称之为依赖注入
Bean对象：IOC容器中创建，管理的对象，称之为Bean
IOC&DI入门

Service层及Dao层的实现类，交给IOC容器管理
为Controller及Service注入运行时依赖的对象

实现控制反转就是对Service与Controller进行控制权的转移，在Service类以及Controller类上添加注解 @Component 就能够实现控制权限的反转

依赖注入的实现在声明对象的上方通过注解 @Autowired 就实现了依赖注入

Bean的声明

要把某个对象交给IOC容器管理，需要在对应的类上加上如下注解之一：
控制反转注解
常见的三层框架都在使用下面三个注解，一般如果出现不属于三个的类时，如果需要控制反转，需要使用 @Component 注解

如何查看bean对象：
Bean
运行之后进行Bean对象的查看，如果没有在注解之后加入Bean对象的名字，则默认将类名进行小写当作Bean对象的名字
如何命名：
在注解后添加名称参数： @Repository（“nihao”）

**注意：**使用以上四个注解都可以声明bean，但在springboot集成web开发中，声明控制器bean只能用 @Controller

Bean组件扫描问题

前面声明bean的四大注解，要想生效，还需被组件扫描注解@ComponentScan扫描

@ComponentScan注解虽然没有显示配置，但是实际上已经包含在了启动类声明注解@SpringBootApplication中，默认扫描的范围是启动类所在的包及其子包

如果出现上述问题需要手动进行扫描：@ComponentScan（{“包名”，“包名”}）

DI详解

在Bean注入中：
@Autowired注解，默认是按照类型进行，如果存在多个相同类型的Bean，将会报出如下错误：
在这里插入图片描述
通过几个注解来解决问题：

@Primary
设置相同Bean的优先级，如果想让那个类的Bean级别更高，在前方加入@Primary注解
@Qualifier（“Bean名称”）
通过该注解直接进行设置Bean的对应对象，写在@Autowired后面
@Resourse（name=“”）
取消@Autowired注解采用Resourse注解进行注解，不以类型进行按照名称继续注入，name直接写入Bean的名字