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);

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