Skip to content

Latest commit

 

History

History
32 lines (23 loc) · 1.61 KB

MIGRATION.md

File metadata and controls

32 lines (23 loc) · 1.61 KB
Raw

JTS Upgrade Guide

The JTS Topology Suite has a long history, and in 2016/2017, Vivid Solutions brought the project to the LocationTech working group of the Eclipse Foundation.

During that transition, the Java package names and Maven GAVs have changed. For package names (typically used in imports), the change is reflected below:

JTS 1.14.0 and before JTS 1.15.0 and later
Maven GroupId com.vividsolutions org.locationtech.jts
Package names com.vividsolutions.jts.* org.locationtech.jts.*

To upgrade a Maven project (or another build tool using Maven dependency management), one can do a find and replace on pom.xml files (or similiar build files). In the source code, one could do a find and replace on the package names. As a concrete example, one could use these two commands to handle most of the migration.

git grep -l com.vividsolutions | grep pom.xml | xargs sed -i "s/com.vividsolutions/org.locationtech.jts/g"
git grep -l com.vividsolutions | xargs sed -i "s/com.vividsolutions/org.locationtech/g"

Using JTS with Maven

To include JTS in a Maven project, add a dependency block like the following:

<dependency>
    <groupId>org.locationtech.jts</groupId>
    <artifactId>jts-core</artifactId>
    <version>${jts.version}</version>
</dependency>

Where ${jts.version} is the released version of JTS one chooses to use. See the releases page for options.