2009年7月5日星期日

[转]GWT 中文文档, 模块

作为GWT应用的最小单元,也就是模块,是用一个XML文件来配置的。一个模块配置文件具有如下的内容:
1.继承的模块,<inherits name="com.google.gwt.user.User" />
2.一个可选的入口, <entry-point class="com.youorg.client.ClassName" />
3.源码路径, <source path="client" />
4.公用资源路径,
5.延迟绑定规则,提供属性配置的文件、类产生器
虽然你可以任意的指定模块在你的代码文件树上位置, 但是, 还是严重的推荐使用google的默认的标准方式, 这样会省掉很多功夫。

入口类

被制定为入口类的类必须具有一个无参数的构造器,入口类是通过EntryPoint.onModuleLoad()
方法初始化的。理解上你可以将之看做一个main()方法。

源码路径

这个路径里面存放的就是所有需要被GWT
编译器转译(我觉得应该叫转译)成JS代码。当然也只有在源路径及其子目录下的文件才有可能被转译为JS代码。这个办法使得服务器和客户端的代码可以放在一个大的命名空间下面,而不冲突。默认的客户端代码的命名空间的末尾是:
client, 对应的服务器端是: server

公用资源路径

一个模块,可以通过将对应的子包的名字配置到公用源下面来指定那些子包是公用的。一般公用资源是HTML,图片啊,其他的什么。
当转译发生是,所有的公共源下面的东西都被复制到模块的输出目录。具体到URL地址的时候,
公共资源的访问是不需要加入包名路径的。如果模块有发生继承,则所有的公共资源将被合并到一起。

继承
GWT1.5提供的功能都是按照模块组成的, 下表提供了一个概览,
Standard Modules GWT 1.5
Module Logical Name Module Definition Contents
User com.google.gwt.user.User User.gwt.xml GWT 核心功能
HTTP com.google.gwt.http.HTTP HTTP.gwt.xml 底层的HTTP链接库
JSON com.google.gwt.json.JSON JSON.gwt.xml JSON 创建和解析
JUnit com.google.gwt.junit.JUnit JUnit.gwt.xml 整合的单元测试框架
XML com.google.gwt.xml.XML XML.gwt.xml XML文件的创建和解析

模块的主题
有些象dot net 和 java, GWT的组建也有界面主题的概念, 下面的这些我是照抄过来的。
Module Logical Name
Module Definition Contents
Chrome com.google.gwt.user.theme.chrome.Chrome Chrome.gwt.xml
chrome 浏览器风格的主题
Dark com.google.gwt.user.theme.dark.Dark Dark.gwt.xml 黑暗风格的主题
Standard com.google.gwt.user.theme.standard.Standard Standard.gwt.xml 这个是默认的

没有评论: