Java Spring Boot 写 API 接口_创建一个springboot项目写一个简单测试接口

先自我介绍一下,小编浙江大学毕业,去过华为、字节跳动等大厂,目前阿里P7

深知大多数程序员,想要提升技能,往往是自己摸索成长,但自己不成体系的自学效果低效又漫长,而且极易碰到天花板技术停滞不前!

因此收集整理了一份《2024年最新软件测试全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友。
img
img
img
img
img

既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上软件测试知识点,真正体系化!

由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新

如果你需要这些资料,可以添加V获取:vip1024b (备注软件测试)
img

正文

}

@PostMapping(“/users”)
public User createUser(@RequestBody User user) {
// 保存用户到数据库
// …

return user;
}
}

在上面的示例中,我们定义了两个 API 接口:

  • GET /api/hello:当客户端发送 GET 请求时,Controller 将返回字符串 “Hello, Spring Boot!”。
  • POST /api/users:当客户端发送 POST 请求时,Controller 将接收一个 User 对象,并将其保存到数据库中。最后,Controller 将返回保存的 User 对象。

第三步:创建实体类

如果 API 需要处理和返回数据对象,可以创建一个实体类来表示数据模型。实体类通常与数据库表相对应,并且可以使用 ORM 工具(如 Hibernate)来映射到数据库。在实体类上使用 @Entity 注解,以表示该类是一个数据库实体。使用 @Id 和 @GeneratedValue 注解来定义实体的主键。

示例代码:

import javax.persistence.*;

@Entity
@Table(name = “users”)
public class User {

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

private String name;

// 省略getter和setter方法
}

在上面的示例中,我们定义了一个名为 User 的实体类。它有一个 id 属性和一个 name 属性。id 属性用于标识 User 对象的唯一性,并使用 @GeneratedValue 注解指定自动生成主键。name 属性是一个字符串类型的属性,用于存储 User 的名称。

第四步:运行应用程序

现在,我们已经创建了一个简单的 Spring Boot 应用程序,其中包含一个 API 接口和一个实体类。我们可以启动应用程序,并访问 API 的 URL 路径来测试 API 接口。

启动应用程序:

$ mvn spring-boot:run

测试 API 接口:

$ curl http://localhost:8080/api/hello
Hello, Spring Boot!

$ curl -X POST -H “Content-Type: application/json”
-d ‘{“name”: “Alice”}’ http://localhost:8080/api/users
{“id”: 1, “name”: “Alice”}

在上面的示例中,我们使用 cURL 工具来测试 API 接口。通过 GET 请求 /api/hello 接口,我们得到了 “Hello, Spring Boot!” 的响应。通过 POST 请求 /api/users 接口,我们创建了一个名为 Alice 的 User 对象,并得到了新创建的 User 对象的响应。

案例

案例一:用户管理系统

假设我们要构建一个用户管理系统,可以实现用户的创建、查询、更新和删除操作。我们可以使用 Java Spring Boot 来构建这个系统的 API 接口。

  1. 创建 User 实体类:

@Entity
@Table(name = “users”)
public class User {

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

private String username;
private String email;

// 省略getter和setter方法
}

  1. 创建 UserController:

@RestController
@RequestMapping(“/api/users”)
public class UserController {

@Autowired
private UserRepository userRepository;

@GetMapping
public List getUsers() {
return userRepository.findAll();
}

@GetMapping(“/{id}”)
public User getUserById(@PathVariable Long id) {
return userRepository.findById(id)
.orElseThrow(() -> new NotFoundException(“User not found”));
}

@PostMapping
public User createUser(@RequestBody User user) {
return userRepository.save(user);
}

@PutMapping(“/{id}”)
public User updateUser(@PathVariable Long id, @RequestBody User updatedUser) {
User user = userRepository.findById(id)
.orElseThrow(() -> new NotFoundException(“User not found”));

user.setUsername(updatedUser.getUsername());
user.setEmail(updatedUser.getEmail());

return userRepository.save(user);
}

@DeleteMapping(“/{id}”)
public void deleteUser(@PathVariable Long id) {
userRepository.deleteById(id);
}
}

  1. 创建 UserRepository:

@Repository
public interface UserRepository extends JpaRepository<User, Long> {
}

案例二:订单管理系统

假设我们要构建一个订单管理系统,可以实现订单的创建、查询、更新和删除操作。我们可以使用 Java Spring Boot 来构建这个系统的 API 接口。

  1. 创建 Order 实体类:

@Entity
@Table(name = “orders”)
public class Order {

@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;

private String orderNumber;
private String customerName;

// 省略getter和setter方法
}

  1. 创建 OrderController:

@RestController
@RequestMapping(“/api/orders”)
public class OrderController {

@Autowired
private OrderRepository orderRepository;

@GetMapping
public List getOrders() {
return orderRepository.findAll();
}

@GetMapping(“/{id}”)
public Order getOrderById(@PathVariable Long id) {
return orderRepository.findById(id)
.orElseThrow(() -> new NotFoundException(“Order not found”));
}

@PostMapping
public Order createOrder(@RequestBody Order order) {
return orderRepository.save(order);
}

@PutMapping(“/{id}”)
public Order updateOrder(@PathVariable Long id, @RequestBody Order updatedOrder) {
Order order = orderRepository.findById(id)
.orElseThrow(() -> new NotFoundException(“Order not found”));

order.setOrderNumber(updatedOrder.getOrderNumber());
order.setCustomerName(updatedOrder.getCustomerName());

return orderRepository.save(order);
}

@DeleteMapping(“/{id}”)
public void deleteOrder(@PathVariable Long id) {
orderRepository.deleteById(id);
}
}

  1. 创建 OrderRepository:

网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。

需要这份系统化的资料的朋友,可以添加V获取:vip1024b (备注软件测试)
img

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
erRepository:

网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。

需要这份系统化的资料的朋友,可以添加V获取:vip1024b (备注软件测试)
[外链图片转存中…(img-b5E7fomP-1713136245616)]

一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!

<think>好的,用户想学习如何使用Spring Boot构建RESTful API的示例教程。我需要根据提供的引用内容来整理一个清晰的步骤指南。 首先,我要确认用户提供的引用内容。引用1、2、3、4都提到了Spring Boot创建RESTful API的关键点,包括项目配置、依赖管理、应用启动、控制器编API测试。需要将这些信息整合成一步步的教程。 第一步应该是创建项目,这里需要提到使用Spring Initializr,并添加Web依赖,引用4提到需要引入Spring Boot的Web依赖,这应该在Maven或Gradle中配置。所以需要详细说明如何通过Spring Initializr选择依赖,或者手动添加依赖。 接下来是项目结构说明,用户可能对标准的Spring Boot项目结构不太熟悉,需要简要说明主应用类的位置,以及控制器应该放在哪里。引用3中的代码示例显示主类在cn.juwatech.springbootrest包下,所以可能需要建议用户创建类似的包结构。 然后,编REST控制器。需要创建一个带有@RestController注解的类,并定义处理HTTP请求的方法,比如@GetMapping、@PostMapping等。引用3提到了测试API的部分,可能需要示例代码来展示如何返回字符串或对象。 接下来是启动应用,引用3中的主类代码可以作为示例,说明如何运行应用,并检查端口是否被占用。 然后是测试API,可以使用curl或Postman,引用3中提到了测试API的步骤,这里需要给出具体的测试命令,比如访问localhost:8080/api/hello,并预期返回结果。 最后,可能需要补充一些进阶内容,比如添加数据库支持或异常处理,但根据引用内容,现有的信息已经覆盖了基础步骤。需要确保每个步骤都参考了提供的引用,并在适当的位置添加引用标识。 检查是否有遗漏的步骤,比如依赖管理部分,引用4提到在Maven或Gradle中添加Web依赖,所以需要在第一步中详细说明pom.xml或build.gradle的配置。 另外,代码示例需要正确格式化,比如Java的代码块使用三个反引号,并指定语言类型。确保所有代码示例正确,没有语法错误。 最后,生成相关问题,需要围绕Spring Boot和RESTful API的常见问题,比如依赖作用、处理POST请求、整合数据库、异常处理等,参考示例中的问题形式。 总结步骤:创建项目→配置依赖→项目结构→编控制器→启动应用→测试API→进阶建议。每个步骤引用对应的引用来源,并正确标注引用标识。</think>### 分步教程:使用 Spring Boot 构建 RESTful API #### 1. **创建 Spring Boot 项目** - 使用 **Spring Initializr**(在线工具或IDE集成)生成项目骨架。 - 添加 **Spring Web 依赖**(关键依赖,支持 RESTful API 开发)[^4]。 - 示例 Maven 依赖配置: ```xml <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> ``` #### 2. **编主启动类** - 主类需添加 `@SpringBootApplication` 注解,并调用 `SpringApplication.run()`。 - 示例代码: ```java @SpringBootApplication public class SpringBootRestApplication { public static void main(String[] args) { SpringApplication.run(SpringBootRestApplication.class, args); } } ``` [^3] #### 3. **创建 REST 控制器** - 新建类并添加 `@RestController` 注解。 - 使用 `@GetMapping`、`@PostMapping` 等注解定义 API 端点。 - 示例返回简单字符串的接口: ```java @RestController @RequestMapping("/api") public class HelloController { @GetMapping("/hello") public String hello() { return "Hello, Spring Boot!"; } } ``` #### 4. **运行与验证** - 启动应用(确保端口未被占用,默认 `8080`)[^3]。 - 使用工具测试 API: - **Curl 命令**: ```bash curl http://localhost:8080/api/hello ``` - **Postman**:发送 GET 请求到上述地址,预期返回 `Hello, Spring Boot!`。 #### 5. **进阶功能扩展** - **数据库整合**:添加 `spring-boot-starter-data-jpa` 和数据库驱动依赖,定义实体类与 Repository 接口。 - **异常处理**:使用 `@ControllerAdvice` 全局捕获异常,返回统一错误格式。 - **请求体处理**:通过 `@RequestBody` 接收 JSON 数据,示例: ```java @PostMapping("/user") public User createUser(@RequestBody User user) { return userService.save(user); } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值