摘要：本文詳細闡述，如何基於geoserver源碼構建eclipse工程文件，操作過程中除用到jdk、eclipse以外，還有git和maven，操作系統為windows8。
1安裝Git
從(http://git-scm.com/download/win)，下載得到Git-1.9.0-preview2014021 7.exe文件，直接安裝即可。安裝成功后，在任何地方右擊鼠標都會有菜單“Git GUI Here”和“Git Bash Here”。
2通過git可視化界面程序checkout geoserver源碼。
點擊“Git GUI Here”將出現如下界面，選擇“克隆已有版本”，進入源碼克隆界面，輸入相應的source Location（源碼所在位置git://github.com/geoserver/geoserver.git） 和 Target Location（本地存儲位置）。
注意：此處設置target directory時，點擊瀏覽按鈕選擇目標文件夾，完成后要在路徑后面添加“克隆”的文件夾名稱。
Checkout 得到的源碼結構如下：
3下載Maven
(http://maven.apache.org/download.cgi)選擇apache-maven-3.21-bin.zip，maven是命令行程序，將下載得到的壓縮包解壓，在使用時臨時指 定PATH變量即可。
解壓后maven文件的結構如下：
4通過maven將源碼構建為工程
4.1打開cmd，將目錄跳轉至源碼所在目錄下的src文件中。
4.2執行命令：
| Set PATH = “maven_dir/bin”;%PATH% |
臨時將maven的路徑添加至環境變量中。
4.3執行命令：
| mvn clean install mvn -DskipTests clean install |
注意：第一條命令在構建工程的同時執行測試用例測試類文件，在命令執行過程中有可能會出現錯誤；第二條命令在構建工程時，不進行測試，不會有測試不通過的異常。
通過maven構建工程
| [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary: [INFO] [INFO] GeoServer ......................................... SUCCESS [ 5.916 s] [INFO] Core Platform Module .............................. SUCCESS [ 5.763 s] [INFO] Open Web Service Module ........................... SUCCESS [ 6.644 s] [INFO] Main Module ....................................... SUCCESS [01:15 min] [INFO] GeoServer Security Modules ........................ SUCCESS [ 0.607 s] [INFO] GeoServer JDBC Security Module .................... SUCCESS [ 8.048 s] [INFO] GeoServer LDAP Security Module .................... SUCCESS [ 8.002 s] [INFO] Web Coverage Service Module ....................... SUCCESS [ 3.605 s] [INFO] Web Coverage Service 1.0 Module ................... SUCCESS [ 6.524 s] [INFO] Web Coverage Service 1.1 Module ................... SUCCESS [ 10.715 s] [INFO] Web Coverage Service 2.0 Module ................... SUCCESS [ 13.674 s] [INFO] Web Feature Service Module ........................ SUCCESS [ 18.692 s] [INFO] Web Map Service Module ............................ SUCCESS [03:41 min] [INFO] KML support for GeoServer ......................... SUCCESS [01:17 min] [INFO] GeoWebCache (GWC) Module .......................... SUCCESS [03:34 min] [INFO] REST Support Module ............................... SUCCESS [ 3.981 s] [INFO] REST Configuration Service Module ................. SUCCESS [01:23 min] [INFO] GeoServer Web Modules ............................. SUCCESS [ 0.162 s] [INFO] Core UI Module .................................... SUCCESS [02:46 min] [INFO] WMS UI Module ..................................... SUCCESS [ 5.256 s] [INFO] GWC UI Module ..................................... SUCCESS [ 10.776 s] [INFO] WFS UI Module ..................................... SUCCESS [ 3.262 s] [INFO] Demoes Module ..................................... SUCCESS [01:08 min] [INFO] WCS UI Module ..................................... SUCCESS [ 4.632 s] [INFO] Security UI Modules ............................... SUCCESS [ 0.155 s] [INFO] Security UI Core Module ........................... SUCCESS [ 7.840 s] [INFO] Security UI JDBC Module ........................... SUCCESS [ 4.315 s] [INFO] Security UI LDAP Module ........................... SUCCESS [ 12.600 s] [INFO] GeoServer Web Application ......................... SUCCESS [01:42 min] [INFO] Community Space ................................... SUCCESS [ 7.778 s] [INFO] GeoServer Extensions .............................. SUCCESS [ 0.226 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 19:21 min [INFO] Finished at: 2014-03-05T16:52:55+08:00 [INFO] Final Memory: 188M/368M [INFO] ------------------------------------------------------------------------ D:\Technology\Learnning\open_gis\geoserver\geoserver_dev\project\geoserver20140305\src>mvn -DskipTests clean install |
4.4通過maven創建eclipse工程文件
執行命令：
| mvn eclipse:eclipse |
命令行會出現如下結果：
| [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary: [INFO] [INFO] GeoServer ......................................... SUCCESS [ 10.022 s] [INFO] Core Platform Module .............................. SUCCESS [ 6.761 s] [INFO] Open Web Service Module ........................... SUCCESS [ 4.690 s] [INFO] Main Module ....................................... SUCCESS [ 8.291 s] [INFO] GeoServer Security Modules ........................ SUCCESS [ 0.041 s] [INFO] GeoServer JDBC Security Module .................... SUCCESS [ 0.759 s] [INFO] GeoServer LDAP Security Module .................... SUCCESS [ 1.313 s] [INFO] Web Coverage Service Module ....................... SUCCESS [ 0.299 s] [INFO] Web Coverage Service 1.0 Module ................... SUCCESS [ 1.545 s] [INFO] Web Coverage Service 1.1 Module ................... SUCCESS [ 4.898 s] [INFO] Web Coverage Service 2.0 Module ................... SUCCESS [ 0.354 s] [INFO] Web Feature Service Module ........................ SUCCESS [ 0.502 s] [INFO] Web Map Service Module ............................ SUCCESS [ 3.534 s] [INFO] KML support for GeoServer ......................... SUCCESS [ 1.063 s] [INFO] GeoWebCache (GWC) Module .......................... SUCCESS [ 9.024 s] [INFO] REST Support Module ............................... SUCCESS [ 0.285 s] [INFO] REST Configuration Service Module ................. SUCCESS [ 0.484 s] [INFO] GeoServer Web Modules ............................. SUCCESS [ 0.032 s] [INFO] Core UI Module .................................... SUCCESS [ 0.922 s] [INFO] WMS UI Module ..................................... SUCCESS [ 0.338 s] [INFO] GWC UI Module ..................................... SUCCESS [ 1.009 s] [INFO] WFS UI Module ..................................... SUCCESS [ 0.274 s] [INFO] Demoes Module ..................................... SUCCESS [ 0.408 s] [INFO] WCS UI Module ..................................... SUCCESS [ 0.604 s] [INFO] Security UI Modules ............................... SUCCESS [ 0.033 s] [INFO] Security UI Core Module ........................... SUCCESS [ 0.319 s] [INFO] Security UI JDBC Module ........................... SUCCESS [ 0.331 s] [INFO] Security UI LDAP Module ........................... SUCCESS [ 0.401 s] [INFO] GeoServer Web Application ......................... SUCCESS [ 0.595 s] [INFO] Community Space ................................... SUCCESS [ 0.032 s] [INFO] GeoServer Extensions .............................. SUCCESS [ 0.030 s] [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESS [INFO] ------------------------------------------------------------------------ [INFO] Total time: 01:09 min [INFO] Finished at: 2014-03-05T17:06:55+08:00 [INFO] Final Memory: 119M/447M [INFO] ------------------------------------------------------------------------ D:\Technology\Learnning\open_gis\geoserver\geoserver_dev\project\geoserver20140305\src> |
5將構建的java工程導入到eclipe中
5.1打開eclipse，選擇window下的preference，在對話框中選擇java-＞buildpath-＞Classpath Variables，點擊“new”將本地的maven repository路徑作為classpath變量添加至工作空間中。
5.2在eclipse中點擊 “file”選擇“import”將創建的eclipse工程導入至eclipse中。
選擇geoserver/src文件夾
工程導入后結構如下：
6運行工程
Console中出現如下記錄：
| log4j:WARN File option not set for appender [geoserverlogfile]. log4j:WARN Are you using FileAppender instead of ConsoleAppender? 三月 05, 2014 9:31:37 下午 org.geoserver.platform.GeoServerExtensions checkContext 警告: Extension lookup occured, but ApplicationContext is unset. 05 三月 21:31:37 INFO [geoserver.global] - ---------------------------------- - GEOSERVER_DATA_DIR: D:\Technology\Learnning\open_gis\geoserver\geoserver_dev\project\geoserver20140305\src\web\app\src\main\webapp\data ---------------------------------- 05 三月 21:31:38 INFO [org.geoserver] - Loaded style 'line' 05 三月 21:31:38 INFO [org.geoserver] - Loaded style 'point' 05 三月 21:31:38 INFO [org.geoserver] - Loaded style 'polygon' 05 三月 21:31:38 INFO [org.geoserver] - Loaded style 'raster' 05 三月 21:31:38 INFO [org.geoserver] - Loaded default workspace it.geosolutions 05 三月 21:31:38 INFO [org.geoserver] - Loaded workspace 'it.geosolutions' 05 三月 21:31:38 INFO [org.geoserver] - Loaded workspace 'topp' 05 三月 21:31:38 INFO [storage.DefaultStorageFinder] - ************************************************************************************************************ 05 三月 21:31:38 INFO [storage.DefaultStorageFinder] - *** Found System environment variable TEMP set to C:\Users\smartmap\AppData \Local\Temp, using it as the default prefix. *** 05 三月 21:31:38 INFO [storage.DefaultStorageFinder] - ************************************************************************************************************* 05 三月 21:31:38 INFO [config.XMLConfiguration] - Will look for geowebcache.xml in 'C:\Users\smartmap\AppData\Local\Temp\geowebcache' 05 三月 21:31:38 INFO [gwc.layer] - Initializing GWC configuration based on GeoServer's Catalog 05 三月 21:31:38 INFO [gwc.layer] - GeoServer TileLayer store base directory is: D:\Technology\Learnning\open_gis\geoserver\geoserver_dev\project\geoserver20140305\src\web\app\src\main\webapp\data\gwc-layers 05 三月 21:31:38 INFO [gwc.layer] - Loading tile layers from D:\Technology\Learnning\open_gis\geoserver\geoserver_dev\project\geoserver20140305\src\web\app\src\main\webapp\data\gwc-layers 05 三月 21:31:38 INFO [gwc.layer] - GWC configuration based on GeoServer's Catalog loaded successfuly 05 三月 21:31:38 INFO [layer.TileLayerDispatcher] - Configuration GeoServer Catalog Configuration contained no layers. 05 三月 21:31:38 INFO [config.XMLConfiguration] - Found configuration file in C:\Users\smartmap\AppData\Local\Temp\geowebcache 05 三月 21:31:38 WARN [config.XMLConfiguration] - ******************************************************************* 05 三月 21:31:38 WARN [config.XMLConfiguration] - *** GWC configuration validation error: cvc-elt.1: 找不到元素 'gwcConfiguration' 的聲明。 05 三月 21:31:38 WARN [config.XMLConfiguration] - *** Will try to use configuration anyway. Please check the order of declared elements against the schema. 05 三月 21:31:38 WARN [config.XMLConfiguration] - ************************************************************ 05 三月 21:31:38 INFO [config.XMLConfiguration] - Initializing GridSets from C:\Users\smartmap\AppData\Local\Temp\geowebcache 05 三月 21:31:38 INFO [config.XMLConfiguration] - Initializing layers from C:\Users\smartmap\AppData\Local\Temp\geowebcache 05 三月 21:31:38 INFO [layer.TileLayerDispatcher] - Configuration C:\Users\smartmap\AppData\Local\Temp\geowebcache contained no layers. 05 三月 21:31:39 INFO [diskquota.ConfigLoader] - DiskQuota configuration not found: C:\Users\smartmap\AppData\Local\Temp\geowebcache \geowebcache-diskquota.xml 05 三月 21:31:39 INFO [diskquota.ConfigLoader] - DiskQuota configuration not found: C:\Users\smartmap\AppData\Local\Temp\geowebcache \geowebcache-diskquota.xml 05 三月 21:31:39 INFO [diskquota.DiskQuotaMonitor] - Setting up disk quota periodic enforcement task 05 三月 21:31:39 INFO [diskquota.DiskQuotaMonitor] - 0 layers configured with their own quotas. 05 三月 21:31:39 INFO [diskquota.DiskQuotaMonitor] - 0 layers attached to global quota 500.0 MB 05 三月 21:31:39 INFO [diskquota.DiskQuotaMonitor] - Disk quota periodic enforcement task set up every 10 SECONDS 05 三月 21:31:39 INFO [org.geoserver] - Loaded service 'wfs', enabled 05 三月 21:31:39 INFO [org.geoserver] - Loaded service 'wms', enabled 05 三月 21:31:39 INFO [org.geoserver] - Loaded service 'wcs', enabled 05 三月 21:31:39 INFO [gwc.config] - Initializing GeoServer specific GWC configuration from gwc-gs.xml 05 三月 21:31:39 INFO [ows.OWSHandlerMapping] - Mapped URL path [/gwc/service/**] onto handler 'dispatcher' 05 三月 21:31:39 INFO [geowebcache.GeoWebCacheDispatcher] - Invoked setServletPrefix(gwc) 05 三月 21:31:39 INFO [georss.GeoRSSPoller] - Initializing GeoRSS poller in a background job... 05 三月 21:31:39 INFO [georss.GeoRSSPoller] - No enabled GeoRSS feeds found, poller will not run. 05 三月 21:31:40 INFO [rest.RESTDispatcher] - Created RESTDispatcher with 14 paths 05 三月 21:31:40 INFO [wms.WMSService] - Will NOT recombine tiles for non-tiling clients. 05 三月 21:31:40 INFO [wms.WMSService] - Will proxy requests to backend that are not getmap or getcapabilities. 05 三月 21:31:40 INFO [ows.OWSHandlerMapping] - Mapped URL path [/ows/**] onto handler 'dispatcher' 05 三月 21:31:40 INFO [ows.OWSHandlerMapping] - Mapped URL path [/ows] onto handler 'dispatcher' 05 三月 21:31:40 INFO [org.geoserver] - GeoServer configuration lock is enabled 05 三月 21:31:41 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wfs/*] onto handler 'dispatcher' 05 三月 21:31:41 INFO [ows.OWSHandlerMapping] - Mapped URL path [/TestWfsPost] onto handler 'wfsTestServlet' 05 三月 21:31:41 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wfs] onto handler 'dispatcher' 05 三月 21:31:45 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wms/*] onto handler 'dispatcher' 05 三月 21:31:45 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wms] onto handler 'dispatcher' 05 三月 21:31:46 INFO [ows.OWSHandlerMapping] - Mapped URL path [/animate] onto handler 'dispatcher' 05 三月 21:31:46 INFO [ows.OWSHandlerMapping] - Mapped URL path [/animate/*] onto handler 'dispatcher' 05 三月 21:31:46 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wcs] onto handler 'dispatcher' 05 三月 21:31:46 INFO [ows.OWSHandlerMapping] - Mapped URL path [/wcs/**] onto handler 'dispatcher' 05 三月 21:31:47 INFO [ows.OWSHandlerMapping] - Mapped URL path [/kml] onto handler 'dispatcher' 05 三月 21:31:47 INFO [ows.OWSHandlerMapping] - Mapped URL path [/kml/*] onto handler 'dispatcher' 05 三月 21:31:47 INFO [ows.OWSHandlerMapping] - Mapped URL path [/kml/icon/**/*] onto handler 'kmlIconService' |
在瀏覽器中輸入http://localhost:8080/geoserver/web/可返回geoserver主頁。如下圖所示。
Reference
[1]Quickstart http://docs.geoserver.org/stable/en/developer/quickstart/index.html
[2]maven guide http://docs.geoserver.org/latest/en/developer/maven-guide/index.html