Skip to content
/ opengis-utils-for-java Public

OGU4J（OpenGIS Utils for Java）是一个基于开源GIS库（GeoTools、JTS、GDAL/OGR、ESRI Geometry API）的Java GIS二次开发工具库。它提供了统一的图层模型和便捷的格式转换功能，简化了GIS数据的读取、处理和导出操作。

License

LGPL-2.1 license
2 stars 0 forks Branches Tags Activity
Star
Notifications You must be signed in to change notification settings

znlgis/opengis-utils-for-java

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

25 Commits
src/main/java/com/znlgis/ogu4j
src/main/java/com/znlgis/ogu4j
 
 
.editorconfig
.editorconfig
 
 
.gitignore
.gitignore
 
 
LICENSE
LICENSE
 
 
README.md
README.md
 
 
pom.xml
pom.xml
 
 

Repository files navigation

OGU4J - OpenGIS Utils for Java

Java Version License Version

English | 中文

中文说明

简介

OGU4J（OpenGIS Utils for Java）是一个基于开源GIS库（GeoTools、JTS、GDAL/OGR、ESRI Geometry API）的Java GIS二次开发工具库。它提供了统一的图层模型和便捷的格式转换功能，简化了GIS数据的读取、处理和导出操作。

项目架构

com.znlgis.ogu4j
├── datasource          # 数据源工具（OguLayerUtil、GtTxtUtil）
├── engine              # GIS引擎核心
│   ├── enums           # 枚举类型（GeometryType、FieldDataType、GisEngineType等）
│   ├── io              # 读写器接口（LayerReader、LayerWriter）
│   ├── model           # 数据模型
│   │   └── layer       # 图层模型（OguLayer、OguFeature、OguField等）
│   └── util            # 引擎工具（CrsUtil、PostgisUtil、OgrUtil等）
├── exception           # 异常类（OguException及其子类）
├── geometry            # 几何处理（GeometryUtil）
└── utils               # 通用工具（ZipUtil、EncodingUtil、SortUtil等）

主要特性

  • 🗂️ 统一图层模型：提供简洁的图层、要素、字段抽象，屏蔽底层GIS库差异
  • 📁 多格式支持：支持Shapefile、GeoJSON、FileGDB、PostGIS、国土TXT坐标文件等格式
  • 🔄 双引擎架构：支持GeoTools和GDAL/OGR两种引擎，可根据需求灵活切换
  • 📐 几何处理：基于JTS和ESRI Geometry API提供丰富的几何操作和空间分析功能
  • 🌐 坐标系管理：内置CGCS2000坐标系支持，提供坐标转换功能
  • 🛠️ 实用工具：提供ZIP压缩/解压、文件编码检测、自然排序等实用工具

快速安装

Maven

<repositories>
    <repository>
        <id>osgeo</id>
        <url>https://repo.osgeo.org/repository/release/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.znlgis.ogu4j</groupId>
    <artifactId>ogu4j</artifactId>
    <version>1.0.0</version>
</dependency>

核心图层模型

本库提供了统一的简化图层模型，位于 com.znlgis.ogu4j.engine.model.layer 包中：

类名 说明
OguLayer 统一的GIS图层定义，包含图层名称、坐标系、几何类型、字段定义和要素集合
OguFeature 统一的要素类，包含要素ID、几何信息（WKT格式）和属性值集合
OguField 统一的字段定义类，包含字段名称、别名、数据类型等信息
OguFieldValue 字段值容器，提供便捷的类型转换方法（getStringValue、getIntValue、getDoubleValue等）
OguCoordinate 坐标类，支持二维/三维坐标及点号/圈号（用于国土TXT格式）
OguFeatureFilter 函数式接口，用于要素过滤
OguLayerMetadata 图层元数据，存储坐标系参数、数据来源、扩展信息等

使用示例

基本操作

// 从JSON字符串创建OguLayer
OguLayer layer = OguLayer.fromJSON(jsonString);

