介绍

随着微服务兴起,越来越多的项目使用微服务架构进行开发,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个注解即可完成整个调用过程,适合小项目。