geoserver中文開發(fā)手冊

1、geoserver中文開發(fā)手冊一目錄目 錄寫在前面一 介紹二 工具JavaMavenSubversion三 源代碼源代碼提交庫結(jié)構(gòu)分支結(jié)構(gòu)四 快速入門取出源代碼由Maven構(gòu)建由Maven生成Eclipse工程文件導(dǎo)入模塊進Eclipse在Eclipse中運行GeoServer訪問GeoServer首頁五 Maven指南六 Eclipse指南七 編程指南八 釋放指南九 釋放測試檢查列表十 CITE測試指南十一 政策與步驟二介紹、工具、源代碼三章一 介紹空。二

2、0;工具在GeoServer開發(fā)者環(huán)境搭建以前，需要安裝以下工具：JavaGeoServer開發(fā)需要JDK1.5及其以上版本，可從Sun Microsystems獲取。注：除了可以使用Sun提供的JDK以外，也可以使用其它的，但這里我們推薦使用Sun的。MavenGeoserver使用Maven工具構(gòu)建。當(dāng)前推薦版本是，可從Apache獲取。雖然是推薦的，但以上版本同樣可用。SubversionGeoserver源代碼由subversion庫完成存儲和版本管理。對于不同平臺有多種subversion客戶端可獲取。更多細節(jié)請訪問： 。三 源代碼源代碼GeoServer源代碼存

3、放在: 。使用以下方式取出開發(fā)版/trunk版本使用以下方式取出穩(wěn)定版/stable版本：警告：Geoserver庫包含大量空間數(shù)據(jù)。從上取出這些數(shù)據(jù)對于低帶寬用戶來說相對就很慢或者很昂貴，這種情況下，用戶可以通過以下方式僅獲取源代碼：提交通過以下步驟提交到代碼庫：1. 安裝subversion配置文件，請看后面?zhèn)渥ⅰ?. 注冊獲取提交權(quán)限。3. 將庫切換到”https”協(xié)議，例如： 庫結(jié)構(gòu)   branches/   spike/   tags/   trunk/

4、 branches包含以前所有穩(wěn)定的開發(fā)分支，etc spike包含實驗版本和原型 tags包含以前所有釋放版本 trunk為當(dāng)前開發(fā)分支。分支結(jié)構(gòu)每個開發(fā)分支都有如下所示的結(jié)構(gòu)：   doc/   src/   data/l doc包含用戶和開發(fā)人員向?qū)У脑次募 src包含Geoserver本身的Java源碼l data包含多種GeoServer的數(shù)據(jù)目錄 三快速入門本章介紹快速搭建、運行GeoServer開發(fā)環(huán)境具體步驟。我們假定您已經(jīng)安裝好所有必須

5、的工具（內(nèi)容見第二章）。注：本章的上的是為了盡快的讓開發(fā)者搭建和運行GeoServer。對于一些更加深入的介紹請見Maven指南和Eclipse指南。l取出源代碼l由Maven構(gòu)建l由Maven生成Eclipse工程文件l導(dǎo)入模塊進Eclipsel在Eclipse里運行GeoServerl訪問GeoServer首頁取出源代碼由subversion庫中取出源代碼。選取trunk作為最新開發(fā)源碼，或者那些基本不可能經(jīng)常更新的版本的穩(wěn)定分支。要么是：svn co  geoserver-trunk或者（穩(wěn)定的分支）svn co  在這頁示例里

6、面，我們假定你取出源碼到一個名為geoserver的目錄，不過，最好還是把名字取得更詳細一點為好。由Maven構(gòu)建修改目錄到源樹的根，執(zhí)行以下maven構(gòu)建命令：cd geoserver/srcmvn clean install成功構(gòu)建后會產(chǎn)生類似于以下的輸出：INFOINFOINFO -INFO Reactor Summary:INFO -INFO GeoServer . SUCCESS 10.271sINFO GeoServer Maven Plugi

7、ns . SUCCESS 0.865sINFO Configuration Deployment PlugIn . SUCCESS 3.820sINFO GeoServer Maven Archetypes . SUCCESS 0.054sINFO GeoServer WFS Output Format Archetype . SUCCESS 0.390sINFO&#

8、160;Core Platform Module . SUCCESS 5.270sINFO Data Module . SUCCESS 4.521sINFO Open Web Service Module . SUCCESS 2.730sINFO Main Module . SUCCESS 10.077sINFO Web Coverage Serv

9、ice Module . SUCCESS 3.785sINFO Web Coverage Service 1.1.1 Module . SUCCESS 5.254sINFO Validation Module . SUCCESS 1.131sINFO Web Feature Service Module . SUCCESS 6.695sINFO W

10、eb Feature Service Module . SUCCESS 1.197sINFO Web Map Service Module . SUCCESS 8.519sINFO Geoserver REST Support Code . SUCCESS 3.366sINFO GeoWebCache (GWC) Module . SUCCESS&

