Spring Boot 入门项目实践一

清疚 2022-02-02 09:31 274阅读 0赞

攻击敌方Spring Boot！

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70][]

[学习自实验楼][Link 1]

# 1 为毛选择Spring Boot #

与普通的 Spring 项目相比，Spring Boot 可以让项目的配置更简化、编码更简化、部署更方便，为开发者提供了开箱即用的良好体验，进一步提升了开发者的开发效率。

![20190512110353368.png][]

Spring Boot 通过一些 starter 的定义减少开发人员在依赖管理上所花费的时间，在整合各项功能的时候不需要去自行搜索和查找所需依赖并且在 Maven 的 pom 文件中进行定义。 starter 可以简单的理解为“场景启动器”，在不同的场景和功能中引入不同的 starter， 如果需要开发 web 项目，在 pom 文件中导入 spring-boot-starter-web ， web 项目开发中所需的依赖都已经维护在 spring-boot-starter-web 中，无需再去导入 servlet 、springmvc 等所需要的 jar 包，项目中如果需要使用 jdbc，在 pom 文件中导入 spring-boot-starter-web 即可，还有其他企业开发中的各种场景，Spring Boot 都已经准备好了，如果没有对应的 starter 也可以自行定义。

![20190512110333450.png][]

# 2 快速构建Spring Boot #

[官方快速构建][Link 2]

[谷歌浏览器中安装JsonView扩展程序][JsonView]

## 2.1 目录结构 ##

![20190512110315838.png][]

src/main/resources 表示配置文件目录，与普通的 Spring 项目相比有些区别，该目录下有 static 和 templates 两个目录，是 Spring Boot 项目默认的静态资源文件目录和模板文件目录，在 Spring Boot 项目中是没有 webapp 目录的，默认是使用 static 和 templates 两个文件夹。

## 2.2 项目启动 ##

### 2.2.1 Maven 插件启动 ###

由于 pom.xml 文件中引入了 spring-boot-maven-plugin 插件依赖，也可以直接使用 Maven 命令来启动 Spring Boot 项目。插件配置如下，如果 pom.xml 文件中没有该 Maven 插件，是无法通过这种方式启动 Spring Boot 项目的。

### ![20190512110252804.png][] ###

点击Terminal ，输入命令 `mvn spring-boot:run`并执行该命令即可启动项目。

或者

![20190512110229344.png][]

### 2.2.2 java -jar 命令启动 ###

打开 Terminal，使用 Maven 命令将项目打包：mvn -Dmaven.test.skip -U clean package

打包成功后进入 target 目录，`cd target`

最后就是启动已经生成的 Jar 包，执行命令为`java -jar springboot-demo-0.0.1-SNAPSHOT.jar`

这种方式也是 Spring Boot 上线时常用的启动流程。

### 2.2.3 浏览器访问 ###

![20190512114411773.png][]

虽然是错误页面，不过能够看到这个页面已经证明Spring Boot 项目搭建和启动过程都已经正确执行了。

# 3 Web功能开发 #

## 3.1 接口开发 ##

HelloController.java

@Controller
    public class HelloController {
    
        @GetMapping
        @ResponseBody
        public String hello(){
            return "hello world!";
        }
    }

处理请求路径为 /hello 的 get 请求，之后返回一段字符串

![20190512114353958.png][]

## 3.2 配置项 ##

我们创建了第一个 Spring Boot 项目，在初始化时我们选择了 web 模块(即在 pom 文件中引入了 spring-boot-starter-web 依赖)，该模块中包含了 SpringMVC 相关依赖，之后我们开发了第一个 web 功能，仅仅是在控制器类中实现了一个简单的字符串返回方法，并对该方法进行了请求地址映射设置，之后没有做其他配置操作，但是项目启动后就能够进行正常的 web 请求并正常返回数据。 回想一下在未使用 Spring Boot 开发 web 应用的场景，在平时的 Spring web 项目中，使用 SpringMVC 模块时需要在容器中配置 SpringMVC 相关的 bean，并且在 web.xml 中配置 DispatcherServlet 以及它的 <Servlet-mapping> 进行请求地址的映射，配置文件如下:

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70 1][]

最后启动 Tomcat 服务器装载 DispatcherServlet，接着就可以进行基于 SpringMVC 框架的 web 项目开发和使用，但是 Spring Boot 开发 web 项目时，开发者只需导入 spring-boot-starter-web 场景启动器即可，根本无需再进行任何配置就能够使得 DispatherServlet 正常加载并使用，这是因为 Spring Boot 在项目启动时已经将 DispatherServlet 自动配置到项目中了，因此我们无需做多余的配置即可完成接口的开发。

使用 Spring Boot 开发 web 应用时，有两个需要注意的配置项：

