DatabaseSaver (interruptible-weka 0.1.2 API)

java.lang.Object
- weka.core.converters.AbstractSaver
- - weka.core.converters.DatabaseSaver

All Implemented Interfaces:: java.io.Serializable, CapabilitiesHandler, CapabilitiesIgnorer, BatchConverter, DatabaseConverter, IncrementalConverter, Saver, EnvironmentHandler, OptionHandler, RevisionHandler

public class DatabaseSaver
extends AbstractSaver
implements BatchConverter, IncrementalConverter, DatabaseConverter, OptionHandler, EnvironmentHandler

Writes to a database (tested with MySQL, InstantDB, HSQLDB).

Valid options are:

 -url <JDBC URL>
  The JDBC URL to connect to.
  (default: from DatabaseUtils.props file)

 -user <name>
  The user to connect with to the database.
  (default: none)

 -password <password>
  The password to connect with to the database.
  (default: none)

 -T <table name>
  The name of the table.
  (default: the relation name)

 -truncate
  Truncate (i.e. delete any data) in table before inserting

 -P
  Add an ID column as primary key. The name is specified
  in the DatabaseUtils file ('idColumn'). The DatabaseLoader
  won't load this column.

 -custom-props <file>
  The custom properties file to use instead of default ones,
  containing the database parameters.
  (default: none)

 -i <input file name>
  Input file in arff format that should be saved in database.

See Also:: Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`protected int`	`m_count` counts the rows and used as a primary key value.
`protected java.lang.String`	`m_createDate` The database specific type for a date (read in from the properties file).
`protected java.lang.String`	`m_createDouble` The database specific type for a double (read in from the properties file).
`protected java.lang.String`	`m_createInt` The database specific type for an int (read in from the properties file).
`protected java.lang.String`	`m_createText` The database specific type for a string (read in from the properties file).
`protected java.io.File`	`m_CustomPropsFile` the custom props file to use instead of default one.
`protected DatabaseConnection`	`m_DataBaseConnection` The database connection.
`protected java.text.SimpleDateFormat`	`m_DateFormat` For converting the date value into a database string.
`protected Environment`	`m_env` Environment variables to use
`protected boolean`	`m_id` Flag indicating if a primary key column should be added.
`protected java.lang.String`	`m_idColumn` The name of the primary key column that will be automatically generated (if enabled).
`protected java.lang.String`	`m_inputFile` An input arff file (for command line use).
`protected java.lang.String`	`m_Password` the password for the database.
`protected java.lang.String`	`m_resolvedTableName` Table name with any environment variables resolved
`protected java.lang.String`	`m_tableName` The name of the table in which the instances should be stored.
`protected boolean`	`m_tabName` Flag indicating whether the default name of the table is the relaion name or not.
`protected boolean`	`m_truncate` Whether to truncate (i.e. drop and then recreate) the table if it already exists
`protected java.lang.String`	`m_URL` the database URL.
`protected java.lang.String`	`m_Username` the user name for the database.

Fields inherited from class weka.core.converters.AbstractSaver
CANCEL, m_DoNotCheckCapabilities, m_retrieval, STRUCTURE_READY, WAIT, WRITE

Fields inherited from interface weka.core.converters.Saver
BATCH, INCREMENTAL, NONE

Constructor Summary

Constructors
Constructor and Description

DatabaseSaver()
Constructor.

