GeoServer开发环境搭建

前言

本文用于记录GeoServer开发环境的搭建过程

release

通过GeoServer发布计划可以看到，在2.23.x版本开始，会移除对jdk1.8的支持。那么当前我们会选择2.22.x版本进行研究

环境

JAVA：1.8或11
Maven
Git

Action

获取源码


git clone git://github.com/geoserver/geoserver.git geoserver

# or

git clone https://github.com/geoserver/geoserver.git geoserver

代码库结构

Each branch has the following structure:

build - release and continuous integration scripts
doc - sources for the user and developer guides
src - java sources for GeoServer itself
data - a variety of GeoServer data directories / configurations

切换到2.22.x分支


# 查看分支
git branch -av

# 切换分支
git checkout -b 2.22.x origin/2.22.x

002-002

002-003

Import modules into IntelliJ

Run the IntelliJ IDE
From the initial panel select Open.

002-004

Navigate to the geoserver/src/pom.xml directory and click OK.

002-005

When asked click on Open as a Project.

002-006

Optionally, depending on which platform, IntelliJ may ask to Trust the Project.

002-007

Wait for IntelliJ to Sync the dependencies, it’s possible to follow the process from the Build tab panel on the bottom.

002-008

Finalize the GeoServer Project configuration

Click File > Project Structure.

002-009

Update the Name and select the correct SDK accordingly to the GeoServer version.

002-010

Click File > Settings.

002-011

From Build, Execution, Deployment > Compiler > Annotation Processors, enable the Annotation processing.

002-012

Click Build > Rebuild Project.

002-013

Run GeoServer from IntelliJ

From the Project browser select the web-app module
Navigate to the org.geoserver.web package
Right-click the Start class and click to Modify Run Configuration...

如果没有该选项，那么直接去Edit Configurations处创建一个即可，Add Configuration，选择Application

002-014

It is important to correctly set the Working directory to src/web/app. While having the Edit Configurations dialog open, fine tune the launch environment (including setting a GEOSERVER_DATA_DIR or the jetty.port). When settings are satisfactory, click OK.

002-015

002-016

It’s possible now to run GeoServer by selecting Run -> Run 'Start'

002-017

第一次启动比较慢

002-018

Access GeoServer front page

After a few seconds, GeoServer should be accessible at: http://localhost:8080/geoserver
The default admin password is geoserver.

FAQ

依赖下载失败或过慢（该条仅供参考）

使用阿里云Maven镜像加速依赖下载，可以参考阿里云Maven向导进行设置【有代理（科学上网）应该就不需要了】

maven配置文件优先级，maven工具所在的conf配置 > 外部化配置

编译提示Node不存在（wcs1_1）

002-019

网络上有一些提示是：手动添加Node的依赖。但是我认为应该不需要手动设置才是，因为从官网的maven quick start中，并未使用任何的编辑器，直接命令行搞定。


# skip unit tests, skip spotless(Spotless is used as a fast way to check that the google-java-format is being applied to the codebase.)

mvn clean install -DskipTests -Dspotless.apply.skip=true

# 不想install, package也可以

mvn clean package -DskipTests -Dspotless.apply.skip=true

这个时候可以看到，Node这个类存在于编译后的代码中

002-020

通过跟踪构建过程可以看到，是由javacc在编译过程中生成的（根据rangeset.jjt文件，知识盲区了）

002-021

其实在官方文档中已经提到了如何处理该问题的，参见Troubleshooting#1，就是需要先完成wcs1_1模块的编译构建。

我就不管那么多了，直接把所有的都构建了

Maven 使用

参见：GeoServer Maven Guide

前言#

环境#

Action#

获取源码#

代码库结构#

切换到2.22.x分支#

Import modules into IntelliJ#

Finalize the GeoServer Project configuration#

Run GeoServer from IntelliJ#

Access GeoServer front page#

FAQ#

依赖下载失败或过慢（该条仅供参考）#

编译提示Node不存在（wcs1_1）#

Maven 使用#

参考#

前言

环境