在微服务架构中，各个服务之间的通信是非常关键的一环。而RESTful API作为一种轻量级的、基于HTTP协议的通信方式，在微服务开发中得到了广泛的应用。在JDK17的环境下，我们可以更加高效地进行RESTful API的开发和调用。接下来，就让我们一起深入了解JDK17下RESTful API的开发和调用实战。

开发环境准备

在开始RESTful API的开发之前，我们需要准备好相应的开发环境。首先，你需要安装JDK17，可以从Oracle官方网站或者OpenJDK官网下载适合你操作系统的JDK17版本，并进行安装。安装完成后，配置好环境变量，确保在命令行中可以正常使用java -version命令查看JDK版本信息。

此外，我们还需要一个开发工具，这里推荐使用IntelliJ IDEA。它是一款功能强大的Java集成开发环境，提供了丰富的插件和工具，可以大大提高我们的开发效率。安装好IntelliJ IDEA后，创建一个新的Maven项目，在pom.xml文件中添加必要的依赖，例如Spring Boot相关的依赖，因为Spring Boot为RESTful API的开发提供了很多便利。

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

RESTful API的创建

创建控制器类

在Spring Boot中，我们可以通过创建控制器类来处理HTTP请求。下面是一个简单的示例：

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/api")
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, JDK17 RESTful API!";
    }
}

在这个示例中，我们创建了一个名为HelloController的控制器类，使用@RestController注解标记该类为RESTful控制器。@RequestMapping("/api")注解指定了该控制器处理的所有请求的基础路径。@GetMapping("/hello")注解表示该方法处理HTTP GET请求，请求路径为/api/hello。当客户端发送该请求时，方法会返回一个字符串"Hello, JDK17 RESTful API!"。

启动Spring Boot应用

创建好控制器类后，我们需要启动Spring Boot应用。在src/main/java目录下创建一个主类，例如Application.java：

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);
    }
}

运行main方法，Spring Boot应用会自动启动，并监听默认的端口（通常是8080）。

RESTful API的调用

使用Postman进行测试

Postman是一款常用的API测试工具，我们可以使用它来测试我们创建的RESTful API。打开Postman，创建一个新的请求，选择HTTP方法为GET，输入请求URLhttp://localhost:8080/api/hello，然后点击发送按钮。如果一切正常，你会在响应区域看到返回的字符串"Hello, JDK17 RESTful API!"。

使用Java代码进行调用

除了使用Postman，我们还可以使用Java代码来调用RESTful API。在JDK17中，我们可以使用HttpClient类来发送HTTP请求。下面是一个示例：

import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ApiClient {

    public static void main(String[] args) throws IOException, InterruptedException {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
               .uri(URI.create("http://localhost:8080/api/hello"))
               .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

在这个示例中，我们创建了一个HttpClient对象，然后使用HttpRequest.Builder构建一个HTTP请求，指定请求的URL。最后，使用client.send方法发送请求，并获取响应结果。

解决RESTful API调用中的跨域和性能问题

跨域问题

在实际开发中，我们经常会遇到跨域问题。跨域是指浏览器从一个域名的网页去请求另一个域名的资源时，由于浏览器的同源策略，会受到限制。在Spring Boot中，我们可以通过配置CorsFilter来解决跨域问题。

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;

@Configuration
public class CorsConfig {

    @Bean
    public CorsFilter corsFilter() {
        CorsConfiguration config = new CorsConfiguration();
        config.addAllowedOriginPattern("*");
        config.addAllowedHeader("*");
        config.addAllowedMethod("*");
        config.setAllowCredentials(true);

        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        source.registerCorsConfiguration("/**", config);

        return new CorsFilter(source);
    }
}

在这个配置类中，我们创建了一个CorsFilter对象，允许所有的来源、所有的请求头和所有的HTTP方法，并且允许携带凭证。

性能问题

为了提高RESTful API的性能，我们可以采取以下措施：

• 缓存机制：使用缓存可以减少对数据库或其他资源的频繁访问。在Spring Boot中，我们可以使用@Cacheable、@CachePut和@CacheEvict等注解来实现缓存功能。
• 异步处理：对于一些耗时的操作，我们可以使用异步处理来提高系统的并发性能。在Spring Boot中，我们可以使用@Async注解来实现异步方法。

总结

通过以上的学习，我们掌握了在JDK17环境下开发和调用RESTful API的方法，包括创建控制器类、启动Spring Boot应用、使用Postman和Java代码进行测试等。同时，我们也解决了RESTful API调用中的跨域和性能问题。掌握了JDK17下RESTful API的开发和调用内容后，下一节我们将深入学习JDK17在微服务安全方面的应用，进一步完善对本章JDK17与微服务开发主题的认知。

---

🍃 程序员JDK17修炼手册系列专栏导航

建议按系列顺序阅读，从基础到进阶逐步掌握JDK核心能力，避免遗漏关键知识点～

• 🔖 专栏目录：JDK17新特性

系列文章衔接

• 🔖 JDK5新特性

• 🔖 JDK8新特性

• 🔖 JDK11新特性

• 🔖 JDK21新特性

• 🍃 博客概览：《程序员技术成长导航，专栏汇总》