实操讲解:新建一个 Spring Boot 程序——以 “Hello World“ 为例
本文详细介绍了如何使用Spring Boot
创建一个简单的"Hello World"
应用程序。步骤包括从安装 IntelliJ IDEA 开始,接着通过 Spring Initializr
创建新项目,配置项目依赖,然后编写控制器类和主应用程序类,并最终运行项目进行测试。通过选择 Spring Web
依赖,项目将具备基本的 Web
功能。文章还提供了完整的项目结构示例,展示了如何组织代码文件,帮助开发者快速掌握 Spring Boot
的基础使用方法。
文章目录
1. 安装 IntelliJ IDEA
确保你已经安装了 IntelliJ IDEA,并且安装了 JDK。
2. 创建一个新项目
2.1 打开 IntelliJ IDEA,选择 File -> New -> Project...
。
2.2 在新项目向导中,选择 Spring Initializr
,然后点击 Next
。
2.3 在这一页面中,填写项目的基本信息:
Name
: HelloWorld(这是项目的名称,可以根据需要更改)Location
: 项目保存的路径Language
: Java(选择 Java 是因为 Spring Boot 主要用于 Java 开发)Type
: Maven(选择 Maven 是因为它是一个流行的项目管理和构建工具)Group
: com.example(com.example
是一个常见的占位符,用于示例代码和演示项目中。实际项目中可以用你公司的域名或项目名称)Artifact
: helloworld(这是项目的构件ID,通常与项目名称一致)Description
: Demo project for Spring Boot(对项目的简短描述)Package name
: com.example.helloworld(这是项目的根包名,通常根据 Group 和 Artifact 组合而成)Packaging
: Jar(选择 Jar 是因为它是 Java 应用程序的常见打包格式)Java version
: 11 或者你的 JDK 版本(选择你的 JDK 版本,通常选择最新的 LTS 版本)
- 点击
Next
。
3. 添加依赖
3.1 配置依赖
在依赖选择页面,勾选 Spring Web
。
除了 Spring Web
,你还可以根据需要选择其他常用的依赖。例如:
Spring Boot DevTools
: 提供开发工具,支持热重载,提高开发效率。Spring Data JPA
: 提供对 JPA 的支持,方便与数据库交互。Spring Security
: 提供安全相关的功能,如身份认证和授权。Thymeleaf
: 如果你需要使用模板引擎生成动态网页,可以选择这个依赖。
如果只有 Spring Web
依赖,你的 pom.xml
文件会自动生成如下配置:
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
这个配置文件包括了 Spring Web
和用于测试的 Spring Boot Starter Test
依赖。具体如下:
spring-boot-starter-web
: 包含了用于构建 Web 应用的核心依赖,如 Spring MVC、Jackson(用于 JSON 处理)等。spring-boot-starter-test
: 包含了用于编写和运行测试的依赖,如 JUnit、Spring TestContext Framework 等。该依赖的scope
被设置为test
,表示它仅在测试编译和运行时可用。
这样就可以满足创建一个基本的 Spring Boot Hello World
Web 应用程序的需求。
3.2 完成
点击 Next
,然后点击 Finish
创建项目。
4. 配置项目
项目创建完成后,IntelliJ IDEA 会自动下载和配置所需的依赖。
5. 编写代码
5.1 创建主类
- 在
src/main/java/com/example/helloworld
目录下,创建一个新包controller
。 - 在
controller
包下,创建一个新 Java 类,命名为HelloController
。 - 在
HelloController
类中,添加以下代码:
package com.example.helloworld.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "Hello, World!";
}
}
5.2 修改主应用程序类
在 src/main/java/com/example/helloworld
目录下,找到 HelloWorldApplication
类,确保它包含以下代码:
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);
}
}
6. 运行项目
- 点击 IntelliJ IDEA 右上角的绿色箭头,或者右键点击
HelloWorldApplication
类,选择Run 'HelloWorldApplication'
。 - 等待 Spring Boot 启动完成。
7. 访问应用
- 打开浏览器,访问
http://localhost:8080/hello
。 - 你应该会看到页面显示 “Hello, World!”。
8. 完整的项目结构
HelloWorld
├── src
│ ├── main
│ │ ├── java
│ │ │ └── com
│ │ │ └── example
│ │ │ └── helloworld
│ │ │ ├── HelloWorldApplication.java
│ │ │ └── controller
│ │ │ └── HelloController.java
│ │ └── resources
│ │ └── application.properties
│ └── test
│ └── java
│ └── com
│ └── example
│ └── helloworld
│ └── HelloWorldApplicationTests.java
└── pom.xml
这样你就创建了一个简单的 Spring Boot “Hello World” 应用。收藏加关注,追更不迷路!