oracle.toplink.services.mbean
Interface MBeanRuntimeServicesMBean

All Known Implementing Classes:

MBeanRuntimeServices

public interface MBeanRuntimeServicesMBean

Purpose: Provide a dynamic interface into the TopLink Session.

Description: This class is ment to provide an interface for gaining access to configuration of the TopLink Session during runtime. It will provides the basis for a JMX MBean

Method Summary

void	addNewConnectionPool(java.lang.String poolName, int maxSize, int minSize, java.lang.String platform, java.lang.String driverClassName, java.lang.String url, java.lang.String userName, java.lang.String password) PUBLIC: This method provides client with access to add a new connection pool to a TopLink ServerSession.
void	addNewConnectionPool(java.lang.String poolName, int maxSize, int minSize, java.lang.String platform, java.lang.String driverClassName, java.lang.String url, java.lang.String userName, java.lang.String password, java.lang.String licencePath) Deprecated.
java.util.List	getAvailableConnectionPools() PUBLIC: This method will return the available Connection pools within this Server Session
java.util.List	getClassesInSession() PUBLIC: This method is used to return those Class Names that have identity Maps in the Session.
java.lang.Integer	getNumberOfObjectsInIdentityMap(java.lang.String className) PUBLIC: This method is used to return the number of objects in a particular Identity Map If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found
java.lang.Integer	getNumberOfObjectsInIdentityMapSubCache(java.lang.String className) PUBLIC: This method is used to return the number of objects in a particular Identity Map's subcache.
java.util.List	getObjectsInIdentityMap(java.lang.String className) PUBLIC: This method will return a collection of the objects in the Identity Map.
java.util.List	getObjectsInIdentityMapSubCache(java.lang.String className) Deprecated.
java.util.Map	getObjectsInIdentityMapSubCacheAsMap(java.lang.String className) PUBLIC: This method will return a collection of the objects in the Identity Map.
int	getSequencePreallocationSize() PUBLIC: Method returns the value of the Sequence Preallocation size
boolean	getShouldCacheAllStatements() PUBLIC: Returns if statements should be cached or not
boolean	getShouldLogDebug() PUBLIC: This method is used to determine if debug messages should be logged
boolean	getShouldLogExceptions() PUBLIC: This method is used to determine if exception messages should be logged
boolean	getShouldLogExceptionStackTrace() PUBLIC: This method is used to determine if exception Stack Trace should be logged
boolean	getShouldLogMessages() PUBLIC: This method is used to determine if messages should be logged by the session
boolean	getShouldLogPerformanceProfiler()
boolean	getShouldPrintConnection() PUBLIC: This method is used to determine if exception Stack Trace should be logged
boolean	getShouldPrintDate() PUBLIC: This method is used to determine if exception Stack Trace should be logged
boolean	getShouldPrintSession() PUBLIC: This method is used to determine if exception Stack Trace should be logged
boolean	getShouldPrintThread() PUBLIC: This method is used to determine if exception Stack Trace should be logged
boolean	getShouldProfilePerformance() PUBLIC: This method will return if profgiling is turned on or not
java.util.List	getSizeForPool(java.lang.String poolName) PUBLIC: This method will retrieve the size of a particulat connection pool
int	getStatementCacheSize() PUBLIC: Returns the statement cache size.
void	resetAllConnections() PUBLIC: This method is used to reset connections from the session to the database.
void	setSequencePreallocationSize(int size) PUBLIC: This method provide access for setting the sequence pre-allocation size
void	setShouldCacheAllStatements(boolean shouldCacheAllStatements) PUBLIC: Method used to set if statements should be cached.
void	setShouldLogDebug(boolean shouldLogDebug) PUBLIC: This method is used to set if debug messages should be logged
void	setShouldLogExceptions(boolean shouldLogExceptions) PUBLIC: This method is used to set if Exception messages should be logged
void	setShouldLogExceptionStackTrace(boolean shouldLogExceptionStackTrace) PUBLIC: This method is used to set if Exception Stack Trace should be logged
void	setShouldLogMessages(boolean shouldLogMessages) PUBLIC: This method is used to set if messages should be logged by the session
void	setShouldLogPerformanceProfiler(boolean shouldLogPerformanceProfiler) PUBLIC: This method is used to turn on Profile logging when using th Performance Profiler
void	setShouldPrintConnection(boolean shouldPrintConnection) PUBLIC: This method is used to set if Exception Stack Trace should be logged
void	setShouldPrintDate(boolean shouldPrintDate) PUBLIC: This method is used to set if Exception Stack Trace should be logged
void	setShouldPrintSession(boolean shouldPrintSession) PUBLIC: This method is used to set if Exception Stack Trace should be logged
void	setShouldPrintThread(boolean shouldPrintThread) PUBLIC: This method is used to set if Exception Stack Trace should be logged
void	setShouldProfilePerformance(boolean shouldProfile) PUBLIC: This method is used to turn on Performance Profiling
void	setStatementCacheSize(int size) PUBLIC: Used to set the statement cache size.
void	updatePoolSize(java.lang.String poolName, int maxSize, int minSize) PUBLIC: This method allows the client to set the pool size for a particular pool, based on the pool name

