摘要：本文详细阐述，如何基于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