as3+java+mysql(mybatis) 数据自动工具（五）

现在介绍常量的配置，主要用于客户端（as3）与服务端（java）之间的常量同步，比如错误码、请求标识等

配置格式：

<macros name="Macros" groupStart="16" groupEnd="128" bitOffset="20" author="idoublewei" note="宏定义">
    <macro name="SEX_MALE" type="integer" value="0" note="性别：男"/>
    <macro name="SEX_FEMALE" type="integer" value="1" note="性别：女"/>
    <group name="WEEK" type="string" value="week" note="星期">
        <macro name="WEEK_MON" type="string" value="monday" note="星期一"/>
        <macro name="WEEK_TUE" type="string" value="tuesday" note="星期二"/>
    </group>
</macros>

常量定义只能有一个根节点 macros，子节点 macro 表示一个常量，子节点 group 同样表示一个常量，但它与其下子节点 macro 有一层特殊的关系，下面在说明 groupStart 和 groupEnd 的时候再详细说明。

macros :

---name 常量类名 - 必须指定

---groupStart 起始分组编号 - 非必须，默认1。解释：有的常量是不关心值的，但必须相互唯一，这时就可以让程序自动计算常量的值，这种常量类型为 integer，该值的意义可见 bitOffset 解释

---groupEnd 结束分组编号 - 非必须，默认 Integer.MAX_VALUE，解释同 groupStart

---bitOffset 自动计算的常量的有效低位。解释：假设该值取 24，自动计算的常量值为 0x24565842，则该常量的高 8(0x24) 位为分组编号（位于 groupStart 与 groupEnd 之间），后 24(0x565842) 位为常量的有效编号

---author 常量类创建者 - 非必须

---note 常量类注释 - 非必须

macro, group :

---name 常量名 - 必须指定

---type 常量类型（区分大小写） - 非必须\

------object 基类

------string 字符串

------integer 整数

------unsigned 非负整数

------decimal 小数

------bool 布尔值

------array 数组，后可接符号 "|" + 元素类型（默认为 object），例如 - array|Integer

------date 日期

---value 常量值（区分大小写） - 非必须，null 表示空

------如果 type 为 bool，则取值：true, false

------如果 type 为 array，则取值： new - 新建对象

------如果 type 为 date，则取值：new - 新建对象。 ms - 日期毫秒数，后接符号 "|" + 数字，例如 - ms|428， format - 日期字符串，后接符号 "|" + 日期格式字符，例如 - format|14-04-16 20:15:36 637

---note 常量注释 - 非必须

需要注意的是

---如果未同时指定 type 和 value，则默认类型为 integer，value 由 groupStart 和 groupEnd 计算

---如果未指定 type，但指定了 value，默认类型为 string

---如果指定的类型为自定义类，则会原样输出，所以指定为自定义类时，最好将自定义类包路径写上，如 com.vo.MyClass

这儿这个 groupStart 和 groupEnd 可能会让人有点不好理解。举个例子，每个应用或游戏都会分很多模块，每个模块的相关请求命令都会写到相关的模块类中，比如

---用户模块 ： 注册请求，登录请求

---好友模块 ：加好友请求，查询好友请求

如果这样定义请求常量

<macros name="ReqMacros" groupStart="1" groupEnd="100" bitOffset="24" author="idoublewei" note="请求命令常量">

　　<group name="USER_MODULE" note="用户相关请求命令模块">
　　　　<macro name="USER_REGISTER" note="注册用户，参数 : userName, password"/>
　　　　<macro name="USER_LOGIN" note="登录用户，参数 : userName, password"/>
　　</group>

　　<group name="FRIEND_MODULE" note="好友相关请求命令模块">
　　　　<macro name="FRIEND_ADD" note="添加好友"/>
　　　　<macro name="FRIEND_SEARCH" note="查询好友"/>
　　</group>

</macros>

例子中所有的常量都没指定类型 type 和值 value，则会自动计算常量值。自动计算的规则：

常量值的计算公式 : index + (group << bitOffset)

---index 当前分组的第 index 个常量

---group 当前分组号，macros 下的直接常量 macro 的分组号从 groupStart 开始，第1个 group 节点的分组号从 groupStart + 1 开始。如果 macros 总的分组大于了 groupEnd - groupStart + 1，则会忽略超出的配置分组

