geoserver中文开发手册
一.目录
目 录
写在前面
一 介绍
二 工具
Java
Maven
Subversion
三 源代码
源代码
提交
库结构
分支结构
四 快速入门
取出源代码
由Maven构建
由Maven生成Eclipse工程文件
导入模块进Eclipse
在Eclipse中运行GeoServer
访问GeoServer首页
五 Maven指南
六 Eclipse指南
七 编程指南
八 释放指南
九 释放测试检查列表
十 CITE测试指南
十一 政策与步骤
二.介绍、工具、源代码三章
一 介绍
空。
二 工具
在GeoServer开发者环境搭建以前,需要安装以下工具:
Java
GeoServer开发需要JDK1.5及其以上版本,可从Sun Microsystems获取。
注:除了可以使用Sun提供的JDK以外,也可以使用其它的,但这里我们推荐使用Sun的。
Maven
Geoserver使用Maven工具构建。当前推荐版本是2.1.0,可从Apache获取。虽然2.1.0是推荐的,但2.0.8以上版本同样可用。
Subversion
Geoserver源代码由subversion库完成存储和版本管理。对于不同平台有多种subversion客户端可获取。更多细节请访问:/getting.html 。
三 源代码
源代码
GeoServer源代码存放在: /geoserver。
profile中文使用以下方式取出开发版/trunk版本
svn co /geoserver/trunk geoserver
使用以下方式取出稳定版/stable版本:
svn co /geoserver/branches/1.7.x geoserver
警告:Geoserver库包含大量空间数据。从上取出这些数据对于低带宽用户来说相对就很慢或者很昂贵,这种情况下,用户可以通过以下方式仅获取源代码:
svn co /geoserver/trunk/src
提交
通过以下步骤提交到代码库:
1. 安装subversion配置文件,请看后面备注。
2. 注册获取提交权限。
3. 将库切换到”https”协议,例如:
[root of checkout]% svn switch /geoserver/trunk
库结构
/geoserver/
branches/
spike/
tags/
trunk/
branches包含以前所有稳定的开发分支,1.6.x,1.7.x,etc…
spike包含实验版本和原型
tags包含以前所有释放版本
trunk为当前开发分支。
分支结构
每个开发分支都有如下所示的结构:
/geoserver/
doc/
src/
data/
l doc包含用户和开发人员向导的源文件
l src包含Geoserver本身的Java源码
l data包含多种GeoServer的数据目录
三.快速入门
本章介绍快速搭建、运行GeoServer开发环境具体步骤。我们假定您已经安装好所有必须的工具(内容见第二章)。 注:本章的上的是为了尽快的让开发者搭建和运行GeoServer。对于一些更加深入的介绍请见Maven指南和Eclipse指南。 ● 取出源代码 ● 由Maven构建 ● 由Maven生成Eclipse工程文件 ● 导入模块进Eclipse ● 在Eclipse里运行GeoServer ● 访问GeoServer首页 取出源代码由subversion库中取出源代码。选取trunk作为最新开发源码,或者那些基本不可能经常更新的版本的稳定分支。 要么是: svn co /geoserver/trunk geoserver-trunk或者(稳定的1.7.x分支 ) svn co /geoserver/branches/1.7.x geoserver-1.7.x在这页示例里面,我们假定你取出源码到一个名为geoserver的目录,不过,最好还是把名字取得更详细一点为好。 由Maven构建修改目录到源树的根,执行以下maven构建命令: cd geoserver/srcmvn clean install成功构建后会产生类似于以下的输出: [INFO] [INFO] [INFO] ------------------------------------------------------------------------ [INFO] Reactor Summary: [INFO] ------------------------------------------------------------------------ [INFO] GeoServer ............................................. SUCCESS [10.271s] [INFO] GeoServer Maven Plugins ............................... SUCCESS [0.865s] [INFO] Configuration Deployment PlugIn ....................... SUCCESS [3.820s] [INFO] GeoServer Maven Archetypes ............................ SUCCESS [0.054s] [INFO] GeoServer WFS Output Format Archetype ................. SUCCESS [0.390s] [INFO] Core Platform Module .................................. SUCCESS [5.270s] [INFO] Data Module ........................................... SUCCESS [4.521s] [INFO] Open Web Service Module ............................... SUCCESS [2.730s] [INFO] Main Module ........................................... SUCCESS [10.077s] [INFO] Web Coverage Service Module ........................... SUCCESS [3.785s] [INFO] Web Coverage Service 1.1.1 Module ..................... SUCCESS [5.254s] [INFO] Validation Module ..................................... SUCCESS [1.131s] [INFO] Web Feature Service Module ............................ SUCCESS [6.695s] [INFO] Web Feature Service Module ............................ SUCCESS [1.197s] [INFO] Web Map Service Module ................................ SUCCESS [8.519s] [INFO] Geoserver REST Support Code ........................... SUCCESS [3.366s] [INFO] GeoWebCache (GWC) Module .............................. SUCCESS [0.255s] [INFO] Web Application Module ................................ SUCCESS [27.386s] [INFO] Community Space ....................................... SUCCESS [0.312s] [INFO] GeoServer Extensions .................................. SUCCESS [0.071s] [INFO] ------------------------------------------------------------------------ [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------------ 由Maven生成Eclipse工程文件生成Eclipse使用的.project文件和.classpath文件: mvn eclipse:eclipse导入模块进Eclipse1. 启动运行Eclipse集成开发环境 2. 打开Eclipse首选项Preferences 3. 依次点击进入:Java,BuildPath,Classpath Variables,点击New 4. 创建类路径变量名称”M2_REPO”,并且设置它的值为本地Maven库的位置,点击OK。 5. 单击OK以应用新的Eclipse首选项。 6. 在包浏览Package Explorer右键并单击导入Import… 7. 选择 已有工程导入工作区 Existing Projects into Workspace,单击下一步: 8. 进入geoserver/src目录 9. 确保所有模块都被选取,单击完成Finish 在Eclipse中运行GeoServer1. 在包浏览Package Explorer中选择web-app模块(1.7.x或更早版本是web) 2. 点击进入server.web包(1.7.x或更早版本是server.jetty) 3. 在Start类上右键,单击Run as, Java Application 访问GeoServer首页● 几秒后,就可通过localhost:8080/geoserver访问到GeoServer ● 默认的用户admin的密码是geoserver |
四.Maven指南
本章是使用Maven构建GeoServer的参考。
安装Maven见工具(第二章)
运行MavenMaven提供了从模块编译到生成测试覆盖报告的多种命令。大部分maven命令可在源树的根运行,或者某个特模块。
注:在准备由源树的根运行maven命令时,请记住要将取出的根目录变换到src目录。
在由源树的根运行一个命令时,或者从包含其它模块的目录时,命令将会为所有模块运行。当从单个模块运行命令时,它只为这个模块运行。
构建GeoServer最常用的命令是安装命令:
mvn clean install虽然clean命令不是必须的,但我们还是推荐用上。上面的命令做了以下的事:
编译源代码
运行单元测试
安装成果到本地Maven库
跳过测试通常在构建时跳过单元测试很有用处。在构建命令中添加-DskipTests标志就可以只编译单元测试而不会运行测试。
mvn -DskipTests clean install离线构建Maven操作会自动下载待构建模块中声明的依赖库。当处理快照(SNAPSHOT)依赖时,这就有可能会有问题。Maven每次执行一天内的首次构建时,会尝试更新它的快照依赖。
由于GeoServer依赖GeoTools库的快照版本,这时可能会有问题。最终导致Maven下载大量GeoTools更新模块并且急剧增加构建时间。而如果你只是本地构建geotools,这些就显得不必要了。
这时,可以使用“离线”方式运行Maven来改进:
mvn -o clean install在离线模式中,Maven不会下载任何外部依赖,也不会更新任何快照依赖。
构建扩展默认情况下,扩展没有被包含在构建中。它们得通过Profile来明确增加到构建中。比如下面的示例就将restconfig扩展添加到构建中:
mvn clean install -P restconfig可以同时添加多个扩展同时使用:
mvn clean install -P restconfig,oracle有个特殊的名为allExtensions的Profile可以添加所有扩展:mvn clean install -P allExtensionsProfilesEclipseMaven的Eclipse插件用于为模块生成eclipse工程:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论