oracle.dmt.odm
Class DataMiningServer

java.lang.Object
  |
  +--oracle.dmt.odm.DataMiningServer

public class DataMiningServer

extends java.lang.Object

An instance of DataMiningServer is used as a proxy to create connections to a Data Mining Server.

Since:

9.0.1

Constructor Summary

DataMiningServer(java.lang.String url, java.lang.String userName, java.lang.String password)
Creates a Data Mining Server with specified information.

DataMiningServer(java.lang.String url, java.lang.String userName, java.lang.String password, java.util.Locale locale)
Creates a Data Mining Server with specified information.

Method Summary

static void	closeConnection(Connection dmsConn) Closes the Data Mining Server connection.
static Connection	createConnection(java.sql.Connection dbConn) Using the given database connection, creates a Data Mining Server connection
Connection	login() Given the parameters set in the Data Mining Server instance, logs into the server and returns a Connection instance.
void	logout(Connection connection) Closes the specified connection to the Data Mining Server.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DataMiningServer

public DataMiningServer(java.lang.String url,
                        java.lang.String userName,
                        java.lang.String password)
                 throws InvalidArgumentException

Creates a Data Mining Server with specified information.

Parameters:

url - URL (jdbc:oracle:thin:@host:port:sid)

userName - user id

password - user password

Throws:

InvalidArgumentException -

• when the url/userName/password are null,
• when the userName/password length >30 characters, or
• when the url is invalid.

InvalidArgumentException

DataMiningServer

public DataMiningServer(java.lang.String url,
                        java.lang.String userName,
                        java.lang.String password,
                        java.util.Locale locale)
                 throws InvalidArgumentException

Creates a Data Mining Server with specified information.

Parameters:

url - URL (jdbc:oracle:thin:@host:port:sid)

userName - user id

password - user password

Throws:

InvalidArgumentException - is thrown

• when the url/userName/password are null,
• when the userName/password length >30 characters, or
• when the url is invalid.

InvalidArgumentException

Method Detail

login

public Connection login()
                                throws ODMException

Given the parameters set in the Data Mining Server instance, logs into the server and returns a Connection instance.

Returns:

Connection to be used for subsequent access to the Data mining Server.

Throws:

ODMException - when login fails

ODMException

logout

public void logout(Connection connection)
            throws InvalidArgumentException,
ODMException

Closes the specified connection to the Data Mining Server. The connection cannot be reused after logout.

Parameters:

connection - a valid connection to a Data Mining Server.

Throws:

InvalidArgumentException - when the connection is null

ODMException - when logout fails

InvalidArgumentException

ODMException

createConnection

public static Connection createConnection(java.sql.Connection dbConn)
                                                  throws ODMException

Using the given database connection, creates a Data Mining Server connection

Parameters:

dbConn - jdbc connection of the data mining user

Returns:

Connection - Connection to be used for subsequent access to the Data mining Server.

Throws:

ODMException - is thrown
- when creation of data mining server connection fails

ODMException

Since:

9.2.0.5

closeConnection

public static void closeConnection(Connection dmsConn)
                            throws ODMException

Closes the Data Mining Server connection. If the data mining server connection is created using the create connection method, then this method will not close the user supplied JDBC connection.

Parameters:

dmsConn - data mining user connection

Throws:

ODMException - is thrown
- when closing of data mining server connection fails

ODMException

Since:

9.2.0.5