这是一个简单的Spring Boot的RestTemplate
客户端,用于执行HTTP请求。
首先,这个类被@Component
注解标记,这意味着它是一个Spring组件,Spring的依赖注入框架会自动创建并管理这个类的实例。
类声明
public class ApiClient {
成员变量
private final RestTemplate restTemplate;
RestTemplate是Spring提供的一个HTTP客户端,用于发送HTTP请求。
final`关键字表示这个成员变量一旦在构造函数中被赋值后,就不能再被修改。
无参构造函数
public ApiClient() {
restTemplate = new RestTemplate();
}
这个无参构造函数是创建一个新的ApiClient
实例的方式。它创建一个新的RestTemplate
实例并将其赋值给restTemplate
成员变量。
公共方法
public <T> T executeRequest(String url, HttpMethod method, Class<T> responseType) {
ResponseEntity<T> response = restTemplate.exchange(url, method, null, responseType);
return response.getBody();
}
这个方法是执行HTTP请求的主要方法。它接受一个URL、一个HTTP方法(GET、POST、PUT等)、以及一个表示预期响应类型的类,然后使用RestTemplate
发送HTTP请求并返回响应的主体。这个方法是泛型的,所以它可以处理任意类型的响应。
在内部,RestTemplate.exchange()
方法使用给定的URL、HTTP方法、实体(在这个例子中是null,因为没有要发送的实体)、以及响应类型来发送HTTP请求。这个方法返回一个ResponseEntity
对象,该对象包含HTTP响应的状态码、头信息和主体。
然后,这个方法返回ResponseEntity.getBody()
,这是响应的主体部分。因为executeRequest()
方法是泛型的,所以返回的主体会是正确的类型(由responseType
参数指定)。
这是一个使用Spring框架的Java类,名为ApiService
。这个类用于通过API与远程服务器进行交互。
类声明
public class ApiService {
这是类的基本声明,表明这是一个公开的类,可以在其他类中继承和引用。
成员变量
private final ApiClient apiClient;
这是一个私有常量成员变量,类型为ApiClient
。这个变量是ApiService
类使用的主要工具,用于执行API请求。final
关键字表示这个变量一旦初始化就不能再改变。
构造函数
@Autowired
public ApiService(ApiClient apiClient) {
this.apiClient = apiClient;
}
这是ApiService
的构造函数,它接受一个ApiClient
类型的参数。@Autowired
注解表示这个构造函数将自动被Spring框架调用,以注入一个已经初始化的ApiClient
实例。这个实例将被赋值给上面的成员变量。
公共方法
以下是两个公共方法:
getDataFromApi(String url, Class responseType)
: 此方法使用GET方法从指定的URL获取数据,并根据响应类型返回结果。它通过调用ApiClient
的executeRequest
方法实现这一点。postDataToApi(String url, Object requestBody, Class responseType)
: 此方法使用POST方法向指定的URL发送给定的请求体,并根据响应类型返回结果。它也通过调用ApiClient
的executeRequest
方法实现这一点。这两个方法都是泛型的,因此可以处理任何类型的响应,这使得代码更加灵活和可重用。
总的来说,这个ApiService
类是一个用于处理API请求的封装器,它简化了对API的使用,并确保所有请求都以一致的方式处理。
这是一个Spring Boot的控制器类,用于处理特定的HTTP请求。让我们详细解释一下每行代码的作用。
类声明
@RestController
这是Spring的@RestController
注解,它表明这个类将处理HTTP请求并直接返回HTTP响应,而不是通过页面渲染。
@RequestMapping("/hello")
这是@RequestMapping
注解的一个应用,它指定了处理请求时的基本URL路径。在这种情况下,所有的请求都会有一个"/hello"的前缀。
成员变量
@Autowired
private ApiService apiService;
这是Spring的@Autowired
注解,它告诉Spring自动装配这个成员变量。也就是说,Spring会查找一个名为ApiService
的bean,并将其自动赋值给这个成员变量。
方法
@GetMapping("/api")
这是@GetMapping
注解,它表示这个方法将处理GET请求,并且请求的URL需要包含"/api"。
public String callApi(@RequestParam String number) {
这是方法的签名。callApi
是方法名,接受一个参数number
,该参数通过@RequestParam
注解进行标注,表示这个参数是从HTTP请求的参数中获取的。在这种情况下,HTTP请求需要包含一个名为"number"的参数。
String url = "https://tools.mgtv100.com/external/v1/logistics/query?no="+number;
这行代码创建了一个URL字符串,该字符串将从"number"参数获取值,并附加到URL的末尾。
return apiService.getDataFromApi(url,String.class);
这行代码调用ApiService
的getDataFromApi
方法,使用上面创建的URL和String.class作为参数。该方法将发送一个GET请求到这个URL,并返回响应的主体。然后,这个主体被返回给HTTP请求。
总的来说,这个控制器类的主要功能是接收包含特定参数"number"的GET请求,然后使用这个参数构造一个URL,并通过这个URL发送一个GET请求。然后返回响应的主体。
import org.springframework.http.HttpMethod;
import org.springframework.http.ResponseEntity;
import org.springframework.stereotype.Component;
import org.springframework.web.client.RestTemplate;
@Component
public class ApiClient {
private final RestTemplate restTemplate;
public ApiClient() {
restTemplate = new RestTemplate();
}
public <T> T executeRequest(String url, HttpMethod method, Class<T> responseType) {
ResponseEntity<T> response = restTemplate.exchange(url, method, null, responseType);
return response.getBody();
}
}
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpMethod;
import org.springframework.stereotype.Service;
@Service
public class ApiService {
private final ApiClient apiClient;
@Autowired
public ApiService(ApiClient apiClient) {
this.apiClient = apiClient;
}
public <T> T getDataFromApi(String url, Class<T> responseType) {
return apiClient.executeRequest(url, HttpMethod.GET, responseType);
}
public <T> T postDataToApi(String url, Object requestBody, Class<T> responseType) {
return apiClient.executeRequest(url, HttpMethod.POST, responseType);
}
}
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/hello")
public class HomeController {
@Autowired
private ApiService apiService;
@GetMapping("/api")
public String callApi(@RequestParam String number) {
String url = "https://tools.mgtv100.com/external/v1/logistics/query?no="+number;
return apiService.getDataFromApi(url,String.class);
}
}