Method Detail

setShouldLogMessages

public void setShouldLogMessages(boolean shouldLogMessages)

PUBLIC: This method is used to set if messages should be logged by the session

getShouldLogMessages

public boolean getShouldLogMessages()

PUBLIC: This method is used to determine if messages should be logged by the session

setShouldLogDebug

public void setShouldLogDebug(boolean shouldLogDebug)

PUBLIC: This method is used to set if debug messages should be logged

getShouldLogDebug

public boolean getShouldLogDebug()

PUBLIC: This method is used to determine if debug messages should be logged

setShouldLogExceptions

public void setShouldLogExceptions(boolean shouldLogExceptions)

PUBLIC: This method is used to set if Exception messages should be logged

getShouldLogExceptions

public boolean getShouldLogExceptions()

PUBLIC: This method is used to determine if exception messages should be logged

setShouldLogExceptionStackTrace

public void setShouldLogExceptionStackTrace(boolean shouldLogExceptionStackTrace)

PUBLIC: This method is used to set if Exception Stack Trace should be logged

getShouldLogExceptionStackTrace

public boolean getShouldLogExceptionStackTrace()

PUBLIC: This method is used to determine if exception Stack Trace should be logged

setShouldPrintDate

public void setShouldPrintDate(boolean shouldPrintDate)

PUBLIC: This method is used to set if Exception Stack Trace should be logged

getShouldPrintDate

public boolean getShouldPrintDate()

PUBLIC: This method is used to determine if exception Stack Trace should be logged

setShouldPrintSession

public void setShouldPrintSession(boolean shouldPrintSession)

PUBLIC: This method is used to set if Exception Stack Trace should be logged

getShouldPrintSession

public boolean getShouldPrintSession()

PUBLIC: This method is used to determine if exception Stack Trace should be logged

setShouldPrintThread

public void setShouldPrintThread(boolean shouldPrintThread)

PUBLIC: This method is used to set if Exception Stack Trace should be logged

getShouldPrintThread

public boolean getShouldPrintThread()

PUBLIC: This method is used to determine if exception Stack Trace should be logged

setShouldPrintConnection

public void setShouldPrintConnection(boolean shouldPrintConnection)

PUBLIC: This method is used to set if Exception Stack Trace should be logged

getShouldPrintConnection

public boolean getShouldPrintConnection()

PUBLIC: This method is used to determine if exception Stack Trace should be logged

setShouldProfilePerformance

public void setShouldProfilePerformance(boolean shouldProfile)

PUBLIC: This method is used to turn on Performance Profiling

getShouldProfilePerformance

public boolean getShouldProfilePerformance()

PUBLIC: This method will return if profgiling is turned on or not

setShouldLogPerformanceProfiler

public void setShouldLogPerformanceProfiler(boolean shouldLogPerformanceProfiler)

PUBLIC: This method is used to turn on Profile logging when using th Performance Profiler

getShouldLogPerformanceProfiler

public boolean getShouldLogPerformanceProfiler()

setShouldCacheAllStatements

public void setShouldCacheAllStatements(boolean shouldCacheAllStatements)

PUBLIC: Method used to set if statements should be cached. Please note that Statements can not be cached when using an external connection pool

getShouldCacheAllStatements

public boolean getShouldCacheAllStatements()

PUBLIC: Returns if statements should be cached or not

setStatementCacheSize

public void setStatementCacheSize(int size)

PUBLIC: Used to set the statement cache size. This is only valid if using cached Statements

getStatementCacheSize

public int getStatementCacheSize()

PUBLIC: Returns the statement cache size. Only valid if statements are being cached

setSequencePreallocationSize

public void setSequencePreallocationSize(int size)

PUBLIC: This method provide access for setting the sequence pre-allocation size

getSequencePreallocationSize

public int getSequencePreallocationSize()

PUBLIC: Method returns the value of the Sequence Preallocation size

updatePoolSize

public void updatePoolSize(java.lang.String poolName,
                           int maxSize,
                           int minSize)

PUBLIC: This method allows the client to set the pool size for a particular pool, based on the pool name

getAvailableConnectionPools

public java.util.List getAvailableConnectionPools()

PUBLIC: This method will return the available Connection pools within this Server Session

getSizeForPool

public java.util.List getSizeForPool(java.lang.String poolName)

PUBLIC: This method will retrieve the size of a particulat connection pool

addNewConnectionPool

public void addNewConnectionPool(java.lang.String poolName,
                                 int maxSize,
                                 int minSize,
                                 java.lang.String platform,
                                 java.lang.String driverClassName,
                                 java.lang.String url,
                                 java.lang.String userName,
                                 java.lang.String password,
                                 java.lang.String licencePath)
                          throws java.lang.ClassNotFoundException

Deprecated.

OBSOLETE: This method provides client with access to add a new connection pool to a TopLink ServerSession. This method throws classNotFound Exception if any of the class names are mispelled.

Throws:

java.lang.ClassNotFoundException

See Also:

throws ClassNotFoundException

addNewConnectionPool

public void addNewConnectionPool(java.lang.String poolName,
                                 int maxSize,
                                 int minSize,
                                 java.lang.String platform,
                                 java.lang.String driverClassName,
                                 java.lang.String url,
                                 java.lang.String userName,
                                 java.lang.String password)
                          throws java.lang.ClassNotFoundException

PUBLIC: This method provides client with access to add a new connection pool to a TopLink ServerSession. This method throws classNotFound Exception if any of the class names are mispelled.

Throws:

java.lang.ClassNotFoundException

resetAllConnections

public void resetAllConnections()

PUBLIC: This method is used to reset connections from the session to the database. Please Note that this will not work with a SessionBroker at this time

getClassesInSession

public java.util.List getClassesInSession()

PUBLIC: This method is used to return those Class Names that have identity Maps in the Session. Please note that SubClasses and aggregates will be missing form this list as they do not have seperate identoty maps.

getObjectsInIdentityMap

public java.util.List getObjectsInIdentityMap(java.lang.String className)
                                       throws java.lang.ClassNotFoundException

PUBLIC: This method will return a collection of the objects in the Identity Map. There is no particular order to these objects.

Throws:

java.lang.ClassNotFoundException

getNumberOfObjectsInIdentityMap

public java.lang.Integer getNumberOfObjectsInIdentityMap(java.lang.String className)
                                                  throws java.lang.ClassNotFoundException

PUBLIC: This method is used to return the number of objects in a particular Identity Map If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found

Throws:

java.lang.ClassNotFoundException

getObjectsInIdentityMapSubCache

public java.util.List getObjectsInIdentityMapSubCache(java.lang.String className)
                                               throws java.lang.ClassNotFoundException

Deprecated.

PUBLIC: This method will return a collection of the objects in the Identity Map. There is no particular order to these objects.

Throws:

java.lang.ClassNotFoundException

See Also:

getObjectsInIdentityMapSubCacheAsMap(String className)

getObjectsInIdentityMapSubCacheAsMap

public java.util.Map getObjectsInIdentityMapSubCacheAsMap(java.lang.String className)
                                                   throws java.lang.ClassNotFoundException

PUBLIC: This method will return a collection of the objects in the Identity Map. There is no particular order to these objects. These objects are returned as a Map which is how they are stored on the cache. This method replaces getObjectsInIdentityMapSubCache(String className) which returned a List.

Throws:

java.lang.ClassNotFoundException

getNumberOfObjectsInIdentityMapSubCache

public java.lang.Integer getNumberOfObjectsInIdentityMapSubCache(java.lang.String className)
                                                          throws java.lang.ClassNotFoundException

PUBLIC: This method is used to return the number of objects in a particular Identity Map's subcache. Only works for those identity Maps with a sub cache (ie Hard Cache Weak Identity Map) If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found

Throws:

java.lang.ClassNotFoundException