geoserver中文开发手册

《geoserver中文开发手册》由会员上传分享，免费在线阅读，更多相关内容在工程资料-天天文库。

WORD格式可编辑geoserver中文开发手册一．目录目 录写在前面一 介绍二 工具JavaMavenSubversion三 源代码源代码提交库结构分支结构四 快速入门取出源代码由Maven构建由Maven生成Eclipse工程文件导入模块进Eclipse在Eclipse中运行GeoServer访问GeoServer首页五 Maven指南六 Eclipse指南七 编程指南八 释放指南九 释放测试检查列表十 CITE测试指南专业知识整理分享 WORD格式可编辑十一 政策与步骤二．介绍、工具、源代码三章一 介绍空。二 工具在GeoServer开发者环境搭建以前，需要安装以下工具：JavaGeoServer开发需要JDK1.5及其以上版本，可从SunMicrosystems获取。注：除了可以使用Sun提供的JDK以外，也可以使用其它的，但这里我们推荐使用Sun的。MavenGeoserver使用Maven工具构建。当前推荐版本是2.1.0，可从Apache获取。虽然2.1.0是推荐的，但2.0.8以上版本同样可用。SubversionGeoserver源代码由subversion库完成存储和版本管理。对于不同平台有多种subversion客户端可获取。更多细节请访问：http://subversion.tigris.org/getting.html 。三 源代码源代码GeoServer源代码存放在: http://svn.codehaus.org/geoserver。使用以下方式取出开发版/trunk版本svncohttp://svn.codehaus.org/geoserver/trunkgeoserver使用以下方式取出稳定版/stable版本：svncohttp://svn.codehaus.org/geoserver/branches/1.7.xgeoserver警告：Geoserver库包含大量空间数据。从上取出这些数据对于低带宽用户来说相对就很慢或者很昂贵，这种情况下，用户可以通过以下方式仅获取源代码：svncohttp://svn.codehaus.org/geoserver/trunk/src提交通过以下步骤提交到代码库：1. 安装subversion配置文件，请看后面备注。2. 注册获取提交权限。3. 将库切换到”https”协议，例如：专业知识整理分享 WORD格式可编辑[rootofcheckout]%svnswitchhttps://svn.codehaus.org/geoserver/trunk 库结构http://svn.codehaus.org/geoserver/  branches/  spike/  tags/  trunk/ branches包含以前所有稳定的开发分支，1.6.x，1.7.x，etc… spike包含实验版本和原型 tags包含以前所有释放版本 trunk为当前开发分支。分支结构每个开发分支都有如下所示的结构：http://svn.codehaus.org/geoserver/  doc/  src/  data/l doc包含用户和开发人员向导的源文件l src包含Geoserver本身的Java源码l data包含多种GeoServer的数据目录 三．快速入门本章介绍快速搭建、运行GeoServer开发环境具体步骤。我们假定您已经安装好所有必须的工具（内容见第二章）。注：本章的上的是为了尽快的让开发者搭建和运行GeoServer。对于一些更加深入的介绍请见Maven指南和Eclipse指南。l取出源代码l由Maven构建l由Maven生成Eclipse工程文件l专业知识整理分享 WORD格式可编辑导入模块进Eclipsel在Eclipse里运行GeoServerl访问GeoServer首页取出源代码由subversion库中取出源代码。选取trunk作为最新开发源码，或者那些基本不可能经常更新的版本的稳定分支。要么是：svn co https://svn.codehaus.org/geoserver/trunk geoserver-trunk或者（稳定的1.7.x分支）svn co https://svn.codehaus.org/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首选项Preferences3.依次点击进入：Java，BuildPath，Classpath Variables，点击New专业知识整理分享 WORD格式可编辑 4.创建类路径变量名称”M2_REPO”,并且设置它的值为本地Maven库的位置，点击OK。 5.单击OK以应用新的Eclipse首选项。6.在包浏览Package Explorer右键并单击导入Import… 7.选择已有工程导入工作区 Existing Projects into Workspace，单击下一步：专业知识整理分享 WORD格式可编辑 8.进入geoserver/src目录9.确保所有模块都被选取，单击完成Finish 在Eclipse中运行GeoServer1.在包浏览Package Explorer中选择web-app模块（1.7.x或更早版本是web）专业知识整理分享 WORD格式可编辑2.点击进入org.geoserver.web包（1.7.x或更早版本是org.vfny.geoserver.jetty）3.在Start类上右键，单击Run as， Java Application 访问GeoServer首页l几秒后，就可通过http://localhost:8080/geoserver访问到GeoServerl默认的用户admin的密码是geoserver 四．Maven指南本章是使用Maven构建GeoServer的参考。安装Maven见工具（第二章）运行MavenMaven提供了从模块编译到生成测试覆盖报告的多种命令。大部分maven命令可在源树的根运行，或者某个特模块。注：在准备由源树的根运行maven命令时，请记住要将取出的根目录变换到src目录。在由源树的根运行一个命令时，或者从包含其它模块的目录时，命令将会为所有模块运行。当从单个模块运行命令时，它只为这个模块运行。构建GeoServer最常用的命令是安装命令：mvn clean install虽然clean命令不是必须的，但我们还是推荐用上。上面的命令做了以下的事：编译源代码专业知识整理分享 WORD格式可编辑运行单元测试安装成果到本地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工程：mvn eclipse:eclipse经过此操作后，这些模块就可以导入Eclipse工作区。该插件有个很有用的功能就是可下载第三方依赖的相关源代码。这是通过添加downloadSources标志来做的：mvn -DdownloadSources eclipse:eclipse警告：当你首次启用downloadSources标志时，构建过程需要很长时间，因为它要下载GeoServer所依赖的每个库的源代码。专业知识整理分享 WORD格式可编辑构建Web模块当安装好web模块后，它会通过内建的特殊配置构建。默认情况下它注是minimal配置。尽管如此，它也可以通过设置configId和configDirectory标志来定制任意配置。比如：mvn clean install -DconfigId=release -DconfigDirectory=/home/jdeolive/geoserver_1.7.x/data上面命令可使用GeoServer上的release配置构建web模块。configId是包含的配置目录名称，configDirectory是包含的配置目录的父级目录。configDirectory可以像刚才的一样的绝对路径，也可以是针对web模块自身的相对路径：mvn clean install -DconfigId=release -DconfigDirectory=../../../data上面的命令与之前有同样的效果，尽管是引用了相对于web模块的路径。该路径，../../../data，在GeoServer取出(check out)的代码目录结构是标准结构的情况下可用。使用Jetty运行web模块Maven的jetty插件可用于运行嵌入了jetty容器的基于web的模块：cd geoserver_1.7.x/src/webmvn jetty:run注：该命令必须从web模块运行，如果从其它模块运行就会失败。上面的命令将会使用自带的数据目录来运行GeoServer。为了使用其它的数据目录可以启用GEOSERVER_DATA_DIR标志：mvn -DGEOSERVER_DATA_DIR=/path/to/datadir jetty:run五．Eclipse指南本章是使用Eclipse开发GeoServer的参考。导入模块运行和调试设置数据目录更改Jetty默认端口专业知识整理分享 WORD格式可编辑配置Jetty中JNDI资源Eclipse首选项代码格式化代码模块文本编辑器编译器导入模块参见Maven指南中的Eclipse部分。运行和调试运行和调试web-app模块中org.geoserver.web.Start类。具体步骤见快速入门。设置数据目录如果未设置，GeoServer默认会使用web-app模块里的minimal目录作为它的数据目录。若要修改，执行以下步骤：1.在Eclipse菜单中打开调试配置（Debug Configurations） 2.先把Start配置，选择Argument面板，并且填写-DGEOSERVER_DATA_DIR参数，设置数据目录为绝对路径。专业知识整理分享 WORD格式可编辑 更改Jetty默认端口如果未设置，Jetty默认会使用8080端口。修改请按以下方式：1.打开上节所说的Start配置中的Argument面板。2.填写-Djetty.port参数，设置它到期望的端口 配置Jetty的JNDI资源JNDI资源如数据资源可以通过提供系统属性中名为jetty.config.file的Jetty服务器配置文件来配置，这个可以在Start配置中的Argument面板上通过VM argument参数指定。配置文件路径是相对于web-app模块根路径的，该模块是启动配置运行的地方。例如：专业知识整理分享 WORD格式可编辑-Djetty.config.file=../../../../../settings/jetty.xml以下的Jetty服务器配置文件就配置了一个JNDI数据源：jdbc/demo，它是一个Oracle数据库的连接池。  jdbc/demo     oracle.jdbc.driver.OracleDriverjdbc:oracle:thin:@oracle.example.com:1521:demodb                claudius              s3cr3t               20          10          0   10000      300000   300000 20  true    100  true      SELECT SYSDATE FROM DUAL                            Jetty没有在GeoServer的WEB-INF/web.xml指定reference-ref，因此没必要修改该文件。GeoServer web-app模块和数据目录没有特定于Jetty的相关信息，因此JNDI资源可以被测试在Jetty下，以便于后面在Tomcat下的开发。也可以看看GeoServer用户手册中Tomcat中建立JNDI连接池章节。专业知识整理分享 WORD格式可编辑Eclipse首选项代码格式化1.下载文件：http://svn.osgeo.org/geotools/trunk/build/eclipse/formatter.xml2.转到首选项中Java，Code Style，Formatter，点击Import… 3.选择步骤1中下载的formatter.xml文件。4.点击Apply 代码模板1.下载文件：http://svn.osgeo.org/geotools/trunk/build/eclipse/codetemplates.xml2.转到首选项Java，Code Style, Formatter,点击Important…专业知识整理分享 WORD格式可编辑 3.选择步骤1中下载的formatter.xml文件。4.点击Apply文本编辑器1.转到General，Editors，Text Editors2.选中Insert Space for tabs3.选中Show print margin，将Print margin column设置为1004.选中Show line numbers5.选中Show whitespace characters（可选）注：显示空白字符可帮助我们发现无意中提交不必要的空格。专业知识整理分享 WORD格式可编辑 6.点击Apply编译器1.转到Java, Compiler, Building2.扩展开Output folder，并将.svn/加到Filtered resources列表中。  专业知识整理分享 WORD格式可编辑3.点击Apply六．编程指南OWS服务本节介绍GeoServer中OWS服务（原文为RESTful服务，可能为笔误）如何工作。OWS服务概览TBA实现一个简单的OWS服务本节将通过以下场景来介绍如何给GeoServer创建一个简单的GeoServer OWS服务。该服务需要提供一个能广告叫做“sayHello”的单一操作的功能（capabilities）文档。该sayHello操作的结果是一个简单的字符串：“Hello World”。内容： 实现一个简单的OWS服务l建立l创建插件l试一试建立创建插件的第一步是为它建立一个maven工程。该工程我们称为“hello”。1.在本地文件系统中任意地方创建一个名为hello的新目录。2.给hello目录添加名为pom.xml文件。1.2.3.4.   4.0.05.   6.  7.    org.geoserver8.    community9.    2.0.110.  11.   org.geoserver12.  hello13.  jar14.  1.0专业知识整理分享 WORD格式可编辑1.   Hello World Service Module2.  3.    4.      org.geoserver5.      main6.      2.0.17.    8.  9.   10.    11.       opengeo12.       opengeo13.       http://repo.opengeo.org14.    15.  16.复制代码3.在hello目录下创建Java源文件目录。hello/+ pom.xml+ src/+ main/+ java/创建插件插件是一系列由spring beans实现的扩展。实例中扩展兴趣点是一个HelloWorld的POJO。1.创建一个名为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 HelloWorld() {  7.   // Do nothing 8.}  9.  public void sayHello(HttpServletRequest request, HttpServletResponse response)10.       throws ServletException, IOException { 11.          response.getOutputStream().write( "Hello World".getBytes() );12.    }13.  }专业知识整理分享 WORD格式可编辑复制代码该服务相对比较简单。它提供了一个一个名为sayHello的方法，带有HttpServletRequest，HttpServletResponse参数。该函数的参数列表会由org.geoserver.ows.Dispatcher自动发现。2.创建applicationContext.xml文件将上面的类申明为一个bean。1.2.3.4.5.    6.    7.        8.     9.        10.    11.        12.         13.        14.         15.        16.         17.        18.            19.                20.sayHello21.            22.        23.         24.复制代码到此，hello工程内容应该是看上去像下面这样了：hello/+ pom.xml+ src/+ main/+ java/+ HelloWorld.java专业知识整理分享 WORD格式可编辑+ 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: [install]7.[INFO] ----------------------------------------------------------------------------8.[INFO] [resources:resources]9.[INFO] Using default encoding to copy filtered resources.10.[INFO] [compiler:compile]11.[INFO] Compiling 1 source file to /home/ak/geoserver/community/hello/target/classes12.[INFO] [resources:testResources]13.[INFO] Using default encoding to copy filtered resources.14.[INFO] [compiler:testCompile][INFO] No sources to compile15.[INFO] [surefire:test][INFO] No tests to run.16.[INFO] [jar:jar]17.[INFO] Building jar: /home/ak/geoserver/community/hello/target/hello-1.0.jar18.[INFO] [jar:test-jar {execution: default}][WARNING] JAR will be empty - no content was marked for inclusion!19.[INFO] Building jar: /home/ak/geoserver/community/hello/target/hello-1.0-tests.jar20.[INFO] [install:install]21.[INFO] Installing /home/ak/geoserver/community/hello/target/hello-1.0.jar to /home/ak/.m2/repository/org/geoserver/hello/1.0/hello-1.0.jar22.[INFO] Installing /home/ak/geoserver/community/hello/target/hello-1.0-tests.jar to /home/ak/.m2/repository/org/geoserver/hello/1.0/hello-1.0-tests.jar23.[INFO] ------------------------------------------------------------------------24.[INFO] BUILD SUCCESSFUL25.[INFO] ------------------------------------------------------------------------26.[INFO] Total time: 6 seconds27.[INFO] Finished at: Fri Sep 21 14:52:31 EDT 200728.[INFO] Final Memory: 27M/178M29.[INFO] -----------------------------------------------------------------------复制代码1.拷贝target/hello-1.0.jar文件到到你的GeoServer安装的WEB-INF/lib目录。专业知识整理分享 WORD格式可编辑2.重启GeoServer。3.访问：http:/geoserver/ows?request=sayHello&service=hello&version=1.0.0请求request我们服务内定义的方法服务serviceapplicationContext.xml文件中Service描述符的名称版本versionapplicationContext.xml文件中Service描述符的版本 可选方法1.与web模块一起构建另外一个可选方法是在新的插件工程上从web模块申明一个依赖。1.像上面一样安装hello模块。2.编辑web/pom.xml，添加如下依赖：org.geoserverhello1.03.安装、运行web模块[web] mvn install jetty:run4.访问：http://localhost:8080/geoserver/ows?request=sayHello&service=hello&version=1.0.0专业知识整理分享 WORD格式可编辑可选方法2：由GeoServer源中运行作为尝试插件开发的一种可选方法：1.安装hello模块。2.更改路径到web模块3.安装web模块。4.拷贝/target/hello-1.0.jar文件到/target/geoserver/WEB-INF/lib目录：[/dev/geoserver/web]% cp ~/hello/target/hello-1.0.jar target/geoserver/WEB-INF/lib5.使用Jetty运行打包的war。[/dev/geoserver/web]% mvn jetty6:run-exploded6.访问：http://localhost:8080/geoserver/ows?request=sayHello&service=hello&version=1.0.0  专业知识整理分享