前提

两个客户端直接都需要注册到同一个网关

引入open Feign依赖

xml
<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-openfeign</artifactId>
</dependency>

配置服务接口

java

@Service
@FeignClient("rec-multiple-data-sources")
public interface dataSourcesSerive {
    @GetMapping("/collec/getArchiveDocumentListByInhospNo?inhospNo={No}")
    List<ViewArchiveDocumentsEntity> getArchiveDocumentListByInhospNo(@PathVariable("No") String inhospNo);
}

也可以增加fallback配置,可以避免连接失败导致的错误

java
@FeignClient(name = "haowee-robService", fallback = RobServiceClient.FallBack.class)
public interface RobServiceClient {
    @Component
    class FallBack implements RobServiceClient {
        @Override
        public Map<String, Object> submitRobTask(RobSubTaskReq req) {
            return null;
        }
    }
    @PostMapping("rob/submitRobTask")
    @ApiOperation("更改执行计划状态")
    Map<String, Object> submitRobTask(@RequestBody RobSubTaskReq req);
    
}

@FeignClient("这里面填想调用的服务名称")

启动类上开启feign


@EnableFeignClients

被调用方接口

java

@RequestMapping("/collec")
public class ExecutionCollectionController {
    @Resource
    private ExecutionCollectionService executionCollectionService;
    @GetMapping("/getArchiveDocumentListByInhospNo")
    public List<ViewArchiveDocumentsEntity> getArchiveDocumentListByInhospNo(@RequestParam("inhospNo") String inhospNo){
        return executionCollectionService.getArchiveDocumentListByInhospNo(inhospNo);
    }

方法请求参数注解

没有参数没有参数就很简单，只需要使用@GetMapping标识好请求路径就可以了。


    @GetMapping("/noParam}")
    public List<Order> noParam();

多个基础类型参数 Get 请求多个参数时，需要使用@RequestParam或者@PathVariable注解，这是因为在加载方法元数据的时候，如果该形参没有注解，默认会直接将其放在请求体中，这样GET 请求时就会报错。

而且注解中的value属性必须指定绑定的参数名，不然会报错RequestParam.value() was empty on parameter 0。案例：


    @GetMapping("insert")
    public List<Order> insertOrder(@RequestParam("accountId") Long accountId, @RequestParam("commodityCode") String commodityCode, @RequestParam("count") Long count, @RequestParam("money") Long money);

    @GetMapping("id/{id}")
    public List<Order> id(@PathVariable("id") String id);

集合数据参数在Spring MVC使用GET 请求传递集合参数时，需要这么写：


    @GetMapping("/noParam")
    public List<Order> noParam(@RequestParam(list) List<Long> list);

在请求时，URL 集合值使用逗号隔开：

http://localhost:9000/order/noParam?list=22,33,44

在使用Feign 调用时，直接调用就可以了，可以从日志看到，Feign 自动将集合类型的参数进行了解析拼接。

单个对象参数当Get 请求参数超过三个时，就需要进行查询参数封装为对象。

上面说到当参数没有注解时，就会放入到请求体中，但是@RequestParam不支持直接传递对象类，这时就需要使用@SpringQueryMap注解，它可以将对象属性及值，转为键值对拼接在URL 后面。


    @GetMapping("/get")
    public Order getOrder(@SpringQueryMap Order order);

多个对象参数多个对象参数时，只需要使用多个@SpringQueryMap即可：


    @GetMapping("/get")
    public Order getOrder(@SpringQueryMap Order order,@SpringQueryMap Account account);

多个对象参数加基本类型参数时，只需要添加对应的注解即可，需要注意实体类中的属性和这个基础类型参数名不能相同，不然拼接到URL中，两个同名参数传递过去就会覆盖了。


    @GetMapping("/get")
    public Order getOrder(@SpringQueryMap Order order,@RequestParam("accountId") Long accountId);

下载文件下载文件需要注意的是，应该返回二进制数据，还有GET 请求时，需要对URL进行编码，不然会报错编码不符合规范，其他没什么区别。


    @GetMapping("/download")
    public ResponseEntity<byte[]> download(@RequestParam("filePath") String filePath) ;

POST 请求案例 POST 请求一般用于数据提交到服务器，比如添加数据，上传文件等。

传递单个对象参数默认形参没有添加注解时，就会放入到请求体中，这个时候会使用编码器，将对象编码，并以Content-Type: application/json形式发送请求，所以只要注意在服务提供者中，添加@RequestBody注解，将请求体转为对象即可。


    @PostMapping("addOrder")
    public Order addOrder(@RequestBody Order order);

传递多个对象参数如果像下面这样使用两个@RequestBody，是会报错的：


    @PostMapping("addOrderAnd")
    public Order addOrderAnd(@RequestBody Order order,@RequestBody Account account);

这时候需要将两个对象封装在一个对象中，变成单个对象进行请求传递：


    @PostMapping("addOrderAnd")
    public Order addOrderAnd(@RequestBody AccountAndOrder accountAndOrder);

上传文件上传文件时，需要注意的是需要使用@RequestPart注解，Fiegn 会解析这个注解，标记为上传文件请求，还需要指定consumes为MULTIPART_FORM_DATA_VALUE，编码器会根据这个配置，将文件对象进行编码。


    @PostMapping(value = "/spring/upload",consumes = MediaType.MULTIPART_FORM_DATA_VALUE,produces =MediaType.APPLICATION_JSON_VALUE )
    @ResponseBody
    public Object springUpload(@RequestPart("file") MultipartFile file) ;

在调用方，上传文件时，则需要将文件对象转为MultipartFile。

一般不采用Feign 去上传文件，这种方式请求链路比较长，性能很低，一般都是前端直接上传到文件服务器，然后再告诉后台上传了哪个文件。


    @GetMapping("/insertOrder")
    public Object insertOrder() {
        File file = new File("E:\\javaPro\\prime-code-generator\\pom.xml");
        MultipartFile multipartFile =fileToMultipartFile(file);
        Object o = orderFeign.springUpload(multipartFile);
        return o;
    }

    public static MultipartFile fileToMultipartFile(File file) {
        String fieldName = "file";
        FileItemFactory factory = new DiskFileItemFactory(16, null);
        FileItem item = factory.createItem(fieldName, "multipart/form-data", true, file.getName());
        int bytesRead = 0;
        byte[] buffer = new byte[8192];
        try {
            FileInputStream fis = new FileInputStream(file);
            OutputStream os = item.getOutputStream();
            while ((bytesRead = fis.read(buffer, 0, 8192)) != -1) {
                os.write(buffer, 0, bytesRead);
            }
            os.close();
            fis.close();
        } catch (IOException e) {
            e.printStackTrace();
        }
        return new CommonsMultipartFile(item);
    }

目录

前提

引入open Feign依赖

配置服务接口

启动类上开启feign

被调用方接口

方法请求参数注解