Mybatis映射Oracle Spatial和Jgeometry

引子

最近要用到Oracle Spatial中SDO_Geometry数据结构，因为SDO_Geometry可以存储点、线、面等几何图形，关于SDO_Geometry的介绍网上很多，此处不再赘述。本文要介绍的是在java中实现对Oracle中的SDO_Geometry类型的字段的读写。

创建Oracle Spatial空间索引

创建Oracle的空间索引的例子网上很多，只列出步骤，不解释具体的原理。
1.创建表

CREATE TABLE GEOMETRY_TABLE(  ID              NUMBER,  NAME            VARCHAR2(30),  GEOMETRY        SDO_GEOMETRY,)

2.创建相应的空间元数据
元数据视图USER_SDO_GEOM_METADATA，可以select查看。

INSERT INTO USER_SDO_GEOM_METADATA VALUES('GEOMETRY_TABLE', 'GEOMETRY', MDSYS.SDO_DIM_ARRAY(MDSYS.SDO_DIM_ELEMENT('longitude', -180, 180, 0.005), MDSYS.SDO_DIM_ELEMENT('latitude', -90, 90, 0.005)), 8307);

USER_SDO_GEOM_METADATA视图包含的字段有TABLE_NAME,COLUMN_NAME,DIMINFO,SRID.对于SRID我们通常使用国际标准的Longitude/Latitude(8307)。使用的有很多标准，如果有兴趣的话可以去oracle的MDSYS用户下去查看，有个专门记录SRID值的表。

3.创建空间索引

CREATE INDEX GEO_INDEX ON GEOMETRY_TABLE(GEOMETRY) INDEXTYPE IS MDSYS.SPATIAL_INDEX;

Mybatis映射JGeometry和SDO_GEOMETRY

空间对象以SDO_GEOMETRY类型存储在数据库表中。要在Java中对其进行处理，必须首先使用JDBC从数据库中读取它们，然后把它们映射为Java类。Oracle Spatial提供了API接口。Oracle Spatial的Java API的jar包在Oracle安装目录($ORACLE_HOME/md/jlib )下(sdoapi.jar和sdoutl.jar)，将其导入java的classpath。主要用的两个类JGeometry和J3D_Geometry，一个是二维的，一个是三维的。

在使用java读写数据库中包含SDO_GEOMETRY类型的表时可以使用JDBC来做，但是由于JDBC的缺点，所以采用Mybatis来做持久层和数据的映射。由于Mybatis不包含将JGeometry和SDO_GEOMETRY对应的TypeHandler，所以要建立自己的TypeHandler。

建立SdoGeometryTypeHandler
建立自己的Typehandler可以通过继承原始接口TypeHandler或者 BaseTypeHandler抽象类，两个差不多，我用的时通过继承原始接口TypeHandler。
在Mybatis中要实现自己的TypeHandler就需要实现Mybatis为我们提供的TypeHandler接口。在TypeHandler中定义了四个方法，下面解释这四个方法的作用：
Java代码

public interface TypeHandler<T> {      /**      * 用于定义在Mybatis设置参数时该如何把Java类型的参数转换为对应的数据库类型      * @param ps 当前的PreparedStatement对象      * @param i 当前参数的位置      * @param parameter 当前参数的Java对象      * @param jdbcType 当前参数的数据库类型      * @throws SQLException      */      void setParameter(PreparedStatement ps, int i, T parameter,             JdbcType jdbcType) throws SQLException;      /**      * 用于在Mybatis获取数据结果集时如何把数据库类型转换为对应的Java类型      * @param rs 当前的结果集      * @param columnName 当前的字段名称      * @return 转换后的Java对象      * @throws SQLException      */      T getResult(ResultSet rs, String columnName) throws SQLException;      /**      * 用于在Mybatis通过字段位置获取字段数据时把数据库类型转换为对应的Java类型      * @param rs 当前的结果集      * @param columnIndex 当前字段的位置      * @return 转换后的Java对象      * @throws SQLException      */      T getResult(ResultSet rs, int columnIndex) throws SQLException;      /**      * 用于Mybatis在调用存储过程后把数据库类型的数据转换为对应的Java类型      * @param cs 当前的CallableStatement执行后的CallableStatement      * @param columnIndex 当前输出参数的位置      * @return      * @throws SQLException      */      T getResult(CallableStatement cs, int columnIndex) throws SQLException;  }  