11、#160;0.255sINFO Web Application Module . SUCCESS 27.386sINFO Community Space . SUCCESS 0.312sINFO GeoServer Extensions . SUCCESS 0.071sINFO -INFO -INFO BUILD SUCCESSFULINFO -由Maven生成Eclipse工程文件生成

12、Eclipse使用的.project文件和.classpath文件：mvn eclipse:eclipse導(dǎo)入模塊進Eclipse1.啟動運行Eclipse集成開發(fā)環(huán)境2.打開Eclipse首選項Preferences3.依次點擊進入：Java，BuildPath，Classpath Variables，點擊New 4.創(chuàng)建類路徑變量名稱”M2_REPO”,并且設(shè)置它的值為本地Maven庫的位置，點擊OK。 5.單擊OK以應(yīng)用新的Eclipse首選項。6.在包瀏覽Package Explorer右鍵并單擊導(dǎo)入Import 7.選擇已有

13、工程導(dǎo)入工作區(qū) Existing Projects into Workspace，單擊下一步： 8.進入geoserver/src目錄9.確保所有模塊都被選取，單擊完成Finish 在Eclipse中運行GeoServer1.在包瀏覽Package Explorer中選擇web-app模塊（或更早版本是web）2.點擊進入包（或更早版本是）3.在Start類上右鍵，單擊Run as， Java Application 訪問GeoServer首頁l幾秒后，就可通過http:/localh

14、ost:8080/geoserver訪問到GeoServerl默認的用戶admin的密碼是geoserver 四Maven指南本章是使用Maven構(gòu)建GeoServer的參考。安裝Maven見工具（第二章）運行MavenMaven提供了從模塊編譯到生成測試覆蓋報告的多種命令。大部分maven命令可在源樹的根運行，或者某個特模塊。注：在準(zhǔn)備由源樹的根運行maven命令時，請記住要將取出的根目錄變換到src目錄。在由源樹的根運行一個命令時，或者從包含其它模塊的目錄時，命令將會為所有模塊運行。當(dāng)從單個模塊運行命令時，它只為這個模塊運行。構(gòu)建GeoServer最常用的命令是安裝命令：mvn&

15、#160;clean install雖然clean命令不是必須的，但我們還是推薦用上。上面的命令做了以下的事：編譯源代碼運行單元測試安裝成果到本地Maven庫跳過測試通常在構(gòu)建時跳過單元測試很有用處。在構(gòu)建命令中添加-DskipTests標(biāo)志就可以只編譯單元測試而不會運行測試。mvn -DskipTests clean install離線構(gòu)建Maven操作會自動下載待構(gòu)建模塊中聲明的依賴庫。當(dāng)處理快照（SNAPSHOT）依賴時，這就有可能會有問題。Maven每次執(zhí)行一天內(nèi)的首次構(gòu)建時，會嘗試更新它的快照依賴。由于GeoServer依賴GeoTools庫的

16、快照版本，這時可能會有問題。最終導(dǎo)致Maven下載大量GeoTools更新模塊并且急劇增加構(gòu)建時間。而如果你只是本地構(gòu)建geotools，這些就顯得不必要了。這時，可以使用“離線”方式運行Maven來改進：mvn -o clean install在離線模式中，Maven不會下載任何外部依賴，也不會更新任何快照依賴。構(gòu)建擴展默認情況下，擴展沒有被包含在構(gòu)建中。它們得通過Profile來明確增加到構(gòu)建中。比如下面的示例就將restconfig擴展添加到構(gòu)建中：mvn clean install -P restconfig可以同時

17、添加多個擴展同時使用：mvn clean install -P restconfig,oracle有個特殊的名為allExtensions的Profile可以添加所有擴展：mvn clean install -P allExtensionsProfilesEclipseMaven的Eclipse插件用于為模塊生成eclipse工程：mvn eclipse:eclipse經(jīng)過此操作后，這些模塊就可以導(dǎo)入Eclipse工作區(qū)。該插件有個很有用的功能就是可下載第三方依賴的相關(guān)源代碼。這是通過添加download

18、Sources標(biāo)志來做的：mvn -DdownloadSources eclipse:eclipse警告：當(dāng)你首次啟用downloadSources標(biāo)志時，構(gòu)建過程需要很長時間，因為它要下載GeoServer所依賴的每個庫的源代碼。構(gòu)建Web模塊當(dāng)安裝好web模塊后，它會通過內(nèi)建的特殊配置構(gòu)建。默認情況下它注是minimal配置。盡管如此，它也可以通過設(shè)置configId和configDirectory標(biāo)志來定制任意配置。比如：mvn clean install -DconfigId=release -DconfigDirectory

