Spring Boot进阶系列一

笔者最近在总结一个 Spring Boot实战系列，以方便将来查找和公司内部培训用途。

1.Springboot从哪里来

SpringBoot是由Pivotal团队在2013年开始研发、2014年4月发布第一个版本的全新开源的轻量级框架。它基于Spring4.0设计，不仅继承了Spring框架原有的优秀特性，而且还通过简化配置来进一步简化了Spring应用的整个搭建和开发过程。另外SpringBoot通过集成大量的框架使得依赖包的版本冲突，以及引用的不稳定性等问题得到了很好的解决。

其主要的优势如下：

创建独立的Spring Web应用程序
嵌入的Tomcat,Jetty或者Undertow,无须部署WAR文件就可以直接运行。
简化Maven或Gradle配置
自动配置Spring
开箱即用，没有代码生成，也无需XML配置. 通过在MAVEN项目的pom.xml文件中添加相关依赖包，然后使用对应注解来代替繁琐的XML配置文件以管理对象的生命周期.
约定优于配置(Convention over configuration) 是一种由SpringBoot本身来配置目标结构，由开发者在结构中添加信息的软件设计范式. 减少了开发人员需要做出决定的数量，同时减少了大量的XML配置，并且可以将代码编译、测试和打包等工作自动化。

Springboot官网目前推荐的版本是2.1.7. 如果是刚开始使用Springboot，那么从2.X开始无疑是最好的选择。

当下大多数公司的生产环境的版本应该是1.X系列。官方最后的1.X版本落在1.5.22.

https://spring.io/blog/2019/08/06/it-is-time-goodbye-spring-boot-1-x

2.开发环境

Eclipse Java EE IDE for Web Developers.Version: 2018-09 (4.9.0)
Java version: 1.8.0_192
apache-maven-3.6.0
apache-tomcat-9.0.12
MySQL Server 8.0.17.0 + MySQL Workbench 8.0 CE

3.Springboot项目结构

Eclipse里面新建项目，选择Spring Starter Project模板，通过向导点击下一步，项目命名为ProductApp0最后选择2.1.7版本。

在resources文件夹里面创建static,templates,public/error的文件夹。

application.properties：自动生成，用于配置项目运行所需的配置数据。

static：用于存放静态资源，里面继续创建子文件夹js,css,image。
public/error: 用于存放类似404.html,5xx.html等文件

templates：用于存放模板文件，使用官方推荐的Thymeleaf

demo下面创建该项目用到的几个文件夹，config,store,model,controller

项目文件夹分布架构大致如下：

该项目具有三个功能，分别向前端返回一个字符串，一个对象，以及一个集合。

4.项目分析

4.1 Pom.xml里面主要添加的包是web, jdbc,jpa, mysql driver,fastjson.结构如下：

　　　　 <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-web</artifactId>

        </dependency>

        <!-- jdbc -->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-jdbc</artifactId>

        </dependency>

        <!-- springboot,jpa 整合包 -->

        <dependency>

            <groupId>org.springframework.boot</groupId>

            <artifactId>spring-boot-starter-data-jpa</artifactId>

        </dependency>

        <!-- mysql 驱动包 -->

        <dependency>

            <groupId>mysql</groupId>

            <artifactId>mysql-connector-java</artifactId>

            <!--根据MySQL server 版本实际情况变动 -->

            <version>8.0.</version><!--$NO-MVN-MAN-VER$ -->

        </dependency>

        <!-- 引入FastJSON -->

        <dependency>

            <groupId>com.alibaba</groupId>

            <artifactId>fastjson</artifactId>

            <version>1.2.</version>

        </dependency>

4.2 该示例需要用到一张表，结构如下:

CREATE TABLE `book` (

  `Id` int(11) NOT NULL AUTO_INCREMENT,

  `Name` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,

  `Category` varchar(32) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,

  `Price` decimal(18,2) NOT NULL,

  `Publish_Date` date NOT NULL,

  `Poster` varchar(45) NOT NULL,

  PRIMARY KEY (`Id`)

) ENGINE=InnoDB AUTO_INCREMENT=25 DEFAULT CHARSET=utf8

4.3 使用Spring-data-jpa访问数据库,分别在model,store文件夹里面里面创建Book 类，BookRepository接口。

@Entity

public class Book implements Serializable {

    private static final long serialVersionUID = -3123479062966697145L;

    @Id

    @Column

    private Integer id;

    @Column

    private String name;

    @Column

    private String category;

    @Column

    private Double price;

    @Column

    @JSONField(format="yyyy-MM-dd")

    private Date publish_date;

    @Column

    private String poster;

    } //省略getter,setter方法

public interface BookRepository extends JpaRepository<Book,Integer> {

}

4.4. 引入fastjson,需要添加一个配置类

@Configuration

public class JSONWebConfig {

         @Bean

