小白教你用Feign

跨服务调用

建议了解：ribbon、feign。不了解也可以用,看下面的即可
跨服务调用：

1. 服务提供者：提供接口，供其他服务（也就是服务消费者）调用
2. 服务消费者：调用服务提供者提供的接口

1、服务提供者

1.1、编写需要调用的服务

和平常写的Controller中的方法一样。例如下面我写了一个Controller方法

/***
 * 根据条件(条件具有唯一性)查询一条信息
 */
@GetMapping("getOnePart")
public PartDTO getPartByCondition(@RequestParam Map<String, Object> params){
    return partService.selectOne(params);
}

1.2、暴露接口

编写步骤如下：

1. 编写FeignClient，其他服务通过这个来调用接口
2. 编写FeignClientFallBack，当接口堵塞，会从这个里面返回设定的默认值

【1】、编写FeignClient

/*
 * @FeignClient(name = "xxx-xxxx-server", fallback = XXXXFeignClientFallBack.class) 
 *   - name 属性指定为服务名称，这个在yml中有定义
 *   - fallback 属性指定当接口堵塞，会从这个里面返回设定的默认值
*/
@FeignClient(name = "dms-parts-server", fallback = XXXXFeignClientFallBack.class)
public interface XXXXXFeignClient {
    /**
     * 根据条件(条件具有唯一性)查询一条备件信息
     */
    /*
     *  @GetMapping("parts/part/getOnePart")
     *     - "parts/part/getOnePart" 为请求全URL：类的@RequestMapping + 方法上的Mapping
     *	   - 方法与调用接口的方法建议一致
    */
    @GetMapping("parts/part/getOnePart")
    public PartDTO getPartByCondition(@RequestParam Map<String, Object> params);
}

【2】、编写FeignClientFallBack

/*
 *  这里实现 FeignClient 方法即可，我返回的为null，也可以返回更为友好的提示
*/
public class XXXXFeignClientFallBack implements PartsFeignClient {
    @Override
    public PartDTO getPartByCondition(Map<String, Object> params) {
        return null;
    }
}

2、服务消费者

【1】直接调用，例如：XXServiceImpl 中调用上面接口，其他代码所有省略，只有重点

• 将 上面FeignClient 的注入进来
• 通过FeignClient 实例调用上面的方法

@Service
public class XXServiceImpl implements XXService {
    @Autowired
    private XXXXXFeignClient xxFeignClient;
    
    @Override
    @Transactional(rollbackFor = Exception.class)
    public void save(XXXForm form) {
         需要 跨服务
        Map<String, Object> map = new HashMap<String, Object>();
        map.put("partNo", "ZS19070601_CM0001");
        PartDTO partDTO = xxFeignClient.getPartByCondition(map);
    }
}

3、坑，注意事项

【1】，将需要调用的接口引入 pom.xml 文件中，不让就会在类中引入不了FeignClient （也就是找不到）。例如我上面是用的【xxx-xxxx-server】，就需要将其引入。

<dependency>
    <groupId>cn.wl.cs</groupId>
    <artifactId>xxx-xxxx-server</artifactId>
    <version>0.0.1-SNAPSHOT</version>
</dependency>

【2】、在启动类中加入 @EnableFeignClients(basePackages = {“cn.wl.cs”}) 注解。启用feign客户端，否则在调用接口时，会报错404，找不到服务。例如我需要调用接口的是XXXXApplication

@SpringBootApplication(exclude = HibernateJpaAutoConfiguration.class)
@ComponentScan(basePackages = {"cn.wl.cs.*"})
// 这里就是声明的
@EnableFeignClients(basePackages = {"cn.wl.cs"})
@EnableEurekaClient
public class XXXXApplication {
    public static void main(String[] args) {
        SpringApplication.run(XXXXApplication .class, args);
    }
}