Merge pull request #9 from orbisgis/groovy_exemple

Add groovy example page

docs/index.rst

@@ -27,6 +27,7 @@ Except where otherwise noted, this documenation is licensed under a *Creative Co
    users/components
    users/quickstart
    users/attributes
+   users/groovy_with_sql
 
 .. toctree::
    :maxdepth: 2

docs/users/groovy_with_sql.rst

@@ -0,0 +1,29 @@
+Groovy script with SQL 
+========
+
+Below is an example of how to use SQL instructions into Groovy script.
+
+.. code-block:: groovy
+   
+	import groovy.sql.Sql;
+
+	def sql = Sql.newInstance(grv_ds);
+
+	// Execute SQL request
+	sql.execute("DROP TABLE IF EXISTS TEST")
+	sql.execute("CREATE TABLE TEST AS SELECT 'POINT(1 3 10)'::geometry THE_GEOM")
+
+	// Fetch results and print point coordinates
+	// row["THE_GEOM"] is an instance of 
+	// http://tsusiatsoftware.net/jts/javadoc/com/vividsolutions/jts/geom/Point.html
+	sql.eachRow("SELECT * FROM TEST") { row ->
+	    pt = row["THE_GEOM"].getCoordinate()
+	    print(pt.x+" "+pt.y+" "+pt.z)
+	}
+
+
+
+To see more, you can consult this tutorial_ from the Groovy documentation.
+
+
+.. _tutorial: http://docs.groovy-lang.org/latest/html/documentation/#_interacting_with_a_sql_database