Package org.apache.tools.ant.taskdefs
Class JDBCTask
java.lang.Object
org.apache.tools.ant.ProjectComponent
org.apache.tools.ant.Task
org.apache.tools.ant.taskdefs.JDBCTask
- All Implemented Interfaces:
Cloneable
- Direct Known Subclasses:
SQLExec
Handles JDBC configuration needed by SQL type tasks.
The following example class prints the contents of the first column of each row in TableName.
package examples; import java.sql.Connection; import java.sql.ResultSet; import java.sql.SQLException; import java.sql.Statement; import org.apache.tools.ant.BuildException; import org.apache.tools.ant.taskdefs.JDBCTask; public class SQLExampleTask extends JDBCTask { private String tableName; public void execute() throws BuildException { Connection conn = getConnection(); Statement stmt=null; try { if (tableName == null) { throw new BuildException("TableName must be specified", location); } String sql = "SELECT * FROM "+tableName; stmt= conn.createStatement(); ResultSet rs = stmt.executeQuery(sql); while (rs.next()) { log(rs.getObject(1).toString()); } } catch (SQLException e) { } finally { if (stmt != null) { try {stmt.close();}catch (SQLException ignore) {} } if (conn != null) { try {conn.close();}catch (SQLException ignore) {} } } } public void setTableName(String tableName) { this.tableName = tableName; } }
- Since:
- Ant 1.5
-
Field Summary
Fields inherited from class org.apache.tools.ant.ProjectComponent
description, location, project
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionvoid
Additional properties to put into the JDBC connection string.Add a path to the classpath for loading the driver.Gets the classpath.protected Connection
Creates a new Connection as using the driver, url, userid and password specified.protected AntClassLoader
Get the classloader used to create a driver.protected static Hashtable
<String, AntClassLoader> Get the cache of loaders and drivers.Gets the password.getRdbms()
Gets the rdbms.getUrl()
Gets the url.Gets the userId.Gets the version.boolean
Gets the autocommit.void
isCaching
(boolean value) Set the caching attribute.protected boolean
isValidRdbms
(Connection conn) Verify we are connected to the correct RDBMSvoid
setAutocommit
(boolean autocommit) Auto commit flag for database connection; optional, default false.void
setCaching
(boolean enable) Caching loaders / driver.void
setClasspath
(Path classpath) Sets the classpath for loading the driver.void
Set the classpath for loading the driver using the classpath reference.void
Class name of the JDBC driver; required.void
setFailOnConnectionError
(boolean b) whether the task should cause the build to fail if it cannot connect to the database.void
setPassword
(String password) Sets the password; required.void
Execute task only if the lower case product name of the DB matches thisvoid
Sets the database connection URL; required.void
Set the user name for the connection; required.void
setVersion
(String version) Sets the version string, execute task only if rdbms version match; optional.Methods inherited from class org.apache.tools.ant.Task
bindToOwner, execute, getOwningTarget, getRuntimeConfigurableWrapper, getTaskName, getTaskType, getWrapper, handleErrorFlush, handleErrorOutput, handleFlush, handleInput, handleOutput, init, isInvalid, log, log, log, log, maybeConfigure, perform, reconfigure, setOwningTarget, setRuntimeConfigurableWrapper, setTaskName, setTaskType
Methods inherited from class org.apache.tools.ant.ProjectComponent
clone, getDescription, getLocation, getProject, setDescription, setLocation, setProject
-
Constructor Details
-
JDBCTask
public JDBCTask()
-
-
Method Details
-
setClasspath
Sets the classpath for loading the driver.- Parameters:
classpath
- The classpath to set
-
setCaching
public void setCaching(boolean enable) Caching loaders / driver. This is to avoid getting an OutOfMemoryError when calling this task multiple times in a row; default: true- Parameters:
enable
- aboolean
value
-
createClasspath
Add a path to the classpath for loading the driver.- Returns:
- a path to be configured
-
setClasspathRef
Set the classpath for loading the driver using the classpath reference.- Parameters:
r
- a reference to a classpath
-
setDriver
Class name of the JDBC driver; required.- Parameters:
driver
- The driver to set
-
setUrl
Sets the database connection URL; required.- Parameters:
url
- The url to set
-
setPassword
Sets the password; required.- Parameters:
password
- The password to set
-
setAutocommit
public void setAutocommit(boolean autocommit) Auto commit flag for database connection; optional, default false.- Parameters:
autocommit
- The autocommit to set
-
setRdbms
Execute task only if the lower case product name of the DB matches this- Parameters:
rdbms
- The rdbms to set
-
setVersion
Sets the version string, execute task only if rdbms version match; optional.- Parameters:
version
- The version to set
-
setFailOnConnectionError
public void setFailOnConnectionError(boolean b) whether the task should cause the build to fail if it cannot connect to the database.- Parameters:
b
- boolean- Since:
- Ant 1.8.0
-
isValidRdbms
Verify we are connected to the correct RDBMS- Parameters:
conn
- the jdbc connection- Returns:
- true if we are connected to the correct RDBMS
-
getLoaderMap
Get the cache of loaders and drivers.- Returns:
- a hashtable
-
getLoader
Get the classloader used to create a driver.- Returns:
- the classloader
-
addConnectionProperty
Additional properties to put into the JDBC connection string.- Parameters:
var
- Property- Since:
- Ant 1.8.0
-
getConnection
Creates a new Connection as using the driver, url, userid and password specified. The calling method is responsible for closing the connection.- Returns:
- Connection the newly created connection or null if the connection failed and failOnConnectionError is false.
- Throws:
BuildException
- if the UserId/Password/Url is not set or there is no suitable driver or the driver fails to load.
-
isCaching
public void isCaching(boolean value) Set the caching attribute.- Parameters:
value
- aboolean
value
-
getClasspath
-
isAutocommit
public boolean isAutocommit()Gets the autocommit.- Returns:
- Returns a boolean
-
getUrl
-
getUserId
-
setUserid
Set the user name for the connection; required.- Parameters:
userId
- The userId to set
-
getPassword
-
getRdbms
-
getVersion
-