二、第一个应用程序

1.查看初始化的 Spring Boot 新项目

整个项目结构都遵循传统Maven或Gradle项目的布局,即主要应用程序代码位于src/main/java 目录里;资源都在src/main/resources 目录里;测试代码都在src/test/java目录里。如果有测试资源的话,要放在src/test/resources里。


新项目结构图.png
  • pom.xml:Maven构建说明文件
  • ReadingListApplication.java:应用程序的启动引导类(bootstrap class),也是主要的Spring配置类
  • application.properties:用于配置应用程序和Spring Boot的属性
  • ReadingListApplicationTests.java:一个基本的集成测试类
  1. 启动引导Spring

ReadingListApplication.java在Spring Boot应用程序里有两个作用:配置和启动引导。

package com.jasonper.readinglist;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class ReadinglistApplication {

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

}

@SpringBootApplication开起了Spring的组件扫描和Spring Boot的自动配置功能。实际上,@SpringBootApplication将三个有用的注解组合到了一起。

  • Spring 的@Configuration:标明该类使用Spring基于Java的配置
  • Spring 的@ComponentScan:启用组件扫描,这样你写的Web控制器类和其他的组件才能自动发现并注册为Spring应用程序上下文里的Bean
  • Spring Boot 的@EnableAutoConfiguration:这一行配置开起了Spring Boot自动配置,让你不再写成篇的配置了

在mian方法中,向SpringApplication.run()传递了一个ReadingListApplication类的引用,还有命令行参数,通过这些东西来启动该应用程序。

Tips:如果你的应用程序需要Spring Boot自动配置外的其他Spring配置,一般来说,最好把它写到一个单独的@Configuration标注的类里(组件扫描会发现并使用这些类的)

  1. 测试Spring Boot应用程序
package com.jasonper.readinglist;

import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

@RunWith(SpringRunner.class)
@SpringBootTest
public class ReadinglistApplicationTests {

    @Test
    public void contextLoads() {
    }

}

ReadingListApplicationTests里有个空方法:contextLoads()。这个空方法足以证明应用程序的上下文加载没有问题。如果存在问题,测试就会失败。

  1. 配置应用程序的属性

application.properties文件是一个空文件,这个文件是可选的,可以删除,这不会对应用程序有任何影响,但留着也没什么问题。
通过application.properties我们也可细粒度的调整Spring Boot的自动配置,可以用它来指定应用程序代码所需的配置项。
你完全不用告诉Spring Boot为你加载application.properties,只要它存在就会被加载,Spring和应用程序代码都能获取其中的属性。

2.Spring Boot 项目构建解析

选择使用Maven来构建应用程序,Initializr会替你生成一个pom.xml文件。

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.1.6.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
    <groupId>com.jasonper</groupId>
    <artifactId>readinglist</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>readinglist</name>
    <description>Demo project for Spring Boot</description>

    <properties>
        <java.version>1.8</java.version>
    </properties>

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

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

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

</project>

<parent>...</parent>:这一部分是从spring-boot-starter-parent继承过来的版本号
<dependencies>...</dependencies>:起步依赖配置
<build>...<build>:运用Spring Boot 插件

构建插件的主要功能是把项目打包成一个可执行的jar包,包括把应用程序的所有依赖打入JAR文件类,并为JAR文件添加一个描述文件,你可以使用java -jar 命令来运行应用程序
除了构建插件,代码里Maven还将spring-boot-starter-parent作为上一级,这样一来就能利用Maven的依赖管理功能,继承很多常用库的依赖版本,在声明依赖的时候就不用指定版本号了。如这个pom.xml里的依赖都没有指定版本。

Tips:Artifact ID带有 spring-boot-starter- 前缀的都是Spring Boot的起步依赖。

3.使用起步依赖

使用起步依赖很简单:

 <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
 </dependency>

覆盖起步依赖引入的传递依赖:
以Spring Boot的Web起步依赖为例,它传递了Jackson JSON库。如果你的项目用不上Jackson JSON库,在Maven里可以使用<exclusions>元素去除Jackson:

<dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <exclusions>
                <exclusion>
                    <groupId>com.fasterxml.jackson.core</groupId>
                </exclusion>
            <exclusions>
 </dependency>

4.使用自动配置

Spring Boot 的自动配置是一个运行时(准确来说,是应用程序启动时)的过程,它考虑了诸多因素,才决定Spring配置该用哪个和不该用哪个。

©著作权归作者所有,转载或内容合作请联系作者
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

推荐阅读更多精彩内容