org.opencms.setup
Class CmsSetupDb

java.lang.Object
  extended byorg.opencms.setup.CmsSetupDb

public class CmsSetupDb
extends java.lang.Object

Helper class to call database setup scripts.

Since:
6.0.0
Version:
$Revision: 1.26 $
Author:
Thomas Weckert, Carsten Weinholz

Field Summary
static java.lang.String SETUP_DATA_FOLDER
          The folder where to read the setup data from.
static java.lang.String SETUP_FOLDER
          The folder where the setup wizard is located.
 
Constructor Summary
CmsSetupDb(java.lang.String basePath)
          Creates a new CmsSetupDb object.
 
Method Summary
 java.lang.String checkVariables(java.lang.String db)
          Returns an optional warning message if needed, null if not.
 void clearErrors()
          Clears the error messages stored internally.
 void closeConnection()
          Closes the internal connection to the database.
 void createDatabase(java.lang.String database, java.util.Map replacer)
          Calls the create database script for the given database.
 void createDatabase(java.lang.String database, java.util.Map replacer, boolean abortOnError)
          Calls the create database script for the given database.
 void createTables(java.lang.String database, java.util.Map replacer)
          Calls the create tables script for the given database.
 void createTables(java.lang.String database, java.util.Map replacer, boolean abortOnError)
          Calls the create tables script for the given database.
 void dropDatabase(java.lang.String database, java.util.Map replacer)
          Calls the drop script for the given database.
 void dropDatabase(java.lang.String database, java.util.Map replacer, boolean abortOnError)
          Calls the drop script for the given database.
 void dropTables(java.lang.String database)
          Calls the drop tables script for the given database.
 void dropTables(java.lang.String database, java.util.Map replacer)
          Calls the drop tables script for the given database.
 void dropTables(java.lang.String database, java.util.Map replacer, boolean abortOnError)
          Calls the drop tables script for the given database.
protected  void finalize()
           
 java.util.Vector getErrors()
          Returns a Vector of Error messages.
 boolean noErrors()
          Checks if internal errors occured.
 void setConnection(java.sql.Connection conn)
          Sets a new internal connection to teh database.
 void setConnection(java.lang.String DbDriver, java.lang.String DbConStr, java.lang.String DbConStrParams, java.lang.String DbUser, java.lang.String DbPwd)
          Creates a new internal connection to the database.
 void updateDatabase(java.lang.String updateScript, java.util.Map replacers)
          Calls an update script.
 void updateDatabase(java.lang.String updateScript, java.util.Map replacers, boolean abortOnError)
          Calls an update script.
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

SETUP_DATA_FOLDER

public static final java.lang.String SETUP_DATA_FOLDER
The folder where to read the setup data from.

See Also:
Constant Field Values

SETUP_FOLDER

public static final java.lang.String SETUP_FOLDER
The folder where the setup wizard is located.

See Also:
Constant Field Values
Constructor Detail

CmsSetupDb

public CmsSetupDb(java.lang.String basePath)
Creates a new CmsSetupDb object.

Parameters:
basePath - the location of the setup scripts
Method Detail

clearErrors

public void clearErrors()
Clears the error messages stored internally.


closeConnection

public void closeConnection()
Closes the internal connection to the database.


createDatabase

public void createDatabase(java.lang.String database,
                           java.util.Map replacer)
Calls the create database script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script

createDatabase

public void createDatabase(java.lang.String database,
                           java.util.Map replacer,
                           boolean abortOnError)
Calls the create database script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script
abortOnError - indicates if the script is aborted if an error occurs

createTables

public void createTables(java.lang.String database,
                         java.util.Map replacer)
Calls the create tables script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script

createTables

public void createTables(java.lang.String database,
                         java.util.Map replacer,
                         boolean abortOnError)
Calls the create tables script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script
abortOnError - indicates if the script is aborted if an error occurs

dropDatabase

public void dropDatabase(java.lang.String database,
                         java.util.Map replacer)
Calls the drop script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script

dropDatabase

public void dropDatabase(java.lang.String database,
                         java.util.Map replacer,
                         boolean abortOnError)
Calls the drop script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script
abortOnError - indicates if the script is aborted if an error occurs

dropTables

public void dropTables(java.lang.String database)
Calls the drop tables script for the given database.

Parameters:
database - the name of the database

dropTables

public void dropTables(java.lang.String database,
                       java.util.Map replacer)
Calls the drop tables script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script

dropTables

public void dropTables(java.lang.String database,
                       java.util.Map replacer,
                       boolean abortOnError)
Calls the drop tables script for the given database.

Parameters:
database - the name of the database
replacer - the replacements to perform in the drop script
abortOnError - indicates if the script is aborted if an error occurs

getErrors

public java.util.Vector getErrors()
Returns a Vector of Error messages.

Returns:
all error messages collected internally

noErrors

public boolean noErrors()
Checks if internal errors occured.

Returns:
true if internal errors occured

setConnection

public void setConnection(java.sql.Connection conn)
Sets a new internal connection to teh database.

Parameters:
conn - the connection to use

setConnection

public void setConnection(java.lang.String DbDriver,
                          java.lang.String DbConStr,
                          java.lang.String DbConStrParams,
                          java.lang.String DbUser,
                          java.lang.String DbPwd)
Creates a new internal connection to the database.

Parameters:
DbDriver - JDBC driver class name
DbConStr - JDBC connect URL
DbConStrParams - JDBC connect URL params, or null
DbUser - JDBC database user
DbPwd - JDBC database password

checkVariables

public java.lang.String checkVariables(java.lang.String db)
Returns an optional warning message if needed, null if not.

Parameters:
db - the selected database key
Returns:
html warning, or null if no warning

updateDatabase

public void updateDatabase(java.lang.String updateScript,
                           java.util.Map replacers)
Calls an update script.

Parameters:
updateScript - the update script code
replacers - the replacers to use in the script code

updateDatabase

public void updateDatabase(java.lang.String updateScript,
                           java.util.Map replacers,
                           boolean abortOnError)
Calls an update script.

Parameters:
updateScript - the update script code
replacers - the replacers to use in the script code
abortOnError - indicates if the script is aborted if an error occurs

finalize

protected void finalize()
                 throws java.lang.Throwable
Throws:
java.lang.Throwable
See Also:
Object.finalize()