Subversion Repositories hibernate-spatial

Rev

Rev 104 | Go to most recent revision | Blame | Compare with Previous | Last modification | View Log | RSS feed 

<?xml version="1.0" encoding="UTF-8"?>

<!--
  ~ $Id: usage.xml 170 2010-03-18 13:33:07Z maesenka $
  ~
  ~ This file is part of Hibernate Spatial, an extension to the
  ~ hibernate ORM solution for geographic data.
  ~
  ~ Copyright © 2007-2010 Geovise BVBA
  ~
  ~ This library is free software; you can redistribute it and/or
  ~ modify it under the terms of the GNU Lesser General Public
  ~ License as published by the Free Software Foundation; either
  ~ version 2.1 of the License, or (at your option) any later version.
  ~
  ~ This library is distributed in the hope that it will be useful,
  ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
  ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  ~ Lesser General Public License for more details.
  ~
  ~ You should have received a copy of the GNU Lesser General Public
  ~ License along with this library; if not, write to the Free Software
  ~ Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  ~
  ~ For more information, visit: http://www.hibernatespatial.org/
  -->

<document>
    <header/>


    <body>
        <section name="Hibernate Spatial Postgis Provider Usage">
            <p>
                To have Hibernate Spatial use this provider, simply drop
                the jar on the class-path alongside the
                hibernate-spatial.jar. When the Hibernate Spatial
                library is loaded it will find the provider and use it
                to retrieve the Hibernate dialect for Postgresql with
                the Postgis extension. This dialect is a subclass of
                <code>org.hibernate.dialect.PostgreSQLDialect</code>
            </p>
            <p>
                With the provider installed, you can use it by setting
                the dialect in the Hibernate configuration file as in
                the following snippet.
            </p>
            <source>
                ...
                &lt;property name="hibernate.dialect"&gt;
                org.hibernatespatial.postgis.PostgisDialect
                &lt;/property&gt;
                ...
            </source>

            <p>
                When there is more than one Hibernate Spatial provider
                on the Class-Path, you should explicitly label the
                dialect for the Geometry valued properties.
            </p>
            <source>
                ...
                &lt;property name="geometry"&gt;
                &lt;type name="org.hibernatespatial.GeometryUserType"&gt;
                &lt;param name="dialect"&gt;postgis&lt;/param&gt;
                &lt;/type&gt;
                &lt;column name="geom" /&gt;
                &lt;/property&gt;
                ...
            </source>
        </section>

    </body>
</document>