*  **server.port** 表示启动后的端口号，默认是 8080
 *  **server.servlet.context-path** 项目路径，是构成 url 地址的一部分

如果想要修改这两个参数值，可以在 application.properties 配置文件中修改：

![20190512114217238.png][]

访问

![20190512114334818.png][]

这样的话，启动后的端口号就不再是 8080 而是 8088 了，在浏览器访问时也需要加上设置的项目路径，比如前面的 hello 请求，路径就变成了 [http://localhost:8088/wyd/hello][http_localhost_8088_wyd_hello]

## 3.3 静态资源处理 ##

在 B/S 架构中，静态资源一般指 Web 服务器对应目录中的资源文件，客户端发送请求到 Web 服务器后，Web 服务器（比如 Tomcat）直接从文件目录中获取文件并返回给客户端，客户端解析并渲染显示出来，比如 HTML、CSS、JavaScript、图片等文件，这些文件原样返回给客户端，并不会在 Web 服务器端有所改变。

[API][]

org.springframework.boot.autoconfigure.web.ResourceProperties

@ConfigurationProperties(
        prefix = "spring.resources",
        ignoreUnknownFields = false
    )
    public class ResourceProperties {
        private static final String[] CLASSPATH_RESOURCE_LOCATIONS = new String[]{
    "classpath:/META-INF/resources/", 
    "classpath:/resources/", 
    "classpath:/static/", 
    "classpath:/public/"};
       ......
    }

通过查看源码我们可以看到，Spring Boot 默认存放静态资源文件的目录有四个，这些目录都在类路径下，它们分别是：

*  **/META-INF/resources/**
 *  **/resources/**
 *  **/static/**
 *  **/public/**

> SpringBoot默认会按照META-/resources > resources > static > public 的优先级寻找对应的资源文件并返回第一个找到的文件。

在进行 web 功能开发时，如果项目中存在静态资源文件，如 HTML、CSS、JavaScript、图片等文件，只要将这些文件放到以上四个文件目录即可正常访问到。

![20190512125653439.png][]

为了验证，分别在每个目录中新增一个静态资源文件，分别是 /META-INF/resources/test.html 、/resources/shiyanlou.png 、/static/test.css 、/public/test.js :

**访问：**

*  http://localhost:8088/wyd/test.html
 *  http://localhost:8088/wyd/test.css
 *  http://localhost:8088/wyd/test.js
 *  http://localhost:8088/wyd/shiyanlou.png

前面四个静态资源目录是 Spring Boot 默认设置的，如果想要更改，可以修改配置文件中的 spring.resources.static-locations 参数。

spring.resources.static-locations=classpath:/shiyanlou/,classpath:/static/

spring.resources.static-locations 的参数值可以设置为一个数组。

# 4 数据库连接操作 #

## 4.1 Spring Boot 连接数据库 ##

### 4.1.1 新增 pom 依赖 ###

Spring Boot 针对 JDBC 的使用提供了对应的 Starter 包：spring-boot-starter-jdbc，方便在 Spring Boot 生态中更好的使用 JDBC，演示项目中使用 MySQL 作为数据库，因此项目中也需要引入 MySQL 驱动包，因此在 pom.xml 文件中新增如下配置：

<dependency>
    	<groupId>org.springframework.boot</groupId>
    	<artifactId>spring-boot-starter-jdbc</artifactId>
    </dependency>
    <dependency>
    	<groupId>mysql</groupId>
    	<artifactId>mysql-connector-java</artifactId>
    </dependency>

### 4.1.2 数据库配置信息 ###

在 application.properties 文件中配置

# 数据源基本配置
    spring.datasource.url=jdbc:mysql://localhost:3306/test?useUnicode=true&characterEncoding=utf8&autoReconnect=true&useSSL=false&serverTimezone=UTC
    spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
    spring.datasource.username=root
    spring.datasource.password=123456

注：在 Spring Boot 2 中，数据库驱动类推荐使用 com.mysql.cj.jdbc.Driver，而不是我们平时比较熟悉的 com.mysql.jdbc.Driver 类了。

### 4.1.3 连接测试 ###

import org.junit.Test;
    import org.junit.runner.RunWith;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.boot.test.context.SpringBootTest;
    import org.springframework.test.context.junit4.SpringRunner;
    
    import javax.sql.DataSource;
    import java.sql.Connection;
    import java.sql.SQLException;
    @RunWith(SpringRunner.class)
    @SpringBootTest
    public class SpringbootApplicationTests {
    
    	// 注入数据源对象
    	@Autowired
    	private DataSource dataSource;
    
    	@Test
    	public void datasourceTest() throws SQLException {
    		// 获取数据库连接对象
    		Connection connection = dataSource.getConnection();
    		// 判断连接对象是否为空
    		System.out.println(connection != null);
    		connection.close();
    	}
    
    }

![20190512162356272.png][]

运行

![20190512162548657.png][]

## 4.2 Spring Boot 数据源自动配置 ##

我们在配置文件中只需要加上数据库的相关信息即可获取到数据库连接对象，那么 Spring Boot 究竟做了哪些自动配置操作使得我们可以如此简单的就直接获取到数据库连接呢？首先，我们来分析一下注入的 DataSource 数据源对象，添加测试方法：

@Test
    public void datasourceTest() throws SQLException {
          // 获取数据源类型
          System.out.println("默认数据源为：" + dataSource.getClass());
    }

运行结果：

> 默认数据源为：class com.zaxxer.hikari.HikariDataSource

在项目启动前，Spring Boot 已经默认向 IOC 容器中注册了一个类型为 HikariDataSource 的数据源对象，不然我们在使用 @Autowired 进行数据源的引入时肯定会报错，HikariCP 是 Spring Boot 2.0 默认使用的数据库连接池，自动配置类为 DataSourceAutoConfiguration.class 和 DataSourceConfiguration.class ，有空阅读一下源码理解一下数据源自动配置的过程。

Spring Boot 不仅仅是自动配置了 DataSource 对象，在数据源对象自动配置完成后，Spring Boot 也自动配置了 JdbcTemplate 对象，JdbcTemplate 是 Spring 对 JDBC 的封装，目的是使 JDBC 更加易于使用，Spring Boot 默认也并没有集成相关的 ORM 框架，而是提供了 JdbcTemplate 来简化开发者对于数据库的操作。

## 4.3 Spring Boot 操作 MySQL ##

import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.jdbc.core.JdbcTemplate;
    import org.springframework.util.StringUtils;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.util.List;
    import java.util.Map;
    
    // @RestController相当于同时使用@Controller和@ResponseBody注解
    @RestController
    @RequestMapping("/jdbc")
    public class JdbcController {
    
        @Autowired
        JdbcTemplate jdbcTemplate;
    
        // 查询 tb_user 表中的所有记录
        @GetMapping("/queryAll")
        public List<Map<String, Object>> queryAll() {
            List<Map<String, Object>> list = jdbcTemplate.queryForList("select * from tb_user");
            return list;
        }
    
        // 向 tb_user 表中新增一条记录
        @GetMapping("/insert")
        public Object insert(String name, String password) {
            if (StringUtils.isEmpty(name) || StringUtils.isEmpty(password)) {
                return false;
            }
            jdbcTemplate.execute("insert into tb_user(`name`,`password`) value (\"" + name + "\",\"" + password + "\")");
            return true;
        }
    
    }

# 4 整合MyBatis操作数据库 #

## 4.1 mybatis-springboot-starter 是啥 ##

[官方文档][Link 3]

Spring Boot 的核心特性包括简化配置并快速开发，当我们需要整合某一个功能时，只需要引入其特定的场景启动器 ( starter ) 即可，比如 web 模块整合、jdbc 模块整合，我们在开发时只需要在 pom.xml 文件中引入对应的场景依赖即可。Spring 官方并没有提供 MyBatis 的场景启动器，但是 MyBatis 官方却紧紧的抱住了 Spring 的大腿，他们提供了 MyBatis 整合 Spring Boot 项目时的场景启动器，也就是 **mybatis-springboot-starter**，大家通过命名方式也能够发现其中的区别，Spring 官方提供的启动器的命名方式为 **spring-boot-starter-\***。

## 4.2 整合过程 ##

### **4.2.1 application.properties 配置** ###

Spring Boot 整合 MyBatis 时几个比较需要注意的配置参数：

*  **mybatis.config-location**
    
    配置 mybatis-config.xml 路径，mybatis-config.xml 中配置 MyBatis 基础属性，如果项目中配置了 mybatis-config.xml 文件需要设置该参数
 *  **mybatis.mapper-locations**
    
    配置 Mapper 文件对应的 XML 文件路径
 *  **mybatis.type-aliases-package**
    
    配置项目中实体类包路径

### 4.2.2 启动类增加 Mapper 扫描 ###

在启动类中添加对 Mapper 包扫描 @MapperScan，Spring Boot 启动的时候会自动加载包路径下的 Mapper 接口。也可以直接在每个 Mapper 接口上面添加 @Mapper 注解，但是如果 Mapper 接口数量较多，在每个 Mapper 加注解是挺繁琐的，建议使用扫描注解。

@SpringBootApplication
    @MapperScan("com.wyd.springboot.dao")
    public class SpringbootApplication {
    
    	public static void main(String[] args) {
    		SpringApplication.run(SpringbootApplication.class, args);
    	}
    
    }

User .java

public class User {
        private Integer id;
        private String name;
        private String password;
        ...
    }

1 有xml的方式
    UserDao.java

public interface UserDao {
        /**
         * 返回数据列表
         * @return
         */
        List<User> findAllUsers();
    
        /**
         * 添加
         * @param User
         * @return
         */
        int insertUser(User User);
    
        /**
         * 修改
         * @param User
         * @return
         */
        int updUser(User User);
    
        /**
         * 删除
         * @param id
         * @return
         */
        int delUser(Integer id);
    
    }

