.gwt.xml 配置說明

如何定義個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" /> :
          這個使用來定義本地化參數的，也能夠用來定義其餘的一些屬性，具體的就只有你去查一下了。