JSBuilder2（extjs.com/products/jsbuilder ）是配合Ext 3新发布的AJAX打包工具

JSBuilder2（extjs.com/products/jsbuilder ）是配合Ext 3新发布的AJAX打包工具，用Java语言编写，制成JAR格式执行文件发布。作为一个方便开发者的打包工具，它内含有几种开源项目在内，包括 Rhino Project（著名的JavaScript编译器）、YUI Compressor（压缩JS/CSS）和Java环境下JSON的编码器（来自www.json.org），方便在JavaScript和CSS项目 中使用。

 

下载地址：

http://dev.sencha.com/deploy/JSBuilder2.zip

 

JSBuilder2具有特性如下：

• 跨平台的Java应用程序
• 用法简单
• 以JSON为配置文件的结构
• 采用YUI Compressor来进行文件的压缩
• 在开发阶段到部署阶段之间，资源文件都可以轻松迁移

与第一版不同，JSBuilder2是纯命令行的工具，因此我们必须了解一下它的参数如何。首先运行JAR包的执行文件必须要有java.exe。 通常我们将该命令加入“环境变量”中，然后加入-jar参数即可以运行这个JSBuilder2.jar文件。关于JSBuilder的参数列表，可见：

• --projectFile -p   （必填的）jsb2文件，该文件定义了打包的具体任务。 Location of a jsb2 project file
•  --homeDir -d       （必填的）生成的主目录，通常就是项目部署的目录。
• --verbose -v       （可选的参数）输出正在生产的详细过程。
• --debugSuffix -s   （可选的参数）为便于调试，生产JS调试文件的后续名称，默认为“debug”，以表示这是调试用的JS文件。
• --help -h          （可选的参数）显示帮助。

Windows平台上的用法：

java -jar JSBuilder2.jar --projectFile C:/Apps/www/ext3svn/ext.jsb2 --homeDir C:/Apps/www/deploy/

Linux或OS X平台上的用法：

java -jar JSBuilder2.jar --projectFile /home/aaron/www/trunk/ext.jsb2 --homeDir /home/aaron/www/deploy/

上面提到JSBuilder的jsb2文件，很明显的是为第二版所服务的配置文件，以区别于旧版。在第一版的时候，*.jsb是采用XML文件作为配置其 配置文件的，那时还是.Net WinForm写好的程序。而在这次Java写的版本中，却是使用了JSON作为其配置文件的格式。我们说到JSBuilder既有Moliza的 Rhino JS引擎也有JSON.org的包同时存在，它既可以让JS引擎以eval()函数获得JSON对象，也可以让Java的代码获得这个JSON对象，都是 比较方便的方法。那么使用XML是不是较为不便呢？也不一定的，因为我们可以从Rhino的开源信息得到了解，较新版的Rhino是升级到 JavaScript 1.8，也就正式支持EXA的标准。在EXA的支持下XML转为JS对象轻而易举。当然这又是另外一件事了。

下面我们说一下这个JSON格式的清单。

The top-level keys are:
- projectName:  String 说明该项目。
- deployDir:    String specifying directory to create within the homeDir
                specified on the commandline
- licenseText:  String specifying the header of all .js and .css, use /n for
                newlines.
- pkgs:         An array of package descriptors
- resources:    An array of resource descriptors

Package Descriptors:
- name:         String describing the package
- file:         String specifying the file to create
- isDebug:      Boolean describing whether to generate debug builds
                This configuration is currently UNUSED. Debug and compressed
                versions will ALWAYS be generated.
- fileIncludes: An array of files descriptors which need to be included in this
                package.
- pkgDeps:      An array of the package descriptor file strings that this
                package depends on. The behavior of this configuration relies
                on the includeDeps configuration.
- includeDeps:  Boolean describing whether or not to include dependencies in the
                outputted file.  Defaults to false.

File Descriptors:
- text:         String describing the file to be included
- path:         String describing the directory of file to be included


Resource Descriptors:
- src:          String describing the folder to move resources from
- dest:         String describing the folder to move resources to
- filters:      String to create a RegEx which specifies how to filter the
                files which are copied from src to dest. All .svn and hidden
                files will automatically be excluded. Note that all /'s must
                be encoded //.

Filter Examples:
- ".*"                 A filter to copy all files
- ".*[//.js|//.css]"   A filter to copy all js and css files.

从清单中可以看出，JSON格式仍然是以Key/Value，键/键值列出。我们定义好我们自己的配置后，保存为一份*.jsb2文件让JSBuilder读取。