// 验证图层数据完整性
layer.validate();

// 过滤要素
List<OguFeature> filtered = layer.filter(feature ->
    "北京".equals(feature.getValue("city")));

// 获取要素数量
int count = layer.getFeatureCount();

// 转换为JSON字符串
String json = layer.toJSON();

读取要素属性

OguFeature feature = layer.getFeatures().get(0);

// 获取属性值
Object value = feature.getValue("fieldName");

// 获取属性值对象
OguFieldValue fieldValue = feature.getAttribute("fieldName");
String strValue = fieldValue.getStringValue();
Integer intValue = fieldValue.getIntValue();
Double doubleValue = fieldValue.getDoubleValue();

// 设置属性值
feature.setValue("fieldName", newValue);

图层格式转换

使用 OguLayerUtil 进行各种格式间的转换：

Shapefile

import com.znlgis.ogu4j.datasource.OguLayerUtil;
import com.znlgis.ogu4j.engine.enums.DataFormatType;
import com.znlgis.ogu4j.engine.enums.GisEngineType;

// 从Shapefile读取（支持属性过滤和空间过滤）
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.SHP,
    shpPath,
    null,                       // 图层名称（Shapefile可为null）
    "NAME = '北京'",            // 属性过滤条件（CQL表达式）
    spatialFilterWkt,           // 空间过滤条件（WKT格式）
    GisEngineType.GEOTOOLS      // 使用的GIS引擎
);

// 保存为Shapefile
OguLayerUtil.writeLayer(
    DataFormatType.SHP,
    layer,
    shpPath,
    null,
    null,
    GisEngineType.GEOTOOLS
);

GeoJSON

// 从GeoJSON读取
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.GEOJSON,
    geojsonPath,
    null, null, null,
    GisEngineType.GEOTOOLS
);

// 保存为GeoJSON
OguLayerUtil.writeLayer(
    DataFormatType.GEOJSON,
    layer,
    geojsonPath,
    null, null,
    GisEngineType.GEOTOOLS
);

FileGDB（需要GDAL支持）

// 从FileGDB读取指定图层
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.FILEGDB,
    gdbPath,
    "layerName",
    attributeFilter,
    spatialFilterWkt,
    GisEngineType.GDAL
);

// 保存到FileGDB
Map<String, Object> options = new HashMap<>();
options.put("featureDataset", "datasetName");
OguLayerUtil.writeLayer(
    DataFormatType.FILEGDB,
    layer,
    gdbPath,
    "layerName",
    options,
    GisEngineType.GDAL
);

PostGIS

// 构建PostGIS连接字符串
String connStr = "PG: host=localhost port=5432 dbname=gisdb user=postgres password=*** active_schema=public";

// 从PostGIS读取
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.POSTGIS,
    connStr,
    "layerName",
    null, null,
    GisEngineType.GEOTOOLS
);

// 保存到PostGIS
OguLayerUtil.writeLayer(
    DataFormatType.POSTGIS,
    layer,
    connStr,
    "layerName",
    null,
    GisEngineType.GEOTOOLS
);

国土TXT坐标文件

import com.znlgis.ogu4j.datasource.GtTxtUtil;

// 从TXT文件读取
OguLayer layer = GtTxtUtil.loadTxt(txtPath, null);

// 保存为TXT文件
OguLayerMetadata metadata = new OguLayerMetadata();
metadata.setDataSource("自然资源部");
metadata.setCoordinateSystemName("2000国家大地坐标系");
metadata.setZoneDivision("3");
metadata.setProjectionType("高斯克吕格");
metadata.setMeasureUnit("米");

int zoneNumber = 39; // 带号
GtTxtUtil.saveTxt(layer, txtPath, metadata, null, zoneNumber);

几何格式转换

使用 GeometryUtil 进行几何格式转换：

import com.znlgis.ogu4j.geometry.GeometryUtil;