Constructors
Constructor and Description
`DatabaseSaver()` Constructor.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`java.lang.String`	`autoKeyGenerationTipText()` Returns the tip text for this property.
`void`	`cancel()` Cancels the incremental saving process and tries to drop the table if the write mode is CANCEL.
`void`	`connectToDatabase()` Opens a connection to the database.
`java.lang.String`	`customPropsFileTipText()` The tip text for this property.
`boolean`	`getAutoKeyGeneration()` Gets whether or not a primary key will be generated automatically.
`Capabilities`	`getCapabilities()` Returns the Capabilities of this saver.
`java.io.File`	`getCustomPropsFile()` Returns the custom properties file in use, if any.
`java.lang.String[]`	`getOptions()` Gets the setting.
`java.lang.String`	`getPassword()` Returns the database password.
`boolean`	`getRelationForTableName()` Gets whether or not the relation name is used as name of the table.
`java.lang.String`	`getRevision()` Returns the revision string.
`java.lang.String`	`getTableName()` Gets the table's name.
`boolean`	`getTruncate()` Get whether to truncate (i.e. drop and recreate) the table if it already exits.
`java.lang.String`	`getUrl()` Gets the database URL.
`java.lang.String`	`getUser()` Gets the database user.
`java.lang.String`	`globalInfo()` Returns a string describing this Saver.
`java.util.Enumeration<Option>`	`listOptions()` Lists the available options.
`static void`	`main(java.lang.String[] options)` Main method.
`protected DatabaseConnection`	`newDatabaseConnection()` Initializes a new DatabaseConnection object, either default one or from custom props file.
`java.lang.String`	`passwordTipText()` Returns the tip text for this property.
`java.lang.String`	`relationForTableNameTipText()` Returns the tip text fo this property.
`void`	`resetOptions()` Resets the Saver ready to save a new data set.
`void`	`setAutoKeyGeneration(boolean flag)` En/Dis-ables the automatic generation of a primary key.
`void`	`setCustomPropsFile(java.io.File value)` Sets the custom properties file to use.
`void`	`setDestination()` Sets the database url using the DatabaseUtils file.
`void`	`setDestination(java.lang.String url)` Sets the database url.
`void`	`setDestination(java.lang.String url, java.lang.String userName, java.lang.String password)` Sets the database url.
`void`	`setEnvironment(Environment env)` Set the environment variables to use.
`void`	`setOptions(java.lang.String[] options)` Sets the options.
`void`	`setPassword(java.lang.String password)` Sets the database password.
`void`	`setRelationForTableName(boolean flag)` En/Dis-ables that the relation name is used for the name of the table (default enabled).
`void`	`setTableName(java.lang.String tn)` Sets the table's name.
`void`	`setTruncate(boolean t)` Set whether to truncate (i.e. drop and recreate) the table if it already exits.
`void`	`setUrl(java.lang.String url)` Sets the database URL.
`void`	`setUser(java.lang.String user)` Sets the database user.
`java.lang.String`	`tableNameTipText()` Returns the tip text for this property.
`java.lang.String`	`truncateTipText()` Returns the tip text for this property.
`java.lang.String`	`urlTipText()` Returns the tip text for this property.
`java.lang.String`	`userTipText()` Returns the tip text for this property.
`void`	`writeBatch()` Writes a Batch of instances.
`void`	`writeIncremental(Instance inst)` Saves an instances incrementally.

Methods inherited from class weka.core.converters.AbstractSaver
doNotCheckCapabilitiesTipText, filePrefix, getDoNotCheckCapabilities, getFileExtension, getInstances, getRetrieval, getWriteMode, resetStructure, retrieveDir, setDestination, setDestination, setDir, setDirAndPrefix, setDoNotCheckCapabilities, setFile, setFilePrefix, setInstances, setRetrieval, setStructure, setWriteMode

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - m_DataBaseConnection
```
protected DatabaseConnection m_DataBaseConnection
```
    The database connection.
  - m_tableName
```
protected java.lang.String m_tableName
```
    The name of the table in which the instances should be stored.
  - m_resolvedTableName
```
protected java.lang.String m_resolvedTableName
```
    Table name with any environment variables resolved
  - m_inputFile
```
protected java.lang.String m_inputFile
```
    An input arff file (for command line use).
  - m_createText
```
protected java.lang.String m_createText
```
    The database specific type for a string (read in from the properties file).
  - m_createDouble
```
protected java.lang.String m_createDouble
```
    The database specific type for a double (read in from the properties file).
  - m_createInt
```
protected java.lang.String m_createInt
```
    The database specific type for an int (read in from the properties file).
  - m_createDate
```
protected java.lang.String m_createDate
```
    The database specific type for a date (read in from the properties file).
  - m_DateFormat
```
protected java.text.SimpleDateFormat m_DateFormat
```
    For converting the date value into a database string.
  - m_idColumn
```
protected java.lang.String m_idColumn
```
    The name of the primary key column that will be automatically generated (if enabled). The name is read from DatabaseUtils.
  - m_count
