springCloud 接口开发和调用简化

介绍

随着微服务兴起，越来越多的项目使用微服务架构进行开发，SpringCloud是最流行的微服务开发组件集之一。但是和dubbo相比，使用SpringCloud 开发和调用接口 要麻烦很多，很多开发人员都希望能简化SpringCloud 开发和调用过程和步骤，easy_spring_cloud 就是用来简化SpringCloud 开发和调用过程的组件，使用easy_spring_cloud 服务开发者只需要在service接口用注解标记哪个方法对外开放，服务使用者只需要像使用本地spring bean一样把service @Autowired进来即可，大大简化了spring cloud 服务接口开发和调用步骤，有效的降低了spring cloud的使用和学习成本。

使用步骤

1、给启动类所在项目添加POM依赖

 <dependency>
    <groupId>com.fhs-opensource</groupId>
    <artifactId>easy-cloud-spring-boot-starter</artifactId>
    <version>1.0.0</version>
 </dependency>

2 需要将依赖的POJO和service放到单独的一个模块中，让服务提供者和消费者都可依赖到，service 接口代码如下：

@CloudApi(serviceName="producer")//producer 是服务提供者的服务名称
public interface UserService {

    @CloudMethod  //加此注解意思是此方法提供给其他微服务调用
    List<UserDto> listByIds(String[] ids);
}

此模块需要依赖：

 <dependency>
     <groupId>com.fhs-opensource</groupId>
     <artifactId>easy_cloud_anno</artifactId>
     <version>1.0.0</version>
 </dependency>

3 消费者 和提供者启动类添加 @EnableEasyCloud(basePackages = "com.fhs") 其中com.fhs 指的是service类的包，可以多个

4 在消费者需要调用userservice的地方直接@Autowired 即可

 @Autowired
 private UserService userService;

需要注意的点-一定要看完

1、如果参数或者返回值有泛型的情况下，或者嵌套层级过深，可能会有问题，这是Java编译机制和fastjson的问题
2、如果参数类型定义了map,反序列化后value的类型可能和你原来的类型不同，比如date 会变成日期字符串，所以map vallue只推荐使用字符串，数字，boolean类型传参，当然尽量不要用map
3、本插件消费者是通过restTemplate调用服务端接口，服务端接口路径为：/easyCloud/proxy/{serviceClass}/{methodName} 如果项目中用到了权限插件请放行
4、如果服务间调用希望加权限认证，可以自定义一个resttemplate，配合spring拦截器或者过滤器拦截/easyCloud/proxy开头请求实现认证

DEMO

easy_cloud_test: easy_cloud 测试

开源项目地址

easy_cloud: easy_cloud 用于简化springcloud 微服务接口开发和调用过程，只需要2个注解即可完成整个调用过程，适合小项目。