随着互联网的普及和移动设备的广泛使用，Web 应用程序已经成为了现代软件开发的重要组成部分。而 RESTful API 已经成为了构建 Web 应用程序的标准方式之一。在这篇文章中，我们将介绍如何使用 Java 构建 RESTful API。
什么是 RESTful API？
REST，即 Representational State Transfer，是一种 Web 架构风格，其中实现了资源的统一标识、分布式系统中的连接、无状态和缓存等关键概念。RESTful API 是基于这种架构风格的设计 API 的方式。
在 RESTful API 中，我们使用 HTTP 协议定义资源和操作，并且使用 HTTP 方法（GET、POST、PUT、DELETE 等）执行这些操作。资源由 URL（Uniform Resource Locator）表示，而数据则以 JSON 或 XML 格式传输。
如何使用 Java 实现 RESTful API？
Java 是一个非常流行的编程语言，并且有很多框架可以用于构建 RESTful API。在本节中，我们将介绍使用 Spring Boot 和 Spring MVC 来构建 RESTful API。
准备工作
首先，我们需要安装 Java 和 Maven，并创建一个 Maven 项目。接下来，我们需要在 pom.xml 文件中添加以下依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>这将添加 Spring Boot 和 Spring MVC 依赖。
创建 Controller
我们可以使用 Spring MVC 的 @RestController 注解创建一个 Controller 类。该类将负责处理来自客户端的 HTTP 请求，并将响应发送回客户端。
以下是一个简单的 Controller 类：
@RestController
@RequestMapping("/api")
public class MyController {
@GetMapping("/hello")
public String hello() {
return "Hello, World!";
}
}在上面的代码中，我们使用了 @RestController 注解来标记该类为 Controller 类，并使用 @RequestMapping 注解来指定该 Controller 处理的 URL 前缀。@GetMapping 注解使用 HTTP GET 方法来处理 /api/hello 的请求，并返回一个字符串。
运行应用程序
现在，我们可以使用以下命令来运行应用程序：
mvn spring-boot:run
这将启动一个 Web 服务器，并将我们的应用程序部署到其中。接下来，我们就可以使用浏览器或者 HTTP 工具来访问我们的应用程序了。
例如，在浏览器中打开 http://localhost:8080/api/hello，我们将看到 Hello, World!。
处理参数
接下来，让我们看看如何处理参数。以下是一个示例，我们将接受一个参数并返回一个包含该参数的字符串。
@RestController
@RequestMapping("/api")
public class MyController {
@GetMapping("/hello")
public String hello(@RequestParam("name") String name) {
return "Hello, " + name + "!";
}
}在上面的代码中，我们添加了一个 @RequestParam 注解来接受名为 name 的参数。该参数的值将被保存在 name 变量中，并将用于构建响应字符串。
现在，我们可以使用以下 URL 来访问我们的应用程序：
http://localhost:8080/api/hello?name=John
这将返回一个包含 Hello, John! 的字符串。
使用 POST 方法
接下来，让我们看看如何使用 POST 方法来处理数据。以下是一个示例，我们将使用 POST 方法来创建一个用户，并将其保存到数据库中。
-- -------------------- ---- -------
---------------
-----------------------
------ ----- -------------- -
----------
------- -------------- ---------------
----------------------
------ ---- ----------------------- ---- ----- -
------ --------------------------
-
-在上面的代码中，我们使用了 @PostMapping 注解来处理 /api/users 的 POST 请求。该方法将一个以 JSON 格式发送的用户数据作为参数，并将其保存到数据库中。
使用 JWT 进行认证
最后，让我们看看如何使用 JWT 进行认证。JWT，即 JSON Web Token，是一种在不同系统之间安全传输信息的标准方式。
以下是一个示例，我们将使用 JWT 来保护我们的 RESTful API。
-- -------------------- ---- -------
---------------
-----------------------
------ ----- -------------- -
----------
------- -------------- ---------------
----------------------
------ ------ ------------------ ---- ----- ------------------- --------- -
---- ------ - ------------------------------------------------------------ --------------------
-- ------- -- ----- -
----------------------------------------------------
------ -------- -------- -- ----------
-
------ ----- - --------------
-------------------------------
---------------- -------
------------------ ------------------------------- - -- - -- - ------
----------------------------------- ---------
-----------
------ ------
-
-在上面的代码中，我们使用了 @PostMapping 注解来处理 /api/login 的 POST 请求。该方法将提供的用户名和密码与数据库中的记录进行比对。如果用户名和密码匹配，则返回一个由 JWT 签名的令牌。
现在，我们可以在我们的应用程序中使用这个令牌来保护受保护的资源。为了使用此令牌，我们只需要在请求的头部添加以下内容：
Authorization: Bearer {token}其中，{token} 是我们之前获得的 JWT 令牌。服务器将使用这个令牌来验证用户的身份，并授权他们访问受保护的资源。
总结
在本文中，我们介绍了如何使用 Java 和 Spring Boot 构建 RESTful API，并学习了如何处理 HTTP 请求和使用 JWT 进行身份验证。我们还提供了示例代码和说明，以便更好地理解这些概念。我希望这篇文章对你有所帮助，让你能够更好地理解 RESTful API 的本质，以及如何使用 Java 构建它们。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/64a2702948841e9894ecf817