```
protected int m_count
```
    counts the rows and used as a primary key value.
  - m_id
```
protected boolean m_id
```
    Flag indicating if a primary key column should be added.
  - m_tabName
```
protected boolean m_tabName
```
    Flag indicating whether the default name of the table is the relaion name or not.
  - m_URL
```
protected java.lang.String m_URL
```
    the database URL.
  - m_Username
```
protected java.lang.String m_Username
```
    the user name for the database.
  - m_Password
```
protected java.lang.String m_Password
```
    the password for the database.
  - m_CustomPropsFile
```
protected java.io.File m_CustomPropsFile
```
    the custom props file to use instead of default one.
  - m_truncate
```
protected boolean m_truncate
```
    Whether to truncate (i.e. drop and then recreate) the table if it already exists
  - m_env
```
protected transient Environment m_env
```
    Environment variables to use
- Constructor Detail
  - DatabaseSaver
```
public DatabaseSaver()
              throws java.lang.Exception
```
    Constructor.
    
    Throws:
    
    java.lang.Exception - throws Exception if property file cannot be read
- Method Detail
  - main
```
public static void main(java.lang.String[] options)
```
    Main method.
    
    Parameters:
    
    options - should contain the options of a Saver.
  - setEnvironment
```
public void setEnvironment(Environment env)
```
    Set the environment variables to use.
    
    Specified by:
    
    setEnvironment in interface EnvironmentHandler
    
    Parameters:
    
    env - the environment variables to use
  - newDatabaseConnection
```
protected DatabaseConnection newDatabaseConnection()
                                            throws java.lang.Exception
```
    Initializes a new DatabaseConnection object, either default one or from custom props file.
    
    Returns:
    
    the DatabaseConnection object
    
    Throws:
    
    java.lang.Exception
    
    See Also:
    
    m_CustomPropsFile
  - resetOptions
```
public void resetOptions()
```
    Resets the Saver ready to save a new data set.
    
    Overrides:
    
    resetOptions in class AbstractSaver
  - cancel
```
public void cancel()
```
    Cancels the incremental saving process and tries to drop the table if the write mode is CANCEL.
    
    Overrides:
    
    cancel in class AbstractSaver
  - globalInfo
```
public java.lang.String globalInfo()
```
    Returns a string describing this Saver.
    
    Returns:
    
    a description of the Saver suitable for displaying in the explorer/experimenter gui
  - getTableName
```
@OptionMetadata(displayName="Table name",
                description="Sets the name of the table",
                displayOrder=4)
public java.lang.String getTableName()
```
    Gets the table's name.
    
    Returns:
    
    the table's name
  - setTableName
```
public void setTableName(java.lang.String tn)
```
    Sets the table's name.
    
    Parameters:
    
    tn - the name of the table
  - tableNameTipText
```
public java.lang.String tableNameTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    the tip text for this property
  - getTruncate
```
@OptionMetadata(displayName="Truncate table",
                description="Truncate (i.e. drop and recreate) table if it already exists",
                displayOrder=6)
public boolean getTruncate()
```
    Get whether to truncate (i.e. drop and recreate) the table if it already exits. If false, then new data is appended to the table.
    
    Returns:
    
    true if the table should be truncated first (if it exists).
  - setTruncate
```
public void setTruncate(boolean t)
```
    Set whether to truncate (i.e. drop and recreate) the table if it already exits. If false, then new data is appended to the table.
    
    Parameters:
    
    t - true if the table should be truncated first (if it exists).
  - truncateTipText
```
public java.lang.String truncateTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    the tip text for this property
  - getAutoKeyGeneration
```
@OptionMetadata(displayName="Automatic primary key",
                description="If set to true, a primary key column is generated automatically (containing the row number as INTEGER). The name of the key is read from DatabaseUtils (idColumn) This primary key can be used for incremental loading (requires an unique key). This primary key will not be loaded as an attribute.",
                displayOrder=7)
public boolean getAutoKeyGeneration()
```
    Gets whether or not a primary key will be generated automatically.
    
    Returns:
    
    true if a primary key column will be generated, false otherwise
  - setAutoKeyGeneration
