# springboot-task1

**Repository Path**: kirayous/springboot-task1

## Basic Information

- **Project Name**: springboot-task1
- **Description**: 实验一
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-04-03
- **Last Updated**: 2021-04-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实验一  使用Spring Boot构建应用程序
## 一、 实验目的

1、 掌握使用IntelliJ IDEA创建Spring Boot应用程序的方法；

2、 了解spring-boot-starter-parent的配置内容；

3、 掌握如何利用Starter扩展Spring Boot应用程序的功能；

4、 掌握如何配置Starter;

5、 掌握如何通过属性文件定制Spring Boot应用程序的初始化参数；

6、 掌握使用Spring Boot编写简单的单元测试；

7、 了解Spring Boot应用程序的Fat Jar文件；

8、 掌握Markdown轻量级标记语言编写README.md文件。

## 二、 实验环境

1、 JDK 1.8或更高版本

2、 Maven 3.6+

3、 IntelliJ IDEA


## 三、 实验任务
#### 1、 通过IntelliJ IDEA的Spring Initializr向导创建Spring Boot项目；

#### 2、 添加两个功能模块：spring MVC、lombok；


![输入图片说明](https://images.gitee.com/uploads/images/2021/0403/192420_61803af7_5631448.png "屏幕截图.png")


#### 3、 添加阿里云镜像仓库作为项目maven仓库；
![输入图片说明](https://images.gitee.com/uploads/images/2021/0403/193627_b6b85c67_5631448.png "屏幕截图.png")

#### 4、 解释项目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 https://maven.apache.org/xsd/maven-4.0.0.xsd">

    <!--    声明项目描述符遵循哪一个POM模型版本。模型本身的版本很少改变，虽然如此，但它仍然是必不可少的，-->
    <!--    这是为了当Maven引入了新的特性或者其他模型变更的时候，确保稳定性。-->
    <modelVersion>4.0.0</modelVersion>


    <!--指该项目的父工程项目，如果有项目为某个父项目的子项目，则parent里面应该填写父项目的groupId和 artifactId 以及 version-->
    <parent>

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


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


        <version>2.4.4</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <!--        公司或者组织的唯一标志，并且配置时生成的路径也是由此生成，-->
    <!--        如com.winner.trade，maven会将该项目打成的jar包放本地路径：/com/winner/trade-->
    <groupId>com.kirayous.task</groupId>

    <!--        本项目的唯一ID，一个groupId下面可能多个项目，就是靠artifactId来区分的 -->
    <artifactId>task1</artifactId>

    <!--        本项目目前所处的版本号-->
    <version>0.0.1-SNAPSHOT</version>

    <!--    项目的名称, Maven产生的文档用，可省略-->
    <name>task1</name>
    <!--    项目主页的URL, Maven产生的文档用 ，可省略-->
    <url>www.funtl.com</url>

    <!--    项目的描述，用于简单描述项目整体，可省略-->
    <description>Demo project for Spring Boot</description>

    <!--    maven默认自定义的属性名
    例如下面 自定义了java.test属性以及对应的值
    那么可以在在pom文件中通过${java.test}来使用他们
    -->
    <properties>
        <java.version>1.8</java.version>
        <java.test>1.8</java.test>
    </properties>


    <!--    打包类型，可取值：pom , jar , maven-plugin , ejb , war , ear , rar , par等等-->
    <packaging>jar</packaging>

    <!--    本项目所依赖的包-->
    <dependencies>



        <dependency>
            <!--            依赖项的组织名-->
            <groupId>junit</groupId>
            <!--            依赖项的子项目名-->
            <artifactId>junit</artifactId>
            <!--            依赖项的版本,可用特殊的符号代表多个版本，如果省略，会默认使用当前最新版本-->
<!--            <version>4.0</version>-->
            <!--            依赖项的适用范围 ，包括compile，provided，runtime，test，system，exclusions [^1]-->
            <scope>test</scope>
            <!--            依赖类型一般省略，默认类型是jar，其他还有jar，war，ejb-client和test-jar-->
<!--            <type>jar</type>-->

            <!--            可选依赖，又叫依赖传递性，如果你在项目B中把C依赖声明为可选，你就需要在依赖于B的项目（例如项目A）中显式的引用对C的依赖。-->
            <optional>true</optional>

            <!--            排除项目中的依赖冲突时使用，不依赖该项目-->
<!--            <exclusions>-->
<!--                <exclusion>-->
<!--                    <groupId>xxx</groupId>-->
<!--                    <artifactId>xxx</artifactId>-->
<!--                </exclusion>-->
<!--            </exclusions>-->
        </dependency>

        <dependency>

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


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

        </dependency>

        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>


<!--    在通常情况下，由于我们的模块很多，我们需要一个itoken-denpendencies的项目来管理子项目的公共的依赖。

        为了项目的正确运行，必须让所有的子项目使用依赖项的统一版本，必须确保应用的各个项目的依赖项和版本一致，才能保证测试的和发布的是相同的结果。

        在我们项目顶层的POM文件中，我们会看到dependencyManagement元素。通过它元素来管理jar包的版本，让子项目中引用一个依赖而不用显示的列出版本号。-->
<!--    <dependencyManagement>-->
<!--        <dependencies>-->
<!--        &lt;!&ndash;spring cloud&ndash;&gt;-->
<!--        <dependency>-->
<!--            <groupId>org.springframework.cloud</groupId>-->
<!--            <artifactId>spring-cloud-dependencies</artifactId>-->
<!--            <version>${spring-cloud.version}</version>-->
<!--            <type>pom</type>-->
<!--            <scope>import</scope>-->
<!--        </dependency>-->
<!--        &lt;!&ndash;zipkin&ndash;&gt;-->
<!--        <dependency>-->
<!--            <groupId>io.zipkin.java</groupId>-->
<!--            <artifactId>zipkin</artifactId>-->
<!--            <version>${zipkin.version}</version>-->
<!--        </dependency>-->
<!--        [...]-->
<!--        <dependencies>-->
<!--    </dependencyManagement>-->



<!--    该为构建或者打包运行项目时候的配置-->
    <build>

<!--        为什么我们需要插件？
            1.需要某个特殊的 jar包，但是有不能直接通过maven依赖获取，或者说在其他环境的maven仓库内不存在，那么如何将我们所需要的jar包打入我们的生产jar包中。
            2.某个jar包内部包含的文件是我们所需要的，或者是我们希望将它提取出来放入指定的位置 ，那么除了复制粘贴，如何通过maven插件实现呢 -->
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>

</project>


```




#### 5、 配置jetty或undertow作为Spring Boot应用程序的默认Servlet容器；

    tomcat：开源，SpringBoot默认，使用比较多

    jetty：小Serlvet容器，适合做长链接，也就是链接上就不断，长连接多用于操作频繁，点对点的通讯，而且连接数不能太多情况，很多人开发测试的时候很喜欢用，

    因为它启动比 tomcat要快很多

    undertow：是一个非阻塞的Servlet容器，但是它不支持JSP。

    Spring Boot 默认使用Tomcat，一旦引入 spring-boot-starter-web 模块，就默认使用Tomcat容器。
    
    所以需要再引用spring-boot-starter-web的依赖模块时，排除掉tomcat

    
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/090732_1b74967a_5631448.png "屏幕截图.png")

    然后导入jetty依赖
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/090912_77ae8320_5631448.png "屏幕截图.png")



    测试运行结果
    
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/091913_f67bf0f4_5631448.png "屏幕截图.png")

#### 6、 配置Gson作为Spring Boot应用程序的默认JSON MessageConverter;(可选)

    JSON是目前主流的前后端数据传输格式，SpringBoot中默认使用Jackson作为JSON的处理器。Gson是Google开源的JSON格式化框架
    
    整合Gson，在这之前需要在spring-boot-starter-web的依赖下除去默认的jackson-databind，然后再加入Gson的依赖。
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/092452_e2c5fa3a_5631448.png "屏幕截图.png")

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/092536_ca6b2034_5631448.png "屏幕截图.png")

    新建实体类
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/100915_9e1b53de_5631448.png "屏幕截图.png")

    新建controller类，然后使用json对实体类进行json格式化（实际上RestController会自动将你返回的实体类进行json格式化）

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/101044_553241ee_5631448.png "屏幕截图.png")

    输出结果
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/101110_9e7ff49f_5631448.png "屏幕截图.png")
#### 7、 修改Spring Boot应用程序启动时的Banner;(新增-2020-10-5)

    直接在recourses目录下加入自定义的banner.txt，springboot容器会默认替换掉原来的banner
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/101338_b3298094_5631448.png "屏幕截图.png")

    启动结果
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/101643_4d174202_5631448.png "屏幕截图.png")


#### 8、 添加一个简单的Spring Mvc控制器组件，用于测试，如下图：



        该类被标记为@RestController，这意味着Spring MVC可以使用它来处理Web请求。@RequestMapping映射‘/’到该类的index()方法。
        从浏览器调用或在命令行上使用curl时，该方法返回纯文本。
        那是因为@RestController是复合注解，它将@Controller和@ResponseBody组合在一起，这两个注解会使Spring Mvc处理Web请求返回的是数据而不是视图。

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/101816_41ccc0d0_5631448.png "屏幕截图.png")

#### 9、 定义一个CommandLineRunner的Bean，用于检查Spring Boot应用程序启动完成后在Spring IoC容器中注册的所有Bean。如下图：

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/105050_4354dd83_5631448.png "屏幕截图.png")

输出结果

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/105130_4989bb53_5631448.png "屏幕截图.png")



坑点（想使用@component注解，但发现有点不同）：

首先先取回一个ApplicationContext对象；

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/105249_b6bcdd2f_5631448.png "屏幕截图.png")

使用@component修饰实现了CommandLine的内部类

![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/105333_721346a3_5631448.png "屏幕截图.png")


结果会报ApplicationContext对象空指针异常

这是由于。。。。。（图片上已经说明了情况）

#### 10、 编写一个简单的单完测试。如下图：


    说明：
        MockMvc来自Spring Test模块，它可以让您通过一组便捷的构建器类将HTTP请求发送到DispatcherServlet中，并对结果进行断言。
        注意，这里使用@AutoConfigureMockMvc和@SpringBootTest。

        1）@SpringBootTest
            使用完@SpringBootTest后，将创建整个应用程序上下文(加载所有配置类的Bean)。
            @SpringBootTest注解告诉SpringBoot去寻找一个主配置类(例如带有@SpringBootApplication的配置类)，并使用它来启动Spring应用程序上下文。SpringBootTest加载完                                    
            整的应用程序并注入所有可能的bean，因此速度会很慢。

        2）@AutoConfigureMockMvc
            Spring在该层处理传入的HTTP请求并将其交给您的控制器。这样，几乎使用了整个堆栈，并且将以与处理真实HTTP请求完全相同的方式调用您的代码，而无需启动Servlet容器        
            就可以进行测试。使用@AutoConfigureMockMvc注解后，则会在spring应用上下文创建MockMvc实例。在测试用例中可以注入MockMvc实例模拟http请求，MockMvc实例会把 
            http请求转交相应的controller处理，而且不需要启动tomcat等Servlet容器。

        3）@WebMvcTest 与 @MockBean
            还有另一种替代方法是使用@WebMvcTest注解，它要求Spring Boot仅创建上下文的Web层(仅实例化controller组件)，其它组件需要自己手动Mock(如:使用@MockBean)。这样 
            就可以大大减少单元测试时初始化Spring上下文时加载的Bean数量，加快启动、测试Spring应用程序的速度。
            与@WebMvcTes功能相类似的还有@DataJpaTest与@JsonTest。

        无论使用哪种方法，Spring Boot都会自动尝试查找应用程序的主应用程序类，但是如果您要构建其他内容，则可以覆盖它或缩小它的范围。


        代码：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/224531_19dfd120_5631448.png "屏幕截图.png")


运行结果：

![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/224617_c7c65f81_5631448.png "屏幕截图.png")

证明测试单元通过，输出跟断言一样
#### 11、 使用IntelliJ IDEA的HTTP Client工具测试控制器端口；

    新建http request文件
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/154601_61b2b7b7_5631448.png "屏幕截图.png")

    写入get请求
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/154710_fabf078b_5631448.png "屏幕截图.png")

    运行
![输入图片说明](https://images.gitee.com/uploads/images/2021/0420/154740_93a10266_5631448.png "屏幕截图.png")

#### 12、 在命令行中使用spring官方提供的mave插件 spring-boot 运行Spring Boot应用程序，并把嵌入式Servlet容器的默认端口8080改为9090；

命令行：mvn spring-boot:run -Dspring-boot.run.arguments=--server.port=9090

运行结果：

![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/224417_cc7111da_5631448.png "屏幕截图.png")
#### 13、 在属性文件中配置Spring Boot应用程序以debug模式运行。
    说明：
        在Debug模式下，Spring Boot在运行时会在终端显示更多的调式信息。
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/223406_13cd85f8_5631448.png "屏幕截图.png")
#### 14、 在命令行中编译、打包Spring Boot应用程序。

打包命令：mvn package

方法一：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/223433_7696bc16_5631448.png "屏幕截图.png")
方法二：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/223448_625d8ba0_5631448.png "屏幕截图.png")


打包结果：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/223521_b691b3bf_5631448.png "屏幕截图.png")

#### 15、 在命令行中使用java命令运行Spring Boot应用程序的Jar文件。

命令：java -jar ./target/task1-0.0.1-SNAPSHOT.jar

![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/223929_66f30928_5631448.png "屏幕截图.png")

运行结果：
![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/224009_0654f847_5631448.png "屏幕截图.png")

#### 16、 在命令行中使用java命令运行Spring Boot应用程序的Jar文件，带参数改变嵌入式Servlet容器的默认端口8080改为9090。
    说明：
        带参数运行jar文件，可以改变很多spring boot内置的属性。
        例如：改变当前激活的属性文件：spring.profiles.active。
        应用场景：部署docker时使用。

命令：java -jar ./target/task1-0.0.1-SNAPSHOT.jar --server.port=9090
运行结果：

![输入图片说明](https://images.gitee.com/uploads/images/2021/0423/224148_1cd5e325_5631448.png "屏幕截图.png")
#### 17、 使用markdown标记语方编写实验报告，并生成README.md文件放在项目仓库的根目录。

已完成