Overview
Getting Hibernate Spatial
Documentation
Providers
Project Documentation
Hibernate Spatial is a generic extension to Hibernate for handling geographic data. Hibernate Spatial is open source and licensed, like Hibernate, under the LGPL license.
Hibernate Spatial allows you to deal with geographic data in a standardized way. It abstracts away from the specific way your database supports geographic data, and provides a standardized, cross-database interface to geographic data storage and query functions.
Hibernate Spatial supports most of the functions of the OGC Simple Feature Specification. Supported databases are: Oracle 10g/11g, Postgresql/Postgis, MySQL, Microsoft SQL Server and H2/GeoDB.
There is a similar project for NHibernate: NHibernate.Spatial.
Hibernate Spatial uses the Java Topology Suite (JTS) as its geometry model. JTS is an implementation of the OpenGIS Simple Features Implementation Specification for SQLv. 1.1 (SFS). This specification is implemented in most RDBMS with spatial data support. It is also a direct precursor to a precursor to SQL/MM Part 3: Spatial (ISO/IEC 13249-3).
The SFS specification defines a set of functions on geometries. Hibernate Spatial makes a subset of these functions available in HQL and in the criteria query API (see the SpatialRestrictions class in the org.hibernatespatial.criterion package).
Not all databases support all the functions defined by Hibernate Spatial. The table below provides an overview of the functions provided by each database
| Function | Description | Postgresql | Oracle 10g/11g | MySQL | SQLServer | GeoDB (H2) |
|---|---|---|---|---|---|---|
| Basic functions on Geometry | ||||||
| int dimension(Geometry) | SFS §2.1.1.1 |  | | | |  |
| String geometrytype(Geometry) | SFS §2.1.1.1 | | | | | |
| int srid(Geometry) | SFS §2.1.1.1 | | | | | |
| Geometry envelope(Geometry) | SFS §2.1.1.1 | | | | | |
| String astext(Geometry) | SFS §2.1.1.1 | | | | | |
| byte[] asbinary(Geometry) | SFS §2.1.1.1 | | | | | |
| boolean isempty(Geometry) | SFS §2.1.1.1 | | | | | |
| boolean issimple(Geometry) | SFS §2.1.1.1 | | | | | |
| Geometry boundary(Geometry) | SFS §2.1.1.1 | | | | | |
| Functions for testing Spatial Relations between geometric objects | ||||||
| boolean equals(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean disjoint(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean intersects(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean touches(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean crosses(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean within(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean contains(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean overlaps(Geometry, Geometry) | SFS §2.1.1.2 | | | | | |
| boolean relate(Geometry, Geometry, String) | SFS §2.1.1.2 | | | | | |
| Functions that support Spatial Analysis | ||||||
| double distance(Geometry, Geometry) | SFS §2.1.1.3 | | | | | |
| Geometry buffer(Geometry, double) | SFS §2.1.1.3 | | | | | |
| Geometry convexhull(Geometry) | SFS §2.1.1.3 | | | | | |
| Geometry intersection(Geometry, Geometry) | SFS §2.1.1.3 | | | | | |
| Geometry geomunion(Geometry, Geometry) | SFS §2.1.1.3 (renamed from union) | | | | | |
| Geometry difference(Geometry, Geometry) | SFS §2.1.1.3 | | | | | |
| Geometry symdifference(Geometry, Geometry) | SFS §2.1.1.3 | | | | | |
| Common non-SFS functions | ||||||
| boolean dwithin(Geometry, Geometry, double) | Returns true if the geometries are within the specified distance of one another | | | | | |
| Geometry transform(Geometry, int) | Returns a new geometry with its coordinates transformed to the SRID referenced by the integer parameter | | | | | |
| Spatial aggregate Functions | ||||||
| Geometry extent(Geometry) | Returns a bounding box that bounds the set of returned geometries | | | | | |