PostgreSQL用Point类型存储经纬度的Java实体类处理方案问询

一、数据库表准备 #

首先在PostgreSQL中创建包含POINT类型字段的表，示例SQL：

CREATE TABLE locations (
    id SERIAL PRIMARY KEY,
    coordinates POINT NOT NULL -- 存储经纬度的Point类型字段
);

二、原生JDBC实现 #

直接使用PostgreSQL JDBC驱动自带的org.postgresql.geometric.PGpoint类处理坐标，无需额外依赖：

import org.postgresql.geometric.PGpoint;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.DriverManager;

public class JdbcCoordinateDemo {
    public static void main(String[] args) throws Exception {
        double lat = 17.4343;
        double lon = 76.4343;
        
        // 注意：PostgreSQL的Point是(经度, 纬度)的顺序，不要搞反
        PGpoint point = new PGpoint(lon, lat);

        try (Connection conn = DriverManager.getConnection(
                "jdbc:postgresql://localhost:5432/your_db",
                "your_user",
                "your_pass"
        );
             PreparedStatement stmt = conn.prepareStatement(
                     "INSERT INTO locations (coordinates) VALUES (?)"
             )) {
            stmt.setObject(1, point);
            stmt.executeUpdate();
        }
    }
}

三、JPA/Hibernate实现（推荐） #

方案1：使用Hibernate Spatial（适合空间查询场景） #

如果需要后续做空间查询（比如找附近点），推荐用Hibernate Spatial，它直接支持PostgreSQL的空间类型。

1. 添加Maven依赖

<dependency>
    <groupId>org.hibernate</groupId>
    <artifactId>hibernate-spatial</artifactId>
    <version>5.6.14.Final</version> <!-- 匹配你的Hibernate版本 -->
</dependency>
<dependency>
    <groupId>org.postgresql</groupId>
    <artifactId>postgresql</artifactId>
    <version>42.6.0</version>
</dependency>

2. 实体类写法

使用JTS库的Point类型映射数据库的POINT字段：

import javax.persistence.*;
import org.locationtech.jts.geom.Point;
import org.locationtech.jts.geom.GeometryFactory;

@Entity
@Table(name = "locations")
public class Location {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(columnDefinition = "POINT")
    private Point coordinates;

    // 空构造函数（JPA要求）
    public Location() {}

    // 从经纬度创建实体的辅助方法
    public static Location fromLatLon(double lat, double lon) {
        GeometryFactory factory = new GeometryFactory();
        // 注意顺序：x=经度，y=纬度
        Point point = factory.createPoint(new org.locationtech.jts.geom.Coordinate(lon, lat));
        return new Location(point);
    }

    // Getter & Setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public Point getCoordinates() { return coordinates; }
    public void setCoordinates(Point coordinates) { this.coordinates = coordinates; }
}

方案2：自定义AttributeConverter（轻量方案） #

如果不需要复杂空间查询，可自定义转换器，用自己的坐标类映射POINT字段，避免引入额外依赖。

1. 自定义坐标类

public class Coordinates {
    private double latitude;
    private double longitude;

    public Coordinates(double latitude, double longitude) {
        this.latitude = latitude;
        this.longitude = longitude;
    }

    // Getter & Setter
    public double getLatitude() { return latitude; }
    public double getLongitude() { return longitude; }
}

2. 实现转换器

import javax.persistence.AttributeConverter;
import javax.persistence.Converter;
import org.postgresql.geometric.PGpoint;

@Converter(autoApply = true) // 自动应用到所有Coordinates类型字段
public class CoordinatesConverter implements AttributeConverter<Coordinates, PGpoint> {
    @Override
    public PGpoint convertToDatabaseColumn(Coordinates coords) {
        if (coords == null) return null;
        // 转成PostgreSQL的Point：经度在前，纬度在后
        return new PGpoint(coords.getLongitude(), coords.getLatitude());
    }

    @Override
    public Coordinates convertToEntityAttribute(PGpoint dbPoint) {
        if (dbPoint == null) return null;
        // 从数据库Point转回来：dbPoint.x是经度，dbPoint.y是纬度
        return new Coordinates(dbPoint.y, dbPoint.x);
    }
}

3. 实体类写法

import javax.persistence.*;

@Entity
@Table(name = "locations")
public class Location {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(columnDefinition = "POINT")
    private Coordinates coordinates;

    // 空构造函数（JPA要求）
    public Location() {}

    public Location(Coordinates coordinates) {
        this.coordinates = coordinates;
    }

    // Getter & Setter
    public Long getId() { return id; }
    public void setId(Long id) { this.id = id; }
    public Coordinates getCoordinates() { return coordinates; }
    public void setCoordinates(Coordinates coordinates) { this.coordinates = coordinates; }
}

四、关键注意事项 #

• 坐标顺序：PostgreSQL的POINT类型是(x, y)对应经度、纬度，存储和查询时必须遵守这个顺序，否则坐标位置会完全错误。
• 依赖版本：使用Hibernate Spatial时，要确保Hibernate版本与Hibernate Spatial版本兼容，避免出现依赖冲突。
• 空间查询：如果需要查询附近的点，可使用PostgreSQL的空间运算符<->，示例原生SQL：

  -- 查询距离指定坐标最近的10个点
  SELECT * FROM locations 
  ORDER BY coordinates <-> point(76.4343, 17.4343) 
  LIMIT 10;
  

内容的提问来源于stack exchange，提问作者VSChari