下载工具后,解压,直接双击 "execute.bat" 文件后(前提已配置好 jdk 1.7 的环境),会生成文件夹 "output",该文件夹下会有生成的对应语言的脚本。
你也可以先尝试修改文件 “config_example.xml” 的配置项,再运行 "execute.bat",看 "output" 文件夹下的文件有什么变化,对于程序员来说应该是很简单的东西了。
新版本支持同步输出 as3(对象+宏), java(对象+宏), c#(对象+宏), mysql(对象), js(宏), lua(宏) 的脚本了。
工具主要目的就是输出不同目标语言下相同的数据对象类定义,和宏类定义。配置详细
[type] 支持的 type 类型 |---boolean : 布尔 |---integer8 : 8 位整型 |---integer16 : 16 位整型 |---integer32 : 32 位整型 |---integer64 : 64 位整型 |---decimal32 : 32 位小数 |---decimal64 : 64 位小数 |---string : 字符串 |---array : 数组,默认泛型类型为 object |---dictionary : 字典,默认泛型类型为 object |---date : 日期 |---object : 基类型 [value] 对应 type 类型支持的默认值 |---boolean : true/false 真/假 |---string : 非 null 时,输出会自动添加引号 |---date, array, dictionary : new 构造对象 |---object : null 空值 [Macros][group] |---宏的分组,当不指定宏类型时,则被系统归为分组中,自动指定类型为 integer32,指定一个系统值 |---值结构为 0x7FFFFFFF,从左到右,第0位始终为0,第1-11位表示所在的组,第12-31表示宏值。如 宏 0x00100001 表示该宏在分组 1 (第 1-11 位 : 0x001) 中,值为 1 (第 12-31 位 : 0x00001) |---分组不能嵌套 [AutoScript] 以包为单位定义对象和宏 |---package : 默认包路径 - 非必需 |---packageAs3 : as3 包路径,如果未指定,则使用 package - 非必需 |---packageJava : java 包路径,如果未指定,则使用 package - 非必需 |---packageNet : c# 包路径,如果未指定,则使用 package - 非必需 |---packageDB : mysql 数据库名,如果未指定,则使用 package 的最内层包名,如果也未指定,则系统默认为 dbScript - 非必需 |---packageJS : js 包路径,如果未指定,则使用 package - 非必需 |---packageLua : lua 包路径,如果未指定,则使用 package - 非必需 |---[Object] 对象数据 |---name : 对象数据类名(即文件名), - 必需 |---extend : 基类 - 非必需 |---note : 对象数据注释 - 非必需 |---nameTable : 该对象数据对应的 mysql 表名,如果未指定,则使用 name - 非必需 |---autoIncrement : mysql 中主键自增起始值 - 非必需 |---[ImportAs3][ImportJava][ImportNet] 对象数据需要引用的其它对象 |---value : 引用的对象完整包路径+类名,如 java.util.Date - 必需 |---[Property] 对象数据属性 |---name : 属性名,c# 输出时会首字母大写 - 必需 |---type : 属性默认类型,指定类型见 [type],如果指定为不支持的类型,则原样输出 - 非必需 |---value : 属性默认值,特殊值见 [value],其它值则会原样输出 - 非必需 |---note : 属性注释 - 非必需 |---typeAs3 : as3 属性类型(原样输出类型和指定的值),如果未指定,则使用 type - 非必需 |---valueAs3 : as3 属性围住值,如果未指定,则使用 value - 非必需 |---typeJava : java 属性类型(原样输出类型和指定的值),如果未指定,则使用 type - 非必需 |---valueJava : java 属性默认值,如果未指定,则使用 value - 非必需 |---typeNet : c# 属性类型(原样输出类型和指定的值),如果未指定,则使用 type - 非必需 |---valueNet : c# 属性默认值,如果未指定,则使用 value - 非必需 |---typeDB : mysql 字段类型(原样输出类型和指定的值),如果未指定,则使用 type - 非必需 |---valueDB : mysql 字段默认值,如果未指定,则使用 value - 非必需 |---restrictDB : mysql 字段约束,如 NOT NULL - 非必需 |---[Macros] 一组宏的定义,该定义下的直系 [Macro] 占用第 1 个分组 |---name : 宏类名(即文件名) - 必需 |---groupStart : 指定分组的起始序号,最小值为 0 |---groupEnd : 指定分组的结束序号,如果小于 groupStart,则默认为 0x7FF |---note : 宏类注释 - 非必需 |---[Macro] 宏 |---name : 宏名 - 必需 |---type : 宏类型,指定类型见 [type],如果指定为不支持的类型,则原样输出 - 非必需 |---value : 宏默认值,特殊值见 [value],其它值则会原样输出 - 非必需 |---note : 宏注释 |---[Group] 宏分组,同 [Macro] 定义一样会生成一个宏,如果不指定类型,则系统指定的值结构为:分组位为当前分组,值部分为0 |---name : 分组(宏)名 |---type : 分组(宏)类型,指定类型见 [type],如果指定为不支持的类型,则原样输出 - 非必需 |---value : 分组(宏)默认值,特殊值见 [value],其它值则会原样输出 - 非必需 |---note : 分组(宏)注释 |---[Macro] 分组中的宏
配置模板
1 <AutoScript package="" packageAs3="" packageJava="" packageNet="" packageDB="" packageJS="" packageLua=""> 2 3 <Object name="" extend="" note="" nameTable="" autoIncrement=""> 4 <ImportAs3 value=""/> 5 <ImportJava value=""/> 6 <ImportNet value=""/> 7 <Property name="" type="" value="" note="" typeAs3="" valueAs3="" typeJava="" valueJava="" typeNet="" valueNet="" typeDB="" valueDB="" restrictDB=""/> 8 </Object> 9 10 <Macros name="" groupStart="" groupEnd="" note=""> 11 <Macro name="" type="" value="" note=""/> 12 <Group name="" type="" value="" note=""> 13 <Macro name="" type="" value="" note=""/> 14 </Group> 15 </Macros> 16 17 </AutoScript>
批文件模板
1 @echo off 2 3 java -classpath ./libs/*; AutoScript ^ 4 -config ./config_example.xml ^ 5 -pathAs3 ./output/as3/ ^ 6 -pathJava ./output/java/ ^ 7 -pathNet ./output/net/ ^ 8 -net2one netLib ^ 9 -pathDB ./output/mysql/ ^ 10 -pathJS ./output/js/ ^ 11 -pathLua ./output/lua/ 12 13 pause 14 15 @echo on 16 exit 17 18 19 ::输出配置文件中的对象数据和宏 20 ::-config 后可以指定多个配置文件,如 -config config_a.xml config_b.xml 21 ::-pathAs3 输出 as3 文件路径(如果需要输出 as3 脚本) 22 ::-pathJava 输出 java 文件路径(如果需要输出 java 脚本) 23 ::-pathNet 输出 c# 文件路径(如果需要输出 c# 脚本) 24 ::-net2one 如果指定的话,将会把每一个配置文件(如 config_a.xml)里的所有对象(节点 Object)输出到一个 .cs 文件中 。后接 .cs 文件名(数量与 -config 指定的文件数量一一对应),如 -config ./configA.xml ./configB.xml -net2one a b,将会输出 a.cs 和 b.cs 文件 25 ::-pathDB 输出 mysql 脚本文件路径(如果需要输出 mysql 脚本) 26 ::-pathJS 输出 js 文件路径(如果需要输出 js 脚本) 27 ::-pathLua 输出 lua 文件路径(如果需要输出 lua 脚本)
比如:客户端与服务端需要统一请求和返回命令、错误码之类的,就可以只需要维护宏定义配置文件。直接输出客户端和服务端的宏定义类。
1 <Macros name="ReqRsp" groupStart="1" groupEnd="100" note="请求返回命令"> 2 <Macro name="WELCOME" type="string" value="欢迎使用"/> 3 <Macro name="ERROR_PASSWORD" type="integer32" value="1" note="密码错误"/> 4 5 <Group name="Register" note="注册"> 6 <Macro name="register_req" note="注册账号请求"/> 7 <Macro name="register_rsp" note="注册请求返回"/> 8 </Group> 9 </Macros> 10 <Macros name="Errors" groupStart="101" groupEnd="200" note="错误码"> 11 <Macro name="WELCOME" type="string" value="欢迎使用"/> 12 <Macro name="ERROR_PASSWORD" type="integer32" value="1" note="密码错误"/> 13 14 <Group name="Register" note="注册"> 15 <Macro name="username_existed" note="登录名已存在"/> 16 <Macro name="email_necessary" note="需要填写电子邮箱"/> 17 </Group> 18 </Macros>