geoserver中文开发手册

1、geoserver中文开发手册一目录目 录写在前面一 介绍二 工具JavaMavenSubversion三 源代码源代码提交库结构分支结构四 快速入门取出源代码由Maven构建由Maven生成Eclipse工程文件导入模块进Eclipse在Eclipse中运行GeoServer访问GeoServer首页五 Maven指南六 Eclipse指南七 编程指南八 释放指南九 释放测试检查列表十 CITE测试指南十一 政策与步骤二介绍、工具、源代码三章一 介绍空。二

2、0;工具在GeoServer开发者环境搭建以前，需要安装以下工具：JavaGeoServer开发需要JDK1.5及其以上版本，可从Sun Microsystems获取。注：除了可以使用Sun提供的JDK以外，也可以使用其它的，但这里我们推荐使用Sun的。MavenGeoserver使用Maven工具构建。当前推荐版本是，可从Apache获取。虽然是推荐的，但以上版本同样可用。SubversionGeoserver源代码由subversion库完成存储和版本管理。对于不同平台有多种subversion客户端可获取。更多细节请访问： 。三 源代码源代码GeoServer源代码存

3、放在: 。使用以下方式取出开发版/trunk版本使用以下方式取出稳定版/stable版本：警告：Geoserver库包含大量空间数据。从上取出这些数据对于低带宽用户来说相对就很慢或者很昂贵，这种情况下，用户可以通过以下方式仅获取源代码：提交通过以下步骤提交到代码库：1. 安装subversion配置文件，请看后面备注。2. 注册获取提交权限。3. 将库切换到”https”协议，例如： 库结构   branches/   spike/   tags/   trunk/

4、 branches包含以前所有稳定的开发分支，etc spike包含实验版本和原型 tags包含以前所有释放版本 trunk为当前开发分支。分支结构每个开发分支都有如下所示的结构：   doc/   src/   data/l doc包含用户和开发人员向导的源文件l src包含Geoserver本身的Java源码l data包含多种GeoServer的数据目录 三快速入门本章介绍快速搭建、运行GeoServer开发环境具体步骤。我们假定您已经安装好所有必须

5、的工具（内容见第二章）。注：本章的上的是为了尽快的让开发者搭建和运行GeoServer。对于一些更加深入的介绍请见Maven指南和Eclipse指南。l取出源代码l由Maven构建l由Maven生成Eclipse工程文件l导入模块进Eclipsel在Eclipse里运行GeoServerl访问GeoServer首页取出源代码由subversion库中取出源代码。选取trunk作为最新开发源码，或者那些基本不可能经常更新的版本的稳定分支。要么是：svn co  geoserver-trunk或者（稳定的分支）svn co  在这页示例里

6、面，我们假定你取出源码到一个名为geoserver的目录，不过，最好还是把名字取得更详细一点为好。由Maven构建修改目录到源树的根，执行以下maven构建命令：cd geoserver/srcmvn clean install成功构建后会产生类似于以下的输出：INFOINFOINFO -INFO Reactor Summary:INFO -INFO GeoServer . SUCCESS 10.271sINFO GeoServer Maven Plugi

7、ns . SUCCESS 0.865sINFO Configuration Deployment PlugIn . SUCCESS 3.820sINFO GeoServer Maven Archetypes . SUCCESS 0.054sINFO GeoServer WFS Output Format Archetype . SUCCESS 0.390sINFO&#

8、160;Core Platform Module . SUCCESS 5.270sINFO Data Module . SUCCESS 4.521sINFO Open Web Service Module . SUCCESS 2.730sINFO Main Module . SUCCESS 10.077sINFO Web Coverage Serv

9、ice Module . SUCCESS 3.785sINFO Web Coverage Service 1.1.1 Module . SUCCESS 5.254sINFO Validation Module . SUCCESS 1.131sINFO Web Feature Service Module . SUCCESS 6.695sINFO W

10、eb Feature Service Module . SUCCESS 1.197sINFO Web Map Service Module . SUCCESS 8.519sINFO Geoserver REST Support Code . SUCCESS 3.366sINFO GeoWebCache (GWC) Module . SUCCESS&

11、#160;0.255sINFO Web Application Module . SUCCESS 27.386sINFO Community Space . SUCCESS 0.312sINFO GeoServer Extensions . SUCCESS 0.071sINFO -INFO -INFO BUILD SUCCESSFULINFO -由Maven生成Eclipse工程文件生成

12、Eclipse使用的.project文件和.classpath文件：mvn eclipse:eclipse导入模块进Eclipse1.启动运行Eclipse集成开发环境2.打开Eclipse首选项Preferences3.依次点击进入：Java，BuildPath，Classpath Variables，点击New 4.创建类路径变量名称”M2_REPO”,并且设置它的值为本地Maven库的位置，点击OK。 5.单击OK以应用新的Eclipse首选项。6.在包浏览Package Explorer右键并单击导入Import 7.选择已有

13、工程导入工作区 Existing Projects into Workspace，单击下一步： 8.进入geoserver/src目录9.确保所有模块都被选取，单击完成Finish 在Eclipse中运行GeoServer1.在包浏览Package Explorer中选择web-app模块（或更早版本是web）2.点击进入包（或更早版本是）3.在Start类上右键，单击Run as， Java Application 访问GeoServer首页l几秒后，就可通过http:/localh

14、ost:8080/geoserver访问到GeoServerl默认的用户admin的密码是geoserver 四Maven指南本章是使用Maven构建GeoServer的参考。安装Maven见工具（第二章）运行MavenMaven提供了从模块编译到生成测试覆盖报告的多种命令。大部分maven命令可在源树的根运行，或者某个特模块。注：在准备由源树的根运行maven命令时，请记住要将取出的根目录变换到src目录。在由源树的根运行一个命令时，或者从包含其它模块的目录时，命令将会为所有模块运行。当从单个模块运行命令时，它只为这个模块运行。构建GeoServer最常用的命令是安装命令：mvn&

15、#160;clean install虽然clean命令不是必须的，但我们还是推荐用上。上面的命令做了以下的事：编译源代码运行单元测试安装成果到本地Maven库跳过测试通常在构建时跳过单元测试很有用处。在构建命令中添加-DskipTests标志就可以只编译单元测试而不会运行测试。mvn -DskipTests clean install离线构建Maven操作会自动下载待构建模块中声明的依赖库。当处理快照（SNAPSHOT）依赖时，这就有可能会有问题。Maven每次执行一天内的首次构建时，会尝试更新它的快照依赖。由于GeoServer依赖GeoTools库的

16、快照版本，这时可能会有问题。最终导致Maven下载大量GeoTools更新模块并且急剧增加构建时间。而如果你只是本地构建geotools，这些就显得不必要了。这时，可以使用“离线”方式运行Maven来改进：mvn -o clean install在离线模式中，Maven不会下载任何外部依赖，也不会更新任何快照依赖。构建扩展默认情况下，扩展没有被包含在构建中。它们得通过Profile来明确增加到构建中。比如下面的示例就将restconfig扩展添加到构建中：mvn clean install -P restconfig可以同时

17、添加多个扩展同时使用：mvn clean install -P restconfig,oracle有个特殊的名为allExtensions的Profile可以添加所有扩展：mvn clean install -P allExtensionsProfilesEclipseMaven的Eclipse插件用于为模块生成eclipse工程：mvn eclipse:eclipse经过此操作后，这些模块就可以导入Eclipse工作区。该插件有个很有用的功能就是可下载第三方依赖的相关源代码。这是通过添加download

18、Sources标志来做的：mvn -DdownloadSources eclipse:eclipse警告：当你首次启用downloadSources标志时，构建过程需要很长时间，因为它要下载GeoServer所依赖的每个库的源代码。构建Web模块当安装好web模块后，它会通过内建的特殊配置构建。默认情况下它注是minimal配置。尽管如此，它也可以通过设置configId和configDirectory标志来定制任意配置。比如：mvn clean install -DconfigId=release -DconfigDirectory

19、=/home/jdeolive/geoserver_1.7.x/data上面命令可使用GeoServer上的release配置构建web模块。configId是包含的配置目录名称，configDirectory是包含的配置目录的父级目录。configDirectory可以像刚才的一样的绝对路径，也可以是针对web模块自身的相对路径：mvn clean install -DconfigId=release -DconfigDirectory=./././data上面的命令与之前有同样的效果，尽管是引用了相对于web模块的路径。该路径，./././data，

20、在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

21、:run五Eclipse指南本章是使用Eclipse开发GeoServer的参考。导入模块运行和调试设置数据目录更改Jetty默认端口配置Jetty中JNDI资源Eclipse首选项代码格式化代码模块文本编辑器编译器导入模块参见Maven指南中的Eclipse部分。运行和调试运行和调试web-app模块中类。具体步骤见快速入门。设置数据目录如果未设置，GeoServer默认会使用web-app模块里的minimal目录作为它的数据目录。若要修改，执行以下步骤：1.在Eclipse菜单中打开调试配置（Debug Configurations） 2.先把Start配置，选择Ar

22、gument面板，并且填写-DGEOSERVER_DATA_DIR参数，设置数据目录为绝对路径。 更改Jetty默认端口如果未设置，Jetty默认会使用8080端口。修改请按以下方式：1.打开上节所说的Start配置中的Argument面板。2.填写-Djetty.port参数，设置它到期望的端口 配置Jetty的JNDI资源JNDI资源如数据资源可以通过提供系统属性中名为的Jetty服务器配置文件来配置，这个可以在Start配置中的Argument面板上通过VM argument参数指定。配置文件路径是相对于web-app模块根路径的，该模块是启动配置运行的地方

23、。例如：-Djetty.config.file=./././././settings/jetty.xml以下的Jetty服务器配置文件就配置了一个JNDI数据源：jdbc/demo，它是一个Oracle数据库的连接池。  jdbc/demo   jdbc:oracle:thin:1521:demodb                claudius   &#

24、160;          s3cr3t               20          10          0  

25、60;10000      300000   300000 20  true    100  true      SELECT SYSDATE FROM DUAL              

26、              Jetty没有在GeoServer的WEB-INF/web.xml指定reference-ref，因此没必要修改该文件。GeoServer web-app模块和数据目录没有特定于Jetty的相关信息，因此JNDI资源可以被测试在Jetty下，以便于后面在Tomcat下的开发。也可以看看GeoServer用户手册中Tomcat中建立JNDI连接池章节。Eclipse首选项代码格式化1.下载文件：2.转到首选项中Java，

27、Code Style，Formatter，点击Import 3.选择步骤1中下载的formatter.xml文件。4.点击Apply 代码模板1.下载文件：2.转到首选项Java，Code Style, Formatter,点击Important 3.选择步骤1中下载的formatter.xml文件。4.点击Apply文本编辑器1.转到General，Editors，Text Editors2.选中Insert Space for tabs3.选中Show print mar

28、gin，将Print margin column设置为1004.选中Show line numbers5.选中Show whitespace characters（可选）注：显示空白字符可帮助我们发现无意中提交不必要的空格。 6.点击Apply编译器1.转到Java, Compiler, Building2.扩展开Output folder，并将.svn/加到Filtered resources列表中。  3.点击Apply六编程指南OWS服务本节介绍GeoServ

29、er中OWS服务（原文为RESTful服务，可能为笔误）如何工作。OWS服务概览TBA实现一个简单的OWS服务本节将通过以下场景来介绍如何给GeoServer创建一个简单的GeoServer OWS服务。该服务需要提供一个能广告叫做“sayHello”的单一操作的功能（capabilities）文档。该sayHello操作的结果是一个简单的字符串：“Hello World”。内容： 实现一个简单的OWS服务l建立l创建插件l试一试建立创建插件的第一步是为它建立一个maven工程。该工程我们称为“hello”。1.在本地文件系统中任意地方创建一个名为hello的新目

30、录。2.给hello目录添加名为pom.xml文件。1.2. <?xml version="1.0" encoding="ISO-8859-1"?>3. <project xmlns="/POM/4.0.0" xmlns:xsi="/2001/XMLSchema-instance"  xsi:schemaLocation="http:/maven.apa

31、/POM/4.0.0 /maven-v4_0_0.xsd">4.    <modelVersion>4.0.0</modelVersion>5.    <!- set parent pom to community pom ->6.   <parent>7.     <g

32、roupId>org.geoserver</groupId>8.     <artifactId>community</artifactId>9.     <version>2.0.1</version>10.   </parent>11.    <groupId>org.geoserver</groupId>12.   <artifact

33、Id>hello</artifactId>13.   <packaging>jar</packaging>14.   <version>1.0</version>15.   <name> Hello World Service Module</name>16.   <dependencies>17.     <dependency

34、>18.       <groupId>org.geoserver</groupId>19.       <artifactId>main</artifactId>20.       <version>2.0.1</version>21.     </dependency>22. 

35、0; </dependencies>23.    <repositories>24.     <repository>25.        <id>opengeo</id>26.        <name>opengeo</name>27.     

36、60;  <url></url>28.     </repository>29.   </repositories>30. </project>复制代码3.在hello目录下创建Java源文件目录。hello/+ pom.xml+ src/+ main/+ java/创建插件插件是一系列由spring beans实现的扩展。实例中扩展兴趣点是一个HelloWorl

37、d的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&#

38、160;HelloWorld()   7.    / Do nothing 8.   9.   public void sayHello(HttpServletRequest request, HttpServletResponse response)10.        throws ServletException, IOE

39、xception  11.           response.getOutputStream().write( "Hello World".getBytes() );12.     13.   复制代码该服务相对比较简单。它提供了一个一个名为sayHello的方法，带有HttpServletRequest，HttpServletResponse参数。该函数的参数列

40、表会由自动发现。2.创建applicationContext.xml文件将上面的类申明为一个bean。1. <?xml version="1.0" encoding="UTF-8"?>2.3. <!DOCTYPE beans PUBLIC "-/SPRING/DTD BEAN/EN" "/dtd/spring-beans.dtd">4. <beans>5

41、.     <!- Spring will reference the instance of the HelloWorld class           by the id name "helloService" ->6.     &

42、lt;bean id="helloService" class="HelloWorld">7.         </bean>8.      <!- This creates a Service descriptor, which allows the org.geoserver.ows.Dis

43、patcher           to locate it. ->9.         <bean id="helloService-1.0.0" class="org.geoserver.platform.Service">10.     <!-

44、60;used to reference the service in the URL ->11.         <constructor-arg index="0" value="hello"/>12.          <!- our ac

45、tual service POJO defined previously ->13.         <constructor-arg index="1" ref="helloService"/>14.          <!- a version number&#

46、160;for this service ->15.         <constructor-arg index="2" value="1.0.0"/>16.          <!- a list of functions for this 

47、service ->17.         <constructor-arg index="3">18.             <list>19.                

48、 <value>20. sayHello</value>21.             </list>22.         </constructor-arg>23.          </bean>24. </beans>复

49、制代码到此，hello工程内容应该是看上去像下面这样了：hello/+ pom.xml+ src/+ main/+ java/+ HelloWorld.java+ 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: install7. INFO -8. INFO resources:resources9. INFO Using default encoding to copy filtered resources.10. INFO compiler:compile11. INFO Compiling 1 source&