// WKT <-> JTS Geometry
Geometry geom = GeometryUtil.wkt2Geometry(wkt);
String wkt = GeometryUtil.geometry2Wkt(geom);

// GeoJSON <-> JTS Geometry
Geometry geom = GeometryUtil.geojson2Geometry(geojson);
String geojson = GeometryUtil.geometry2Geojson(geom);

// WKT <-> GeoJSON
String geojson = GeometryUtil.wkt2Geojson(wkt);
String wkt = GeometryUtil.geojson2Wkt(geojson);

// WKT <-> ESRI JSON
String esriJson = GeometryUtil.wkt2EsriJson(wkt, wkid);
String wkt = GeometryUtil.esriJson2Wkt(esriJson);

// GeoJSON <-> ESRI JSON
String esriJson = GeometryUtil.geoJson2EsriJson(wkid, geojson);
String geojson = GeometryUtil.esriJson2GeoJson(esriJson);

// ESRI JSON <-> JTS Geometry
Geometry geom = GeometryUtil.esriJson2Geometry(esriJson);
String esriJson = GeometryUtil.geometry2EsriJson(geom, wkid);

几何空间分析

GeometryUtil 提供了两套几何分析方法：基于JTS Geometry对象的方法和基于WKT字符串的方法（后缀为Wkt）。

基于JTS Geometry对象

import com.znlgis.ogu4j.geometry.GeometryUtil;

// 空间关系判断
boolean result = GeometryUtil.intersects(geomA, geomB);
boolean result = GeometryUtil.contains(geomA, geomB);
boolean result = GeometryUtil.within(geomA, geomB);
boolean result = GeometryUtil.touches(geomA, geomB);
boolean result = GeometryUtil.crosses(geomA, geomB);
boolean result = GeometryUtil.overlaps(geomA, geomB);
boolean result = GeometryUtil.disjoint(geomA, geomB);

// 空间分析
Geometry buffer = GeometryUtil.buffer(geom, distance);
Geometry intersection = GeometryUtil.intersection(geomA, geomB);
Geometry union = GeometryUtil.union(geomA, geomB);
Geometry difference = GeometryUtil.difference(geomA, geomB);
Geometry symDifference = GeometryUtil.symDifference(geomA, geomB);

// 几何属性
double area = GeometryUtil.area(geom);
double length = GeometryUtil.length(geom);
Geometry centroid = GeometryUtil.centroid(geom);
Geometry interiorPoint = GeometryUtil.interiorPoint(geom);
int dimension = GeometryUtil.dimension(geom);
int numPoints = GeometryUtil.numPoints(geom);
GeometryType geometryType = GeometryUtil.geometryType(geom);
boolean isEmpty = GeometryUtil.isEmpty(geom);

// 几何边界与外包矩形
Geometry boundary = GeometryUtil.boundary(geom);
Geometry envelope = GeometryUtil.envelope(geom);

// 凸包与凹包
Geometry convexHull = GeometryUtil.convexHull(geom);
Geometry concaveHull = GeometryUtil.concaveHull(geom);

// 拓扑验证与简化
TopologyValidationResult validResult = GeometryUtil.isValid(geom);
SimpleGeometryResult simpleResult = GeometryUtil.isSimple(geom);
Geometry simplified = GeometryUtil.simplify(geom, tolerance);
Geometry validated = GeometryUtil.validate(geom);
Geometry densified = GeometryUtil.densify(geom, distance);

// 几何相等判断
boolean equalsExact = GeometryUtil.equalsExact(geomA, geomB);
boolean equalsExactTol = GeometryUtil.equalsExactTolerance(geomA, geomB, tolerance);
boolean equalsNorm = GeometryUtil.equalsNorm(geomA, geomB);
boolean equalsTopo = GeometryUtil.equalsTopo(geomA, geomB);

// 空间关系模式
boolean relateResult = GeometryUtil.relatePattern(geomA, geomB, "T*T***FF*");
String relate = GeometryUtil.relate(geomA, geomB);

