本小节将带领您构建一个简单的Web服务，使用Java和Spring Boot框架。我们将逐步实现一个具有基本RESTful API的Web服务。
1. 环境准备
在开始之前，请确保您已安装以下软件：
- Java Development Kit (JDK) 版本 11 或以上
- Maven（用于项目管理）
- 一个文本编辑器或IDE（如 IntelliJ IDEA 或 Eclipse）
2. 创建Spring Boot项目
我们将使用Spring Initializr来生成项目骨架。
- 打开 Spring Initializr
- 选择以下配置：
- Project:
Maven Project
- Language:
Java
- Spring Boot:
2.6.0（或最新版本）
- Project Metadata:
- Group:
com.example
- Artifact:
demo
- Name:
demo
- Packaging:
Jar
- Java:
11
- 在Dependencies中添加：
- 点击
Generate 下载生成的项目压缩包，将其解压到本地。
3. 创建基本的REST控制器
在解压后的项目中，您会看到一个典型的Maven项目结构。打开src/main/java/com/example/demo目录，在此目录中创建一个新的Java类 HelloController：
1
2
3
4
5
6
7
8
9
10
11
12
13
| package com.example.demo;
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!";
}
}
|
解释代码
@RestController：这个注解表示该类是一个RESTful控制器，能够处理HTTP请求。@GetMapping("/hello")：这个注解表示当用户访问/hello路径时，将执行hello()方法。hello()方法返回一个字符串"Hello, World!"。
4. 运行Web服务
在项目目录中，使用以下命令运行您的Spring Boot应用：
如果您使用的是Windows，请使用mvnw.cmd命令。
一旦应用启动，您将在控制台看到类似以下内容：
1
2
| Tomcat started on port(s): 8080 (http) with context path ''
Started DemoApplication in 5.123 seconds (JVM running for 5.456)
|
5. 测试Web服务
打开您的Web浏览器或使用curl命令测试API。访问 http://localhost:8080/hello，您应该看到网页上显示：
或者在终端中使用curl命令：
1
| curl http://localhost:8080/hello
|
您将获得相同的输出。
6. 添加更多的功能
为了使Web服务更强大，我们可以添加一个返回用户信息的API。首先，创建一个User类：
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
| package com.example.demo;
public class User {
private String name;
private int age;
public User(String name, int age) {
this.name = name;
this.age = age;
}
public String getName() {
return name;
}
public int getAge() {
return age;
}
}
|
然后，在HelloController中添加一个新的API：
1
2
3
4
| @GetMapping("/user")
public User getUser() {
return new User("John Doe", 30);
}
|
7. 再次测试
重启应用后，访问 http://localhost:8080/user。您将收到如下JSON格式的响应：
1
2
3
4
| {
"name": "John Doe",
"age": 30
}
|
8. 结语
在本小节中，我们创建了一个基本的Java Web服务，使用了Spring Boot框架。您学会了如何：
- 使用
Spring Initializr创建项目
- 创建RESTful API并处理HTTP请求
- 返回自定义对象作为JSON响应
您可以进一步扩展该服务，添加更多功能，如数据库连接、用户认证等。Spring Boot提供了强大的生态系统支持，使开发变得迅速而高效。