19、=/home/jdeolive/geoserver_1.7.x/data上面命令可使用GeoServer上的release配置構(gòu)建web模塊。configId是包含的配置目錄名稱，configDirectory是包含的配置目錄的父級目錄。configDirectory可以像剛才的一樣的絕對路徑，也可以是針對web模塊自身的相對路徑：mvn clean install -DconfigId=release -DconfigDirectory=./././data上面的命令與之前有同樣的效果，盡管是引用了相對于web模塊的路徑。該路徑，./././data，

20、在GeoServer取出(check out)的代碼目錄結(jié)構(gòu)是標(biāo)準(zhǔn)結(jié)構(gòu)的情況下可用。使用Jetty運行web模塊Maven的jetty插件可用于運行嵌入了jetty容器的基于web的模塊：cd geoserver_1.7.x/src/webmvn jetty:run注：該命令必須從web模塊運行，如果從其它模塊運行就會失敗。上面的命令將會使用自帶的數(shù)據(jù)目錄來運行GeoServer。為了使用其它的數(shù)據(jù)目錄可以啟用GEOSERVER_DATA_DIR標(biāo)志：mvn -DGEOSERVER_DATA_DIR=/path/to/datadir jetty

21、:run五Eclipse指南本章是使用Eclipse開發(fā)GeoServer的參考。導(dǎo)入模塊運行和調(diào)試設(shè)置數(shù)據(jù)目錄更改Jetty默認端口配置Jetty中JNDI資源Eclipse首選項代碼格式化代碼模塊文本編輯器編譯器導(dǎo)入模塊參見Maven指南中的Eclipse部分。運行和調(diào)試運行和調(diào)試web-app模塊中類。具體步驟見快速入門。設(shè)置數(shù)據(jù)目錄如果未設(shè)置，GeoServer默認會使用web-app模塊里的minimal目錄作為它的數(shù)據(jù)目錄。若要修改，執(zhí)行以下步驟：1.在Eclipse菜單中打開調(diào)試配置（Debug Configurations） 2.先把Start配置，選擇Ar

22、gument面板，并且填寫-DGEOSERVER_DATA_DIR參數(shù)，設(shè)置數(shù)據(jù)目錄為絕對路徑。 更改Jetty默認端口如果未設(shè)置，Jetty默認會使用8080端口。修改請按以下方式：1.打開上節(jié)所說的Start配置中的Argument面板。2.填寫-Djetty.port參數(shù)，設(shè)置它到期望的端口 配置Jetty的JNDI資源JNDI資源如數(shù)據(jù)資源可以通過提供系統(tǒng)屬性中名為的Jetty服務(wù)器配置文件來配置，這個可以在Start配置中的Argument面板上通過VM argument參數(shù)指定。配置文件路徑是相對于web-app模塊根路徑的，該模塊是啟動配置運行的地方

23、。例如：-Djetty.config.file=./././././settings/jetty.xml以下的Jetty服務(wù)器配置文件就配置了一個JNDI數(shù)據(jù)源：jdbc/demo，它是一個Oracle數(shù)據(jù)庫的連接池。  jdbc/demo   jdbc:oracle:thin:1521:demodb                claudius   &#

24、160;          s3cr3t               20          10          0  

25、60;10000      300000   300000 20  true    100  true      SELECT SYSDATE FROM DUAL              

26、              Jetty沒有在GeoServer的WEB-INF/web.xml指定reference-ref，因此沒必要修改該文件。GeoServer web-app模塊和數(shù)據(jù)目錄沒有特定于Jetty的相關(guān)信息，因此JNDI資源可以被測試在Jetty下，以便于后面在Tomcat下的開發(fā)。也可以看看GeoServer用戶手冊中Tomcat中建立JNDI連接池章節(jié)。Eclipse首選項代碼格式化1.下載文件：2.轉(zhuǎn)到首選項中Java，

27、Code Style，F(xiàn)ormatter，點擊Import 3.選擇步驟1中下載的formatter.xml文件。4.點擊Apply 代碼模板1.下載文件：2.轉(zhuǎn)到首選項Java，Code Style, Formatter,點擊Important 3.選擇步驟1中下載的formatter.xml文件。4.點擊Apply文本編輯器1.轉(zhuǎn)到General，Editors，Text Editors2.選中Insert Space for tabs3.選中Show print mar

28、gin，將Print margin column設(shè)置為1004.選中Show line numbers5.選中Show whitespace characters（可選）注：顯示空白字符可幫助我們發(fā)現(xiàn)無意中提交不必要的空格。 6.點擊Apply編譯器1.轉(zhuǎn)到Java, Compiler, Building2.擴展開Output folder，并將.svn/加到Filtered resources列表中。  3.點擊Apply六編程指南OWS服務(wù)本節(jié)介紹GeoServ

