目录
[1. 订单服务接口](#1. 订单服务接口)
[2. 商品服务接口](#2. 商品服务接口)
[三、使用 RestTemplate 调用商品服务](#三、使用 RestTemplate 调用商品服务)
[方式一:通过 Spring 注入 RestTemplate](#方式一:通过 Spring 注入 RestTemplate)
[方式二:直接 new RestTemplate](#方式二:直接 new RestTemplate)
一、背景
在一个购物平台中,订单服务和商品服务通常是两个独立部署的服务:
-
订单服务
order-service:负责订单数据,对外提供/order/{orderId}接口 -
商品服务
product-service:负责商品数据,对外提供/product/{id}接口
订单详情中需要展示商品信息,例如商品名称、价格、图片等。也就是说,OrderInfo 中会包含一个 ProductInfo:
java
@Data
public class OrderInfo {
private Integer id;
private Integer userId;
private Integer productId;
private Integer num;
private Integer price;
private Integer deleteFlag;
private Date createTime;
private Date updateTime;
private ProductInfo productInfo;
}
但是,订单服务和商品服务是两个独立服务,订单服务不能直接注入商品服务的 ProductService,也不能直接访问商品服务的数据库。订单服务要拿到商品信息,就需要通过网络调用商品服务提供的接口。
本文用一个最简单的例子,说明订单服务如何通过 RestTemplate 调用商品服务,并讨论这种写法存在的问题以及生产环境中的改进方向。
二、两个服务对外提供的接口
1. 订单服务接口
订单服务根据订单 ID 查询订单详情:
java
@RequestMapping("/order")
@RestController
public class OrderController {
@Autowired
private OrderService orderService;
@GetMapping("/{orderId}")
public OrderInfo getOrderById(@PathVariable("orderId") Integer orderId) {
return orderService.selectOrderById(orderId);
}
}
2. 商品服务接口
商品服务根据商品 ID 查询商品信息:
java
@RequestMapping("/product")
@RestController
public class ProductController {
@Autowired
private ProductService productService;
@GetMapping("/{id}")
public ProductInfo getProductById(@PathVariable("id") Integer id) {
return productService.selectProductById(id);
}
}
订单服务查询到订单后,发现订单中有 productId,于是需要再调用商品服务:
java
GET http://127.0.0.1:9090/product/{productId}
三、使用 RestTemplate 调用商品服务
RestTemplate 是 Spring 提供的 HTTP 客户端,可以用来发起 REST 请求。订单服务可以使用 RestTemplate#getForObject() 调用商品服务接口,并把返回的 JSON 转换成 ProductInfo 对象。
方式一:通过 Spring 注入 RestTemplate
推荐通过配置类创建 RestTemplate Bean,再由 Spring 注入使用。
java
@Configuration
public class RestTemplateConfig {
@Bean
public RestTemplate restTemplate() {
SimpleClientHttpRequestFactory factory = new SimpleClientHttpRequestFactory();
factory.setConnectTimeout(3000);
factory.setReadTimeout(5000);
return new RestTemplate(factory);
}
}
订单服务中注入并使用:
java
@Slf4j
@Service
public class OrderService {
@Autowired
private OrderMapper orderMapper;
@Autowired
private RestTemplate restTemplate;
public OrderInfo selectOrderById(Integer orderId) {
OrderInfo orderInfo = orderMapper.selectById(orderId);
String url = "http://127.0.0.1:9090/product/" + orderInfo.getProductId();
ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
orderInfo.setProductInfo(productInfo);
return orderInfo;
}
}
这样订单服务就通过 HTTP 调用了商品服务,并把商品信息组装进了订单详情。
方式二:直接 new RestTemplate
也可以直接创建 RestTemplate:
java
@Slf4j
@Service
public class OrderService {
@Autowired
private OrderMapper orderMapper;
public OrderInfo selectOrderById(Integer orderId) {
RestTemplate restTemplate = new RestTemplate();
OrderInfo orderInfo = orderMapper.selectById(orderId);
String url = "http://127.0.0.1:9090/product/" + orderInfo.getProductId();
ProductInfo productInfo = restTemplate.getForObject(url, ProductInfo.class);
orderInfo.setProductInfo(productInfo);
return orderInfo;
}
}
这种方式本地测试可以跑通,但不建议在正式项目中使用。原因包括:
-
每次调用都创建新对象,浪费资源
-
不受 Spring 管理
-
不方便统一配置超时、拦截器、日志和异常处理
-
后续接入服务发现、负载均衡时改造麻烦
所以更推荐通过 @Bean 注入 RestTemplate。
