【远程调用框架】如何实现一个简单的RPC框架(三)优化一:利用动态代理改变用户服务调用方式

【如何实现一个简单的RPC框架】系列文章:

这篇博客,在(一)(二)的基础上,对第一版本实现的服务框架进行改善,不定期更新,每次更新都会增加一个优化的地方。

 

  • 1优化一利用动态代理改变用户服务调用方式
  • 1 目的
  • 2 方法
  • 3 使用

 



1、优化一:利用动态代理改变用户服务调用方式



1.1 目的

改变用户使用LCRPC进行服务调用的方式,使得用户像访问本地接口一样访问远程服务。 
在第一个版本的服务框架开发完成后,如果用户希望远程调用一个服务的某一个方法,为了得到正确结果,那么他必须要掌握的信息包括:方法的名称、方法的参数类型及个数、方法的返回值,以及服务发布者提供的二方包和LCRPC依赖。使用时,需要在spring配置文件中进行类似下面的配置:

<bean id="caculator" class="whu.edu.lcrpc.server.impl.LCRPCConsumerImpl">
    <property name="interfaceName" value="whu.edu.lcrpc.service.ICaculator" ></property>
    <property name="version" value="0.1"></property>
</bean>

假设我们要调用的服务对应的接口为:ICaculator;当我们想要调用这个接口的add方法时,需要调用LCRPCConsumerImpl提供的ServiceConsumer方法,该方法的签名为:

public Object serviceConsumer(String methodName, Object[] params)
  • 1

这意味着,用户在调用服务所有的方法时,都需要使用LCRPCConsumerImpl提供的ServiceConsumer方法,传入方法的名称,以及参数列表,并且在得到该函数的结果后显示将Object对象转换为该函数的返回类型。例如,希望调用这个接口的add方法:

List<Object> params = new ArrayList<>();
MyParamDO myParamDO = new MyParamDO();
myParamDO.setN1(1.0);
myParamDO.setN2(2.0);
params.add(myParamDO);
MyResultDO result = (MyResultDO) rpcConsumer.serviceConsumer("multiply",params);

这样的使用方式,看起来有些麻烦。那么是否可以在使用LCRPC依赖进行远程服务调用时与访问本地接口没有区别,用户在调用方法时,直接使用服务发布者提供的二方包,直接调用二方包中接口的方法,例如上面的程序是否可以改成:

MyParamDO myParamDO = new MyParamDO();
myParamDO.setN1(1.0);
myParamDO.setN2(2.0);
MyResultDO result = caculator.add(myParamDO);

caculator为ICaculator类型对象,Spring配置文件中的配置不变。

其实,使用动态代理的方式完全可以实现上述目的。



1.2 方法

方法:动态代理 
关于动态代理的知识读者可以自行查阅网上诸多资料,也可以阅读《疯狂Java讲义》第18章对动态代理的介绍。 
使用JDK为我们提供的Proxy和InvocationHandler创建动态代理。主要步骤包括: 
step 1. 实现接口InvocationHandler,实现方法invoke,执行代理对象所有方法执行时将会替换成执行此invoke方法,因此我们可以将真正的操作在该函数中实现(例如本服务框架中:拼装请求参数序列化后发送给服务端,得到结果后解析,即远程服务调用的过程)。 
step2. 利用Proxy的new ProxyInstance生成动态代理对象。例如:

InvocationHandler handler = new MyInvocationhandler(...);
Foo f = (Foo)Proxy.newProxyInstance(Foo.class.getClassLoader(),new Class[]{Foo.calss},hanlder);

此时,调用f的所有方法执行的均是handler中的invoke方法。

了解了实现动态代理的思路后,我们可以对我们自己编写的RPC服务框架进行改善了(第一个版本请参考博客【远程调用框架】如何实现一个简单的RPC框架(二)优化)。

  • step 1. 编写类MyinvocationHandler,实现接口InvocationHandler,且该实现类需要包括两个属性变量:interFaceName(所要代理的接口的全限定名)、version(服务版本号)。实现方法invoke,在该方法中获取方法的名称、参数列表,在此基础上拼装request请求对象,发送给服务端,接收响应,反序列化后返回。其实就是复用我们第一个版本中的代码。该类代码如下:
@Data
public class MyInvocationHandler implements InvocationHandler {

    private String interfaceName;//接口的全限定名
    private String version;//服务版本号
    private IConsumerService consumerService;//初始化客户端辅助类


    public MyInvocationHandler(String interfaceName, String version){
        this.interfaceName = interfaceName;
        this.version = version;
        consumerService = new ConsumerServiceImpl();
    }

