【正文】 單元，是 XML 格式的 文件。包括所有的你的 GWT 項(xiàng)目需要的配置信息，即下列信息： ? 繼承模塊 ? 一個(gè)入口點(diǎn)應(yīng) 用類名；這些是可選的，雖然任何關(guān)系到 HTML 的模塊都必須至少有一個(gè)指定的入口類。 ? 原代碼路徑 ? 公共路徑 ? 延期綁定規(guī)則，包括屬性提供者和類生成器。 模塊 （ Modules）可以出現(xiàn)在你的類路徑的任何包里，但是 強(qiáng)力推薦它應(yīng)該出現(xiàn)在標(biāo)準(zhǔn)項(xiàng)目布局的根包里。 入口類 一個(gè)模塊入口是任何 實(shí)現(xiàn) EntryPoint 接口 的類 ，并且可以被無參數(shù)構(gòu)造實(shí)例。當(dāng)裝載一個(gè)模塊時(shí)，每個(gè)入口類被實(shí)例化，并且它們的 ()方法被調(diào)用。 原代碼路徑 模塊 能夠指定哪 個(gè)子包 包含 可轉(zhuǎn)換原代碼， 方法是 把 命名包和它的子包被加入原代碼路徑。只有在 建立在原代碼路徑上的文件才可能被轉(zhuǎn)換成 JAVASCRIPT，客戶端代碼和服務(wù)端代碼 也可以 無沖突地 混合在同一個(gè)類路徑中。 當(dāng)模塊繼承其他模塊，它們的原代碼路徑被綁定，這樣每個(gè)模塊 將 會(huì) 能夠訪問到它需要的可轉(zhuǎn)換原代碼。 公共路徑 模塊能夠指定哪個(gè)子包是公共的，方法是命名包和它的子包被加入到公共路徑。 當(dāng)你把你的應(yīng)用程序編譯成 JAVASCRIPT 時(shí)，在公共路徑中能找到的所有的文件都被復(fù)制到模塊的輸出目錄。凈效果是用戶可見的 URLs 不需要包含一 個(gè)完整的包名。 當(dāng)模塊繼承其他模塊時(shí)，它們的公共路徑被綁定，這樣每個(gè)模塊都可以訪問它所需要的靜態(tài)資源。 特殊規(guī)范 ? 模塊 XML 格式 在 XML 文件中定義模塊，并且置入你的項(xiàng)目包層級(jí)。 模塊定義在 XML 文件中，它的文件名擴(kuò)展是 .。 模塊 XML文件應(yīng)當(dāng)位于你的項(xiàng)目的根包 如果你正在使用標(biāo)準(zhǔn)項(xiàng)目結(jié)構(gòu)，你的模塊 XML 可以像以下這樣簡(jiǎn)單： module inherits name=/ entrypoint class=/ /module ? 裝載模塊 在 JAVA 類路徑中發(fā)現(xiàn)的模塊 XML 文件，被它們的邏輯模塊引用 ，從主頁用名字引入，也被其他模塊引入。 模塊總是關(guān)聯(lián)到它們的邏輯名。模塊的邏輯名遵守這種形式 且不包括實(shí)際文件系統(tǒng)路徑和文件擴(kuò)展名。例如：模塊 XML文件的邏輯名位于： ~/src//example/cal/ 是 ? 可用元素 inherits name=logicalmodulename/ 從指定的模塊繼承所有的設(shè)置，就像被繼承的模塊的 XML 被逐字復(fù)制。一些模塊可被用這種方式繼承。 entrypoint class=classname/ 指定的入口點(diǎn)類。一些入口類能夠被從被繼承模塊加入、包含。 source path=path/ 通過綁定包 向原代碼路徑加入包 ，在包中，模塊 XML 可以在特定的子包路徑中找到。任何出現(xiàn)在這個(gè)子包下的 JAVA原代碼文件，或任何下層子包內(nèi)，假 定都是需要被轉(zhuǎn)換的。 如果在模塊 XML 文件中沒有定義 source這個(gè)元素，客戶（ client）子包 會(huì)被隱含地原代碼路徑，就像模塊 XML 文件中有定義 source path=client一樣 。這個(gè)默認(rèn)設(shè)置幫助保持模塊 XML使用標(biāo)準(zhǔn)項(xiàng)目結(jié)構(gòu)。 public path=path/ 通過綁定包向公共路徑中加入包，在綁定包中，模塊 XML將會(huì)在指定路徑中被發(fā)現(xiàn)來指定 servlet path=urlpath class=classname/ 為了 RPC測(cè)試的方便性，這個(gè)元素裝載一 個(gè) SERVLET類，它應(yīng)用到指定的 URL路徑。這個(gè) URL 路徑應(yīng)該是絕對(duì)路徑，并且符合目錄形式（例如： /spellcheck）。你的客戶端代 碼 指 定 這 個(gè) URL 映 射 到 一 個(gè) 調(diào) 用(String)。一些 SERVLET 可以用這種方式裝載，包括那些 從繼承模塊里來的。 自動(dòng)注入外部的 JAVASCRIPT文件，這個(gè)文件位于 src指定的位置 。 script readyfunction body 是一個(gè) JAVASCRIPT 函數(shù)體，當(dāng)這個(gè)腳本已知被初始化時(shí)，它返回 true stylesheet src=cssurl/ 自動(dòng)注入外部的 CSS文件， 這個(gè)文件位于 src 指定的位置。 extendproperty name=clientpropertyname values=maseparatedvalues/ 為一個(gè)已存在的客戶屬性值集合進(jìn)行擴(kuò)展。一些值可以用這種方式添加，并且客戶屬性值通過繼承模塊進(jìn)行累積。你可能只是發(fā)現(xiàn)它 對(duì)于“在國(guó)際化中指定本地”（ specifying locales in internationalization） 有用 ? 自動(dòng)資源注入 模塊組（ Modules）能夠包含到外部 JAVASCRIPT 和 CSS 的引用，方法是當(dāng)模塊自身裝載時(shí)，它們也被自動(dòng)裝載。 模塊可以包含到外部 JAVASCRIPT 和 CSS 文件的引用，方法是當(dāng)模 塊自我加載時(shí)自動(dòng)加載。 ? 注入外部 JAVASCRIPT 對(duì)于在你的模塊 自動(dòng)地關(guān)聯(lián)外部 JAVASCRIPT 文件 ，腳本注入是一個(gè)方便的方法。腳本注入使用下面的語法： script src=jsurl![CDATA[ script readyfunction body ]]/script “ readyfunction body”部分是 JAVASCRIPT 函數(shù)主體部分，當(dāng)腳本被裝載并可用后，它返回 true。 腳本被裝載進(jìn)主頁 （ host page） 的名字空間 （ namespace）， 其作用與你顯式地使用 HTML script元素進(jìn)行引入是相同的 。 例如：假定你的模塊需要的腳本名為 : 。 那么示例代碼如下： function foo() { // do something neat doSomethingTimeConsuming()。 } function bar() { // do something else neat } 你的模塊應(yīng)該如下所示： module inherits name=/ script src=![CDATA[ // More plex tests are possible, but usually checking for the existence // of a function is enough. if ($) return true。 else return false。 ]]/script /module 可用－函數(shù)（ readyfunction）的目的就是明確地指出腳本已被完全裝載，這樣，你的 GWT代碼就能夠使用 JSNI，并且可以確定 被引用的標(biāo)識(shí)符是可用的。在上面的例子中，函數(shù) bar的存在就說明了腳本已經(jīng)就緒了。 ? 注入外部的樣式表 樣式表注入是把外部的 CSS文件自動(dòng)關(guān)聯(lián)到你的模塊的一個(gè)便捷方式。使用如下語法 可以把 CSS 文件自動(dòng)附加到你的主頁（ host page）上。 stylesheet src=cssurl/ 你能夠用這種方式加入一些樣式表，包含入頁面時(shí)的順序就是 元素在你的模塊 XML 文件中出現(xiàn)的順序。 ? 注入和模塊繼承 模塊繼承使資源注入更加方便。如果你想要?jiǎng)?chuàng)建一個(gè)可重用類庫，這個(gè)庫依賴特定的樣式表的 JAVASCRIPT 文件，你可以確定你的類庫的客戶 可 以用從模塊繼承的方式自動(dòng)得到所需之物。 ? 過濾公共包 在你的公共路徑中濾進(jìn)或?yàn)V出文件，以避免無意地發(fā)布文件。 public元素不支持完全的 FileSet 語義。當(dāng)前只有下列屬性和嵌套元素被支持： ? includes 屬性 ? excludes 屬性 ? defaultexcludes 屬性 ? casesensitive 屬性 ? 嵌套標(biāo)志 include ? 嵌套標(biāo)志 exclude 其他屬性和嵌套元素不被支持 重要注意事項(xiàng) Defaultexcludes的默認(rèn)值是 true。 命令行工具 開始開發(fā) 時(shí)需要的一些有用 的命令行工具 。 GWT 只有很少的幾個(gè)命令行工具。它們也可以用于向現(xiàn)存項(xiàng)目加入新的東西。例如， projectCreator可以用于使一個(gè) Eclipse 項(xiàng)目符合 GWT 的規(guī)范。 ? projectCreator 生成基本的項(xiàng)目骨架 。 一個(gè)可選的 Ant build 文件，和 ／或 Eclipse 項(xiàng)目。 projectCreator [ant projectName] [eclipse projectName] [out dir] [overwrite] [ignore] ant 生成一個(gè) Ant build 文件，用于編譯源代碼（將會(huì)加入 .） eclipse 生成一個(gè) eclipse 項(xiàng)目。 out 輸出文件寫入到這個(gè)目錄（默認(rèn)是當(dāng)前目錄） overwrite 覆蓋任何已經(jīng)存在的文件。 ignore 忽略任何已經(jīng)存在的文件；不覆蓋 ? 示例 ~/Foo projectCreator ant Foo eclipse Foo Created directory src Created directory test Created file Created file .project Created file .classpath 運(yùn)行 ant f src編譯到 bin。這個(gè) build 文 件也包含一個(gè)目的包，這個(gè)包用于把項(xiàng)目打包成一個(gè) jar 文件。 .project能夠被引入到 Eclipse 工作區(qū) ? applicationCreator 生成一個(gè)初 始的應(yīng)用程序 ，這個(gè)應(yīng)用程序可以從主機(jī)模式啟動(dòng)，并且可以編譯成JAVASCRIPT applicationCreator [eclipse projectName] [out dir] [overwrite] [ignore] className eclipse 為命名的 eclipse 項(xiàng)目 生成一個(gè)調(diào)試 啟動(dòng)配置項(xiàng)。 out 這個(gè)目錄用于寫入輸入文件（默認(rèn)為當(dāng)前目錄） overwrite 覆蓋任何已經(jīng)存在的文件 ignore 忽略任何已經(jīng)存在的文件；不覆蓋 className 創(chuàng)建 一個(gè)合乎規(guī)格 應(yīng)用程序類 名字 ? 示例 ~/Foo applicationCreator eclipse Foo Created directory src//example/foo/client Created directory src//example/foo/public Created file src//example/foo/ Created file src//example/foo/public/ Created file src//example/foo/client/ Created file Created file Fooshell Created file Foopile 運(yùn)行 Fooshell 命令行在主機(jī)模式中生成新的應(yīng)用。 Foopile 把 JAVA應(yīng)用轉(zhuǎn)換成 JAVASCRIPT， 在目錄 . WEB文件夾，這是一個(gè)用于 Eclipse 的啟動(dòng)配置。 ? junitCreator 生成 JUnit測(cè)試程序 生成一個(gè) JUnit test測(cè)試程序和腳本，可用于主機(jī)模式和 WEB 模式。 junitCreator junit pathToJUnitJar [eclipse projectName] [out dir] [overwrite] [ignore] className junit 指定到你的 的路徑（必須） module 指定要使 用的應(yīng)用模塊名（必須）。 eclipse 為命名的 eclipse 項(xiàng)目創(chuàng)建一個(gè)調(diào)試啟動(dòng)選項(xiàng) out 用于寫入輸出文件的目錄（默認(rèn)是當(dāng)前目錄） overwrite 覆蓋任何已經(jīng)存在的文件。 ignore 忽略任何已經(jīng)存在的文件；不覆蓋 className 要?jiǎng)?chuàng)建的合乎規(guī)格的測(cè)試類名字。 ? 示例 ~/Foo junitCreator –junit /opt/eclipse/plugins/ module eclipse Foo Created directory test//example/foo/test Created file test//example/foo/client/