29、er中OWS服務(wù)（原文為RESTful服務(wù)，可能為筆誤）如何工作。OWS服務(wù)概覽TBA實現(xiàn)一個簡單的OWS服務(wù)本節(jié)將通過以下場景來介紹如何給GeoServer創(chuàng)建一個簡單的GeoServer OWS服務(wù)。該服務(wù)需要提供一個能廣告叫做“sayHello”的單一操作的功能（capabilities）文檔。該sayHello操作的結(jié)果是一個簡單的字符串：“Hello World”。內(nèi)容： 實現(xiàn)一個簡單的OWS服務(wù)l建立l創(chuàng)建插件l試一試建立創(chuàng)建插件的第一步是為它建立一個maven工程。該工程我們稱為“hello”。1.在本地文件系統(tǒng)中任意地方創(chuàng)建一個名為hello的新目

30、錄。2.給hello目錄添加名為pom.xml文件。1.2. <?xml version="1.0" encoding="ISO-8859-1"?>3. <project xmlns="/POM/4.0.0" xmlns:xsi="/2001/XMLSchema-instance"  xsi:schemaLocation="http:/maven.apa

31、/POM/4.0.0 /maven-v4_0_0.xsd">4.    <modelVersion>4.0.0</modelVersion>5.    <!- set parent pom to community pom ->6.   <parent>7.     <g

32、roupId>org.geoserver</groupId>8.     <artifactId>community</artifactId>9.     <version>2.0.1</version>10.   </parent>11.    <groupId>org.geoserver</groupId>12.   <artifact

33、Id>hello</artifactId>13.   <packaging>jar</packaging>14.   <version>1.0</version>15.   <name> Hello World Service Module</name>16.   <dependencies>17.     <dependency

34、>18.       <groupId>org.geoserver</groupId>19.       <artifactId>main</artifactId>20.       <version>2.0.1</version>21.     </dependency>22. 

35、0; </dependencies>23.    <repositories>24.     <repository>25.        <id>opengeo</id>26.        <name>opengeo</name>27.     

36、60;  <url></url>28.     </repository>29.   </repositories>30. </project>復(fù)制代碼3.在hello目錄下創(chuàng)建Java源文件目錄。hello/+ pom.xml+ src/+ main/+ java/創(chuàng)建插件插件是一系列由spring beans實現(xiàn)的擴展。實例中擴展興趣點是一個HelloWorl

37、d的POJO。1.創(chuàng)建一個名為HelloWorld的類： 1. import java.io.IOException;2. import javax.servlet.ServletException;3. import javax.servlet.http.HttpServletRequest;4. import javax.servlet.http.HttpServletResponse;5. public class HelloWorld    6.   public&#

38、160;HelloWorld()   7.    / Do nothing 8.   9.   public void sayHello(HttpServletRequest request, HttpServletResponse response)10.        throws ServletException, IOE

39、xception  11.           response.getOutputStream().write( "Hello World".getBytes() );12.     13.   復(fù)制代碼該服務(wù)相對比較簡單。它提供了一個一個名為sayHello的方法，帶有HttpServletRequest，HttpServletResponse參數(shù)。該函數(shù)的參數(shù)列

40、表會由自動發(fā)現(xiàn)。2.創(chuàng)建applicationContext.xml文件將上面的類申明為一個bean。1. <?xml version="1.0" encoding="UTF-8"?>2.3. <!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd">4. <beans>5

41、.     <!- Spring will reference the instance of the HelloWorld class           by the id name "helloService" ->6.     &

42、lt;bean id="helloService" class="HelloWorld">7.         </bean>8.      <!- This creates a Service descriptor, which allows the org.geoserver.ows.Dis

43、patcher           to locate it. ->9.         <bean id="helloService-1.0.0" class="org.geoserver.platform.Service">10.     <!-

44、60;used to reference the service in the URL ->11.         <constructor-arg index="0" value="hello"/>12.          <!- our ac

45、tual service POJO defined previously ->13.         <constructor-arg index="1" ref="helloService"/>14.          <!- a version number&#

46、160;for this service ->15.         <constructor-arg index="2" value="1.0.0"/>16.          <!- a list of functions for this 

47、service ->17.         <constructor-arg index="3">18.             <list>19.                

48、 <value>20. sayHello</value>21.             </list>22.         </constructor-arg>23.          </bean>24. </beans>復(fù)

49、制代碼到此，hello工程內(nèi)容應(yīng)該是看上去像下面這樣了：hello/+ pom.xml+ src/+ main/+ java/+ HelloWorld.java+ applicationContext.xml試一試1.安裝hello模塊。1. hello% mvn install2. hello% mvn install 3. INFO Scanning for projects.4. INFO -5. INFO Building Hello World Service Module6. INFO task-segment: install7. INFO -8. INFO resources:resources9. INFO Using default encoding to copy filtered resources.10. INFO compiler:compile11. INFO Compiling 1 source&