---bitOffset （32 - bitOffset）表示常量值的高几位代表该常量的分组号

根据该配置，可以得到 as3 常量类

package
{
    /**
     * 请求命令常量
     * @author idoublewei 2014-05-24 10:03:30
     */
    public class ReqMacros
    {

        /** 用户相关请求命令模块 */
        static public const USER_MODULE:int = 33554432;
        /** 注册用户，参数 : userName, password */
        static public const USER_REGISTER:int = 33554433;
        /** 登录用户，参数 : userName, password */
        static public const USER_LOGIN:int = 33554434;
        /** 好友相关请求命令模块 */
        static public const FRIEND_MODULE:int = 50331648;
        /** 添加好友 */
        static public const FRIEND_ADD:int = 50331649;
        /** 查询好友 */
        static public const FRIEND_SEARCH:int = 50331650;

    }
}

java 常量类

/**
 * 请求命令常量
 * @author idoublewei 2014-05-24 10:03:30
 */
public class ReqMacros {

    /** 用户相关请求命令模块 */
    static public final int USER_MODULE = 33554432;
    /** 注册用户，参数 : userName, password */
    static public final int USER_REGISTER = 33554433;
    /** 登录用户，参数 : userName, password */
    static public final int USER_LOGIN = 33554434;
    /** 好友相关请求命令模块 */
    static public final int FRIEND_MODULE = 50331648;
    /** 添加好友 */
    static public final int FRIEND_ADD = 50331649;
    /** 查询好友 */
    static public final int FRIEND_SEARCH = 50331650;

}

我们可以看到

---USER_MODULE 常量的值写成16进制为 0x02000000，USER_REGISTER 为 0x02000001，USER_LOGIN 为 0x02000002

---FRIEND_MODULE  常量的值写成16进制为 0x03000000，FRIEND_ADD 为 0x03000001，FRIEND_SEARCH 为 0x03000002

可以看出来，常量值的低 bitOffset 位可作为实际请求命令，剩余的高 （32 - bitOffset） 位可以解释成该请求命令属于哪个模块。这样的常量值定义有什么好处呢？来试着写一下服务端的请求处理吧。

---用户请求的处理可以写成 UserFacade，专门处理高 （32 - bitOffset） 位为 2 的请求命令

---好友请求的处理可以写成 FriendFacade，专门处理高 （32 - bitOffset） 位为 3 的请求命令

然后写一个接口 IFacade 定义为请求处理接口，如下

/**
 * 请求处理接口
 * @author idoublewei
 */
public interface IFacade {

    /**
     * 处理请求
     * @param command 请求命令
     * @param param请求参数
     * @return 请求返回的数据
     */
    Object request(int command, Object param);

}

那么可以让前面的 UserFacade implements IFacade，FriendFacade implements IFacade，这样所有请求处理都归结到 IFacade 了。然后再定义一个 FacadeMgr 类，专门管理请求的分发，如下

import java.util.HashMap;
import java.util.Map;

public class FacadeMgr {

    //这个就是配置中的 bitOffset
    private int bitOffset = 24;
    private Map<Integer, IFacade> commandModuleFacadeMap = new HashMap<Integer, IFacade>();

    /** 注册模块接口 */
    public void registerFacade(int commandModule, IFacade facade) {
        commandModuleFacadeMap.put(Integer.valueOf(commandModule) >>> bitOffset, facade);
    }
    /** 处理请求 */
    public Object request(int command, Object param) {
        if (commandModuleFacadeMap.containsKey(Integer.valueOf(command >>> bitOffset))) {
            return commandModuleFacadeMap.get(Integer.valueOf(command >>> bitOffset)).request(command, param);
        }
        return null;
    }

}

可以在服务启动初始化时注册相关请求处理接口

FacadeMgr facadeMgr = new FacadeMgr();
facadeMgr.registerFacade(ReqMacros.USER_MODULE, new UserFacade());
facadeMgr.registerFacade(ReqMacros.FRIEND_MODULE, new FriendFacade());

当前请求到达时，可以直接请用

facadeMgr.request(reqCommand, reqParam);