    @Override
    public Object invoke(Object proxy, Method method, Object[] args) throws Throwable {
        //方法的名称
        String methodName = method.getName();
        //方法的返回类型
        Class returnType = method.getReturnType();

        //若服务唯一标识没有提供,则抛出异常
        if (interfaceName == null || interfaceName.length() == 0
                || version == null || version.length() == 0)
            throw new LCRPCServiceIDIsIllegal();
        //step1. 根据服务的唯一标识获取该服务的ip地址列表
        String serviceID = interfaceName + "_" + version;
        Set<String> ips = consumerService.getServiceIPsByID(serviceID);
        if (ips == null || ips.size() == 0)
            throw new LCRPCServiceNotFound();

        //step2. 路由,获取该服务的地址,路由的结果会返回至少一个地址,所以这里不需要抛出异常
        String serviceAddress = consumerService.getIP(serviceID,methodName,args,ips);

        //step3. 根据传入的参数,拼装Request对象,这里一定会返回一个合法的request对象,所以不需要抛出异常
        LCRPCRequestDO requestDO = consumerService.getRequestDO(interfaceName,version,methodName,args);

        //step3. 传入Request对象,序列化并传入服务端,拿到响应后,反序列化为object对象
        Object result = null;
        try {
            result = consumerService.sendData(serviceAddress,requestDO);
        }catch (Exception e){
            //在服务调用的过程种出现问题
            throw new LCRPCRemoteCallException(e.getMessage());
        }
        if (result == null)throw new LCRPCRemoteCallException(Constant.SERVICEUNKNOWNEXCEPTION);
        //step4. 返回object对象
        return result;
    }
}
  • step 2. 我们希望在使用时spring配置文件中的配置不变,依旧是(把bean的id值变了一下):
<bean id="caculator" class="whu.edu.lcrpc.server.impl.LCRPCConsumerImpl">
    <property name="interfaceName" value="whu.edu.lcrpc.service.ICaculator" ></property>
    <property name="version" value="0.1"></property>
</bean>

用户的使用方式如下:

@Resource
ICaculator caculator;
caculator.add(...)

那么此时我们如何将动态代理对象传给caculator,并且spring配置文件中bean的class值配置的是LCRPCCounsumerImpl,如何在spring生成bean的时候,生成的是响应接口的动态代理对象?而后将该动态代理对象传给caculator,使得用户可以直接调用caculator中的方法,而实际上是调用的动态代理中的方法。 
Spring的FactoryBean接口,帮我们实现了该要求。当某一个类实现了FactoryBean接口的时候,spring在创建该类型的bean时可以生成其他类型的对象返回。可以参考博客【Spring:FactoryBean接口】实现FactoryBean接口,Spring在初始化bean时有何不同。利用这一点,我们让LCRPCConsumerImpl实现FactoryBean接口,并在重写的getObject方法中生成相应接口的动态代理对象返回。修改后LCRPCConsumerImpl增加代码如下:

@Override
public Object getObject() throws Exception {
    //返回接口interfaceName的动态代理类
    return getProxy();
}

@Override
public Class<?> getObjectType() {
    try {
        return Class.forName(interfaceName).getClass();
    } catch (ClassNotFoundException e) {
        e.printStackTrace();
    }
    return null;
}

@Override
public boolean isSingleton() {
    return false;
}

private  Object getProxy() throws ClassNotFoundException {
    Class clz = Class.forName(interfaceName);
    return Proxy.newProxyInstance(clz.getClassLoader(),new Class[]{clz},new MyInvocationHandler(interfaceName,version));
}

getProxy方法利用Proxy和我们自己实现的MyInvocationHandler类返回了某个接口的动态代理对象。 
至此,我们在LCRPC服务框架部分的改造已经完成了。用户现在可以在客户端像调用本地接口一样,访问某一个远程服务了。关于具体的使用请参考1.3节内容。



1.3 使用

还是在上一版本客户端测试代码的基础上,我们还是要调用服务发布者发布的计算器服务。

  • (1)如果用户希望调用接口ICaculator对应的服务,则spring的配置文件如下:
<bean id="caculator" class="whu.edu.lcrpc.server.impl.LCRPCConsumerImpl">
    <property name="interfaceName" value="whu.edu.lcrpc.service.ICaculator" ></property>
    <property name="version" value="0.1"></property>
</bean>

class值为LCRPCConsumerImpl,但是spring返回的bean的类型为interfaceName属性对应接口的动态代理对象。

  • (2)ConsumerTest类修改为:
@Resource
ICaculator caculator;
public void add(){
    System.out.println("add:" + caculator.add(1,2));
}
public void minus(){
    System.out.println("minus:" + caculator.minus(1,2));
}
public void multiply(){
    MyParamDO p1 = new MyParamDO();
    p1.setN1(1);
    p1.setN2(2);
    System.out.println("multiply:" + caculator.multiply(p1));
}

public void divide(){
    MyParamDO p1 = new MyParamDO();
    p1.setN1(1);
    p1.setN2(2);
    System.out.println("divide:" + caculator.divide(p1));
}

此时可以发现,我们在调用远程服务的时候,完全就是利用服务发布者提供的二方包,调用其中的接口,跟本地调用完全没有差别。 
执行主类没有改变,运行后的结果如下,与第一版本相同。

ncclient rpc方法 rpc方式调用_java