Bremersee GeoJSON for Spring Data MongoDB

This project contains converters for reading and writing GeoJSON from and into a MongoDB with Spring Data.

License

License

Categories

Categories

MongoDB Data Databases Geo Business Logic Libraries Geospatial JSON
GroupId

GroupId

org.bremersee
ArtifactId

ArtifactId

bremersee-geojson-spring-data-mongodb
Last Version

Last Version

2.0.0
Release Date

Release Date

Type

Type

jar
Description

Description

Bremersee GeoJSON for Spring Data MongoDB
This project contains converters for reading and writing GeoJSON from and into a MongoDB with Spring Data.
Project Organization

Project Organization

bremersee.org

Download bremersee-geojson-spring-data-mongodb

How to add to project

<!-- https://jarcasting.com/artifacts/org.bremersee/bremersee-geojson-spring-data-mongodb/ -->
<dependency>
    <groupId>org.bremersee</groupId>
    <artifactId>bremersee-geojson-spring-data-mongodb</artifactId>
    <version>2.0.0</version>
</dependency>
// https://jarcasting.com/artifacts/org.bremersee/bremersee-geojson-spring-data-mongodb/
implementation 'org.bremersee:bremersee-geojson-spring-data-mongodb:2.0.0'
// https://jarcasting.com/artifacts/org.bremersee/bremersee-geojson-spring-data-mongodb/
implementation ("org.bremersee:bremersee-geojson-spring-data-mongodb:2.0.0")
'org.bremersee:bremersee-geojson-spring-data-mongodb:jar:2.0.0'
<dependency org="org.bremersee" name="bremersee-geojson-spring-data-mongodb" rev="2.0.0">
  <artifact name="bremersee-geojson-spring-data-mongodb" type="jar" />
</dependency>
@Grapes(
@Grab(group='org.bremersee', module='bremersee-geojson-spring-data-mongodb', version='2.0.0')
)
libraryDependencies += "org.bremersee" % "bremersee-geojson-spring-data-mongodb" % "2.0.0"
[org.bremersee/bremersee-geojson-spring-data-mongodb "2.0.0"]

Dependencies

compile (4)

Group / Artifact Type Version
org.bremersee : bremersee-geojson jar 2.0.0
org.springframework.data : spring-data-mongodb Optional jar
org.mongodb : bson Optional jar
org.projectlombok : lombok Optional jar

test (1)

Group / Artifact Type Version
junit : junit jar

Project Modules

There are no modules declared in this project.

Bremersee GeoJSON

codecov

This project contains modules for reading and writing GeoJSON. The GeoJSON format is specified in rfc7946.

Maven Site

Usage

GeoJSON can be read or written with adding the GeoJsonObjectMapperModule to the ObjectMapper or without.

Without adding the GeoJsonObjectMapperModule to the ObjectMapper

If you do not add the GeoJsonObjectMapperModule to the ObjectMapper, you'll have to use the GeometryWrapper:

public class Example {
  
  public static void main(String[] args) {
    ObjectMapper om = new ObjectMapper();
    Point p = GeometryUtils.createPoint(10.2, 52.4);
    GeometryWrapper gw = new GeometryWrapper(p);
    String json = om.writeValueAsString(gw);
    System.out.println(json);
  }
}

GeoJsonFeature and GeoJsonFeatureCollection can be used without adding the module to the object mapper, too.

public class Example {
  
  public static void main(String[] args) {
    ObjectMapper om = new ObjectMapper();
    Point p = GeometryUtils.createPoint(10.2, 52.4);
    GeoJsonFeature f = new GeoJsonFeature("id", p, false, null);
    String json = om.writeValueAsString(f);
    System.out.println(json);
  }
}
With adding the GeoJsonObjectMapperModule to the ObjectMapper

If you add the GeoJsonObjectMapperModule to the ObjectMapper, you'll be able to process the geometry object directly:

public class Example {
  
  public static void main(String[] args) {
    ObjectMapper om = new ObjectMapper();
    om.registerModule(new GeoJsonObjectMapperModule());
    Point p = GeometryUtils.createPoint(10.2, 52.4);
    String json = om.writeValueAsString(p);
    System.out.println(json);
  }
}

Spring Data MongoDB Support

If you want to persist the JTS geometry objects to a MongoDB with Spring Data you'll have to register these converters:

@Configuration
public class PersistenceConfiguration {

  @Primary
  @Bean
  public MongoCustomConversions customConversions() {
    final List<Object> converters = new ArrayList<>(
        GeoJsonConverters.getConvertersToRegister(null));
    // add more custom converters
    return new MongoCustomConversions(converters);
  }
}

An entity may look like this:

@Document(collection = "feature")
@TypeAlias("Route")
public class RouteEntity {

  @Id
  private String id;

  @GeoSpatialIndexed(type = GeoSpatialIndexType.GEO_2DSPHERE)
  private MultiLineString geometry; // this is org.locationtech.jts.geom.MultiLineString

  private double[] bbox;

  private RouteProperties properties;

  // getter and setter
}

Versions

Version
2.0.0