// 距离计算
double distance = GeometryUtil.distance(geomA, geomB);
boolean withinDistance = GeometryUtil.isWithinDistance(geomA, geomB, maxDistance);

// 多边形操作
Geometry splitResult = GeometryUtil.splitPolygon(polygon, line);
Geometry polygonized = GeometryUtil.polygonize(geom);

基于WKT字符串（使用ESRI Geometry API）

// 空间关系判断（需要指定坐标系WKID）
boolean result = GeometryUtil.intersectsWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.containsWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.withinWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.disjointWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.touchesWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.crossesWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.overlapsWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.equalsWkt(wktA, wktB, wkid);
boolean result = GeometryUtil.relatePatternWkt(wktA, wktB, wkid, pattern);

// 空间分析
String buffer = GeometryUtil.bufferWkt(wkt, wkid, distance);
String intersection = GeometryUtil.intersectionWkt(wktA, wktB, wkid);
String union = GeometryUtil.unionWkt(wktList, wkid);
String difference = GeometryUtil.differenceWkt(wktA, wktB, wkid);
String symDifference = GeometryUtil.symDifferenceWkt(wktA, wktB, wkid);
String convexHull = GeometryUtil.convexHullWkt(wkt);
String boundary = GeometryUtil.boundaryWkt(wkt);

// 几何属性
double area = GeometryUtil.areaWkt(wkt);
double length = GeometryUtil.lengthWkt(wkt);
String centroid = GeometryUtil.centroidWkt(wkt);
int dimension = GeometryUtil.dimensionWkt(wkt);
boolean isEmpty = GeometryUtil.isEmptyWkt(wkt);
double distance = GeometryUtil.distanceWkt(wktA, wktB, wkid);
GeometryType geometryType = GeometryUtil.geometryTypeWkt(wkt);
boolean isSimple = GeometryUtil.isSimpleWkt(wkt, wkid);

// 几何简化
String simplified = GeometryUtil.simplifyWkt(wkt, wkid);

坐标系工具（CrsUtil）

位于 com.znlgis.ogu4j.engine.util 包中：

import com.znlgis.ogu4j.engine.util.CrsUtil;
// 坐标转换（WKT字符串）
String transformedWkt = CrsUtil.transform(wkt, sourceWkid, targetWkid);

// 坐标转换（JTS Geometry）
Geometry transformed = CrsUtil.transform(geometry, sourceWkid, targetWkid);

// 图层投影转换
OguLayer reprojected = CrsUtil.reproject(layer, targetWkid);

// 获取带号
int zoneNumber = CrsUtil.getDh(geometry);
int zoneNumber = CrsUtil.getDh(wkt);
int zoneNumber = CrsUtil.getDh(projectedWkid);

// 获取几何对应的WKID
Integer wkid = CrsUtil.getWkid(geometry);

// 获取投影坐标系WKID
Integer projectedWkid = CrsUtil.getProjectedWkid(dh);
Integer projectedWkid = CrsUtil.getProjectedWkid(geometry);

// 判断坐标系类型
boolean isProjected = CrsUtil.isProjectedCRS(crs);

// 获取容差
double tolerance = CrsUtil.getTolerance(wkid);

// 获取支持的坐标系列表
Map<Integer, CoordinateReferenceSystem> crsList = CrsUtil.getSupportedCRSList();

数据模型

TopologyValidationResult - 拓扑验证结果

用于封装几何对象拓扑验证的结果，包含验证是否通过、错误位置、错误类型和错误信息：

import com.znlgis.ogu4j.geometry.GeometryUtil;
import com.znlgis.ogu4j.engine.model.TopologyValidationResult;

TopologyValidationResult result = GeometryUtil.isValid(geom);
if (!result.isValid()) {
    System.out.println("错误类型: " + result.getErrorType().getDesc());
    System.out.println("错误位置: " + result.getCoordinate());
    System.out.println("错误信息: " + result.getMessage());
}

