action 提供接口化的使用方式 - ioGame21

[iohao]

我们先看一段代码，是逻辑服之间的交互，去另外一个逻辑服中找数据；

如果对逻辑服之间的交互不熟悉的，可以先看 逻辑服之间的交互-介绍文档 。

下面两个方法达到的效果是一样的

• invokeModuleMessageData1 使用了 3 行代码，从 Weather 逻辑服中取得一个结果。（后续称为方法1）
• invokeModuleMessageData2 使用了 1 行代码，从 Weather 逻辑服中取得一个结果。

从使用代码上看，无疑是第二种编码方式更加的优雅。让我们来看看第二种使用方式的代码是如何编写的吧！

public class DemoFightAction1 {
    public void invokeModuleMessageData1() {
        // 路由：这个路由是将要访问逻辑服的路由（表示你将要去的地方）
        CmdInfo todayWeatherCmd = CmdInfo.getCmdInfo(DemoCmdForWeather.cmd, DemoCmdForWeather.todayWeather);
        // 游戏逻辑服通讯上下文
        InvokeModuleContext invokeModuleContext = BrokerClientHelper.getInvokeModuleContext();
        // 根据路由信息来请求其他子服务器（其他逻辑服）的数据
        DemoWeatherMsg demoWeatherMsg1 = invokeModuleContext.invokeModuleMessageData(todayWeatherCmd, DemoWeatherMsg.class);

        log.info("demoWeatherMsg1 : {}", demoWeatherMsg1);
    }

    public void invokeModuleMessageData2() {

        /*
         * 单个逻辑服与单个逻辑服通信请求 - 有返回值（可跨进程）
         * action 接口化的写法
         */
        DemoWeatherMsg demoWeatherMsg2 = WeatherActionMapper.ME.invokeModuleMessageData();
        log.info("demoWeatherMsg2 : {}", demoWeatherMsg2);
    }
}

action 接口定义

我们将路由定义在了接口与接口的方法上；这样可以不必每次使用时，像【方法1】 那样显示的编写路由相关的信息了。

注意：只需要定义接口就能使用了，不需要编写接口的实现类！

/**
 * action 接口化
 * <pre>
 *     无需实现类，直接定义接口就可以使用。
 *     定义接口后，就能访问其他逻辑服的 action 了。
 * </pre>
 *
 * @author 渔民小镇
 * @date 2023-05-10
 */
@ActionController(DemoCmdForWeather.cmd)
public interface WeatherActionMapper {
    WeatherActionMapper ME = ActionMappers.getAction(WeatherActionMapper.class);

    @ActionMethod(DemoCmdForWeather.todayWeather)
    DemoWeatherMsg invokeModuleMessageData();
}

回调写法

来让我们看看回调的写法，下面两个方法也是等效的。

• asyncCallback1 使用了 7 行代码，从 Weather 逻辑服中取得一个回调结果。（后续称为方法1）
• asyncCallback2 使用了 3 行代码，从 Weather 逻辑服中取得一个回调结果。

public class DemoFightAction1 {
    public void asyncCallback1() {
        // 写在的写法
        CompletableFuture.supplyAsync(() -> {
            // 路由：这个路由是将要访问逻辑服的路由（表示你将要去的地方）
            CmdInfo todayWeatherCmd = CmdInfo.getCmdInfo(DemoCmdForWeather.cmd, DemoCmdForWeather.todayWeather);
            // 游戏逻辑服通讯上下文
            InvokeModuleContext invokeModuleContext = BrokerClientHelper.getInvokeModuleContext();
            // 根据路由信息来请求其他子服务器（其他逻辑服）的数据
            return invokeModuleContext.invokeModuleMessageData(todayWeatherCmd, DemoWeatherMsg.class);
        }).thenAccept(demoWeatherMsg -> {
            // 回调写法
            log.info("demoWeatherMsg : {}", demoWeatherMsg);
        });
    }

    public void asyncCallback2() {
        // 接口化的写法
        WeatherActionMapper.ME.invokeModuleMessageData(demoWeatherMsg -> {
            // 回调写法
            log.info("demoWeatherMsg : {}", demoWeatherMsg);
        });
    }
}

action 接口定义

此时，action 接口增加了一个回调的方法。

注意：只需要定义接口就能使用了，不需要编写接口的实现类！

@ActionController(DemoCmdForWeather.cmd)
public interface WeatherActionMapper {
    WeatherActionMapper ME = ActionMappers.getAction(WeatherActionMapper.class);

    @ActionMethod(DemoCmdForWeather.todayWeather)
    DemoWeatherMsg invokeModuleMessageData();

    @ActionMethod(DemoCmdForWeather.todayWeather)
    void invokeModuleMessageData(Consumer<?> consumer);
}

小结

action 接口化的优点挺多，除了以上这些，你知道具体还有哪些优点吗 🍄

会在接口中提供多种类的通讯使用方式，如下图

将考虑加入 ioGame21 ，即下个大版本中！