```
public void setAutoKeyGeneration(boolean flag)
```
    En/Dis-ables the automatic generation of a primary key.
    
    Parameters:
    
    flag - flag for automatic key-genereration
  - autoKeyGenerationTipText
```
public java.lang.String autoKeyGenerationTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    tip text for this property
  - getRelationForTableName
```
@OptionMetadata(displayName="Use relation name",
                description="If set to true, the relation name will be used as name for the database table. Otherwise the user has to provide a table name.",
                displayOrder=5)
public boolean getRelationForTableName()
```
    Gets whether or not the relation name is used as name of the table.
    
    Returns:
    
    true if the relation name is used as the name of the table, false otherwise
  - setRelationForTableName
```
public void setRelationForTableName(boolean flag)
```
    En/Dis-ables that the relation name is used for the name of the table (default enabled).
    
    Parameters:
    
    flag - if true the relation name is used as table name
  - relationForTableNameTipText
```
public java.lang.String relationForTableNameTipText()
```
    Returns the tip text fo this property.
    
    Returns:
    
    the tip text for this property
  - getUrl
```
@OptionMetadata(displayName="Database URL",
                description="The URL of the database",
                displayOrder=1)
public java.lang.String getUrl()
```
    Gets the database URL.
    
    Specified by:
    
    getUrl in interface DatabaseConverter
    
    Returns:
    
    the URL
  - setUrl
```
public void setUrl(java.lang.String url)
```
    Sets the database URL.
    
    Specified by:
    
    setUrl in interface DatabaseConverter
    
    Parameters:
    
    url - the URL
  - urlTipText
```
public java.lang.String urlTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    the tip text for this property
  - getUser
```
public java.lang.String getUser()
```
    Gets the database user.
    
    Specified by:
    
    getUser in interface DatabaseConverter
    
    Returns:
    
    the user name
  - setUser
```
@OptionMetadata(displayName="Username",
                description="The user name for the database",
                displayOrder=2)
public void setUser(java.lang.String user)
```
    Sets the database user.
    
    Specified by:
    
    setUser in interface DatabaseConverter
    
    Parameters:
    
    user - the user name
  - userTipText
```
public java.lang.String userTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    the tip text for this property
  - getPassword
```
@OptionMetadata(displayName="Password",
                description="The database password",
                displayOrder=3)
 @PasswordProperty
public java.lang.String getPassword()
```
    Returns the database password.
    
    Returns:
    
    the database password
  - setPassword
```
public void setPassword(java.lang.String password)
```
    Sets the database password.
    
    Specified by:
    
    setPassword in interface DatabaseConverter
    
    Parameters:
    
    password - the password
  - passwordTipText
```
public java.lang.String passwordTipText()
```
    Returns the tip text for this property.
    
    Returns:
    
    the tip text for this property
  - getCustomPropsFile
```
@OptionMetadata(displayName="DB config file",
                description="The custom properties that the user can use to override the default ones.",
                displayOrder=8)
 @FilePropertyMetadata(fileChooserDialogType=0,
                      directoriesOnly=false)
public java.io.File getCustomPropsFile()
```
    Returns the custom properties file in use, if any.
    
    Returns:
    
    the custom props file, null if none used
  - setCustomPropsFile
```
public void setCustomPropsFile(java.io.File value)
```
    Sets the custom properties file to use.
    
    Parameters:
    
    value - the custom props file to load database parameters from, use null or directory to disable custom properties.
  - customPropsFileTipText
```
public java.lang.String customPropsFileTipText()
```
    The tip text for this property.
    
    Returns:
    
    the tip text
  - setDestination
```
public void setDestination(java.lang.String url,
                           java.lang.String userName,
                           java.lang.String password)
```
    Sets the database url.
    
    Parameters:
    
    url - the database url
    
    userName - the user name
    
    password - the password
  - setDestination
```
public void setDestination(java.lang.String url)
```
    Sets the database url.
    
    Parameters:
    
    url - the database url
  - setDestination
```
public void setDestination()
```
    Sets the database url using the DatabaseUtils file.
  - getCapabilities
```
public Capabilities getCapabilities()
```
    Returns the Capabilities of this saver.
    
    Specified by:
    
    getCapabilities in interface CapabilitiesHandler
    
    Overrides:
    
    getCapabilities in class AbstractSaver
    
    Returns:
    
    the capabilities of this object
    
    See Also:
    
    Capabilities
  - connectToDatabase
```
public void connectToDatabase()
```
    Opens a connection to the database.
  - writeIncremental
```
public void writeIncremental(Instance inst)
                      throws java.io.IOException