UserDao.xml

<mapper namespace="com.wyd.springboot.dao.UserDao">
        <resultMap type="com.wyd.springboot.domain.User" id="UserResult">
            <result property="id" column="id"/>
            <result property="name" column="name"/>
            <result property="password" column="password"/>
        </resultMap>
        <select id="findAllUsers" resultMap="UserResult">
            select id,name,password from tb_user
            order by id desc
        </select>
        <insert id="insertUser" parameterType="com.lou.springboot.entity.User">
            insert into tb_user(name,password)
            values(#{name},#{password})
        </insert>
        <update id="updUser" parameterType="com.lou.springboot.entity.User">
            update tb_user
            set
            name=#{name},password=#{password}
            where id=#{id}
        </update>
        <delete id="delUser" parameterType="int">
            delete from tb_user where id=#{id}
        </delete>
    </mapper>

**2 无xml的方式**

import java.util.List;
    
    import org.apache.ibatis.annotations.Mapper;
    import org.apache.ibatis.annotations.Param;
    import org.apache.ibatis.annotations.Select;
    import org.apache.ibatis.annotations.Update;
    
    import com.imooc.miaosha.domain.MiaoshaGoods;
    import com.imooc.miaosha.vo.GoodsVo;
    
    @Mapper
    public interface GoodsDao {
    	
    	@Select("select g.*,mg.stock_count, mg.start_date, mg.end_date,mg.miaosha_price from miaosha_goods mg left join goods g on mg.goods_id = g.id")
    	public List<GoodsVo> listGoodsVo();
    
    	@Update("update miaosha_goods set stock_count = stock_count - 1 where goods_id = #{goodsId} and stock_count > 0")
    	public int reduceStock(MiaoshaGoods g);
    	
    }

学累了吧，撸一会比卡丘吧。

![watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70 2][]

然后还是得继续学习的

[Spring Boot 入门及前后端分离项目实践 二][Spring Boot _]

[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70]: /images/20220202/0a298355e808472daf0def2aef076e48.png
[Link 1]: https://www.shiyanlou.com/courses/1244/labs/9842/document/
[20190512110353368.png]: /images/20220202/d26d11b9c3604154863a3e4014f69321.png
[20190512110333450.png]: /images/20220202/bd5c66f125fe4918a07d39dd2e0241b4.png
[Link 2]: https://start.spring.io
[JsonView]: https://www.cnblogs.com/whycxb/p/7126116.html
[20190512110315838.png]: /images/20220202/43c4f137bdb6457aa756a502189ff0c1.png
[20190512110252804.png]: /images/20220202/0e1eae5d28c2464487a9a8f37f40cf1a.png
[20190512110229344.png]: /images/20220202/a9d92fc375c84e88bd1970397369a13c.png
[20190512114411773.png]: /images/20220202/33a8312a50334bd68d691abf78f0d777.png
[20190512114353958.png]: /images/20220202/6f9afa4669ff4ee7a59533728ed32057.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70 1]: /images/20220202/774937d6b4a24aa7a1946a40911d58ab.png
[20190512114217238.png]: /images/20220202/2f6838be39f6414d82f7683f882ca934.png
[20190512114334818.png]: /images/20220202/f8f220fcf2bd40448745cdb6508b0719.png
[http_localhost_8088_wyd_hello]: http://localhost:8082/shiyanlou/hello
[API]: https://docs.spring.io/spring-boot/docs/2.1.4.RELEASE/api/
[20190512125653439.png]: /images/20220202/318e2336699c4465b3e6353aeec286db.png
[20190512162356272.png]: /images/20220202/10a6e4d67de345cc8b6a91e874fb4360.png
[20190512162548657.png]: /images/20220202/5f1821f783a3441bb5715e96236e4630.png
[Link 3]: http://www.mybatis.org/spring-boot-starter/mybatis-spring-boot-autoconfigure/index.html
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3d5ZHlkMTEw_size_16_color_FFFFFF_t_70 2]: /images/20220202/5e426362be6744c88bc6bc9cbeaf6508.png
[Spring Boot _]: https://blog.csdn.net/wydyd110/article/details/90143680