org.eclipse.persistence.services.weblogic
Interface MBeanWebLogicRuntimeServicesMBean

All Superinterfaces:

MBeanRuntimeServicesMBean

All Known Implementing Classes:

MBeanWebLogicRuntimeServices

public interface MBeanWebLogicRuntimeServicesMBean
extends MBeanRuntimeServicesMBean

Purpose: Provide a dynamic interface into the EclipseLink Session.

Description: This class is meant to provide facilities for managing an EclipseLink session external to EclipseLink over JMX.

Method Summary

void	clearStatementCache() Used to clear the statement cache.
java.lang.String	getApplicationName() getApplicationName(): Answer the name of the module (EAR name) that this session is associated with.
java.lang.Object[][]	getClassSummaryDetails() Provide an instance of 2 Dimensional Array simulating tabular format information about all classes in the session.
java.util.ArrayList<ClassSummaryDetail>	getClassSummaryDetailsArray() Provide a list of instance of ClassSummaryDetail containing information about all classes in the session.
java.lang.Object[][]	getClassSummaryDetailsUsingFilter(java.lang.String filter) Provide an instance of 2 Dimensional Array simulating tabular format information about all classes in the session whose class names match the provided filter.
java.util.ArrayList<ClassSummaryDetail>	getClassSummaryDetailsUsingFilterArray(java.lang.String filter) Provide a list of instance of ClassSummaryDetail containing information about the classes in the session whose class names match the provided filter.
java.lang.String	getConnectionPoolType() Return connection pool type.
java.lang.String	getCurrentEclipseLinkLogLevel() Answer the EclipseLink log level that is changeable.
java.lang.String	getDatabasePlatform() Return the database platform used by the DatabaseSession.
java.lang.String	getDeployedEclipseLinkLogLevel() Answer the EclipseLink log level at deployment time.
java.lang.String	getDriver() Return db driver class name.
java.lang.String	getJdbcConnectionDetails() Return JDBCConnection detail information.
java.lang.String	getLogFilename() Return the log filename.
java.lang.String	getLogType() Return the log type, either "EclipseLink", "Java" or "Server"
java.util.Vector	getMappedClassNamesUsingFilter(java.lang.String filter) INTERNAL: This method traverses the EclipseLink descriptors and returns a Vector of the descriptor's reference class names that match the provided filter.
java.lang.Integer	getMaxSizeForPool(java.lang.String poolName) This method will retrieve the max size of a particular connection pool
java.lang.Integer	getMinSizeForPool(java.lang.String poolName) This method will retrieve the min size of a particular connection pool
java.lang.String	getModuleName() getModuleName(): Answer the name of the context-root of the application that this session is associated with.
java.lang.Integer	getNumberOfObjectsInAllIdentityMaps() This method will SUM and return the number of objects in all Identity Maps in the session.
java.lang.Integer	getNumberOfPersistentClasses() This method will answer the number of persistent classes contained in the session.
java.lang.String	getProfilingType() This method is used to get the type of profiling.
java.lang.String	getSessionName() Answer the name of the EclipseLink session this MBean represents.
java.lang.String	getSessionType() Answer the type of the EclipseLink session this MBean represents.
java.lang.Integer	getStringBindingSize() Return the size of strings after which will be bound into the statement If we are not using a DatabaseLogin, or we're not using string binding, answer 0 (zero).
java.lang.Long	getTimeConnectionEstablished() This method will return a long indicating the exact time in Milliseconds that the session connected to the database.
java.lang.Boolean	getUsesByteArrayBinding() Shows if Byte Array Binding is turned on or not
java.lang.Boolean	getUsesEclipseLinkProfiling() This method answers true if EclipseLink Performance Profiling is on.
java.lang.Boolean	getUsesJDBCBatchWriting() This method will return if batchWriting is in use or not.
java.lang.Boolean	getUsesNativeSQL() Shows if native SQL is being used
java.lang.Boolean	getUsesStreamsForBinding() This method indicates if streams are being used for binding
java.lang.Boolean	getUsesStringBinding() This method indicates if Strings are being bound
void	initializeAllIdentityMaps() This method is used to initialize the identity maps in the session.
void	initializeIdentityMap(java.lang.String className) This method is used to initialize the identity maps specified by className.
void	initializeIdentityMaps(java.lang.String[] classNames) This method is used to initialize the identity maps specified by the Vector of classNames.
void	invalidateAllIdentityMaps() This method is used to invalidate the identity maps in the session.
void	invalidateIdentityMap(java.lang.String className) This method is used to invalidate the identity maps specified by className.
void	invalidateIdentityMap(java.lang.String className, java.lang.Boolean recurse) This method is used to invalidate the identity maps specified by className.
void	invalidateIdentityMaps(java.lang.String[] classNamesParam, java.lang.Boolean recurse) This method is used to invalidate the identity maps specified by the String[] of classNames.
boolean	isJPASession() Return whether this session is an EclipseLink JPA session.
void	printAllIdentityMapTypes() This method will log the types of Identity Maps in the session.
void	printAvailableConnectionPools() This method will print the available Connection pools to the SessionLog.
void	printClassesInSession() This method is used to output those Class Names that have identity Maps in the Session.
void	printIdentityMapLocks() This method will log the instance level locks in all Identity Maps in the session.
void	printIdentityMapLocks(java.lang.String registeredClassName) This method will log the instance level locks in the Identity Map for the given class in the session.
void	printObjectsInIdentityMap(java.lang.String className) This method will log the objects in the Identity Map.
void	printObjectsInIdentityMaps() This method will log all objects in all Identity Maps in the session.
void	printProfileSummary() This method assumes EclipseLink Profiling (as opposed to Java profiling).
void	printProfileSummaryByClass() This method assumes EclipseLink Profiling (as opposed to Java profiling).
void	printProfileSummaryByQuery() This method assumes EclipseLink Profiling (as opposed to Java profiling).
void	setCurrentEclipseLinkLogLevel(java.lang.String newLevel) Set the EclipseLink log level to be used at runtime.
void	setProfilingType(java.lang.String profileType) This method is used to select the type of profiling.
void	setUseEclipseLinkProfiling() This method is used to turn on EclipseLink Performance Profiling
void	setUseNoProfiling() This method is used to turn off all Performance Profiling, DMS or EclipseLink.

Methods inherited from interface org.eclipse.persistence.services.mbean.MBeanRuntimeServicesMBean

addNewConnectionPool, getAvailableConnectionPools, getClassesInSession, getNumberOfObjectsInIdentityMap, getNumberOfObjectsInIdentityMapSubCache, getObjectsInIdentityMap, getObjectsInIdentityMapSubCacheAsMap, getProfileWeight, getSequencePreallocationSize, getShouldCacheAllStatements, getShouldLogMessages, getShouldLogPerformanceProfiler, getShouldProfilePerformance, getSizeForPool, getStatementCacheSize, resetAllConnections, setProfileWeight, setSequencePreallocationSize, setShouldCacheAllStatements, setShouldLogPerformanceProfiler, setShouldProfilePerformance, setStatementCacheSize, updatePoolSize

Method Detail

getSessionName

java.lang.String getSessionName()

Answer the name of the EclipseLink session this MBean represents.

getSessionType

java.lang.String getSessionType()

Answer the type of the EclipseLink session this MBean represents. Types include: "ServerSession", "DatabaseSession", "SessionBroker"

getClassSummaryDetailsUsingFilter

java.lang.Object[][] getClassSummaryDetailsUsingFilter(java.lang.String filter)

Provide an instance of 2 Dimensional Array simulating tabular format information about all classes in the session whose class names match the provided filter. The 2 Dimensional array contains each item with values being row object array. Each row object array represents EclipseLink class details info with respect to below attributes: ["Class Name", "Parent Class Name", "Cache Type", "Configured Size", "Current Size"]

getClassSummaryDetails

java.lang.Object[][] getClassSummaryDetails()

Provide an instance of 2 Dimensional Array simulating tabular format information about all classes in the session. The 2 Dimensional array contains each item with values being row object array. Each row object array represents EclipseLink class details info with respect to below attributes: ["Class Name", "Parent Class Name", "Cache Type", "Configured Size", "Current Size"]

getClassSummaryDetailsUsingFilterArray

java.util.ArrayList<ClassSummaryDetail> getClassSummaryDetailsUsingFilterArray(java.lang.String filter)

Provide a list of instance of ClassSummaryDetail containing information about the classes in the session whose class names match the provided filter. ClassSummaryDetail is a model specific class that can be used internally by the Portable JMX Framework to convert class attribute to JMX required open type, it has:- 1. model specific type that needs to be converted : ["Class Name", "Parent Class Name", "Cache Type", "Configured Size", "Current Size"] 2. convert methods.

Parameters:

filter - A comma separated list of strings to match against.

Returns:

A ArrayList of instance of ClassSummaryDetail containing class information for the class names that match the filter.

getClassSummaryDetailsArray

java.util.ArrayList<ClassSummaryDetail> getClassSummaryDetailsArray()

Provide a list of instance of ClassSummaryDetail containing information about all classes in the session. ClassSummaryDetail is a model specific class that can be used internally by the Portable JMX Framework to convert class attribute to JMX required open type, it has:- 1. model specific type that needs to be converted : ["Class Name", "Parent Class Name", "Cache Type", "Configured Size", "Current Size"] 2. convert methods.

Returns:

A ArrayList of instance of ClassSummaryDetail containing class information for the class names that match the filter.

getMappedClassNamesUsingFilter

java.util.Vector getMappedClassNamesUsingFilter(java.lang.String filter)

INTERNAL: This method traverses the EclipseLink descriptors and returns a Vector of the descriptor's reference class names that match the provided filter. The filter is a comma separated list of strings to match against.

Parameters:

filter - A comma separated list of strings to match against.

Returns:

A Vector of class names that match the filter.

getModuleName

java.lang.String getModuleName()

getModuleName(): Answer the name of the context-root of the application that this session is associated with. Answer "unknown" if there is no module name available. Default behavior is to return "unknown" - we override this behavior here for WebLogic.

getApplicationName

java.lang.String getApplicationName()

getApplicationName(): Answer the name of the module (EAR name) that this session is associated with. Answer "unknown" if there is no application name available. Default behavior is to return "unknown" - we override this behavior here for WebLogic.

getDeployedEclipseLinkLogLevel

java.lang.String getDeployedEclipseLinkLogLevel()

Answer the EclipseLink log level at deployment time. This is read-only.

getCurrentEclipseLinkLogLevel

java.lang.String getCurrentEclipseLinkLogLevel()

Answer the EclipseLink log level that is changeable. This does not affect the log level in the project (i.e. The next time the application is deployed, changes are forgotten)

setCurrentEclipseLinkLogLevel

void setCurrentEclipseLinkLogLevel(java.lang.String newLevel)

Set the EclipseLink log level to be used at runtime. This does not affect the log level in the project (i.e. The next time the application is deployed, changes are forgotten)

Parameters:

String - newLevel: new log level

getProfilingType

java.lang.String getProfilingType()

This method is used to get the type of profiling. Possible values are: "EclipseLink" or "None".

setProfilingType

void setProfilingType(java.lang.String profileType)

This method is used to select the type of profiling. Valid values are: "EclipseLink" or "None". These values are not case sensitive. null is considered to be "None".

setUseEclipseLinkProfiling

void setUseEclipseLinkProfiling()

This method is used to turn on EclipseLink Performance Profiling

getUsesEclipseLinkProfiling

java.lang.Boolean getUsesEclipseLinkProfiling()

This method answers true if EclipseLink Performance Profiling is on.

setUseNoProfiling

void setUseNoProfiling()

This method is used to turn off all Performance Profiling, DMS or EclipseLink.

getStringBindingSize

java.lang.Integer getStringBindingSize()

Return the size of strings after which will be bound into the statement If we are not using a DatabaseLogin, or we're not using string binding, answer 0 (zero).

getTimeConnectionEstablished

java.lang.Long getTimeConnectionEstablished()

This method will return a long indicating the exact time in Milliseconds that the session connected to the database.

getUsesJDBCBatchWriting

java.lang.Boolean getUsesJDBCBatchWriting()

This method will return if batchWriting is in use or not.

getUsesByteArrayBinding

java.lang.Boolean getUsesByteArrayBinding()

Shows if Byte Array Binding is turned on or not

getUsesNativeSQL

java.lang.Boolean getUsesNativeSQL()

Shows if native SQL is being used

getUsesStreamsForBinding

java.lang.Boolean getUsesStreamsForBinding()

This method indicates if streams are being used for binding

getUsesStringBinding

java.lang.Boolean getUsesStringBinding()

This method indicates if Strings are being bound

clearStatementCache

void clearStatementCache()

Used to clear the statement cache. Only valid if statements are being cached

printAvailableConnectionPools

void printAvailableConnectionPools()

This method will print the available Connection pools to the SessionLog.

getMaxSizeForPool

java.lang.Integer getMaxSizeForPool(java.lang.String poolName)

This method will retrieve the max size of a particular connection pool

Parameters:

poolName - the name of the pool to get the max size for

Returns:

Integer for the max size of the pool. Return -1 if pool doesn't exist.

getMinSizeForPool

java.lang.Integer getMinSizeForPool(java.lang.String poolName)

This method will retrieve the min size of a particular connection pool

Parameters:

poolName - the name of the pool to get the min size for

Returns:

Integer for the min size of the pool. Return -1 if pool doesn't exist.

printClassesInSession

void printClassesInSession()

This method is used to output 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 separate identity maps.

printObjectsInIdentityMap

void printObjectsInIdentityMap(java.lang.String className)
                               throws java.lang.ClassNotFoundException

This method will log the objects in the Identity Map. There is no particular order to these objects.

Parameters:

className - the fully qualified classname identifying the identity map

Throws:

thrown - then the IdentityMap for that class name could not be found

java.lang.ClassNotFoundException

printAllIdentityMapTypes

void printAllIdentityMapTypes()

This method will log the types of Identity Maps in the session.

printObjectsInIdentityMaps

void printObjectsInIdentityMaps()

This method will log all objects in all Identity Maps in the session.

getNumberOfObjectsInAllIdentityMaps

java.lang.Integer getNumberOfObjectsInAllIdentityMaps()

This method will SUM and return the number of objects in all Identity Maps in the session.

getNumberOfPersistentClasses

java.lang.Integer getNumberOfPersistentClasses()

This method will answer the number of persistent classes contained in the session. This does not include aggregates.

printIdentityMapLocks

void printIdentityMapLocks()

This method will log the instance level locks in all Identity Maps in the session.

printIdentityMapLocks

void printIdentityMapLocks(java.lang.String registeredClassName)

This method will log the instance level locks in the Identity Map for the given class in the session.

printProfileSummary

void printProfileSummary()

This method assumes EclipseLink Profiling (as opposed to Java profiling). This will log at the INFO level a summary of all elements in the profile.

printProfileSummaryByClass

void printProfileSummaryByClass()

This method assumes EclipseLink Profiling (as opposed to Java profiling). This will log at the INFO level a summary of all elements in the profile, categorized by Class.

printProfileSummaryByQuery

void printProfileSummaryByQuery()

This method assumes EclipseLink Profiling (as opposed to Java profiling). This will log at the INFO level a summary of all elements in the profile, categorized by Query.

getLogType

java.lang.String getLogType()

Return the log type, either "EclipseLink", "Java" or "Server"

Returns:

the log type

getDatabasePlatform

java.lang.String getDatabasePlatform()

Return the database platform used by the DatabaseSession.

Returns:

String databasePlatform

getJdbcConnectionDetails

java.lang.String getJdbcConnectionDetails()

Return JDBCConnection detail information. This includes URL and datasource information.

getConnectionPoolType

java.lang.String getConnectionPoolType()

Return connection pool type. Values include: "Internal", "External" and "N/A".

getDriver

java.lang.String getDriver()

Return db driver class name. This only applies to DefaultConnector. Return "N/A" otherwise.

getLogFilename

java.lang.String getLogFilename()

Return the log filename. This returns the fully qualified path of the log file when EclipseLink logging is enabled. Null is returned otherwise.

Returns:

String logFilename

initializeAllIdentityMaps

void initializeAllIdentityMaps()

This method is used to initialize the identity maps in the session.

initializeIdentityMaps

void initializeIdentityMaps(java.lang.String[] classNames)
                            throws java.lang.ClassNotFoundException

This method is used to initialize the identity maps specified by the Vector of classNames.

Parameters:

classNames - String[] of fully qualified classnames identifying the identity maps to initialize

Throws:

java.lang.ClassNotFoundException

initializeIdentityMap

void initializeIdentityMap(java.lang.String className)
                           throws java.lang.ClassNotFoundException

This method is used to initialize the identity maps specified by className.

Parameters:

className - the fully qualified classnames identifying the identity map to initialize

Throws:

java.lang.ClassNotFoundException

invalidateAllIdentityMaps

void invalidateAllIdentityMaps()

This method is used to invalidate the identity maps in the session.

invalidateIdentityMaps

void invalidateIdentityMaps(java.lang.String[] classNamesParam,
                            java.lang.Boolean recurse)
                            throws java.lang.ClassNotFoundException

This method is used to invalidate the identity maps specified by the String[] of classNames.

Parameters:

classNames - String[] of fully qualified classnames identifying the identity maps to invalidate

recurse - Boolean indicating if we want to invalidate the children identity maps too

Throws:

java.lang.ClassNotFoundException

invalidateIdentityMap

void invalidateIdentityMap(java.lang.String className)
                           throws java.lang.ClassNotFoundException

This method is used to invalidate the identity maps specified by className. This does not invalidate the children identity maps

Parameters:

className - the fully qualified classname identifying the identity map to invalidate

Throws:

java.lang.ClassNotFoundException

invalidateIdentityMap

void invalidateIdentityMap(java.lang.String className,
                           java.lang.Boolean recurse)
                           throws java.lang.ClassNotFoundException

This method is used to invalidate the identity maps specified by className.

Parameters:

className - the fully qualified classname identifying the identity map to invalidate

recurse - Boolean indicating if we want to invalidate the children identity maps too

Throws:

java.lang.ClassNotFoundException

isJPASession

boolean isJPASession()

Return whether this session is an EclipseLink JPA session. The absence of this function or a value of false will signify that the session belongs to a provider other than EclipseLink.

Returns: