107 lines
4.7 KiB
Markdown
107 lines
4.7 KiB
Markdown
---
|
||
title: GeoServer二级开发-环境配置
|
||
date: 2021-04-23
|
||
author: ac
|
||
sticky: 2
|
||
tags:
|
||
- GeoServer
|
||
categories:
|
||
- GIS
|
||
---
|
||
|
||
### 1. 工具
|
||
|
||
- jdk8：geoserver中的各模块都是指定了jdk为1.8，所以建议采用jdk8
|
||
- maven：jar包管理
|
||
- idea
|
||
|
||
> GeoServer Development requires Java 8, Maven, and git. Due to subtle changes in Java class libraries we require development on Java 8 at this time (although the result is tested on Java 11).
|
||
|
||
官方是建议使用git来拉取geoserver的源码，这里我采用的是直接下载源码的方式。
|
||
|
||
|
||
|
||
### 2. 构建项目
|
||
|
||
进入src目录，使用maven命令构建项目：
|
||
|
||
```groovy
|
||
//-DskipTests，不执行测试用例，但编译测试用例类生成相应的class文件至target/test-classes下
|
||
mvn -DskipTests install
|
||
```
|
||
|
||
该命令会下载pom文件中的依赖，将项目和各模块构建到本地仓库，以及编译各模块代码。
|
||
|
||
|
||
|
||
> 较旧的版本使用的仓库是`Boundless Maven Repository`，较新的版本是使用`OSGeo Nexus Release Repository`
|
||
|
||
|
||
|
||
生成的编译文件在target目录下：
|
||
|
||
<img src="../images/geoserver/image-20210423180211319.png" alt="image-20210423180211319" style="zoom:50%;" />
|
||
|
||
> 注意:这里生成的annotaions、javacc、javacc-timestamp、jjtree-timestamp在项目中都是作为sources root资源。
|
||
|
||
|
||
|
||
### 3. 配置项目
|
||
|
||
- 编译器使用`Eclipse`
|
||
|
||
|
||
|
||
- 配置Maven，在IDEA中指定本地的Maven路径，确保`mvn install`命令打包的模块jar包在同一个仓库内。后续的开发中需要引用到源码中的模块
|
||
|
||
|
||
|
||
- 修改启动参数
|
||
|
||
<img src="../images/geoserver/image-20210423180852683.png" alt="image-20210423180852683" style="zoom:67%;" />
|
||
|
||
添加一个VM Option参数`-DGEOSERVER_DATA_DIR`，用来指定`GeoServer`应用的【数据目录】；
|
||
|
||
把`Working directory`修改为`$MODULE_DIR$`，这样各模块的工作路径为模块各自的相对路径。
|
||
|
||
> 默认的【数据目录】在项目的web模块中：
|
||
>
|
||
> -DGEOSERVER_DATA_DIR=${PROJECT}/src/web/app/src/main/webapp/data/
|
||
|
||
- 启动项目
|
||
|
||
|
||
|
||
在浏览器中输入`http://localhost:8080/geoserver`可以访问刚启动的`GeoServer`应用。
|
||
|
||
|
||
|
||
|
||
|
||
### 4. 项目结构
|
||
|
||
- `platform` 包的`org.geoserver.platform.Service` 类代表服务，提供id、版本、支持的操作等元数据的描述信息。如果两个服务的id和版本相同则会被认为是同一个服务;
|
||
- `platform` 包的`org.geoserver.platform.Operation` 类代表某个服务下可以被请求的操作，例如`GetCapabilities`，这个类利用Java的反射机制；
|
||
- `ows` 包的`org.geoserver.ows.Dispatcher` 类处理所有`OWS`的请求；
|
||
- `main` 包的`org.geoserver.catalog.Catalog` 接口包含资源访问的方法，这些资源有"Layer"，"Layer Group"，"Map"，"Namesapce"，"Resource"，"Store"，"Style"和"Workspace"；
|
||
- `main` 包的`org.geoserver.config.GeoServer` 接口包含访问服务器公共配置信息的方法；
|
||
|
||
|
||
|
||
### 5. 第三方库
|
||
|
||
- `GeoTools`可以说是Java语言的`GIS`标准包，它继承了`GeoAPI`，一个符合`OGC`简单要素访问协议（[Simple Feature Access](http://www.opengeospatial.org/standards/sfa)）的Java包，提供了大量`GIS`操作，包括多种格式的空间数据源访问，地图渲染，空间几何操作，`GeoServer`的`GIS`部分完全使用它来实现；
|
||
- `Spring`框架，GeoServer用它来构建运行时环境，通过Spring容器来管理项目的bean实例。我们会在“main”，“wcs”，“wfs”和“wms”下面看到这样一个文件`applicationContext.xml`，这个文件告诉spring框架需要创建哪些类实例，以及如何创建；
|
||
- `FreeMarker`是一个模板引擎， 即一种基于模板和要改变的数据， 并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。我们可以很容易实现对象模型与输出格式的分离，`GeoServer`用它来实现某些HTML文本的输出；
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
### 参考文章
|
||
|
||
[1] GeoServer源码解析和扩展 （一）基础篇 https://blog.csdn.net/hnzhangshilong/article/details/6822233
|
||
|
||
[2] Quickstart https://docs.geoserver.org/latest/en/developer/quickstart/index.html |