        public HttpMessageConverters fastJsonHttpMessageConverters() {

            FastJsonHttpMessageConverter fastJsonHttpMessageConverter = new FastJsonHttpMessageConverter();

            FastJsonConfig fastJsonConfig = new FastJsonConfig();

            fastJsonConfig.setSerializerFeatures(SerializerFeature.PrettyFormat);

            fastJsonHttpMessageConverter.setFastJsonConfig(fastJsonConfig);

            HttpMessageConverter<?> converter = fastJsonHttpMessageConverter;

            return new HttpMessageConverters(converter);

        }

}

4.5 在controller文件夹里面创建HelloController class如下，

@RestController

@RequestMapping("/hello")

public class HelloController {

    @Autowired

    private BookRepository bookRepository;

    @GetMapping("/test")

    public String test() {

        return "My first springboot web application!";

    }

    @GetMapping("/findOne")

    public Book findOne() throws NotFoundException {

        int id=1;

        Optional<Book> book = this.bookRepository.findById(id);

        if(book.isPresent()) {

            return book.get();

        }

        else {

            throw new NotFoundException("Not found...");

        }

    }

    @GetMapping("/findAll")

    public List<Book> findAll()

    {

        List<Book> books = this.bookRepository.findAll();

        return books;

    }

}

说明：

@Autowired：自动导入依赖的bean.
@Configuration：相当于xml配置文件
@Bean：用@Bean标注方法等价于XML中配置的bean。
@Entity：@Table(name=”“)：表明这是一个实体类, 一般用于JPA。这两个注解一般一块使用，但是如果表名和实体类名相同的话，@Table可以省略
@Controller：用于定义控制器类，在spring项目中由控制器负责将用户发来的URL请求转发到对应的服务接口（service层），注解在类上面，方法需要配合注解@RequestMapping
@RestController注解是@Controller和@ResponseBody的合集,表示这是个控制器bean,并且是将函数的返回值直接填入HTTP响应体中,是REST风格的控制器。
@RequestMapping：提供路由信息，负责URL到Controller中的具体函数的映射, 返回值通常解析为跳转路径
@ResponseBody：表示该方法的返回结果直接写入HTTP response body中，一般在异步获取数据时使用，用于构建RESTful的WEB API。比如异步获取json数据，加上@Responsebody后，会直接返回json数据。该注解一般会配合@RequestMapping使用。
@GetMapping 组合注解，是@RequestMapping(method = RequestMethod.GET)的缩写

4.6 application.properties文件内容如下：

# DB connection configuration

spring.datasource.url=jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC

spring.datasource.username=***

spring.datasource.password=******

# JPA configuration

spring.jpa.hibernate.ddl-auto=update

spring.jpa.show-sql=true

4.7 程序入口点在main函数

@SpringBootApplication

public class ProductApp0Application {

    public static void main(String[] args) {

        SpringApplication.run(ProductApp0Application.class, args);

    }

}

@SpringBootApplication是Spring Boot的核心注解，是一个组合注解，用于启动类上。包含了@ComponentScan、@Configuration和@EnableAutoConfiguration注解。其中@ComponentScan让spring Boot扫描到Configuration类并把它加入到程序上下文。

选中项目，右键选择Debug As或Run As菜单，先点击Maven clean,后点击Maven install。

编译无错误后，点击Spring Boot App运行项目。

浏览器输入以下地址，查看结果。

http://localhost:8080/hello/test

http://localhost:8080/hello/findOne

http://localhost:8080/hello/findAll

5.打包部署

5.1一般来说打成jar或者war包，eclipse默认生成jar包。在项目里面的target文件夹里面。运行程序则用下面的命令，

java -jar ProductApp0-0.0.1-SNAPSHOT.jar

5.2.1 SpringbootApplication 类继承 SpringBootServletInitializer 并重写 configure 方法，如下：

@SpringBootApplication

public class ProductApp0Application extends SpringBootServletInitializer {

    @Override

    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {

        return builder.sources(ProductApp0Application.class);

    }

    public static void main(String[] args) {

        SpringApplication.run(ProductApp0Application.class, args);

    }

}

5.2.2 在pom.xml里面添加一行，跟在<description>标签后面，

    <groupId>com.example</groupId>

    <artifactId>ProductApp0</artifactId>

    <version>0.0.1-SNAPSHOT</version>

    <name>ProductApp0</name>

    <description>Demo project for Spring Boot</description>

    <packaging>war</packaging>

Eclipse里面点击Maven clean, Maven install,最终在target文件夹里面生成如下:

复制 war包到tomcat/webapps文件夹，建议重名为home.war. 然后启动tomcat/bin文件夹里面的startup.bat

浏览器里面输入如下地址，查看结果

http://localhost:8080/home/hello/test

http://localhost:8080/home/hello/findOne

http://localhost:8080/home/hello/findAll