如何定义个XML模块文件
模块是被定义于名为 gwt.xml.ModulName 的文件中。这个文件应改被放在你的工程的根目录。如果你的工程使用的GWT标准工程文件夹的结构,那么你的配置文件应该向下面那样简单。
<module>
<inherits name="com.google.gwt.user.User" />
<entry-point class="com.example.cal.client.CalendarApp" />
</module>
加载模块
模块配置的XML文件应该在JAVA的类加载路径里面。模块总是通过他们的逻辑名被引用。模
块的逻辑名是这样的:包名1.包名2.模块名。逻辑名并不用反映实际的文件系统路径和文件扩展名。如下,假如一个模块的XML文件:
~/src/com/example/cal/Calendar.gwt.xml
那么对应的逻辑名可以是:
com.example.cal.Calendar
重命名模块
模块配置文件的<module>元素有一个可选的属性 rename-to 。这个属性可以让JAVA -> JavaScript的编译器把对应模组按照重命名之后的名字来处理。重命名一个模块可以带来如下好处:
可以使用一个不反应实际包结构的短名
to create a "working module" to speed up development time by restricting the number of permutations (这个不知道该怎么译, 所以把原文放在这里。permutations 是排列组合的意思。)
com.foo.WorkingModule.gwt.xml:
<module rename-to="com.foo.MyModule">
<inherits name="com.foo.MyModule" />
<set-property name="user.agent" value="ie6" />
<set-property name="locale" value="default" />
</module>
对应如上的配置文件,当WorkingModule.gwt.xml被编译的时候,默认情况下将仅仅产生一个用于ie6的版本。这种方式可以帮助你提高开发时的编译速度。这时编译器的输出将是以重名后的包名产生的。
但是,在主机(Host)模式下,需要使用实际的XML文件名对应的模块名,即物理名。总之
主机模式下,GWT(谷歌网站工具)只会按照物理名去查找对应的模块。
使用多个模块
大多数情况下,你可能会打算创建一个可以在其他GWT工程中重用的模块。创建这类模块的时候并不意味着该模块必须要定义一个入口(entryPoint)。实际上, GALGWT(Google API Library for Google Web Toolkit )中Gears对GWT的绑定中就有这种情况。你可以在jar包中的gwt-google-apis/com/google/gwt/gears/ Gears.gwt.xml 中看到,那里并没有定义入口。所以任何想要在GWT工程中使用Gears for GWT的模块都需要在其模块配置文件中继承Gears.gwt.xml module。例如: 一个名为 Foo 的模块项使用GALGWT, 则其模块配置文件中应该有一个<inherits> 元素。
<module>
...
<inherits name="com.google.gwt.gears.Gears" />
到输出目录。
XML配置文件参考
这一节列出了模块配置文件中最常用的元素。
<inherits name="logical-module-name" /> :
从指定的模块继承所有的设置。这样做时间上是将所有的设置都复制的当前的这个文件。可以继承的模块数量不限。
<entry-point /> :
定义一个入口类。可以定义任意数量的入口,当然被继承过来的入口同样有效。同一个有效域内的所有的入口都被
编译到同一个代码库。并且,被按照出现在配置文件中的顺序依次的被各自的onModuleLoad()方法加载。
<source path="path" /> :
每个<source>标签都通过合并其所指定的路径到模块配置XML文件所指定的包中去的方法, 加入了一个包到编译
器的源码路径内。所有出现在包中的java文件或者其子包都会被编译。同样,基于模式匹配的过滤也是支持的,以便于为你
提供对编译输出,主要是对那些资源将被复制编译输出目录,提供细粒度的控制。如果整个模块配置文件都没有<source>标
签被定义,那么client包将被隐式的加入到源码路径中去,这个动作等同于<source path = "client">.这个默认设置可以
帮助大家使用google推荐的标准工程文件夹的组织方式。
<public path = "path" />
这个标签用于将一个包加入到public path 路径下面。所有出现于public path路径下面的资源将被所有的客户
端代码访问。和source一样, <public> 也有一个默认的指向,模块根目录,就是模块配置文件所在的目录,下的public
文件夹。
<servlet path="url-path" /> :
为了便于RPC测试,这个标签定义了一个servlet并将之绑定到一个URL,但是请注意,和在web.xml中定义不同,
1。此处要求URL的末尾必须是一个目录而不是”/”。在客户端代码中, 你可以指定一个调用位置,
用ServiceDefTarget.setServiceEntryPoint(String).这里对加载的servlet的数量没有限制。2。这个地方的定义
只对GWT的内置服务器的服务器端的调试起作用。
<script src ="js-url" /> :
在中用模块的主页中引入js文件或者文件夹,这个效果等同于你在HTML 页面中使用 script 。
<stylesheet src="css-url" /> :
在中用模块的主页中引入css文件或者文件夹,这个效果等同于你在HTML 页面中使用 script 。
<extend-property name="client-property-name" values="comma-separated-values" /> :
这个使用来定义本地化参数的,也可以用来定义其他的一些属性,具体的就只有你去查一下了。