```
    Saves an instances incrementally. Structure has to be set by using the setStructure() method or setInstances() method. When a structure is set, a table is created.
    
    Specified by:
    
    writeIncremental in interface Saver
    
    Overrides:
    
    writeIncremental in class AbstractSaver
    
    Parameters:
    
    inst - the instance to save
    
    Throws:
    
    java.io.IOException - throws IOEXception.
  - writeBatch
```
public void writeBatch()
                throws java.io.IOException
```
    Writes a Batch of instances.
    
    Specified by:
    
    writeBatch in interface Saver
    
    Specified by:
    
    writeBatch in class AbstractSaver
    
    Throws:
    
    java.io.IOException - throws IOException
  - getOptions
```
public java.lang.String[] getOptions()
```
    Gets the setting.
    
    Specified by:
    
    getOptions in interface OptionHandler
    
    Returns:
    
    the current setting
  - setOptions
```
public void setOptions(java.lang.String[] options)
                throws java.lang.Exception
```
    Sets the options.
    Valid options are:
```
 -url <JDBC URL>
  The JDBC URL to connect to.
  (default: from DatabaseUtils.props file)
 
```
```
 -user <name>
  The user to connect with to the database.
  (default: none)
 
```
```
 -password <password>
  The password to connect with to the database.
  (default: none)
 
```
```
 -T <table name>
  The name of the table.
  (default: the relation name)
 
```
```
 -truncate
  Truncate (i.e. delete any data) in table before inserting
 
```
```
 -P
  Add an ID column as primary key. The name is specified
  in the DatabaseUtils file ('idColumn'). The DatabaseLoader
  won't load this column.
 
```
```
 -custom-props <file>
  The custom properties file to use instead of default ones,
  containing the database parameters.
  (default: none)
 
```
```
 -i <input file name>
  Input file in arff format that should be saved in database.
 
```
    Specified by:
    
    setOptions in interface OptionHandler
    
    Parameters:
    
    options - the options
    
    Throws:
    
    java.lang.Exception - if options cannot be set
  - listOptions
```
public java.util.Enumeration<Option> listOptions()
```
    Lists the available options.
    
    Specified by:
    
    listOptions in interface OptionHandler
    
    Returns:
    
    an enumeration of the available options
  - getRevision
```
public java.lang.String getRevision()
```
    Returns the revision string.
    
    Specified by:
    
    getRevision in interface RevisionHandler
    
    Returns:
    
    the revision

Class DatabaseSaver

Field Summary

Fields inherited from class weka.core.converters.AbstractSaver

Fields inherited from interface weka.core.converters.Saver

Constructor Summary

Method Summary

Methods inherited from class weka.core.converters.AbstractSaver

Methods inherited from class java.lang.Object

Field Detail

m_DataBaseConnection

m_tableName

m_resolvedTableName

m_inputFile

m_createText

m_createDouble

m_createInt

m_createDate

m_DateFormat

m_idColumn

m_count

m_id

m_tabName

m_URL

m_Username

m_Password

m_CustomPropsFile

m_truncate

m_env

Constructor Detail

DatabaseSaver

Method Detail

main

setEnvironment

newDatabaseConnection

resetOptions

cancel

globalInfo

getTableName

setTableName

tableNameTipText

getTruncate

setTruncate

truncateTipText

getAutoKeyGeneration

setAutoKeyGeneration

autoKeyGenerationTipText

getRelationForTableName

setRelationForTableName

relationForTableNameTipText

getUrl

setUrl

urlTipText

getUser

setUser

userTipText

getPassword

setPassword

passwordTipText

getCustomPropsFile

setCustomPropsFile

customPropsFileTipText

setDestination

setDestination

setDestination

getCapabilities

connectToDatabase

writeIncremental

writeBatch

getOptions

setOptions

listOptions

getRevision