OpenFeign-远程调用((Feign的使用方法))

最佳实践(Feign的使用方法)

最佳实践, 其实也就是经过历史的迭代, 在项⽬中的实践过程中, 总结出来的最好的使⽤⽅式.

通过观察, 我们也能看出来, Feign的客⼾端与服务提供者的controller代码⾮常相似.

Feign 客⼾端:

@FeignClient(value = "product-service", path = "/product")
public interface ProductApi {
 @RequestMapping("/{productId}")
 ProductInfo getProductById(@PathVariable("productId") Integer productId);
}

服务提供⽅Controller

@RequestMapping("/product")
@RestController
public class ProductController {
 @RequestMapping("/{productId}")
 public ProductInfo getProductById(@PathVariable("productId") Integer 
productId){
 //...
 }
}

有没有⼀种⽅法可以简化这种写法呢?

方案一:Feign 继承⽅式

官⽅推荐Feign的使⽤⽅式为继承的⽅式, 但是企业开发中, 更多是把Feign接⼝抽取为⼀个独⽴的模块

(做法和继承相似, 但理念不同).

操作⽅法:

将Feign的Client抽取为⼀个独⽴的模块, 并把涉及到的实体类等都放在这个模块中, 打成⼀个Jar. 服务

消费⽅只需要依赖该Jar包即可. 这种⽅式在企业中⽐较常⻅, Jar包通常由服务提供⽅来实现.

1.创建⼀个module:

2.引入依赖

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

3.编写接⼝

public interface ProductInterface {

    @RequestMapping("/{productId}")
    ProductInfo getProductInfo(@PathVariable("productId") Integer productId);

    @RequestMapping("/p1")
    String p1(@RequestParam("id") Integer id);

    @RequestMapping("/p2")
    String p2(@RequestParam("id") Integer id,@RequestParam("name") String name);

    @RequestMapping("/p3")
    String p3(@SpringQueryMap ProductInfo productInfo);

    @RequestMapping("/p4")
    String p4(@RequestBody ProductInfo productInfo);
}

相当于把ProductApi 和 ProductInfo 搬到 product-api 这个model里

4.打jar包

通过Maven打包

install:把当前工程打成 jar 包,放在maven本地仓库(不是远程仓库)

下面这个样子就代表打包成功,

我们在复制包的路径看是否存在

5.修改服务提供⽅代码

服务提供⽅实现接⼝ ProductInterface

@RestController
@RequestMapping("/product")
public class ProductController implements ProductInterface {

    @Autowired
    private ProductService productService;

    @RequestMapping("/{productId}")
    public ProductInfo getProductById(@PathVariable("productId") Integer productId){
        return productService.selectProductById(productId);
    }

    @RequestMapping("/p1")
    public String p1(Integer id){
        return "product-service 接收到的参数,id=" + id;
    }

    @RequestMapping("/p2")
    public String p2(Integer id,String name){
        return "product-service 接收到的参数,id=" + id + "name = " + name;
    }

    @RequestMapping("/p3")
    public String p3(ProductInfo productInfo){
        return "product-service 接收到的参数 productInfo =  " + productInfo.toString();
    }

    @RequestMapping("/p4")
    public String p4(@RequestBody ProductInfo productInfo){
        return  "product-service 接收到的参数 productInfo =  " + productInfo.toString();
    }

}

由于我们要是用ProductInterface这个接口,刚才已经把product-api这个model已经达成jar包了,我们就可以把jar包引入,从而就可以实现ProductInterface接口了。

ProductInfo这个实体类也是,product-api里已经存在这个实体类了,那么product-service里的就可以删除了。

使用快捷键,按住 alt + 回车(enter),可以快速引入我们需要的jar包。

成功引入我们刚才创建好的jar包。

6.修改服务消费⽅

服务消费⽅继承ProductInterface

@FeignClient(value = "product-service" , path = "/product")
public interface ProductApi extends ProductInterface {

}

7.测试

远程调⽤:127.0.0.1:8080/order/1

方案二:Feign 抽取⽅式(抽取的模块,通常是由服务的提供方来写)

官⽅推荐Feign的使⽤⽅式为继承的⽅式, 但是企业开发中, 更多是把Feign接⼝抽取为⼀个独⽴的模块

(做法和继承相似, 但理念不同).

继承:在使用的时候仍需要再声明一个 Feign 的接口(ProductApi)

操作⽅法:

将Feign的Client抽取为⼀个独⽴的模块, 并把涉及到的实体类等都放在这个模块中, 打成⼀个Jar. 服务

消费⽅只需要依赖该Jar包即可. 这种⽅式在企业中⽐较常⻅, Jar包通常由服务提供⽅来实现.

1.创建一个model

2.引入依赖

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

3.完成抽取

把order-service模块里的 ProductApi 和 ProductInfo 抽取到 product-api。

4.打包 install

通过Maven打包

install:把当前工程打成 jar 包,放在maven本地仓库(不是远程仓库)

下面这个样子就代表打包成功,

我们在复制包的路径看是否存在

5.服务调用方,引入抽取出来的模块(order-service)

  1. 删除 ProductApi, ProductInfo
  2. 引⼊依赖
        <dependency>
            <groupId>org.example</groupId>
            <artifactId>product-api</artifactId>
            <version>1.0-SNAPSHOT</version>
            <scope>compile</scope>
        </dependency>

修改项⽬中ProductApi, ProductInfo的路径为product-api中的路径

  1. 指定扫描类: ProductApi(最重要,必不可少)

由于我们进行了抽取,ProductApi就属于第三方的了,我们又需要依赖注入@Autowired ,而我们的扫描路径只能扫描启动类的同一级文件及子文件,所以为了能够成功注入ProductApi我们需要 在启动类添加扫描路径

@EnableFeignClients(basePackages = {"com.bite.api"})

完整代码

@EnableFeignClients(basePackages = {"com.bite.api"})
@SpringBootApplication
public class OrderServiceApplication {
	 public static void main(String[] args) {
		 SpringApplication.run(OrderServiceApplication.class, args);
	 }
}

或者也可以指定需要加载的Feign客⼾端(通过@EnableFeignClients(clients = {ProductApi.class}))


@EnableFeignClients(clients = {ProductApi.class})
@SpringBootApplication
public class OrderServiceApplication {
    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class,args);
    }
}

6.测试

远程调⽤:127.0.0.1:8080/order/1

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值