geoserver開發手冊系列-資料下載頁

　　

【正文】 cket生成合適的URL。）在類不需要參數到它的構建函數的情況下，我們可以用Spring插入一個鏈接。在Sping創建鏈接要求我們的頁面鏈接文本必須國際化。我們呆會會對國際化進行更加深入的討論。GeoServer的最簡單的可能的Wicket擴展包含3個文件。有個Java類定義（在src/main/java/org/geoserver/web/example/）。package 。import 。public class MyPage extends GeoServerBasePage{ // We will fill in the rest later, for now the page can just be blank}同樣也需要一個Spring應用環境文檔（src/main/java/）：bean class= id=myPageLink ! An internal identifier for the link ponent property name=id value=mypage/ ! The i18n key for the link title property name=titleKey value=/ ! The i18n key for a longer description of the page property name=descriptionKey value=/ ! The fully qualified name of the page class property name=ponentClass value=/ ! Optional, an icon to display alongside the link. property name=icon value=imgs// ! Optional, the category in which the link should be grouped. property name=category ref=someCategory/ ! Optional, a key used to order the links in the menu. property name=order value=100//bean第三個需要的文件是國際化字符串的默認字典，存于src/main/java/：=My Example Page=An example page for developers trying to extend the GeoServer UI.如果你使用了這些三個文件創建了一個jar，并且把它添加到GeoServer類路徑（Classpath）中，我們就能在左側看到新的鏈接。加到頁面到這我們已經給UI添加一個頁面，但是這個還不是很有趣。在Wicket里面，頁面以HTML文件提供他們的內容，該HTML文件與Java代碼有著同樣的名稱，當然擴展名不同。關于這些文件的有些具體細節與標準HTML不同；一方面，它們必須是標準有效的XML，Wicket才能處理。另外，Wicket使用少量的“特殊”元素來描述哪里需要Java代碼檢測并處理成HTML。下面是GeoServer管理控制臺最常用的： Wicket元素目的foo wicket:id=”bar”/fooWicket:id屬性告知Wicket將要使用的名稱，當匹配到Wicket組件的。wicket:child/不需要內容，但是擴展該頁的類可以此處插入內容。wicket:extend/wicket:extend封裝的內容將會在wicket:child/的地方插入到父頁，wicket:panel/wicket:panel與wicket:extend相似，但是用于創建特定的組件而非擴展的頁。wicket:head/wicket:head包含這個標記（能用于頁面pages或者面板panels）的頁面頭部需要添加的這節內容（像包含的CSS或JavaScript代碼）wicket:link/wicket:link封裝那些將會重寫到頁面的鏈接，CSS文件和它管理的其它資源。（這會允許你引用那些相對于Java源代碼的路徑的資源，而不是渲染后的HTML）。wicket:message key=”i18nKey”Default Text/wicket:message告知Wicket到國際化數據庫查找字符串，如果找到了就替換成需要的文本。Wicket只提供很少的組件，其中一些見于Wicket組件參考。總體上，Wicket組件需要一個模型對象來處理getting，setting，和轉換組件相關的值的to/from字符串。這個示例的目的是，我們將會集中于一個最簡單的，即為Label，它會在運行時替換所綁定的值的元素內容。由以上的內容我們繼續，我們可以把一個字符串提供給Label的構造函數，并且它透明式的轉換成一個模型：package 。import 。import 。public class MyPage extends GeoServerBasePage{ public MyPage(){ add(new Label(label, Hello World))。 }}相關的HTML源是src/main/java/org/geoserver/web/example/：htmlhead/headbody wicket:extend Greetings, GeoServer User! My message for you is span wicket:id=label thanks for using GeoServer /span. /wicket:extend/body/html當然，我們可以使用Wicket來做很多更加復雜（并且有用）的事，但是這個示例演示的是最通用功能：僅僅是添加一些動作到HTML元素。在導航菜單外部添加鏈接當然，我們不能在左邊菜單中添加全部的東西；一方面，它只定義了靜態鏈接集，GeoServer綁定這些鏈接到很多不同配置的資源。加一方面，有些頁面需要傳參數給它們的構造函數。如果你需要添加特定的鏈接到頁面上，你可以使用Wicket Links組件，并且定制onClick行為來調用相應的構造函數。（你也可以在處理用戶輸入的其它方法里使用setResponsePage，如form提交。更詳細的信息請查詢Wicket文檔。）一個示例：//...import 。//...add(new Link(link){ public void onClick(){ setResponsePage(new MyPage())。 }})。相對應的HTML將像：Follow this lovely a href= wicket:id=linklink/a.使它國際化在GeoServer UI，我們使用一個定制的資源查找工具，以供任意模塊提供資源字符。，在你的src目錄的根部（比如project/src/main/java/）。wicket:message元素使得文本國際化變得十分容易，但是在你需要插入值到句子中依語言不同而變化的位置時，你將會使用到一些更加復雜的方法。在Wicket里面，i18n值字符串能定義參數，通過這些參數能提供放置動態值到國際化字符串的能力。詳見：添加資源通常在HTML里面，你會需要包含一些有用的東西，如CSS文件，JavaScript庫，或者包含到頁面上的圖片。Wicket允許你使用URL來描述這些相對于你的Java源文件，使用封裝在wicket:link標簽里面的相對路徑。Wicket會在運行時使用正確的路徑來重寫這些鏈接。盡管如此，對于類似于不是繼承于父類的資源，因此如果你需要包含多個包里都有的資源，你就需要一個新的類供兩個類中共享資源。看GeoServer UI核心模塊中的XMLEditor組件，作為組件的示例，它也是起這個功能。UI設計準則下面是GeoServer中Wicket頁面的UI設計簡單準則：表單Forms在表單里面，將每個字段分組作為包含一個標簽和一個字段的一項放在一個無序列表中。對于單選按鈕和復選框，標簽應當放在字段后面；對于其它的，標簽就可放在字段的前面，比如：ul li label for=foowicket:message key=foo Foo /wicket:message input wicket:id=foo type=text/input /li/ul避免用戶需要特殊知識比如，當需要一個值列表時，可以提供一個工具允許用戶一次一個元素地操作列表，而不是給一個逗號分隔的值列表定制組件我們推薦創建一個可持續利用的Wicket組件用于任意一個復雜的值，這些值可能被用戶編輯，比如外框或者自由字符串列表。通過提取并封裝成一個組件，就能更易于提供一個兼容的、豐富的編輯功能給用戶。Web用戶接口簡介GeoServer使用著名的Wicket網絡應用程序框架作為它的用戶接口。Wicket與很多Java網絡框架不同的是它是基于組件的而非JSP模板的。這點使得Wicket對于很多javat程序員來說是一個顯得更加自然的網絡框架，因為這些人對于Swing編程比網絡編程更熟。插件原生的Wicket組件可由類路徑（classpath）加載。這就意味著網絡應用程序可以基于模塊方式構建，而不是單一方式。GeoServer將這種理念更前進一步，提供一個可插拔的用戶接口，在該接口中Wicket組件可通過Spring和規則的GeoServer插件機制進行插拔。插件化的每個組件由組件描述符描述，：public abstract class ComponentInfo implements Serializable { /** * the id of the ponent */ String id。 /** * the title of the ponent */ String title。 /** * The description of the ponent */ String description。 /** * the class of the ponent */ Class ponentClass。 }ComponentInfo的實例包含了關于組件的元信息，如標題和描述等等，還有實現該組件的類。每個ComponentInfo的子類表示了一個特定的擴展點。例如，”main”頁面的擴展點，如從應用程序主菜單鏈接過去的頁面。實現一個Wicket UI擴展本節描述如何實現一個GeoServer Wicket用戶接口的擴展。該擴展非常簡單，就是一個由主菜單鏈接過去的很基礎的頁面，顯示一下“Hello World”。預置條件在開始之前，GeoServer必須在本地系統上構建成功。具體細節見源代碼和快速入門兩章。創建新模塊1. 在本地系統上創建一個名為hello_web的模塊。2. ： xmlns= xmlns:xsi= xsi:schemaLocation=:// web2 hello_web jar hello_web webcore mavenpilerplugin 3. 在新模塊根目錄下創建src/main/java目錄。[hello_web]% mkdir p src/main/java 創建頁面類1. 。，它由GeoServerBasePage頁面擴展而來。package 。import 。public class HelloPage extends GeoServerBasePage {} 2. 首先，我們需要實現它的構造函數。在Wicket里面，一個頁面或組件都是在它的構造函數里面構建。我們的頁面很簡單，將會創建一個值為“Hello World!”的標簽。import 。... public HelloPage() { add( new Label( hellolabel, Hello World!) )。 } 在上面代碼中，創建了一個Label的實例。構造函數的第一個參數是組件id。在Wicket框架中每個組件都必須有一個自己的id。下一節中該id還會用于綁定這些組件到它的HTML表達上。Label構造函數的第二個參數是值，這里我們寫的是“Hello World!”創建頁面表達效果1. 頁面完成后，接下來一步就是為頁面創建HTML表達效果。，放在與HelloPagejava類同一目錄下 wicket:id=hellolabel 有幾件事需要注意下。第一件是元素的使用，它會告訴wicket說HelloPage是另一個頁面的擴展，本示例中是GeoServerBasePage，并且它會繼承來自于這個頁面的表達效果。元素的使用，它會告訴wicket說HelloPage是另一個頁面的擴展，本示例中是GeoServerBasePage，并且它會繼承來自于