SimpleGeometryResult - 简单几何判断结果

用于封装几何对象简单性检查的结果，简单几何是指不存在自相交或重复点的几何对象：

import com.znlgis.ogu4j.geometry.GeometryUtil;
import com.znlgis.ogu4j.engine.model.SimpleGeometryResult;

SimpleGeometryResult result = GeometryUtil.isSimple(geom);
if (!result.isSimple()) {
    System.out.println("非简单点位置: " + result.getNonSimplePts());
}

TopologyValidationErrorType - 拓扑错误类型

定义几何对象拓扑验证中可能出现的各类错误：

错误类型 说明
ERROR 拓扑检查错误
REPEATED_POINT 点重叠
HOLE_OUTSIDE_SHELL 洞在图形外
NESTED_HOLES 洞重叠
DISCONNECTED_INTERIOR 图形内部不连通
SELF_INTERSECTION 自相交
RING_SELF_INTERSECTION 环自相交
NESTED_SHELLS 图形重叠
DUPLICATE_RINGS 环重复
TOO_FEW_POINTS 点太少无法构成有效几何
INVALID_COORDINATE 无效坐标
RING_NOT_CLOSED 环未闭合

API模块概览

包名 说明
com.znlgis.ogu4j.engine.model.layer 图层模型类（OguLayer、OguFeature、OguField、OguFieldValue、OguCoordinate、OguFeatureFilter、OguLayerMetadata）
com.znlgis.ogu4j.engine.model 数据模型类（DbConnBaseModel、GdbGroupModel、TopologyValidationResult、SimpleGeometryResult）
com.znlgis.ogu4j.engine.enums 枚举类型（GeometryType、FieldDataType、GisEngineType、DataFormatType、TopologyValidationErrorType）
com.znlgis.ogu4j.engine.io 读写器接口（LayerReader、LayerWriter）
com.znlgis.ogu4j.engine.util 引擎工具类（CrsUtil、ShpUtil、PostgisUtil、OgrUtil、GeotoolsUtil、GdalCmdUtil）
com.znlgis.ogu4j.engine GIS引擎（GisEngine、GisEngineFactory、GeoToolsEngine、GdalEngine及其Reader/Writer）
com.znlgis.ogu4j.geometry 几何处理工具（GeometryUtil）
com.znlgis.ogu4j.datasource 数据源工具类（OguLayerUtil、GtTxtUtil）
com.znlgis.ogu4j.utils 通用工具类（ZipUtil、EncodingUtil、SortUtil、NumUtil）
com.znlgis.ogu4j.exception 异常类（OguException、DataSourceException、FormatParseException、EngineNotSupportedException、LayerValidationException、TopologyException）

实用工具类

ZipUtil - ZIP压缩解压工具

import com.znlgis.ogu4j.utils.ZipUtil;

// 压缩文件夹
ZipUtil.zip(folder, "output.zip");
ZipUtil.zip(folder, "output.zip", StandardCharsets.UTF_8);

// 解压文件
ZipUtil.unzip("input.zip", destPath);
ZipUtil.unzip("input.zip", destPath, StandardCharsets.UTF_8);

EncodingUtil - 文件编码检测工具

import com.znlgis.ogu4j.utils.EncodingUtil;

// 自动检测文件编码
Charset charset = EncodingUtil.getFileEncoding(file);

SortUtil - 自然排序工具

import com.znlgis.ogu4j.utils.SortUtil;

// 包含数字的字符串自然排序
int result = SortUtil.compareString("第5章", "第10章");  // 返回 -1

GdalCmdUtil - GDAL命令行工具

import com.znlgis.ogu4j.engine.util.GdalCmdUtil;

// 获取GDB图层结构
GdbGroupModel structure = GdalCmdUtil.getGdbDataStructure(gdbPath);

NumUtil - 数字格式化工具

import com.znlgis.ogu4j.utils.NumUtil;

// 去除科学计数法显示
String plainString = NumUtil.getPlainString(1.234E10);  // 返回 "12340000000"

依赖说明

本库主要依赖以下开源库：

依赖库 版本 说明
JTS 1.20.0 Java拓扑套件，提供几何对象和空间操作
GeoTools 34.1 Java GIS工具库，提供数据读写和坐标系支持
ESRI Geometry API 2.2.4 ESRI几何引擎，提供高性能几何运算
GDAL 3.11.0 地理空间数据抽象库（可选，用于FileGDB等格式支持）
Hutool 5.8.41 Java工具库，提供便捷的工具方法
Fastjson2 2.0.60 高性能JSON处理库
Zip4j 2.11.5 ZIP压缩解压库
Lombok 1.18.36 Java注解库，简化代码编写

环境要求

  • Java: 17+
  • GDAL（可选）: 如需使用FileGDB格式或GDAL引擎，需安装GDAL并配置环境变量

English

Introduction

OGU4J (OpenGIS Utils for Java) is a Java GIS development toolkit based on open-source GIS libraries (GeoTools, JTS, GDAL/OGR, ESRI Geometry API). It provides a unified layer model and convenient format conversion functions to simplify GIS data reading, processing, and exporting operations.

Project Structure

com.znlgis.ogu4j
├── datasource          # Data source utilities (OguLayerUtil, GtTxtUtil)
├── engine              # GIS engine core
│   ├── enums           # Enumerations (GeometryType, FieldDataType, GisEngineType, etc.)
│   ├── io              # Reader/Writer interfaces (LayerReader, LayerWriter)
│   ├── model           # Data models
│   │   └── layer       # Layer models (OguLayer, OguFeature, OguField, etc.)
│   └── util            # Engine utilities (CrsUtil, PostgisUtil, OgrUtil, etc.)
├── exception           # Exception classes (OguException and subclasses)
├── geometry            # Geometry processing (GeometryUtil)
└── utils               # Common utilities (ZipUtil, EncodingUtil, SortUtil, etc.)

Features

  • 🗂️ Unified Layer Model: Provides simple layer, feature, and field abstractions, hiding the differences of underlying GIS libraries
  • 📁 Multi-format Support: Supports Shapefile, GeoJSON, FileGDB, PostGIS, and China National Land TXT coordinate files
  • 🔄 Dual Engine Architecture: Supports both GeoTools and GDAL/OGR engines, switchable based on requirements
  • 📐 Geometry Processing: Rich geometry operations and spatial analysis based on JTS and ESRI Geometry API
  • 🌐 CRS Management: Built-in CGCS2000 coordinate system support with coordinate transformation capabilities
  • 🛠️ Utility Tools: Provides ZIP compression/decompression, file encoding detection, natural sorting, and other utilities

Installation

Maven

<repositories>
    <repository>
        <id>osgeo</id>
        <url>https://repo.osgeo.org/repository/release/</url>
    </repository>
</repositories>

<dependency>
    <groupId>com.znlgis.ogu4j</groupId>
    <artifactId>ogu4j</artifactId>
    <version>1.0.0</version>
</dependency>

Layer Model

The library provides a unified simplified layer model in the com.znlgis.ogu4j.engine.model.layer package:

Class Description
OguLayer Unified GIS layer definition with name, CRS, geometry type, fields, and features
OguFeature Unified feature class containing ID, geometry (WKT format), and attributes
OguField Unified field definition with name, alias, and data type
OguFieldValue Field value container with convenient type conversion methods
OguCoordinate Coordinate class supporting 2D/3D coordinates with point/ring numbers
OguFeatureFilter Functional interface for feature filtering
OguLayerMetadata Layer metadata storing CRS parameters, data source, and extended info

Quick Start

// Create OguLayer from JSON
OguLayer layer = OguLayer.fromJSON(jsonString);

