DataSet (groovy 2.4.4 API)

groovy.sql.DataSet

Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Inherited fields
Fields inherited from class	Fields
`class Sql`	`ALL_RESULT_SETS, ARRAY, BIGINT, BINARY, BIT, BLOB, BOOLEAN, CHAR, CLOB, DATALINK, DATE, DECIMAL, DISTINCT, DOUBLE, FIRST_RESULT_SET, FLOAT, INTEGER, JAVA_OBJECT, LOG, LONGVARBINARY, LONGVARCHAR, NO_RESULT_SETS, NULL, NUMERIC, OTHER, REAL, REF, SMALLINT, STRUCT, TIME, TIMESTAMP, TINYINT, VARBINARY, VARCHAR`

Constructor Summary

Constructors
Constructor and description
`DataSet (Sql sql, Class type)`
`DataSet (Sql sql, String table)`

Methods Summary

Methods
Type	Name and description
`void`	`add(Map<String, Object> map)` Adds the provided map of key-value pairs as a new row in the table represented by this DataSet.
`void`	`cacheConnection(Closure closure)`
`void`	`close()`
`protected void`	`closeResources(Connection connection, Statement statement, ResultSet results)`
`protected void`	`closeResources(Connection connection, Statement statement)`
`void`	`commit()`
`protected Connection`	`createConnection()`
`DataSet`	`createView(Closure criteria)`
`void`	`each(Closure closure)` Calls the provided closure for each of the rows of the table represented by this DataSet.
`void`	`each(int offset, int maxRows, Closure closure)` Calls the provided closure for a "page" of rows from the table represented by this DataSet.
`DataSet`	`findAll(Closure where)` Return a lazy-implemented filtered view of this DataSet.
`Object`	`firstRow()` Returns the first row from a DataSet's underlying table
`List<Object>`	`getParameters()`
`String`	`getSql()`
`protected SqlOrderByVisitor`	`getSqlOrderByVisitor()`
`protected SqlWhereVisitor`	`getSqlWhereVisitor()`
`DataSet`	`reverse()` Return a lazy-implemented reverse-ordered view of this DataSet.
`void`	`rollback()`
`List`	`rows()` Returns a List of all of the rows from the table a DataSet represents.
`List`	`rows(int offset, int maxRows)` Returns a "page" of the rows from the table a DataSet represents.
`DataSet`	`sort(Closure sort)` Return a lazy-implemented re-ordered view of this DataSet.
`int[]`	`withBatch(Closure closure)` Performs the closure (containing batch operations) within a batch.
`int[]`	`withBatch(int batchSize, Closure closure)` Performs the closure (containing batch operations) within a batch.
`void`	`withTransaction(Closure closure)`

Inherited Methods Summary

Inherited Methods
Methods inherited from class	Name
`class Sql`	ARRAY, BIGINT, BINARY, BIT, BLOB, BOOLEAN, CHAR, CLOB, DATALINK, DATE, DECIMAL, DISTINCT, DOUBLE, FLOAT, INTEGER, JAVA_OBJECT, LONGVARBINARY, LONGVARCHAR, NULL, NUMERIC, OTHER, REAL, REF, SMALLINT, STRUCT, TIME, TIMESTAMP, TINYINT, VARBINARY, VARCHAR, asList, asList, asList, asSql, buildSqlWithIndexedProps, cacheConnection, cacheStatements, call, call, call, call, call, call, callWithAllRows, callWithAllRows, callWithRows, callWithRows, callWithRows, checkForNamedParams, close, closeResources, closeResources, closeResources, commit, configure, createConnection, createPreparedQueryCommand, createQueryCommand, dataSet, dataSet, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, eachRow, execute, execute, execute, execute, execute, execute, execute, execute, execute, execute, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executeInsert, executePreparedQuery, executeQuery, executeUpdate, executeUpdate, executeUpdate, executeUpdate, executeUpdate, expand, findWhereKeyword, firstRow, firstRow, firstRow, firstRow, firstRow, getConnection, getDataSource, getParameters, getResultSetConcurrency, getResultSetHoldability, getResultSetType, getUpdateCount, getUpdatedParams, in, inout, isCacheNamedQueries, isCacheStatements, isEnableNamedQueries, isWithinBatch, loadDriver, newInstance, newInstance, newInstance, newInstance, newInstance, newInstance, newInstance, nullify, out, preCheckForNamedParams, query, query, query, query, query, resultSet, rollback, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, rows, setCacheNamedQueries, setCacheStatements, setEnableNamedQueries, setInternalConnection, setObject, setParameters, setResultSetConcurrency, setResultSetHoldability, setResultSetType, withBatch, withBatch, withBatch, withBatch, withInstance, withInstance, withInstance, withInstance, withInstance, withInstance, withInstance, withStatement, withTransaction

- Constructor Detail
  - public DataSet(Sql sql, Class type)
  - public DataSet(Sql sql, String table)
