de.csgis.commons.json

Class GeojsonPGHelper

java.lang.Object

de.csgis.commons.json.GeojsonPGHelper

public class GeojsonPGHelper
extends Object

A helper to insert, update and/or delete database rows from GeoJSON objects. A helper instance is meant to work on a single table in a PostGIS database.

Constructor Summary

Constructors

Constructor and Description
GeojsonPGHelper(String table, String idColumn, String geomColumn, int srid) Creates a new helper to insert, update and/or delete database rows from GeoJSON objects.

Method Summary

Modifier and Type	Method and Description
void	delete(net.sf.json.JSONObject geojson) It deletes the given object from the database.
String	getTable()
void	insert(net.sf.json.JSONObject geojson) Inserts the given object in the database.
void	setConnection(Connection connection) Sets the connection to use before calling insert(JSONObject), update(JSONObject) and/or delete(JSONObject).
void	update(net.sf.json.JSONObject geojson) Updates the given object in the database.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

GeojsonPGHelper

public GeojsonPGHelper(String table,
                       String idColumn,
                       String geomColumn,
                       int srid)

Creates a new helper to insert, update and/or delete database rows from GeoJSON objects. A helper is meant to work on a single table in a PostGIS database.

Parameters:

table - The table to use for inserts, updates and deletes.

idColumn - The name of the primary key column. The helper does not support primary keys with more than one column.

geomColumn - The name of the geometry column. The helper does not support more than one geometry column.

srid - The SRID for the geometries.

Method Detail

setConnection

public void setConnection(Connection connection)

Sets the connection to use before calling insert(JSONObject), update(JSONObject) and/or delete(JSONObject).

Parameters:

connection - The connection to use when inserting/updating/deleting objects.

insert

public void insert(net.sf.json.JSONObject geojson)
            throws SQLException,
                   IOException

Inserts the given object in the database.

Parameters:

geojson - The object to insert.

Throws:

SQLException - if the object cannot be updated.

IOException - if the geometry contained in the GeoJSON cannot be translated into WKT.

NullPointerException - if the connection has not been previously configured by calling setConnection(Connection).

update

public void update(net.sf.json.JSONObject geojson)
            throws SQLException,
                   IOException

Updates the given object in the database. The idField property is used for the WHERE clause to update only the specific object.

Parameters:

geojson - The object to update.

Throws:

SQLException - if the object cannot be updated.

IOException - if the geometry contained in the GeoJSON cannot be translated into WKT or the GeoJSON object does not have a idColumn property.

NullPointerException - if the connection has not been previously configured by calling setConnection(Connection).

delete

public void delete(net.sf.json.JSONObject geojson)
            throws SQLException,
                   IOException

It deletes the given object from the database.

Parameters:

geojson - The GeoJSON object to delete. Only the idField (see GeojsonPGHelper(String, String, String, int)) property is used.

Throws:

SQLException - if the object cannot be deleted.

IOException - if the GeoJSON object does not have an idColumn property.

NullPointerException - if the connection has not been previously configured by calling setConnection(Connection).

getTable

public String getTable()