《geoserver中文开发手册》由会员分享,可在线阅读,更多相关《geoserver中文开发手册(15页珍藏版)》请在金锄头文库上搜索。
1、geoserver中文开发手册一目录目录写在前面一介绍二工具JavaMavenSubversion三源代码源代码提交库结构分支结构四快速入门取出源代码由Maven构建由Maven生成Eclipse工程文件导入模块进Eclipse在Eclipse中运行GeoServer访问GeoServer首页五Maven指南六Eclipse指南七编程指南八释放指南九释放测试检查列表十CITE测试指南十一政策与步骤二介绍、工具、源代码三章一介绍空.二工具在GeoServer开发者环境搭建以前,需要安装以下工具:JavaGeoServer开发需要JDK1.5与其以上版本,可从Sun Microsystems获取.
2、注:除了可以使用Sun提供的JDK以外,也可以使用其它的,但这里我们推荐使用Sun的.MavenGeoserver使用Maven工具构建.当前推荐版本是,可从Apache获取.虽然是推荐的,但以上版本同样可用.SubversionGeoserver源代码由subversion库完成存储和版本管理.对于不同平台有多种subversion客户端可获取.更多细节请访问:.三源代码源代码GeoServer源代码存放在:.使用以下方式取出开发版/trunk版本使用以下方式取出稳定版/stable版本:警告:Geoserver库包含大量空间数据.从上取出这些数据对于低带宽用户来说相对就很慢或者很昂贵,这种
3、情况下,用户可以通过以下方式仅获取源代码:提交通过以下步骤提交到代码库:1.安装subversion配置文件,请看后面备注.2.注册获取提交权限.3.将库切换到s协议,例如:库结构 branches/ spike/ tags/ trunk/branches包含以前所有稳定的开发分支,etcspike包含实验版本和原型tags包含以前所有释放版本trunk为当前开发分支.分支结构每个开发分支都有如下所示的结构: doc/ src/ data/ldoc包含用户和开发人员向导的源文件lsrc包含Geoserver本身的Java源码ldata包含多种GeoServer的数据目录三快速入门本章介绍快速搭
4、建、运行GeoServer开发环境具体步骤.我们假定您已经安装好所有必须的工具内容见第二章.注:本章的上的是为了尽快的让开发者搭建和运行GeoServer.对于一些更加深入的介绍请见Maven指南和Eclipse指南.l取出源代码l由Maven构建l由Maven生成Eclipse工程文件l导入模块进Eclipsel在Eclipse里运行GeoServerl访问GeoServer首页取出源代码由subversion库中取出源代码.选取trunk作为最新开发源码,或者那些基本不可能经常更新的版本的稳定分支.要么是:svncogeoserver-trunk或者稳定的分支svnco在这页示例里面,我们
5、假定你取出源码到一个名为geoserver的目录,不过,最好还是把名字取得更详细一点为好.由Maven构建修改目录到源树的根,执行以下maven构建命令:cdgeoserver/srcmvncleaninstall成功构建后会产生类似于以下的输出:INFOINFOINFO-INFOReactorSummary:INFO-INFOGeoServer.SUCCESS10.271sINFOGeoServerMavenPlugins.SUCCESS0.865sINFOConfigurationDeploymentPlugIn.SUCCESS3.820sINFOGeoServerMavenArchety
6、pes.SUCCESS0.054sINFOGeoServerWFSOutputFormatArchetype.SUCCESS0.390sINFOCorePlatformModule.SUCCESS5.270sINFODataModule.SUCCESS4.521sINFOOpenWebServiceModule.SUCCESS2.730sINFOMainModule.SUCCESS10.077sINFOWebCoverageServiceModule.SUCCESS3.785sINFOWebCoverageService1.1.1Module.SUCCESS5.254sINFOValidati
7、onModule.SUCCESS1.131sINFOWebFeatureServiceModule.SUCCESS6.695sINFOWebFeatureServiceModule.SUCCESS1.197sINFOWebMapServiceModule.SUCCESS8.519sINFOGeoserverRESTSupportCode.SUCCESS3.366sINFOGeoWebCacheModule.SUCCESS0.255sINFOWebApplicationModule.SUCCESS27.386sINFOCommunitySpace.SUCCESS0.312sINFOGeoServ
8、erExtensions.SUCCESS0.071sINFO-INFO-INFOBUILDSUCCESSFULINFO-由Maven生成Eclipse工程文件生成Eclipse使用的.project文件和.classpath文件:mvneclipse:eclipse导入模块进Eclipse1.启动运行Eclipse集成开发环境2.打开Eclipse首选项Preferences3.依次点击进入:Java,BuildPath,ClasspathVariables,点击New4.创建类路径变量名称M2_REPO,并且设置它的值为本地Maven库的位置,点击OK.5.单击OK以应用新的Eclipse首
9、选项.6.在包浏览PackageExplorer右键并单击导入Import7.选择已有工程导入工作区ExistingProjectsintoWorkspace,单击下一步:8.进入geoserver/src目录9.确保所有模块都被选取,单击完成Finish在Eclipse中运行GeoServer1.在包浏览PackageExplorer中选择web-app模块或更早版本是web2.点击进入包或更早版本是3.在Start类上右键,单击Runas,JavaApplication访问GeoServer首页l几秒后,就可通过:/localhost:8080/geoserver访问到GeoServerl
10、默认的用户admin的密码是geoserver四Maven指南本章是使用Maven构建GeoServer的参考.安装Maven见工具第二章运行MavenMaven提供了从模块编译到生成测试覆盖报告的多种命令.大部分maven命令可在源树的根运行,或者某个特模块.注:在准备由源树的根运行maven命令时,请记住要将取出的根目录变换到src目录.在由源树的根运行一个命令时,或者从包含其它模块的目录时,命令将会为所有模块运行.当从单个模块运行命令时,它只为这个模块运行.构建GeoServer最常用的命令是安装命令:mvncleaninstall虽然clean命令不是必须的,但我们还是推荐用上.上面的
11、命令做了以下的事:编译源代码运行单元测试安装成果到本地Maven库跳过测试通常在构建时跳过单元测试很有用处.在构建命令中添加-DskipTests标志就可以只编译单元测试而不会运行测试.mvn-DskipTestscleaninstall离线构建Maven操作会自动下载待构建模块中声明的依赖库.当处理快照SNAPSHOT依赖时,这就有可能会有问题.Maven每次执行一天内的首次构建时,会尝试更新它的快照依赖.由于GeoServer依赖GeoTools库的快照版本,这时可能会有问题.最终导致Maven下载大量GeoTools更新模块并且急剧增加构建时间.而如果你只是本地构建geotools,这些就显得不必要了.这时,可以使用离线方式运行Maven来改进:mvn-ocleaninstall在离线模式中,Maven不会下载任何外部依赖,也不会更新任何快照依赖.构建扩展默认情况下,扩展没有被包含在构建中.它们得通过Profile来明确增加到构建中.比如下面的示例就将restconfig扩展添加到构建中:mvncleaninstall-Prestconfig可以同时添加