在实际开发中，会有一些基础类型的业务参数，比如需要经常用到下面类似的，如：通过 装备-衣服-id 得到衣服装备详细、通过 装备-头盔-id 得到头盔装备详细、通过 xx-id 得到xx数据 等。

这些参数基本都是相同的，如果每一个类似这样的请求都创建一个数据协议，会产生比较多的碎片协议，如

对于这种情况，业务框架将提供一些较好的支持；首先，业务框架会提供一个通用的 pb 类型，如下

在代码中的使用，如下伪代码

由于是业务参数基础包装类型-int，实际上我们还可以这样使用，下面这种用法与上面是等价的。这种实际上就是有点像是 java 基础类型的自动装箱和拆箱

框架支持的自动装箱、拆箱基础类型如下

由于 bolt 处理业务时是多线程的，当多个逻辑服同时修改一个共享的数据逻辑服，会有并发问题；对于这种情况有两种处理方式

1. 使用 synchronized 关键字 加锁
2. 使用其他的并发框架，做无锁化编程

这里推荐使用 Disruptor 并发框架来做线程的编排，这样可以做到无锁化编程。框架内提供了一个 Disruptor 相关的模块 light-domain-event 领域事件，开发者可按需选择；

在框架中，给逻辑服编排业务线程是很简单的事、而且足够的灵活。

下面是一个游戏逻辑服编排业务线程的示例

public class WrapperLogicServer extends AbstractBrokerClientStartup {
    ... ... 省略部份代码
    
    @Override
    public BrokerClientBuilder createBrokerClientBuilder() {
        // bolt 业务处理器的钩子管理器
        ClientProcessorHooks hooks = getClientProcessorHooks();

        BrokerClientBuilder builder = BrokerClient.newBuilder();
        builder
                .appName("业务参数自动装箱和拆箱-逻辑服")
                // 设置 bolt 业务处理器的钩子管理器
                .clientProcessorHooks(hooks)
        ;
        
        return builder;
    }

    private ClientProcessorHooks getClientProcessorHooks() {
        // bolt 业务处理器的钩子管理器
        ClientProcessorHooks hooks = new ClientProcessorHooks();

        // 设置逻辑服业务处理钩子接口
        hooks.setRequestMessageClientProcessorHook((barSkeleton, flowContext) -> {

            // 这里做线程编排相关的逻辑

            CmdInfo cmdInfo = flowContext.getCmdInfo();
            // 得到当前请求路由
            int cmdMerge = cmdInfo.getCmdMerge();
            // 如果是这个路由，就给到其他并发框架
            if (cmdMerge == CmdKit.merge(14, 10)) {
                // 注意，这里是伪代码；
                // 开发者放到 disruptor 或其他并发框架中执行，这样可以做到无锁化编程。
                barSkeleton.handle(flowContext);
                return;
            }

            // 默认正常执行
            barSkeleton.handle(flowContext);
        });

        return hooks;
    }
}

• 国内首个基于蚂蚁金服 SOFABolt 的 java 网络游戏服务器框架；无锁异步化、事件驱动的架构设计；
• 通过 ioGame 可以很容易的搭建出一个集群无中心节点、分步式的网络游戏服务器！
• 轻量级、更节约、更简单、开箱即用、无配置文件、启动快、超高性能
• 业务框架平均每秒可以执行 1152 万次业务逻辑
• 对webMVC开发者友好
• 代码即文档

ioGame 是一个由 java 语言编写的网络游戏服务器框架。支持 websocket、tcp ，适用于全球同服、回合制游戏、策略游戏、即时战斗等游戏服务器的开发。具有高性能、稳定、易用易扩展、超好编程体验等特点。可做为 H5、手游、端游的 java 游戏服务器。

ioGame 是轻量级的网络游戏服务器框架，在使用 ioGame 时，无需安装其他服务，如： Nginx、Redis、MQ、Mysql、ZooKeeper、Protobuf协议编译工具 ... ...等。简单点说，就是无需安装其他产品就能使用；这意味着在使用上简单了，在部署上也为企业节约了成本。

通过 ioGame 你可以很容易的搭建出一个稳定、高性能、集群无中心节点、分步式、自带负载均衡、跨进程通信、避免类爆炸设计的网络游戏服务器。游戏框架借助于蚂蚁金服 sofa-bolt 通信框架来提供通信方面的稳定与高性能。

在 ioGame 中能让你遗忘 Netty，你几乎没有机会能直接的接触到 Netty 的复杂，但却能享受 Netty 带来的高性能。对开发者要求极低，为开发者节约开发时间。

即使之前没有游戏编程的经验，也能参与到游戏编程中。如果你之前具备一些游戏开发或者 webMVC 相关的知识，则会更容易上手游戏服务器的开发。

ioGame 可以很方便的与 spring 集成（5 行代码）。在部署上支持多服单进程的方式部署（类似单体应用）、也支持多服多进程多机器的方式部署。在部署方式上可以随意切换，而不需要更改代码；日常中按照单体思维开发，在生产上可以使用多进程的方式部署；当然，也可以使用单进程的方式部署。

ioGame 框架职责清晰、业务开发几乎零学习成本、源码有高质量注释、示例多、使用文档多，开发体验最佳、对接文档自动生成、逻辑服之间可跨进程跨机器通信、业务代码定位--神级特性、异常机制。

ioGame 是国内首个基于蚂蚁金服 sofa-bolt 的网络游戏框架，游戏框架由 [网络通信框架] 和 [业务框架] 组成。

• 网络通信框架：职责是各服务器之间的网络通信
• 业务框架：职责是业务逻辑的处理方式和编写方式

架构简图

通过 ioGame 可以使得游戏编程变得简单，下面是一个业务示例

Proto 协议文件定义

首先我们自定义一个协议文件，这个协议文件作为我们的业务载体描述。这个协议是纯java代码编写的，使用的是 jprotobuf，jprotobuf 是对 google protobuf 的简化使用，性能同等。

可以把这理解成DTO、POJO、业务数据载体等，其主要目的是用于业务数据的传输；

/** 请求 */
@ProtobufClass
@FieldDefaults(level = AccessLevel.PUBLIC)
public class HelloReq {
    String name;
}

@ActionController(1)
public class DemoAction {
    @ActionMethod(0)
    public HelloReq here(HelloReq helloReq) {
        HelloReq newHelloReq = new HelloReq();
        newHelloReq.name = helloReq.name + ", I'm here ";
        return newHelloReq;
    }
}

┏━━━━━ Debug. [(DemoAction.java:4).here] ━━━ [cmd:1 - subCmd:0 - cmdMerge:65536]
┣ userId : 888
┣ 参数: helloReq : HelloReq(name=塔姆)
┣ 响应: HelloReq(name=塔姆, I'm here )
┣ 时间: 0 ms (业务方法总耗时)
┗━━━━━ Debug [DemoAction.java] ━━━