The PostGIS extension must be registered within the JDBC driver.
There are three ways to do this:
-- If you use pgjdbc 8.0, the org/postgresql/postgresql.properties
+- If you use pgjdbc 8.0, the org/postgresql/driverconfig.properties
file contained in the postgis.jar autoregisters the PostGIS
extension for the PostGIS data types (geometry, box2d, box3d)
within the pgjdbc driver.
autoregister for the same PostGIS types, as the driver cannot guess
which extension it should actually use on which connection. The
current pgjdbc implementation simply parses all
-org/postgresql/postgresql.properties the classloader can find in his
+org/postgresql/driverconfig.properties the classloader can find in his
classpath, and later definitions override earlier ones.
PostGIS server side problem as the server fails to parse some
OpenGIS compliant WKT representations, and it is unlikely to be
fixed as users should migrate to PostGIS 1.0.
+
+ The Autoregister Test needs a pgjdbc version 8.0 or newer, and will
+ refuse to work against older versions. It also will skip the box2d
+ test on PostGIS 0.X releases which lack this datatype.
If you get different failures in the online tests, check whether
your really fulfil the prerequisites above. If yes, please contact
--- /dev/null
+/*
+ * TestAutoregister.java
+ *
+ * PostGIS extension for PostgreSQL JDBC driver - example and test classes
+ *
+ * (C) 2005 Markus Schaber, schabios@logi-track.com
+ *
+ * This program is free software; you can redistribute it and/or modify it under
+ * the terms of the GNU General Public License as published by the Free Software
+ * Foundation; either version 2 of the License.
+ *
+ * This program 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 General Public License for more
+ * details.
+ *
+ * You should have received a copy of the GNU General Public License along with
+ * this program; if not, write to the Free Software Foundation, Inc., 59 Temple
+ * Place, Suite 330, Boston, MA 02111-1307 USA or visit the web at
+ * http://www.gnu.org.
+ *
+ * $Id$
+ */
+
+package examples;
+
+import org.postgis.PGbox2d;
+import org.postgis.PGbox3d;
+import org.postgis.PGgeometry;
+import org.postgresql.Driver;
+import org.postgresql.util.PGobject;
+
+import java.sql.Connection;
+import java.sql.DriverManager;
+import java.sql.ResultSet;
+import java.sql.SQLException;
+import java.sql.Statement;
+
+/**
+ * This test program tests whether the autoregistration of PostGIS data types
+ * within the pgjdbc driver was successful. This is supposed to work with
+ * pgjdbc.jar version 8.0 and newer, and thus refuses to work with older pgjdbc
+ * versions. (But it will work fine against older servers.) It also checks for
+ * postgis version to know whether box2d is available.
+ */
+public class TestAutoregister {
+
+ public static void main(String[] args) {
+ String dburl = null;
+ String dbuser = null;
+ String dbpass = null;
+
+ if (args.length == 3) {
+ System.out.println("Testing proper auto-registration");
+ dburl = args[0];
+ dbuser = args[1];
+ dbpass = args[2];
+ } else {
+ System.err.println("Usage: java examples/TestParser dburl user pass");
+ System.exit(1);
+ // Signal the compiler that code flow ends here.
+ throw new AssertionError();
+ }
+
+ System.out.println("Driver version: " + Driver.getVersion());
+ int major = Integer.parseInt(Driver.getVersion().trim().split(" ")[1].split("\\.")[0]);
+ if (major < 8) {
+ System.out.println("Your pgdjbc " + major
+ + ".X is too old, it does not support autoregistration!");
+ return;
+ }
+
+ System.out.println("Creating JDBC connection to " + dburl);
+ Connection conn = null;
+ Statement stat = null;
+ try {
+ conn = DriverManager.getConnection(dburl, dbuser, dbpass);
+ stat = conn.createStatement();
+ } catch (SQLException e) {
+ System.out.println("Connection initialization failed, aborting.");
+ e.printStackTrace(System.out);
+ System.exit(1);
+ }
+
+ String version = null;
+ try {
+ ResultSet rs = stat.executeQuery("SELECT postgis_version()");
+ rs.next();
+ version = rs.getString(1);
+ if (version == null) {
+ throw new SQLException("postgis_version returned NULL!");
+ }
+ } catch (SQLException e) {
+ System.out.println("Error fetching PostGIS version: " + e.getMessage());
+ System.out.println("Is PostGIS really installed in the database?");
+ System.exit(1);
+ }
+
+ System.out.println("PostGIS Version: " + version);
+
+ PGobject result = null;
+
+ /* Test geometries */
+ try {
+ ResultSet rs = stat.executeQuery("SELECT 'POINT(1 2)'::geometry");
+ rs.next();
+ result = (PGobject) rs.getObject(1);
+ if (result instanceof PGgeometry) {
+ System.out.println("PGgeometry successful!");
+ } else {
+ System.out.println("PGgeometry failed!");
+ }
+ } catch (SQLException e) {
+ System.out.println("Selecting geometry failed: " + e.getMessage());
+ }
+
+ /* Test box3d */
+ try {
+ ResultSet rs = stat.executeQuery("SELECT 'BOX3D(1 2 3, 4 5 6)'::box3d");
+ rs.next();
+ result = (PGobject) rs.getObject(1);
+ if (result instanceof PGbox3d) {
+ System.out.println("Box3d successful!");
+ } else {
+ System.out.println("Box3d failed!");
+ }
+ } catch (SQLException e) {
+ System.out.println("Selecting box3d failed: " + e.getMessage());
+ }
+
+ /* Test box2d if appropriate */
+ if (version.trim().startsWith("0.")) {
+ System.out.println("PostGIS version is too old, not testing box2d");
+ } else {
+ try {
+ ResultSet rs = stat.executeQuery("SELECT 'BOX(1 2,3 4)'::box2d");
+ rs.next();
+ result = (PGobject) rs.getObject(1);
+ if (result instanceof PGbox2d) {
+ System.out.println("Box2d successful!");
+ } else {
+ System.out.println("Box2d failed! " + result.getClass().getName());
+ }
+ } catch (SQLException e) {
+ System.out.println("Selecting box2d failed: " + e.getMessage());
+ }
+ }
+
+ System.out.println("Finished.");
+ }
+}
\ No newline at end of file
projects / postgis / commitdiff