Spring Boot 从入门到实践：轻松搭建和使用微服务架构

本文将全面介绍 Spring Boot 的创建和使用，为您展示如何从零搭建一个 Spring Boot 项目，并运行一个简单的 RESTful API。文章内容将分为以下几个部分：

一、简介
二、环境准备
三、创建 Spring Boot 项目
四、项目结构与配置
五、实现 RESTful API
六、运行与测试
七、总结

一、简介

Spring Boot 是一个用来简化 Spring 应用程序搭建和开发的框架。它通过约定优于配置的原则，自动配置了许多默认选项，可以让开发者快速地创建和部署微服务。Spring Boot 提供了大量的 Starter 依赖，方便开发者集成和使用各种常用功能。

二、环境准备

在开始创建 Spring Boot 项目之前，确保您的电脑已安装了以下环境：

JDK 1.8 或更高版本
Maven 3.2 或更高版本
IDE（推荐 IntelliJ IDEA 或 Eclipse）

三、创建 Spring Boot 项目

3.1 使用 Spring Initializer 创建项目

访问 Spring Initializer，这是一个在线的 Spring Boot 项目生成器。

填写项目信息如下：

Project Type: Maven Project
Language: Java
Packaging: Jar
Artifact: demo
Group: com.example

3.2 添加依赖

在生成的 pom.xml 文件中添加以下依赖：

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency><!-- ...其他依赖 -->
</dependencies>

3.3 创建 Main 类

在 src/main/java/com/example/demo 目录下，创建一个名为 Application 的 Java 类，并添加以下代码：

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

以上代码创建了一个 Spring Boot 应用，并通过 @SpringBootApplication 注解启用自动配置。

四、项目结构与配置

项目结构：

demo/
|-- src/
|   |-- main/
|   |   |-- java/
|   |   |   |-- com.example.demo/
|   |   |   |   |-- Application.java
|   |   |   |   |-- controller/
|   |   |   |   |-- service/
|   |   |   |   |-- repository/
|   |   |-- resources/
|   |   |   |-- application.properties
|-- pom.xml

4.1 配置文件

在 src/main/resources 目录下，创建一个名为 application.properties 的文件，并添加以下配置：

server.port=8080

4.2 Controller 层

在 src/main/java/com/example/demo/controller 目录下，创建 UserController 类：

package com.example.demo.controller;import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;@RestController
@RequestMapping("/users")
public class UserController {@GetMappingpublic String getUsers() {return "Hello, users!";}
}

五、实现 RESTfulAPI

在本节中，我们将实现一个简单的 RESTful API，用于用户的创建、查询、更新和删除（CRUD）操作。

5.1 创建 User 实体类

在 src/main/java/com/example/demo 目录下，创建 User 实体类：

package com.example.demo;import java.io.Serializable;public class User implements Serializable {private Long id;private String name;private Integer age;// 构造方法、getter 和 setter ...
}

5.2 创建 UserService 接口及实现类

在 src/main/java/com/example/demo/service 目录下，创建 UserService 接口以及实现类 UserServiceImpl，用于处理用户相关逻辑。这里为了简化，我们将数据直接保存在内存中：

package com.example.demo.service;import com.example.demo.User;
import java.util.List;public interface UserService {List<User> findAll();User findById(Long id);User create(User user);User update(User user);void delete(Long id);
}package com.example.demo.service.impl;import com.example.demo.User;
import com.example.demo.service.UserService;
import org.springframework.stereotype.Service;
import java.util.ArrayList;
import java.util.List;
import java.util.Map;
import java.util.concurrent.ConcurrentHashMap;@Service
public class UserServiceImpl implements UserService {private final Map<Long, User> userRepository = new ConcurrentHashMap<>();// 实现查询所有用户、根据 ID 查询、创建、更新和删除用户的方法 ...
}

5.3 修改 UserController 类

将刚刚创建的 UserService 注入 UserController 类，实现 RESTful API:

package com.example.demo.controller;import com.example.demo.User;
import com.example.demo.service.UserService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;import java.util.List;@RestController
@RequestMapping("/users")
public class UserController {@Autowiredprivate UserService userService;@GetMappingpublic ResponseEntity<List<User>> getUsers() {return new ResponseEntity<>(userService.findAll(), HttpStatus.OK);}@GetMapping("/{id}")public ResponseEntity<User> getUserById(@PathVariable("id") Long id) {User user = userService.findById(id);if (user != null) {return new ResponseEntity<>(user, HttpStatus.OK);} else {return new ResponseEntity<>(HttpStatus.NOT_FOUND);}}@PostMappingpublic ResponseEntity<User> createUser(@RequestBody User user) {User createdUser = userService.create(user);return new ResponseEntity<>(createdUser, HttpStatus.CREATED);}@PutMapping("/{id}")public ResponseEntity<User> updateUser(@PathVariable("id") Long id, @RequestBody User updatedUser) {User user = userService.findById(id);if (user != null) {updatedUser.setId(id);userService.update(updatedUser);return new ResponseEntity<>(updatedUser, HttpStatus.OK);} else {return new ResponseEntity<>(HttpStatus.NOT_FOUND);}}@DeleteMapping("/{id}")public ResponseEntity<Void> deleteUser(@PathVariable("id") Long id) {userService.delete(id);return new ResponseEntity<>(HttpStatus.NO_CONTENT);}
}

六、运行与测试

运行应用：

$ mvn spring-boot:run

在浏览器或 REST 客户端（如 Postman）中测试 RESTful API：

获取所有用户：GET http://localhost:8080/users
根据 ID 查询用户：GET http://localhost:8080/users/{id}
创建用户：POST http://localhost:8080/users，请求体包含用户信息，例如：{"name": "张三", "age": 28}
更新用户：PUT http://localhost:8080/users/{id}，请求体包含更新后的用户信息
删除用户：DELETE http://localhost:8080/users/{id}