// Validate layer data integrity
layer.validate();

// Filter features
List<OguFeature> filtered = layer.filter(feature ->
    "Beijing".equals(feature.getValue("city")));

// Convert to JSON
String json = layer.toJSON();

Format Conversion

import com.znlgis.ogu4j.datasource.OguLayerUtil;
import com.znlgis.ogu4j.engine.enums.DataFormatType;
import com.znlgis.ogu4j.engine.enums.GisEngineType;

// Shapefile
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.SHP, shpPath, null, null, null, GisEngineType.GEOTOOLS);
OguLayerUtil.writeLayer(
    DataFormatType.SHP, layer, shpPath, null, null, GisEngineType.GEOTOOLS);

// GeoJSON
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.GEOJSON, geojsonPath, null, null, null, GisEngineType.GEOTOOLS);
OguLayerUtil.writeLayer(
    DataFormatType.GEOJSON, layer, geojsonPath, null, null, GisEngineType.GEOTOOLS);

// FileGDB (requires GDAL)
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.FILEGDB, gdbPath, "layerName", null, null, GisEngineType.GDAL);
OguLayerUtil.writeLayer(
    DataFormatType.FILEGDB, layer, gdbPath, "layerName", options, GisEngineType.GDAL);

// PostGIS
String connStr = "PG: host=localhost port=5432 dbname=gisdb user=postgres password=*** active_schema=public";
OguLayer layer = OguLayerUtil.readLayer(
    DataFormatType.POSTGIS, connStr, "layerName", null, null, GisEngineType.GEOTOOLS);
OguLayerUtil.writeLayer(
    DataFormatType.POSTGIS, layer, connStr, "layerName", null, GisEngineType.GEOTOOLS);

Requirements

  • Java: 17+
  • GDAL (optional): Required for FileGDB format or GDAL engine

Dependencies

Library Version Description
JTS 1.20.0 Java Topology Suite for geometry objects and spatial operations
GeoTools 34.1 Java GIS toolkit for data I/O and CRS support
ESRI Geometry API 2.2.4 ESRI geometry engine for high-performance geometry operations
GDAL 3.11.0 Geospatial Data Abstraction Library (optional, for FileGDB support)
Hutool 5.8.41 Java utility library for convenient utility methods
Fastjson2 2.0.60 High-performance JSON processing library
Zip4j 2.11.5 ZIP compression/decompression library
Lombok 1.18.36 Java annotation library to simplify code writing

Data Models

TopologyValidationResult - Topology Validation Result

Encapsulates the result of geometry topology validation, including validation status, error location, error type, and error message:

import com.znlgis.ogu4j.geometry.GeometryUtil;
import com.znlgis.ogu4j.engine.model.TopologyValidationResult;

TopologyValidationResult result = GeometryUtil.isValid(geom);
if (!result.isValid()) {
    System.out.println("Error Type: " + result.getErrorType().getDesc());
    System.out.println("Error Location: " + result.getCoordinate());
    System.out.println("Error Message: " + result.getMessage());
}

SimpleGeometryResult - Simple Geometry Check Result

Encapsulates the result of geometry simplicity check. A simple geometry has no self-intersections or repeated points:

import com.znlgis.ogu4j.geometry.GeometryUtil;
import com.znlgis.ogu4j.engine.model.SimpleGeometryResult;

SimpleGeometryResult result = GeometryUtil.isSimple(geom);
if (!result.isSimple()) {
    System.out.println("Non-simple point locations: " + result.getNonSimplePts());
}

TopologyValidationErrorType - Topology Error Types

Defines various topology validation error types for geometry objects:

Error Type Description
ERROR Topology check error
REPEATED_POINT Repeated point
HOLE_OUTSIDE_SHELL Hole outside shell
NESTED_HOLES Nested holes
DISCONNECTED_INTERIOR Disconnected interior
SELF_INTERSECTION Self-intersection
RING_SELF_INTERSECTION Ring self-intersection
NESTED_SHELLS Nested shells
DUPLICATE_RINGS Duplicate rings
TOO_FEW_POINTS Too few points to form valid geometry
INVALID_COORDINATE Invalid coordinate
RING_NOT_CLOSED Ring not closed

API Overview

Package Description
com.znlgis.ogu4j.engine.model.layer Layer model classes (OguLayer, OguFeature, OguField, OguFieldValue, OguCoordinate, OguFeatureFilter, OguLayerMetadata)
com.znlgis.ogu4j.engine.model Data model classes (DbConnBaseModel, GdbGroupModel, TopologyValidationResult, SimpleGeometryResult)
com.znlgis.ogu4j.engine.enums Enumerations (GeometryType, FieldDataType, GisEngineType, DataFormatType, TopologyValidationErrorType)
com.znlgis.ogu4j.engine.io Reader/Writer interfaces (LayerReader, LayerWriter)
com.znlgis.ogu4j.engine.util Engine utilities (CrsUtil, ShpUtil, PostgisUtil, OgrUtil, GeotoolsUtil, GdalCmdUtil)
com.znlgis.ogu4j.engine GIS engines (GisEngine, GisEngineFactory, GeoToolsEngine, GdalEngine and their Readers/Writers)
com.znlgis.ogu4j.geometry Geometry utilities (GeometryUtil)
com.znlgis.ogu4j.datasource Data source utilities (OguLayerUtil, GtTxtUtil)
com.znlgis.ogu4j.utils Common utilities (ZipUtil, EncodingUtil, SortUtil, NumUtil)
com.znlgis.ogu4j.exception Exception classes (OguException, DataSourceException, FormatParseException, EngineNotSupportedException, LayerValidationException, TopologyException)

Utility Classes

ZipUtil - ZIP Compression/Decompression

import com.znlgis.ogu4j.utils.ZipUtil;

// Compress a folder
ZipUtil.zip(folder, "output.zip");

// Extract a ZIP file
ZipUtil.unzip("input.zip", destPath);

EncodingUtil - File Encoding Detection

import com.znlgis.ogu4j.utils.EncodingUtil;

// Auto-detect file encoding
Charset charset = EncodingUtil.getFileEncoding(file);

SortUtil - Natural Sorting

import com.znlgis.ogu4j.utils.SortUtil;

// Natural string comparison with numbers
int result = SortUtil.compareString("Chapter 5", "Chapter 10");  // returns -1

NumUtil - Number Formatting

import com.znlgis.ogu4j.utils.NumUtil;

// Remove scientific notation display
String plainString = NumUtil.getPlainString(1.234E10);  // returns "12340000000"

GdalCmdUtil - GDAL Command Line Tool

import com.znlgis.ogu4j.engine.util.GdalCmdUtil;

// Get GDB layer structure
GdbGroupModel structure = GdalCmdUtil.getGdbDataStructure(gdbPath);

CrsUtil - Coordinate Reference System Utilities

import com.znlgis.ogu4j.engine.util.CrsUtil;

// Coordinate transformation
String transformedWkt = CrsUtil.transform(wkt, sourceWkid, targetWkid);
Geometry transformed = CrsUtil.transform(geometry, sourceWkid, targetWkid);

// Layer reprojection
OguLayer reprojected = CrsUtil.reproject(layer, targetWkid);

// Get zone number
int zoneNumber = CrsUtil.getDh(geometry);

License

This project is licensed under the Apache License 2.0.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

About

OGU4J（OpenGIS Utils for Java）是一个基于开源GIS库（GeoTools、JTS、GDAL/OGR、ESRI Geometry API）的Java GIS二次开发工具库。它提供了统一的图层模型和便捷的格式转换功能，简化了GIS数据的读取、处理和导出操作。

Resources

Readme

License

LGPL-2.1 license
Activity

Stars

2 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages