com.ibm.dse.applsrv.aa
Class SecurityJDBCPersistence2

java.lang.Object
  |
  +--com.ibm.dse.applsrv.aa.SecurityJDBCPersistence2

public class SecurityJDBCPersistence2
extends java.lang.Object
implements SecurityPersistence, SecurityConstants, LimitsConstants

This class represents a JDBC persistence controller for the security objects.


Fields inherited from interface com.ibm.dse.applsrv.aa.SecurityConstants
ACTIVE_CONTEXTS, ALL_CONTEXTS, AUDIT_FILE, CBTF_TRACING, CONFIGURATION, CONFIGURATIONS_DATABASE, CONTEXT_ACTIVE, CONTEXT_DATABASE, CONTEXT_INACTIVE, CONTEXT_INVALID, CONTEXTS, CONTROLLER, DEFAULT_CONFIGURATIONS_DATABASE, DEFAULT_CONTEXT_DATABASE, DEFAULT_GROUPS_DATABASE, DEFAULT_RIGHTS_DATABASE, DEFAULT_ROLES_DATABASE, DEFAULT_SERVICES_DATABASE, DEFAULT_USER_DATABASE, ENCRYPTION, GLOBAL_CONTEXTS, GROUPS, GROUPS_DATABASE, INACTIVE_CONTEXTS, JDBC_DATABASE, JDBC_DRIVER, JDBC_MAX_DATA, JDBC_MAX_GROUPS, JDBC_MAX_HANDLER, JDBC_MAX_ID, JDBC_MAX_PASSWORD, JDBC_MAX_RIGHT_TIMES, JDBC_MAX_RIGHTS, JDBC_MAX_ROLE_TIMES, JDBC_MAX_ROLES, JDBC_MAX_USER_ID, JDBC_MAX_USERS, JDBC_PASSWORD, JDBC_URL, JDBC_USER_ID, LIMIT_DATABASE, LIMITS, LOGGING_HANDLER, LOGGING_OPTIONS, PERSIST_CONTEXTS, PERSISTENCE, QUERY_PASSWORDS, RIGHTS, RIGHTS_DATABASE, ROLES, ROLES_DATABASE, SECURITY_DIRECTORY, SECURITY_MANAGER, SERVICES, SERVICES_DATABASE, SPECIFIC_CONTEXTS, TEST_ADD_RIGHT_TO_USER, TEST_ADD_RIGHTS_TO_USER, TEST_AUDIT, TEST_CONTEXT_IDS, TEST_DISABLE_PERSISTENCE, TEST_EXPORT, TEST_GET_CONFIGURATION, TEST_GET_CONTEXTS, TEST_GET_GROUPS, TEST_GET_PASSWORD_ACCESS, TEST_GET_PERSISTENCE, TEST_GET_RIGHTS, TEST_GET_ROLES, TEST_GET_SERVICES, TEST_GET_UNIQUE_LOGON, TEST_GET_USERS, TEST_GROUP_IDS, TEST_IMPORT, TEST_IMPORT2, TEST_LOAD_CONFIGURATIONS, TEST_LOAD_CONTEXTS, TEST_LOAD_GROUPS, TEST_LOAD_RIGHTS, TEST_LOAD_ROLES, TEST_LOAD_SERVICES, TEST_LOAD_USERS, TEST_PERSISTENCE, TEST_QUERY_SM, TEST_REMOVE_ALL_RIGHTS_FROM_USER, TEST_RESET, TEST_RIGHT_IDS, TEST_ROLE_IDS, TEST_SAVE, TEST_SERVICE_IDS, TEST_SET_CONFIGURATION, TEST_SET_PASSWORD_ACCESS, TEST_SET_PERSISTENCE, TEST_SET_UNIQUE_LOGON, TEST_TEST1, TEST_TEST2, TEST_TEST3, TEST_TRACE, TEST_USER_IDS, TRACE_EXCEPTIONS, TRACE_FILE, TRACE_LOGGER, UNIQUE_LOGONS, USE_LIMITS, USER_DATABASE, USERS
 
Fields inherited from interface com.ibm.dse.applsrv.aa.LimitsConstants
BIN, CLOSE_MAX_AMT, CONTAINER_SUBTYPE, CONTAINER_TYPE, CONTAINER_TYPE_DB, CURCODE, CURRENTVALUE_AMT, DESCRIPTION, DRAWER, LIMIT, LIMITS_COLUMNS, LIMITS_DATA_NAMES, OFF_VALUE_AMT, ON_VALUE_AMT, OVERSHORT_MAX_AMT, RHT_NAME, SETTLE_MAX_AMT, TRANS_TYPE, TRANS_TYPE_DB, TRAY, WRK_OFF_COUNT_HIGH, WRK_OFF_HIGH_AMT, WRK_OFF_LOW_AMT, WRK_ON_COUNT_HIGH, WRK_ON_HIGH_AMT, WRK_ON_LOW_AMT
 
Constructor Summary
SecurityJDBCPersistence2()
          Create a new instance of this persistence controller.
 
Method Summary
 void commit()
          Commits all changes to the database.
static java.sql.Connection connect(java.lang.String aDatabaseURL, java.lang.String userId, java.lang.String password)
          Centralized connect method.
 java.lang.String database()
          Return the name of this database.
protected  void finalize()
          Close the database connection whenever this object is about to be garbase collected.
 void initialize(Dictionary config)
          Initialize the persistor with the specified set of options.
 java.io.Serializable load()
          Return an object representing the current state of the persistent database.
 void rollback()
          Rollback all changes to the database.
 void save(java.io.Serializable db)
          Replace the persistent database with the in-memory copy.
 void setMapLimits()
          Stores some helper information to assist mapping of information between database and SecurityLimits
 void shutdown()
          Shutdown this database.
 
Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SecurityJDBCPersistence2

public SecurityJDBCPersistence2()
Create a new instance of this persistence controller.
Method Detail

commit

public void commit()
            throws DSESecurityException
Commits all changes to the database. Nothing is done if the autoCommit attribute is set to true.
Throws:
DSESecurityException - - if commit failed.

connect

public static java.sql.Connection connect(java.lang.String aDatabaseURL,
                                          java.lang.String userId,
                                          java.lang.String password)
                                   throws java.sql.SQLException
Centralized connect method.
Parameters:
aDatabaseURL - String - the database URL.
userId - String - the default userId.
password - String - the default password.
Returns:
Connection - the database connection.
Throws:
java.sql.SQLException - com.ibm.dse.applsrv.aa.SecurityJDBCPersistence2.connect(aDatabaseURL , userId , password);

database

public java.lang.String database()
Return the name of this database.
Specified by:
database in interface SecurityPersistence
Returns:
String - the name of this database.

finalize

protected void finalize()
                 throws java.lang.Throwable
Close the database connection whenever this object is about to be garbase collected.
Overrides:
finalize in class java.lang.Object
Throws:
java.lang.Throwable - - finalization error.

initialize

public void initialize(Dictionary config)
                throws DSESecurityException
Initialize the persistor with the specified set of options.
Specified by:
initialize in interface SecurityPersistence
Parameters:
config - Dictionary - the configuration options.
Throws:
DSESecurityException - - database error.

load

public java.io.Serializable load()
                          throws DSESecurityException
Return an object representing the current state of the persistent database.
Specified by:
load in interface SecurityPersistence
Returns:
Serializable - the copy of the persistent database.
Throws:
DSESecurityException - - database error.

rollback

public void rollback()
              throws DSESecurityException
Rollback all changes to the database.
Throws:
DSESecurityException - - if rollback failed.

save

public void save(java.io.Serializable db)
          throws DSESecurityException
Replace the persistent database with the in-memory copy.
Specified by:
save in interface SecurityPersistence
Parameters:
db - Serializable - the in-memory database.
Throws:
DSESecurityException - - database error.

setMapLimits

public void setMapLimits()
Stores some helper information to assist mapping of information between database and SecurityLimits

shutdown

public void shutdown()
Shutdown this database.
Specified by:
shutdown in interface SecurityPersistence
Tags copied from interface: SecurityPersistence
Throws:
DSESecurityException - - database error.