- Method Detail
  - public void add(Map<String, Object> map)
    
    Adds the provided map of key-value pairs as a new row in the table represented by this DataSet.
    throws:
    SQLException if a database error occurs
    
    Parameters:
    map - the key (column-name), value pairs to add as a new row
  - @Override public void cacheConnection(Closure closure)
  - @Override public void close()
  - @Override protected void closeResources(Connection connection, Statement statement, ResultSet results)
  - @Override protected void closeResources(Connection connection, Statement statement)
  - @Override public void commit()
  - @Override protected Connection createConnection()
  - public DataSet createView(Closure criteria)
  - public void each(Closure closure)
    
    Calls the provided closure for each of the rows of the table represented by this DataSet.
    throws:
    SQLException if a database access error occurs
    
    Parameters:
    closure - called for each row with a GroovyResultSet
    See Also:
    Sql.eachRow
  - public void each(int offset, int maxRows, Closure closure)
    
    Calls the provided closure for a "page" of rows from the table represented by this DataSet. A page is defined as starting at a 1-based offset, and containing a maximum number of rows.
    throws:
    SQLException if a database access error occurs
    
    Parameters:
    offset - the 1-based offset for the first row to be processed
    maxRows - the maximum number of rows to be processed
    closure - called for each row with a GroovyResultSet
    See Also:
    Sql.eachRow
  - public DataSet findAll(Closure where)
    
    Return a lazy-implemented filtered view of this DataSet.
    Parameters:
    where - the filtering Closure
    Returns:
    the view DataSet
  - public Object firstRow()
    
    Returns the first row from a DataSet's underlying table
    throws:
    SQLException if a database error occurs
    
    Returns:
    Returns the first GroovyRowResult object from the dataset
  - public List<Object> getParameters()
  - public String getSql()
  - protected SqlOrderByVisitor getSqlOrderByVisitor()
  - protected SqlWhereVisitor getSqlWhereVisitor()
  - public DataSet reverse()
    
    Return a lazy-implemented reverse-ordered view of this DataSet.
    Returns:
    the view DataSet
  - @Override public void rollback()
  - public List rows()
    
    Returns a List of all of the rows from the table a DataSet represents.
    throws:
    SQLException if a database error occurs
    
    Returns:
    Returns a list of GroovyRowResult objects from the dataset
  - public List rows(int offset, int maxRows)
    
    Returns a "page" of the rows from the table a DataSet represents. A page is defined as starting at a 1-based offset, and containing a maximum number of rows.
    throws:
    SQLException if a database error occurs
    
    Parameters:
    offset - the 1-based offset for the first row to be processed
    maxRows - the maximum number of rows to be processed
    Returns:
    a list of GroovyRowResult objects from the dataset
  - public DataSet sort(Closure sort)
    
    Return a lazy-implemented re-ordered view of this DataSet.
    Parameters:
    sort - the ordering Closure
    Returns:
    the view DataSet
  - @Override public int[] withBatch(Closure closure)
    
    Performs the closure (containing batch operations) within a batch. Uses a batch size of zero, i.e. no automatic partitioning of batches.
    throws:
    SQLException if a database access error occurs, or this method is called on a closed Statement, or the driver does not support batch statements. Throws BatchUpdateException (a subclass of SQLException) if one of the commands sent to the database fails to execute properly or attempts to return a result set.
    
    Parameters:
    closure - the closure containing batch and optionally other statements
    Returns:
    an array of update counts containing one element for each command in the batch. The elements of the array are ordered according to the order in which commands were added to the batch.
  - @Override public int[] withBatch(int batchSize, Closure closure)
    
    Performs the closure (containing batch operations) within a batch. For example:
```
 dataSet.withBatch(3) {
     add(anint: 1, astring: "Groovy")
     add(anint: 2, astring: "rocks")
     add(anint: 3, astring: "the")
     add(anint: 4, astring: "casbah")
 }
 
```
    throws:
    SQLException if a database access error occurs, or the driver does not support batch statements. Throws BatchUpdateException (a subclass of SQLException) if one of the commands sent to the database fails to execute properly.
    
    Parameters:
    batchSize - partition the batch into batchSize pieces, i.e. after batchSize addBatch() invocations, call executeBatch() automatically; 0 means manual calls to executeBatch are required
    closure - the closure containing batch and optionally other statements
    Returns:
    an array of update counts containing one element for each command in the batch. The elements of the array are ordered according to the order in which commands were added to the batch.
  - @Override public void withTransaction(Closure closure)

Summary:
Constructor
Method

| Detail:
Constructor
Method

[Java] Class DataSet

Constructor Summary

Methods Summary

Inherited Methods Summary

Constructor Detail

public DataSet(Sql sql, Class type)

public DataSet(Sql sql, String table)

Method Detail

public void add(Map<String, Object> map)

@Override public void cacheConnection(Closure closure)

@Override public void close()

@Override protected void closeResources(Connection connection, Statement statement, ResultSet results)

@Override protected void closeResources(Connection connection, Statement statement)

@Override public void commit()

@Override protected Connection createConnection()

public DataSet createView(Closure criteria)

public void each(Closure closure)

public void each(int offset, int maxRows, Closure closure)

public DataSet findAll(Closure where)

public Object firstRow()

public List<Object> getParameters()

public String getSql()

protected SqlOrderByVisitor getSqlOrderByVisitor()

protected SqlWhereVisitor getSqlWhereVisitor()

public DataSet reverse()

@Override public void rollback()

public List rows()

public List rows(int offset, int maxRows)

public DataSet sort(Closure sort)

@Override public int[] withBatch(Closure closure)

@Override public int[] withBatch(int batchSize, Closure closure)

@Override public void withTransaction(Closure closure)