Spring Boot初体验：从创建项目到Hello World（附完整代码）

在学习Spring Boot的过程中，亲自创建一个简单的项目并让它运行起来是一个很好的开始。就像搭建一座房子，我们得先打好地基，而创建Spring Boot项目就是我们进入Spring Boot世界的第一步。在这个小节中，我们将通过一步步的操作，从项目的创建到实现一个简单的“Hello World”程序，让你对Spring Boot有一个初步的体验。

实操模块

1. 使用Spring Initializr创建项目

Spring Initializr是一个非常方便的工具，它就像是一个项目模板生成器，能帮助我们快速创建Spring Boot项目的基本结构。下面我们来详细看看如何使用它。

具体步骤：

打开浏览器，访问Spring Initializr的官方网站：https://start.spring.io/ 。这个网站就像是一个项目创建的“魔法工厂”，我们在这里可以配置项目的各种参数。在页面中进行项目的基本配置：
Project：选择“Maven Project”。Maven是一个项目管理和构建工具，它就像是一个高效的管家，能帮助我们管理项目的依赖和构建过程。Language：选择“Java”。Java是一种广泛使用的编程语言，Spring Boot主要就是基于Java开发的。Spring Boot：选择合适的版本。这里我们可以根据自己的需求和实际情况选择，一般建议选择较稳定的版本。Group：填写项目的组织名，例如“com.example”。这就像是给项目贴上一个独特的标签，方便我们区分不同的项目。Artifact：填写项目的名称，例如“spring-boot-hello-world”。这是项目的具体名称，在后续的开发和部署中会经常用到。Name：项目的显示名称，默认会和Artifact一致，你也可以根据自己的喜好进行修改。Description：简单描述项目的功能，让其他人能快速了解这个项目是做什么的。Package name：根据Group和Artifact自动生成，一般不需要修改。Packaging：选择“Jar”。Jar是Java的一种打包格式，方便我们将项目打包成一个可执行的文件。Java：选择合适的Java版本，确保和你本地的Java环境一致。添加项目依赖：在“Dependencies”中搜索并添加“Spring Web”依赖。Spring Web是Spring Boot中用于开发Web应用的模块，有了它我们就能轻松创建Web服务了。就像给房子添加了一扇门，让外界可以和房子进行交互。点击“Generate”按钮，会下载一个压缩包。这个压缩包就是我们创建好的项目的基本结构，包含了项目的各种配置文件和目录。将下载的压缩包解压到你喜欢的目录中，然后用你喜欢的IDE（如IntelliJ IDEA、Eclipse等）打开这个项目。

示例代码结构：
解压后的项目结构大致如下：


spring-boot-hello-world
├── .mvn
│   └── wrapper
│       ├── MavenWrapperDownloader.java
│       └── mvnw.cmd
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com
│   │   │       └── example
│   │   │           └── springboothelloworld
│   │   │               └── SpringBootHelloWorldApplication.java
│   │   └── resources
│   │       ├── application.properties
│   │       ├── static
│   │       └── templates
│   └── test
│       └── java
│           └── com
│               └── example
│                   └── springboothelloworld
│                       └── SpringBootHelloWorldApplicationTests.java
├── mvnw
├── mvnw.cmd
└── pom.xml

2. 编写Hello World控制器

控制器在Spring Boot项目中就像是一个“交通指挥员”，负责接收客户端的请求并返回相应的响应。下面我们来编写一个简单的Hello World控制器。

具体步骤：

在src/main/java/com/example/springboothelloworld目录下创建一个新的Java类，命名为HelloWorldController。在HelloWorldController类中编写以下代码：


package com.example.springboothelloworld;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloWorldController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello World!";
    }
}

代码解释：

@RestController：这是一个注解，它告诉Spring Boot这个类是一个控制器，并且返回的结果会直接作为HTTP响应的内容。就像是给这个类贴上了一个“控制器”的标签。@GetMapping("/hello")：这也是一个注解，它表示当客户端发送一个GET请求到/hello路径时，会调用hello()方法。就像是设置了一个“交通规则”，告诉客户端在访问/hello时会发生什么。public String hello()：这是一个简单的方法，它返回一个字符串“Hello World!”。当客户端访问/hello路径时，就会收到这个字符串作为响应。

3. 运行项目

现在我们已经完成了项目的创建和控制器的编写，接下来就可以运行项目并测试我们的“Hello World”程序了。

具体步骤：

打开src/main/java/com/example/springboothelloworld目录下的SpringBootHelloWorldApplication.java类。这个类是项目的启动类，就像是项目的“发动机”，启动它就能让整个项目运行起来。在SpringBootHelloWorldApplication类中找到main方法，右键点击并选择“Run ‘SpringBootHelloWorldApplication’”。当控制台输出类似以下信息时，说明项目已经成功启动：


Started SpringBootHelloWorldApplication in 3.212 seconds (JVM running for 3.874)

打开浏览器，访问http://localhost:8080/hello。如果一切正常，你会在浏览器中看到“Hello World!”的字样。这就说明我们的项目已经成功运行，并且能够正常响应客户端的请求。

核心技术点

Spring Boot项目创建

Spring Boot项目的创建主要依赖于Spring Initializr这个工具，它通过简单的配置就能帮助我们生成项目的基本结构。在创建过程中，我们需要注意选择合适的项目类型（如Maven Project）、编程语言（Java）、Spring Boot版本等。这些选择会影响项目的后续开发和部署。例如，选择不同的Spring Boot版本可能会有不同的特性和兼容性。

基本配置

在项目创建完成后，我们还需要进行一些基本的配置。例如，在src/main/resources目录下的application.properties文件中，我们可以配置项目的端口号、数据库连接信息等。这些配置就像是给项目设置了一些“规则”，让项目能够按照我们的要求运行。例如，如果我们想修改项目的端口号，可以在application.properties文件中添加以下配置：


server.port=8081

这样，项目就会在8081端口上运行。

问题解决

在创建项目的过程中，可能会遇到依赖下载失败的问题。这通常是由于网络问题或者Maven仓库配置不正确导致的。下面我们来看看如何解决这个问题。

网络问题

如果是网络问题导致依赖下载失败，我们可以尝试更换网络环境，或者使用代理服务器。例如，在settings.xml文件中配置代理服务器：


<proxies>
  <proxy>
    <id>myproxy</id>
    <active>true</active>
    <protocol>http</protocol>
    <host>proxy.example.com</host>
    <port>8080</port>
    <username>proxyuser</username>
    <password>proxypass</password>
    <nonProxyHosts>localhost|127.0.0.1</nonProxyHosts>
  </proxy>
</proxies>

Maven仓库配置不正确

如果是Maven仓库配置不正确导致依赖下载失败，我们可以修改settings.xml文件中的仓库地址。例如，使用阿里云的Maven仓库：


<mirrors>
  <mirror>
    <id>alimaven</id>
    <name>aliyun maven</name>
    <url>https://maven.aliyun.com/repository/public</url>
    <mirrorOf>central</mirrorOf>
  </mirror>
</mirrors>

总结

通过本小节的学习，我们掌握了Spring Boot项目的创建、基本配置以及如何编写一个简单的“Hello World”控制器并运行项目。这些内容是我们学习Spring Boot的基础，就像是学会了走路的基本姿势。掌握了这些内容后，下一节我们将深入学习Spring Boot的配置文件，进一步完善对本章Spring Boot基础入门主题的认知。这样我们就能更好地控制项目的运行，实现更多复杂的功能。