2.1 第一个Spring Boot项目：helloworld

分手后的思念是犯贱 2023-10-07 21:43 17阅读 0赞

> ## 第2章 开始 Spring Boot 之旅 ##
> 
> 2.1 [第一个Spring Boot项目：helloworld][Spring Boot_helloworld]  
> 2.2 [单元测试][Link 1]  
> 2.3 [开发环境热部署][Link 2]

### 2.1 第一个Spring Boot项目：helloworld ###

#### 2.1.1 创建Spring Boot项目 ####

**1、使用Spring官网提供的构建页面**  
（1）访问Spring官网（https://start.spring.io/）。  
（2）选择构建工具为Maven Project，编程语言选择Java，Spring Boot 版本为 2.7.6，填写项目基本信息，添加相关依赖（按需添加）。  
（3）单击Generate创建并下载项目压缩包。  
（4）解压后，使用IDEA打开项目，选择 File -> Open File or Project，选择解压后的文件夹，单击OK按钮，项目即可创建完成。 ![Spring 官网提供的构建页面][Spring]

**2、使用IDEA构建**  
（1）选择 File -> New -> Project 命令，弹出新建项目的对话框。  
（2）选择 Spring Initializr，出现配置界面，IDEA已经帮助做了集成。IDEA界面中的Group、Artifact等输入框就对应着项目的pom.xml中的groupId、artifactId等配置项。  
![IDEA构建项目页面1][IDEA_1]

![IDEA构建项目页面2][IDEA_2]

#### 2.1.2 Spring Boot项目结构 ####

![在这里插入图片描述][0004495870174095aa0365f033ad95c6.png]

Spring Boot的基础结构共有3个主要目录和一个pom.xml文件。

*  src/main/java：程序开发以及主程序目录。
 *  src/main/resources：配置文件和资源文件目录。
 *  src/test/java：测试程序目录

新建的helloworld项目只有java、resources、test三个基础结构目录。完整的项目包括前台页面、model实体、数据库访问、公共基础类等非常多的文件和目录，Spring Boot 建议的目录结构如下：  
![在这里插入图片描述][f72a1c6eb85c48d9ad82935f4fc4d85a.png]

（1）Java目录（src/main/java）：程序开发以及主程序目录。java目录下的com.example.helloworld为后台java文件的根目录，包括：

*  Application.java：位于java文件的根目录下，是项目的启动类。注意Spring Boot项目只能有一个main()方法入口。
 *  comm：建议放置公共的类，如全局的配置文件、工具类等。
 *  model：主要用于实体（Entity）。
 *  repository：主要是数据库访问层代码。
 *  service：主要是业务类代码
 *  web：负责前台页面访问的Controller路由。

（2）resources目录（src/main/resources）：配置文件和资源文件目录。包括：

*  static：存放Web访问的静态资源，如JS、CSS、图片等。
 *  templates：存放页面模板。
 *  application.properties：存放项目的配置信息。

（3）test目录（src/test/java）：测试程序目录。存放单元测试的代码。

（4）pom.xml：位于项目根目录下，用于配置项目依赖包以及其他配置。

附录：

项目启动类（HelloworldApplication.java）

package com.example.helloworld;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    
    @SpringBootApplication
    public class HelloworldApplication {
        
    
        public static void main(String[] args) {
        
            SpringApplication.run(HelloworldApplication.class, args);
        }
    
    }

单元测试类（HelloworldApplicationTests.java）

package com.example.helloworld;
    
    import org.junit.jupiter.api.Test;
    import org.springframework.boot.test.context.SpringBootTest;
    
    @SpringBootTest
    class HelloworldApplicationTests {
        
    
        @Test
        void contextLoads() {
        
        }
    
    }

#### 2.1.3 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">
        <modelVersion>4.0.0</modelVersion>
    
        
        <groupId>com.example</groupId>
        <artifactId>helloworld</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <packaging>jar</packaging>
        <name>helloworld</name>
        <description>helloworld</description>
    
        
        <properties>
            <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
            <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
            <java.version>1.8</java.version>
        </properties>
    
        
        <parent>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-parent</artifactId>
            <version>2.7.5</version>
            <relativePath/> 
        </parent>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
            </dependency>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-devtools</artifactId>
                <scope>runtime</scope>
                <optional>true</optional>
            </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>

#### 2.1.4 第一个helloworld程序 ####

（1）创建第一个helloworld接口程序

package com.example.helloworld.controller;
    
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    @RestController
    public class HelloController {
        
        @RequestMapping("/hello")
        public String hello() {
        
            return "Hello @ Spring Boot!!!";
        }
    }

（2）运行helloworld程序

右击项目中的“Run ‘HelloworldApplication’”命令就可以启动项目。

（3）访问接口，查看页面返回结果

打开浏览器，访问 http://localhost:8080/hello 地址，查看页面返回的结果。

访问/hello地址后，后台成功接收到页面请求并返回“Hello @ Spring Boot!!!”，说明我们的第一个 Spring Boot 项目运行成功。

#### 总结 ####

本节从简单的helloworld程序开始介绍创建 Spring Boot 项目的方法和流程，以及 Spring Boot 项目结构，最后介绍项目中非常重要的pom.xml文件。

> 来源：《Spring Boot 从入门到实战》学习笔记

[Spring Boot_helloworld]: https://blog.csdn.net/Shipley_Leo/article/details/128141056
[Link 1]: https://blog.csdn.net/Shipley_Leo/article/details/128140934
[Link 2]: https://blog.csdn.net/Shipley_Leo/article/details/128140789
[Spring]: https://img-blog.csdnimg.cn/e284b40484bf45c88ded497cb1b54735.png#pic_center
[IDEA_1]: https://img-blog.csdnimg.cn/9469566e1bd643da9e376623fcc59fce.png
[IDEA_2]: https://img-blog.csdnimg.cn/b8c92c07261048848a4e4b7da4acea4a.png#pic_center
[0004495870174095aa0365f033ad95c6.png]: https://img-blog.csdnimg.cn/0004495870174095aa0365f033ad95c6.png
[f72a1c6eb85c48d9ad82935f4fc4d85a.png]: https://img-blog.csdnimg.cn/f72a1c6eb85c48d9ad82935f4fc4d85a.png