GeometryCollection 的类型映射器（TypeHandler）

by emanjusaka from  https://www.emanjusaka.top/2024/05/mybatis-typeHandler-geometryCollection 彼岸花开可奈何
本文欢迎分享与聚合，全文转载请留下原文地址。

GeometryCollection 是 GeoJSON 数据模型中的一个类型，用于表示一个几何对象的聚集。MySQL8 中支持了 GeometryCollection 类型，在对数据库和实体类举行对象映射时需要我们自己编写类型映射器来完成映射。java 本身不支持 GeometryCollection 类型，我们需要引入第三方包来获得支持。
引入geotools工具包

该依赖在 maven 中心堆栈中没有，需要另外配置下堆栈
geotools库支持 jdk8 的最高版本是 28.2。

1. <dependency>
2.             <groupId>org.geotools</groupId>
3.             <artifactId>gt-geojson-core</artifactId>
4.             <version>28.2</version>
5.         </dependency>
7. <repositories>
8.         
9.         <repository>
10.             <id>osgeo</id>
11.             <name>OSGeo Release Repository</name>
12.             <url>https://repo.osgeo.org/repository/release/</url>
13.             <snapshots>
14.                 <enabled>false</enabled>
15.             </snapshots>
16.             <releases>
17.                 <enabled>true</enabled>
18.             </releases>
19.         </repository>
20.         <repository>
21.             <id>osgeo-snapshot</id>
22.             <name>OSGeo Snapshot Repository</name>
23.             <url>https://repo.osgeo.org/repository/snapshot/</url>
24.             <snapshots>
25.                 <enabled>true</enabled>
26.             </snapshots>
27.             <releases>
28.                 <enabled>false</enabled>
29.             </releases>
30.         </repository>
31.         
32.     </repositories>

复制代码

实体类

本示例的 mybatis 增加框架利用的是 tkmapper，如果是利用的 MyBatisPlus 注解切换成对应的注解，大同小异。为了演示方便我去除了无关字段，重点关注 GeometryCollection 类型的 areaGeom 字段即可。

1. package top.emanjusaka.test;
3. import com.iles.handler.GeometryCollectionTypeHandler;
4. import lombok.Data;
5. import lombok.EqualsAndHashCode;
6. import org.locationtech.jts.geom.GeometryCollection;
7. import tk.mybatis.mapper.annotation.ColumnType;
9. import javax.persistence.Column;
10. import javax.persistence.GeneratedValue;
11. import javax.persistence.Id;
12. import javax.persistence.Table;
14. @Data
15. @EqualsAndHashCode(callSuper = false)
16. @Table(name = "car_work_area")
17. public class CarWorkAreaDO {
18.     private static final long serialVersionUID = 1L;
20.     /**
21.      * 自增 ID
22.      */
23.     @Id
24.     @GeneratedValue(generator = "JDBC")
25.     private Long id;
27.     @Column(name = "area_geom")
28.     @ColumnType(typeHandler = GeometryCollectionTypeHandler.class)
29.     private GeometryCollection areaGeom;
32. }

复制代码

TypeHandler 映射器

大多数支持地理空间数据的数据库系统（如 PostgreSQL/PostGIS、MySQL、SQL Server 等）都支持以 WKT 或 WKB 格式存储和检索 GeometryCollection 类型的数据。具体利用哪种格式取决于应用场景的需求，好比对存储空间的敏感度、数据交换的便捷性以及性能要求等。本文存储的是 WKT 格式。

