oracle.toplink.services.mbean
Interface MBeanDevelopmentServicesMBean

All Known Implementing Classes:

MBeanDevelopmentServices

public interface MBeanDevelopmentServicesMBean

Purpose: Provide a dynamic interface into the TopLink Identity Map Manager.

Description: This interface is ment to provide a framework for gaining access to configuration and statistics of the TopLink Cache during runtime. It provides JMX functionality

Method Summary

boolean	getChangeSetPropagationShouldBeAsynchronous() PUBLIC: This method indicates if Propigation of Cache Synch messages should be Asynchronous or not
boolean	getShouldBindAllParameters() PUBLIC: Method returns if all Parameters should be bound or not
boolean	getShouldRemoveConnectionOnError()
int	getStringBindingSize() PUBLIC: Return the size of strings after which will be bound into the statement
boolean	getUsesBatchWriting() PUBLIC: This method will return if batchWriting is in use or not.
boolean	getUsesByteArrayBinding() PUBLIC: Shows if Byte Array Binding is turned on or not
boolean	getUsesJDBCBatchWriting() PUBLIC: This method will return if batchWriting is in use or not.
boolean	getUsesNativeSQL() PUBLIC: Shows if native SQL is being used
boolean	getUsesStreamsForBinding() PUBLIC: This method indicates if streams are being used for binding
boolean	getUsesStringBinding() PUBLIC: This method indicates if Strings are being bound
void	initializeAllIdentityMaps() PUBLIC: This method is used to clear the contents of all identity maps.
void	initializeCacheSynchronizationServices() PUBLIC: This method will be used by clients to restart their synchronization service for a particular session.
void	initializeIdentityMap(java.lang.String className) PUBLIC: This method is used to clear the contents of a particular identity map.
void	refreshProject(java.lang.String projectFilePath) PUBLIC: This method used to reset a project in a session.
void	setChangeSetPropagationShouldBeAsynchronous(boolean isAsynchronous) PUBLIC: This method is ued to modify the cache synchronization feature.
void	setIdentityMapForClass(java.lang.String className, java.lang.String identityMapClassType, int maxSize) PUBLIC: This method will be used to set a new type of identity map for a particular class type.
void	setShouldBindAllParameters(boolean shouldBindAllParameters) PUBLIC: This method is used to controll if All parameters should be bound
void	setShouldRemoveConnectionOnError(boolean shouldRemoveConnection) PUBLIC: This method is ued to modify the cache synchronization feature.
void	setStringBindingSize(int size) PUBLIC: Sets the size of strings after which they will be bound into the statement
void	setUsesBatchWriting(boolean usesBatchWriting) PUBLIC: This method is used to turn on TopLink Batch Writing.
void	setUsesByteArrayBinding(boolean usesByteArrayBinding) PUBLIC: This method allows control of weither byte arrays should be bound into the statement or not.
void	setUsesJDBCBatchWriting(boolean usesJDBCBatchWriting) PUBLIC: This method is used to turn on JDBC Batch Writing.
void	setUsesNativeSQL(boolean usesNativeSQL) PUBLIC: This method allows the client to set if Native SQL should be used.
void	setUsesStreamsForBinding(boolean usesStreamsForBinding) PUBLIC: This method is used to set if streams should be used for binding.
void	setUsesStringBinding(boolean usesStringBinding) PUBLIC: Allows the client to set if String should be bound into the statement or not.
void	updateCacheSize(java.lang.String className, int newSize) PUBLIC: This method is used to update the cache size of a particular Identity Map If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found
void	updateSynchronizationDiscoveryMulticastGroup(java.lang.String multicastIP, int multicastPort) PUBLIC: This method will be used to update the multicast group of the Synchronization Service.

Method Detail

initializeIdentityMap

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

PUBLIC: This method is used to clear the contents of a particular identity map. Users should be aware that if any of these objects are in use when this action is completed they will lose object identity. If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found

Throws:

java.lang.ClassNotFoundException

initializeAllIdentityMaps

public void initializeAllIdentityMaps()

PUBLIC: This method is used to clear the contents of all identity maps. Users should be aware that if any of these objects are in use when this action is completed they will lose object identity.

setIdentityMapForClass

public void setIdentityMapForClass(java.lang.String className,
                                   java.lang.String identityMapClassType,
                                   int maxSize)
                            throws java.lang.ClassNotFoundException

PUBLIC: This method will be used to set a new type of identity map for a particular class type. If objects of that class type are in use loss of object identity will result. For prevention client may wish to initialize all identity maps first. If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found

Throws:

java.lang.ClassNotFoundException

refreshProject

public void refreshProject(java.lang.String projectFilePath)

PUBLIC: This method used to reset a project in a session. All connected clients will get errors. project must be of the xml type. This attribute will not be stored on a save.

updateCacheSize

public void updateCacheSize(java.lang.String className,
                            int newSize)
                     throws java.lang.ClassNotFoundException

PUBLIC: This method is used to update the cache size of a particular Identity Map If ClassNotFoundException is thrown then the IdenityMap for that class name could not be found

Throws:

java.lang.ClassNotFoundException

setChangeSetPropagationShouldBeAsynchronous

public void setChangeSetPropagationShouldBeAsynchronous(boolean isAsynchronous)

PUBLIC: This method is ued to modify the cache synchronization feature. It allows the user to update the method of sending changes. Asynchronous means that the method may return to the client before that changes have been sent to all servers.

getChangeSetPropagationShouldBeAsynchronous

public boolean getChangeSetPropagationShouldBeAsynchronous()

PUBLIC: This method indicates if Propigation of Cache Synch messages should be Asynchronous or not

setShouldRemoveConnectionOnError

public void setShouldRemoveConnectionOnError(boolean shouldRemoveConnection)

PUBLIC: This method is ued to modify the cache synchronization feature. It allows the user to update weither remote connections should be dropped on error.

getShouldRemoveConnectionOnError

public boolean getShouldRemoveConnectionOnError()

updateSynchronizationDiscoveryMulticastGroup

public void updateSynchronizationDiscoveryMulticastGroup(java.lang.String multicastIP,
                                                         int multicastPort)

PUBLIC: This method will be used to update the multicast group of the Synchronization Service. This will control what servers will be connected to each other.

initializeCacheSynchronizationServices

public void initializeCacheSynchronizationServices()
                                            throws SynchronizationException

PUBLIC: This method will be used by clients to restart their synchronization service for a particular session. This will cause the session to drop all remote connections used for synchronization

Throws:

SynchronizationException

setShouldBindAllParameters

public void setShouldBindAllParameters(boolean shouldBindAllParameters)

PUBLIC: This method is used to controll if All parameters should be bound

getShouldBindAllParameters

public boolean getShouldBindAllParameters()

PUBLIC: Method returns if all Parameters should be bound or not

setStringBindingSize

public void setStringBindingSize(int size)

PUBLIC: Sets the size of strings after which they will be bound into the statement

getStringBindingSize

public int getStringBindingSize()

PUBLIC: Return the size of strings after which will be bound into the statement

setUsesBatchWriting

public void setUsesBatchWriting(boolean usesBatchWriting)

PUBLIC: This method is used to turn on TopLink Batch Writing. Please note that toggling this setting while a transaction is open may result in mis-ordered sql statements or loss of statements. Also please note that TopLink Batch Writing may not work with all JDBC Drivers

getUsesBatchWriting

public boolean getUsesBatchWriting()

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

setUsesJDBCBatchWriting

public void setUsesJDBCBatchWriting(boolean usesJDBCBatchWriting)

PUBLIC: This method is used to turn on JDBC Batch Writing. Please note that toggling this setting while a transaction is open may result in mis-ordered sql statements or loss of statements.

getUsesJDBCBatchWriting

public boolean getUsesJDBCBatchWriting()

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

setUsesByteArrayBinding

public void setUsesByteArrayBinding(boolean usesByteArrayBinding)

PUBLIC: This method allows control of weither byte arrays should be bound into the statement or not. Toggling this attribute while an SQL statement is being built, or if you are caching statements, will result in errors.

getUsesByteArrayBinding

public boolean getUsesByteArrayBinding()

PUBLIC: Shows if Byte Array Binding is turned on or not

setUsesNativeSQL

public void setUsesNativeSQL(boolean usesNativeSQL)

PUBLIC: This method allows the client to set if Native SQL should be used.

getUsesNativeSQL

public boolean getUsesNativeSQL()

PUBLIC: Shows if native SQL is being used

setUsesStreamsForBinding

public void setUsesStreamsForBinding(boolean usesStreamsForBinding)

PUBLIC: This method is used to set if streams should be used for binding. Please note that toggeling this attribute while a statement is being built will result in errors.

getUsesStreamsForBinding

public boolean getUsesStreamsForBinding()

PUBLIC: This method indicates if streams are being used for binding

setUsesStringBinding

public void setUsesStringBinding(boolean usesStringBinding)

PUBLIC: Allows the client to set if String should be bound into the statement or not. Please note that toggling this attribute while a statement is being built, or if statement caching is being used, will result in errors.

getUsesStringBinding

public boolean getUsesStringBinding()

PUBLIC: This method indicates if Strings are being bound