目录
2.2 创建一个 Spring MVC 的 Spring BootController
3.4 Spring Boot 下的 Spring MVC(注解)
1.1 简介
springboot是spring家族中的一个全新框架,用来简化spring程序的创建和开发过程。在以往我们通过SpringMVC+Spring+Mybatis框架进行开发的时候,我们需要配置web.xml,spring配置,mybatis配置,然后整合在一起,而springboot抛弃了繁琐的xml配置过程,采用大量默认的配置来简化我们的spring开发过程。
SpringBoot化繁为简,使开发变得更加的简单迅速。
1.2 特性
- 能够快速创建基于spring的程序
- 能够直接使用Java main方法启动内嵌的Tomcat服务器运行springboot程序,不需要部署war包
- 提供约定的starter POM来简化Maven配置,让Maven的配置变得简单
- 自动化配置,根据项目的Maven依赖配置,springboot自动配置spring、springmvc等
- 提供了程序的健康检查功能
- 基本可以完全不使用xml配合文件,采用注解配置
1.3 四大核心
自动配置、起步依赖、Actuator、命令行界面
2.1 SpringBoot 项目开发步骤
(1)创建一个 Module,选择类型为Spring Initializr 快速构建
(2)设置 GAV 坐标及 pom 配置信息
(3)选择 Spring Boot 版本及依赖
(4)设置模块名称、Content Root 路径及模块文件的目录,然后点击finish即可
(5)项目结构如下:
static:存放静态资源。如图片、CSS、JavaScript 等
templates:存放 Web 页面的模板文件
application.properties/application.yml 用于存放程序的各种依赖模块的配置信息,比如 服务端口,数据库连接配置等
.gitignore:使用版本控制工具 git 的时候,设置一些忽略提交的内容
Application.java:SpringBoot 程序执行的入口,执行该程序中的 main 方法,启动当前SpringBoot项目。
(6)对pom.xml文件进行解释
4.0.0 org.springframework.boot spring-boot-starter-parent 2.2.1.RELEASE com.bjpowernode.springboot 002-springboot-springmvc 1.0.0 002-springboot-springmvc Demo project for Spring Boot 1.8 org.springframework.boot spring-boot-starter-web org.springframework.boot spring-boot-starter-test test org.junit.vintage junit-vintage-engine org.springframework.boot spring-boot-maven-plugin
2.2 创建一个 Spring MVC 的 Spring BootController
(1)创建SpringBootController 类
注意:新创建的类一定要位于 Application 同级目录或者下级目录,否则 SpringBoot 加
载不到。
package com.bjpowernode.springboot.web; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.ResponseBody; @Controller public class SpringBootController { @RequestMapping(value = "/springBoot/say") public @ResponseBody String say() { return "Hello,springBoot!"; } }
(2)启动Application类中的main方法
通过在控制台的输出,可以看到启动 SpringBoot 框架,会启动一个内嵌的 tomcat,端
口号为 8080,上下文根为空 。
(3)在浏览器中输入 http://localhost:8080/springBoot/say进行访问
2.3 分析
(1)spring-boot-starter-parent 是一个 Springboot 的父级依赖,开发 SpringBoot 程序都需
要继承该父级项目,它用来提供相关的 Maven 默认依赖,使用它之后,常用的 jar
包依赖可以省去 version 配置
(2)Spring Boot 提供了一些默认的jar 包的依赖,可查看该父级依赖的 pom 文件
(3)如果不想使用某个默认的依赖版本,可以通过 pom.xml 文件的属性配置覆盖各个
依赖项,比如覆盖 Spring 版本:
5.0.0.RELEASE spring-framework.version >
(4) @SpringBootApplication 注解是 Spring Boot 项目的核心注解,主要作用是开启
Spring 自动配置,如果在 Application 类上去掉该注解,那么不会启动 SpringBoot程序
(5)main 方法是一个标准的 Java 程序的 main 方法,是boot项目启动运行的入口
(6)@Controller 及 @ResponseBody 依然是我们之前的 Spring MVC,因为 Spring Boot
的里面依然是使用我们的 Spring MVC + Spring + MyBatis 等框架
2.4 核心配置文件格式
(1).properties 文件(默认采用该文件)
通过修改 application.properties 配置文件,修改默认 tomcat 端口号及项目上下文件根:
#设置内嵌 Tomcat 端口号 server.port=9090 #配置项目上下文根 server.servlet.context-path=/003-springboot-port-context-path
页面显示结果:
(2) .yml 文件 :
项目名称:004-springboot-yml
yml 是一种 yaml 格式的配置文件,主要采用一定的空格、换行等格式排版进行配置。它能够直观的被计算机识别数据序列化格式,容易被人类阅读,yaml 类似于 xml,但是语法比 xml 简洁很多,值与前面的冒号配置项必须要有一个空格, yml 后缀也可以使用 yaml 后缀 。
注意:当两种格式配置文件同时存在时,使用的是.properties 配置文件。
(3)多环境配置(.properties方式)
在实际开发的过程中,我们的项目会经历很多的阶段(开发->测试->上线),每个阶段
的配置也会不同,例如:端口、上下文根、数据库等,那么这个时候为了方便在不同的环境
之间切换,SpringBoot 提供了多环境配置,具体步骤如下 :
项目名称:005-springboot-multi-environment
为每个环境创建一个配置文件,命名必须为 application-环境标识.properties|yml
application-dev.properties
#开发环境#设置内嵌 Tomcat 默认端口号 server.port=8080 #设置项目的上下文根 server.servlet.context-path=/005-springboot-multi-environment-dev
application-product.properties
#生产环境 #配置内嵌 Tomcat 默认端口号 server.port=80 #配置项目上下文根 server.servlet.context-path=/005-springboot-multi-environment-product
application-test.properties
#测试环境 #配置内嵌 Tomcat 端口号 server.port=8081 #配置项目的上下文根 server.servlet.context-path=/005-springboot-multi-environment-test
在总配置文件 application.properties 进行环境的激活
#SpringBoot 的总配置文件 #激活开发环境 #spring.profiles.active=dev #激活测试环境 #spring.profiles.active=test #激活生产环境 spring.profiles.active=product
(4)多环境配置(.yml方式)
application-dev.yml
#设置开发环境配置 server: port: 8080 #设置 Tomcat 内嵌端口号 servlet: context-path: /dev #设置上下文根
application-product.yml
#设置生产环境配置 server: port: 80 servlet: context-path: /product
application-test.yml
#设置测试环境配置 server: port: 9090 servlet: context-path: /test
在总配置文件 application.yml进行环境的激活
#springboot 总配置文件 #激活开发环境 #spring: # profiles: # active: dev #激活测试环境 #spring: # profiles: # active: test #激活生产环境 spring: profiles: active: product
(5)Spring Boot 自定义配置
在 SpringBoot 的核心配置文件中,除了使用内置的配置项之外,我们还可以在自定义配
置,然后采用如下注解去读取配置的属性值:
(A)@Value注解 用于逐个读取application.properties中的配置
案例演示:
(1) 在核心配置文件 applicatin.properties 中,添加两个自定义配置项 school.name 和
website。在 IDEA 中可以看到这两个属性不能被 SpringBoot 识别,背景是桔色的 :
.properties方式
.yml方式
#设置端口号及上下文根 server: port: 9090 servlet: context-path: / school: name: ssm websit: http://www.baidu.com
(2)在 SpringBootController 中定义属性,并使用@Value 注解或者自定义配置值,并对其方法进行测试
@Controller public class SpringBootController { @Value("${school.name}") private String schoolName; @Value("${websit}") private String websit; @RequestMapping(value = "/springBoot/config") public @ResponseBody String say() { return schoolName + "------" + websit; } }
(3)重新运行 Application,在浏览器中进行测试
(B)@ConfigurationProperties
作用:将整个文件映射成一个对象,用于自定义配置项比较多的情况 。
案例演示:
(1)在 com.abc.springboot.config 包下创建 ConfigInfo 类,并为该类加上 Component 和
ConfigurationProperties 注解,并在 ConfigurationProperties 注解中添加属性 prefix,可以区分同名配置 。
@Data@Component @ConfigurationProperties(prefix = "school") public class ConfigInfo { private String name; private String websit; }
(2)application.properties 配置文件
#设置内嵌 Tomcat 端口号 server.port=9090 #设置上下文根 server.servlet.context-path=/config school.name=ssm school.websit=http://www.baidu.com
(3)在 SpringBootController 中注入 ConfigInfo 配置类
@Autowired private ConfigInfo configInfo;
(4)修改 SpringBootController 类中的测试方法
@RequestMapping(value = "/springBoot/config") public @ResponseBody String say() { return configInfo.getName() + "=======" + configInfo.getWebsit(); }
(5)重新运行 Application,在浏览器中进行测试
(C)警告解决
在 ConfigInfo 类中使用了 ConfigurationProperties 注解后,IDEA 会出现一个警告,不影响程序的执行。
点击 open documentnation 跳转到网页,在网页中提示需要加一个依赖,我们将这
个依赖拷贝,粘贴到 pom.xml 文件中 即可。
org.springframework.boot spring-boot-configuration-processor true
(D)中文乱码
如果在 SpringBoot 核心配置文件中有中文信息,会出现乱码:
- 一般在配置文件中,不建议出现中文(注释除外)
- 如果出现中文,可以先转化为 ASCII 码
2.5 Spring Boot 前端使用 JSP
(1)在 pom.xml 文件中配置以下依赖项
org.apache.tomcat.embed tomcat-embed-jasper javax.servlet javax.servlet-api javax.servlet.jsp javax.servlet.jsp-api 2.3.1 javax.servlet jstl
(2)在 pom.xml 的 build 标签中要配置以下信息
SpringBoot 要求 jsp 文件必须编译到指定的 META-INF/resources 目录下才能访问,否则
访问不到。其实官方已经更建议使用模板技术。
src/main/webapp META-INF/resources ** Student queryStudentById(Integer id); }
(C)在 service.impl 包下创建 service 接口并编写代码
@Service public class StudentServiceImpl implements StudentService { @Autowired private StudentMapper studentMapper; @Override public Student queryStudentById(Integer id) { return studentMapper.selectByPrimaryKey(id); } }
(D)如果在 web 中导入 service 存在报错,可以尝试进行如下配置解决
(E) 在 Mybatis 反向工程生成的 StudentMapper 接口上加一个 Mapper 注解
@Mapper 作用:mybatis 自动扫描数据持久层的映射文件及 DAO 接口的关系
@Mapper public interface StudentMapper { }
(F)默认情况下,Mybatis 的 xml 映射文件不会编译到 target 的 class 目录下,所
以我们需要在 pom.xml 文件中配置 resource 。
src/main/java ***.xml org.mybatis.generator mybatis-generator-maven-plugin 1.3.6 GeneratorMapper.xml true true org.springframework.boot spring-boot-maven-plugin
application. properties核心配置文件
#配置内嵌 Tomcat 端口号 server.port=8090 #配置项目上下文根 server.servlet.context-path=/ #配置数据库的连接信息 #注意这里的驱动类有变化 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.url=jdbc:mysql://localhost:3306/springboot?useUnicode=true&characterEncoding=UTF-8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8 spring.datasource.username=root spring.datasource.password=root
通过逆向工程生成 DAO
创建 RESTfulController
@RestController public class RESTfulController { @PostMapping(value = "/springBoot/student/{name}/{age}") public Object addStudent(@PathVariable("name") String name, @PathVariable("age") Integer age) { Map retMap = new HashMap(); retMap.put("name",name); retMap.put("age",age); return retMap; } @DeleteMapping(value = "/springBoot/student/{id}") public Object removeStudent(@PathVariable("id") Integer id) { return "删除的学生 id 为:" + id; } @PutMapping(value = "/springBoot/student/{id}") public Object modifyStudent(@PathVariable("id") Integer id) { return "修改学生的 id 为" + id; } @GetMapping(value = "/springBoot/student/{id}") public Object queryStudent(@PathVariable("id") Integer id) { return "查询学生的 id 为" + id; } }
使用 Postman 模拟发送请求,进行测试 :
(4)请求冲突的问题
解决方案:<1>修改路径 <2>修改请求方式
创建 RESTfulController 类,结合 Postman 进行测试说明 :
@RestController public class RESTfulController { @GetMapping(value = "/springBoot/order/{id}/{status}") public Object queryOrder(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map map = new HashMap(); map.put("id",id); map.put("status",status); return map; } @GetMapping(value = "/springBoot/{id}/order/{status}") public Object queryOrder1(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map map = new HashMap(); map.put("id",id); map.put("status",status); return map; } @GetMapping(value = "/springBoot/{status}/order/{id}") public Object queryOrder2(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map map = new HashMap(); map.put("id",id); map.put("status",status); return map; } @PostMapping(value = "/springBoot/{status}/order/{id}") public Object queryOrder3(@PathVariable("id") Integer id, @PathVariable("status") Integer status) { Map map = new HashMap(); map.put("id",id); map.put("status",status); return map; } }
(5)RESTful 原则
- 增 post 请求、删 delete 请求、改 put 请求、查 get 请求
- 请求路径不要出现动词:
- 分页、排序等操作,不需要使用斜杠传参数
3.6 Spring Boot 集成 Redis
完善根据学生 id 查询学生的功能:先从 redis 缓存中查找,如果找不到,再从数据库中
查找,然后放到 redis 缓存中。
具体实现步骤:
(A)首先通过 MyBatis 逆向工程生成实体 bean 和数据持久层 :
(B)在 pom.xml 文件中添加 redis 依赖
org.springframework.boot spring-boot-starter-data-redis
(C)Spring Boot 核心配置文件application.properties 如下:
#配置内嵌 Tomcat 端口号 server.port=9090 #配置项目上下文根 server.servlet.context-path=/016-springboot-redis #配置连接 MySQL 数据库信息 spring.datasource.url=jdbc:mysql://127.0.0.1:3306/springboot?useUnicode=true&characterEncoding=UTF8&useJDBCCompliantTimezoneShift=true&useLegacyDatetimeCode=false&serverTimezone=GMT%2B8 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver spring.datasource.username=root spring.datasource.password=root #配置 redis 连接信息 spring.redis.host=127.0.0.1 spring.redis.port=6379 #spring.redis.password=root
(D)启动redis服务
(E)RedisController类
@RestController public class RedisController { @Autowired private StudentService studentService; @GetMapping(value = "/springboot/allStudentCount") public Object allStudentCount(HttpServletRequest request) { Long allStudentCount = studentService.queryAllStudentCount(); return "学生总人数:" + allStudentCount; } }
(F)StudentService 接口
public interface StudentService { Long queryAllStudentCount(); }
(G)在 StudentServiceImpl 中注入 RedisTemplate,并编写根据 id获取学生的方法
配置了上面的步骤,Spring Boot 将自动配置 RedisTemplate,在需要操作 redis 的类中注入 redisTemplate 即可。
注意:Spring Boot 帮我们注入 RedisTemplate 类,泛型里面只能写
@Service public class StudentServiceImpl implements StudentService { @Autowired private StudentMapper studentMapper; @Autowired private RedisTemplate
(H)StudentMapper 接口
@Mapperpublic interface StudentMapper { Long selectAllStudentCount(); }
(I)StudentMapper 映射文件
(J)启动类 Application
在 SpringBoot 启动类上添加扫描数据持久层的注解并指定扫描包:
@SpringBootApplication @MapperScan(basePackages = "com.abc.springboot.mapper")//扫描数据持久层 public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } }
(K)让 Student 类实现序列化接口(可选)
在类名上 Alt + 回车,如果没有提示生成序列化 id,那么需要做如下的配置 :
(L)启动 SpringBoot 应用,访问测试
来源地址:https://blog.csdn.net/friggly/article/details/123888590