建立一个名叫SdoGeometryTypeHandler的TypeHandler，具体代码如下：
Java代码

package com.instance.mybatis.handler;import java.sql.CallableStatement;import java.sql.PreparedStatement;import java.sql.ResultSet;import java.sql.SQLException;import oracle.spatial.geometry.JGeometry;import oracle.sql.STRUCT;import org.apache.ibatis.type.JdbcType;import org.apache.ibatis.type.MappedJdbcTypes;import org.apache.ibatis.type.MappedTypes;import org.apache.ibatis.type.TypeHandler;@MappedTypes({JGeometry.class})@MappedJdbcTypes({JdbcType.STRUCT})//这两个Mapped也可不需要public class SdoGeometryTypeHandler implements TypeHandler<JGeometry> {    @Override    public void setParameter(PreparedStatement ps, int i, JGeometry parameter,            JdbcType jdbcType) throws SQLException {        // TODO Auto-generated method stub        STRUCT dbObject = JGeometry.store(parameter, ps.getConnection());        ps.setObject(i, dbObject);    }    @Override    public JGeometry getResult(ResultSet rs, String columnName)            throws SQLException {        // TODO Auto-generated method stub        STRUCT st = (STRUCT) rs.getObject(columnName);        if (st != null) {            return JGeometry.load(st);        }        return null;    }    @Override    public JGeometry getResult(ResultSet rs, int columnIndex)            throws SQLException {        // TODO Auto-generated method stub        STRUCT st = (STRUCT) rs.getObject(columnIndex);        if (st != null) {            return JGeometry.load(st);        }        return null;    }    @Override    public JGeometry getResult(CallableStatement cs, int columnIndex)            throws SQLException {        // TODO Auto-generated method stub        STRUCT st = (STRUCT) cs.getObject(columnIndex);        if (st != null) {            return JGeometry.load(st);        }        return null;    }}

然后我们在Mybatis的配置文件中这样注册它：

 <?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd" ><configuration>    <typeAliases>        <typeAlias type="oracle.spatial.geometry.JGeometry" alias="JGeometry" />        <typeAlias type="com.instance.domain.Geometry" alias="Geometry" />    </typeAliases>    <typeHandlers>        <typeHandler handler="com.albert.wen.instance.mybatis.handler.SdoGeometryTypeHandler" javaType="JGeometry" />    </typeHandlers>    <mappers>        <mapper resource="com/instance/mapper/GeometryDaoMapper.xml" />    </mappers></configuration>

下面就是GeometryDaoMapper.xml中如何使用自定义的TypeHandler了,查询和插入的SQL语句写法：

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.instance.mapper.GeometryDaoMapper">    <resultMap id="defaultResultMap" type="Geometry">        <result property="id" column="id" />        <result property="name" column="name" />        <result property="geometry" column="geometry" javaType="JGeometry" jdbcType="STRUCT" />    </resultMap>    <select id="select" resultMap="defaultResultMap">        SELECT id, name, geometry FROM geometry_table    </select>    <insert id="insert" parameterType="Geometry">        INSERT INTO geometry_table(id, name, geometry) VALUES(#{id}, #{name}, #{geometry,javaType=JGeometry,jdbcType=STRUCT})    </insert></mapper>

在网上找了一下，没有找到关于Mybatis将JGeometry和Oracle中的SDO_Geometry映射的例子，所以就将自己的实例发出来和大家分享一下，还有数据库的配置是使用spring完成的。因为是第一次写博客，还是用markdown写的，格式可能会有点乱。