Spring Cloud 之 Feign Client优雅调用（七）

上一篇讲了Feign Client调用，但是不够优雅，一个互联网公司往往有几十个，甚至上百个微服务，如果都通过下面的方式调用，我们可能要封装上千个接口。而且服务提供者升级接口时，消费端也要修改代码。那么有没有这样一种方式，服务提供者提供一个API包出来，消费者只需要引入这个API包，就能像Dubbo调用本地服务一样便捷呢。当然。。。

/**
 * @author Leo
 */
@FeignClient(value = "x-demo-service")
public interface FeignClientDemoService {

    @RequestMapping(value = "demo/service", method = RequestMethod.GET)
    String service();
}

1、新建一个module名称为x-demo-service-api的模块

2、定义接口类

@RequestMapping("demo-api")
public interface ServiceDemoApi {

    @PostMapping("sayHello")
    BaseResponse sayHello(@RequestBody BaseRequest request);
}

BaseRequest类

/**
 * @author Leo
 */
@Data
public class BaseRequest<T> implements Serializable {
    private String uuid;

    private T data;
}

BaseResponse类

/**
 * @author Leo
 */
@Data
public class BaseResponse<T> implements Serializable {
    private String code;

    private String message;

    private T data;
}

3、因为x-demo-service-api只是一个接口定义服务，供服务提供者和服务消费者依赖使用，所以x-demo-service-api没有启动类，也没有任何配置，到此x-demo-service-api就已经OK了

4、x-demo-service提供者改造

首先修改gradle配置文件，增加对x-demo-service-api依赖

dependencies {
    compile project(":x-demo-service-api")

    compile("org.springframework.cloud:spring-cloud-starter-netflix-eureka-client")
}

新建一个Controller，该Controller要实现我们在x-demo-service-api中定义的ServiceDemoApi接口

/**
 * @author Leo
 */
@RestController
@Slf4j
public class DemoApiProviderController implements ServiceDemoApi {

    @Value("${server.port}")
    String port;

    @Override
    public BaseResponse sayHello(BaseRequest request) {
        BaseResponse response = new BaseResponse();
        response.setCode("0000");
        response.setMessage("success");
        response.setData("ServiceDemoApi: " + port);
        return response;
    }
}

5、x-demo-service-feign服务消费者改造

同样gradle配置文件增加对x-demo-service-api的依赖

dependencies {
    compile project(":x-demo-service-api")

    compile("org.springframework.cloud:spring-cloud-starter-netflix-eureka-client")
    compile("org.springframework.cloud:spring-cloud-starter-openfeign")6 }

然后新建一个DemoApiClient接口，该接口继承我们在x-demo-service-api中定义的ServiceDemoApi接口，并为其加上注解@FeignClient(value = "x-demo-service")

@FeignClient(value = "x-demo-service")
public interface DemoApiClient extends ServiceDemoApi {

}

新建一个Controller类DemoApiConsumerController，第5行注入DemoApiClient接口，第11行就行调用本地方法一样调用远程服务。

@RestController
@RequestMapping("feign/api")
public class DemoApiConsumerController {
    @Autowired
    private DemoApiClient demoApiClient;

    @RequestMapping(value = "service", method = RequestMethod.GET)
    public BaseResponse service() {
        BaseRequest request = new BaseRequest();
        request.setUuid("123");
        return demoApiClient.sayHello(request);
    }
}

6、验证

x-demo-service和x-demo-service-feign改造完成，我们依次重启。在浏览器中输入：http://localhost:8092/feign/api/service，观察返回报文。

至此， x-demo-service-api演示结束，以后别人再找我们对接接口，你就可以把x-demo-service-api打成jar包傲慢的丢给他，让他自己去调用吧。等等好像差点什么，接口文档怎么办？下一篇再写接口文档吧。。。。。。