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.17</version><!--$NO-MVN-MAN-VER$ -->
        </dependency>
        <!-- 引入FastJSON -->
        <dependency>
            <groupId>com.alibaba</groupId>
            <artifactId>fastjson</artifactId>
            <version>1.2.35</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 AsRun 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

posted @ 2019-08-30 22:34  沐璟  阅读(736)  评论(0编辑  收藏  举报