1. package top.emanjusaka.handler;
3. import org.apache.ibatis.type.BaseTypeHandler;
4. import org.apache.ibatis.type.JdbcType;
5. import org.locationtech.jts.geom.GeometryCollection;
6. import org.locationtech.jts.io.ParseException;
7. import org.locationtech.jts.io.WKTReader;
8. import org.locationtech.jts.io.WKTWriter;
10. import java.sql.CallableStatement;
11. import java.sql.PreparedStatement;
12. import java.sql.ResultSet;
13. import java.sql.SQLException;
15. /**
16. * @Author emanjusaka
17. */
18. public class GeometryCollectionTypeHandler extends BaseTypeHandler<GeometryCollection> {
19.     private static final WKTReader wktReader = new WKTReader();
21.     @Override
22.     public void setNonNullParameter(PreparedStatement ps, int i, GeometryCollection parameter, JdbcType jdbcType) throws SQLException {
23.         ps.setString(i, parameter.toText());
24.     }
26.     @Override
27.     public GeometryCollection getNullableResult(ResultSet rs, String columnName) throws SQLException {
28.         String wkt = rs.getString(columnName);
29.         try {
30.             return wkt != null ? (GeometryCollection) wktReader.read(wkt) : null;
31.         } catch (ParseException e) {
32.             throw new RuntimeException(e);
33.         }
34.     }
36.     @Override
37.     public GeometryCollection getNullableResult(ResultSet rs, int columnIndex) throws SQLException {
38.         String wkt = rs.getString(columnIndex);
39.         try {
40.             return wkt != null ? (GeometryCollection) wktReader.read(wkt) : null;
41.         } catch (ParseException e) {
42.             throw new RuntimeException(e);
43.         }
44.     }
46.     @Override
47.     public GeometryCollection getNullableResult(CallableStatement cs, int columnIndex) throws SQLException {
48.         String wkt = cs.getString(columnIndex);
49.         try {
50.             return wkt != null ? (GeometryCollection) wktReader.read(wkt) : null;
51.         } catch (ParseException e) {
52.             throw new RuntimeException(e);
53.         }
54.     }
55. }

复制代码

mapper 文件

1. package top.emanjusaka.mapper;
3. import top.emanjusaka.test.CarWorkAreaDO;
4. import org.apache.ibatis.annotations.Param;
5. import tk.mybatis.mapper.common.Mapper;
7. import java.util.List;
10. public interface CarWorkAreaMapper extends Mapper<CarWorkAreaDO> {
11.     /**
12.      * 插入数据
13.      *
14.      * @param carWorkArea
15.      * @return:
16.      */
17.     int insertCustom(CarWorkAreaDO carWorkArea);
18. }

复制代码

注意事项：

• resultMap 中 area_geom 字段注意配置 TypeHandler，否则无法举行映射导致报错
  
• 插入的 sql 语句中，area_geom 字段也需要指定 typeHandler，并且需要调用 ST_GeomCollFrom()函数读取数据。
  
• 查询时可以调用函数 AsTex()
  

1. <?xml version="1.0" encoding="UTF-8"?>
2. <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
4. <mapper namespace="top.emanjusaka.mapper.CarWorkAreaMapper">
5.     <resultMap type="com.iles.models.car.CarWorkAreaDO" id="carWorkAreaResult">
6.         <result property="id" column="id"/>
7.         <result property="areaGeom" column="area_geom" javaType="org.locationtech.jts.geom.GeometryCollection"
8.                 jdbcType="OTHER"
9.                 typeHandler="top.emanjusaka.handler.GeometryCollectionTypeHandler"/>
10.     </resultMap>
13.     <insert id="insertCustom" parameterType="com.iles.models.car.CarWorkAreaDO">
14.         insert into
15.         car_work_area(id,area_geom)
16.         values
17.         (#{id},ST_GeomCollFromText(#{areaGeom,typeHandler=top.emanjusaka.handler.GeometryCollectionTypeHandler}))
18.     </insert>
19. </mapper>

复制代码

在技能的星河中遨游，我们互为引路星辰，共同追逐发展的光芒。愿本文的洞见能触动您的思绪，如有所共鸣，请以点赞之手，轻抚赞同的弦。
原文地址： https://www.emanjusaka.top/2024/05/mybatis-typeHandler-geometryCollection
微信公众号：emanjusaka的编程栈

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。