|
Oracle Fusion Middleware Oracle WebLogic Server 10.3.1 MBean API Reference 11g Release 1 (10.3.1) Part Number E13945-02 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
runtime.JDBCDataSourceRuntimeMBean
public interface JDBCConnectionPoolRuntimeMBean
This class is used for monitoring a WebLogic JDBC component
This is a type-safe inteface for a
WebLogic Server MBean, which you can import into your client
classes and access through
weblogic.management.MBeanHome
. As of 9.0,
MBeanHome
inteface and all type-safe interfaces for
WebLogic Server MBeans are deprecated. Instead, client classes that
interact with WebLogic Server MBeans should use standard JMX design
patterns in which clients use the
javax.management.MBeanServerConnection
inteface to
discover MBeans, attributes, and attribute types at runtime. For
more information, see "Developing Manageable Applications with JMX"
on http://www.oracle.com/technology/products/weblogic/index.html.
Field Summary |
---|
Fields inherited from interface weblogic.management.runtime.ComponentRuntimeMBean |
---|
ACTIVATED, NEW, PREPARED, UNPREPARED |
Method Summary | |
---|---|
void |
clearStatementCache()
Deprecated. Clears the cache of Prepared and Callable Statements maintained for each connection in the connection pool. |
void |
disableDroppingUsers()
Deprecated. Disable the pool, immediately disconnecting all users. |
void |
disableFreezingUsers()
Deprecated. Disable the pool, suspending all operations on pool connections until the pool is re-enabled. |
void |
dumpPool()
Deprecated. Prints out the data structure of the connection pool in the following lists: alvList - lists details about database connections in the connection pool that are not currently in use by a client. unavlList - lists details about database connections that WebLogic Server failed to create on server startup or failed to recreate after a failed database connection test. resvList - lists details about database connections in teh connection pool that are currently in use by a client. |
void |
enable()
Deprecated. Restore all access to and operations on the pool. |
void |
forceShutdown()
Deprecated. Forcibly shuts down the connection pool. |
void |
forceSuspend()
Deprecated. Forcibly disables the pool, suspending all operations on pool connections until the pool is re-enabled. |
int |
getActiveConnectionsAverageCount()
Deprecated. |
int |
getActiveConnectionsCurrentCount()
Deprecated. |
int |
getActiveConnectionsHighCount()
Deprecated. |
int |
getConnectionDelayTime()
Deprecated. |
int |
getConnectionLeakProfileCount()
Deprecated. Connection leak is a situation when connection from the pool was not closed explicitly by calling close() and was garbage collected. |
JDBCConnectionLeakProfile[] |
getConnectionLeakProfiles(int index,
int count)
Deprecated. Connection leak profiling stores stack trace at the time when connection was created in case of connection leak. |
int |
getConnectionsTotalCount()
Deprecated. The total number of JDBC connections in this JDBCConnectionPoolRuntimeMBean since the pool has been
instantiated. |
int |
getCurrCapacity()
Deprecated. The current capacity of this connection pool. |
int |
getFailuresToReconnectCount()
Deprecated. |
int |
getHighestNumAvailable()
Deprecated. The highest number of available connections in this pool. |
int |
getHighestNumUnavailable()
Deprecated. The highest number of unavailable connections in this pool. |
int |
getLeakedConnectionCount()
Deprecated. |
int |
getMaxCapacity()
Deprecated. The maximum capacity of this connection pool. |
int |
getNumAvailable()
Deprecated. The number of available connections in this pool. |
int |
getNumUnavailable()
Deprecated. The number of unavailable connections in this pool. |
boolean |
getPoolState()
Deprecated. |
Properties |
getProperties()
Deprecated. Returns the properties for a pool. |
String |
getState()
Deprecated. The current state of the connection pool. |
int |
getStatementProfileCount()
Deprecated. SQL roundtrip profiling stores SQL statement text, execution time and other metrics. |
JDBCStatementProfile[] |
getStatementProfiles(int index,
int count)
Deprecated. SQL roundtrip profiling stores SQL statement text, execution time and other metrics. |
String |
getVersionJDBCDriver()
Deprecated. The class name of the JDBC driver used to create database connections. |
int |
getWaitingForConnectionCurrentCount()
Deprecated. |
int |
getWaitingForConnectionHighCount()
Deprecated. |
int |
getWaitSecondsHighCount()
Deprecated. |
boolean |
isEnabled()
Deprecated. |
boolean |
poolExists(String poolName)
Deprecated. Indicates whether the specified pool exists. |
void |
reset()
Deprecated. Resets the connection pool by shutting down and re-establishing all available connecton pool connections. |
void |
resetConnectionLeakProfile()
Deprecated. Resets connection leak profile. |
void |
resetStatementProfile()
Deprecated. Resets SQL statement profile. |
void |
resume()
Deprecated. Restores all access to and operations on a connection pool that has been suspended (marked as disabled). |
void |
shrink()
Deprecated. Shrinks the named database ConnectionPool to the current number of reserved connections or the initial connection pool size, which ever is greater. |
void |
shutdown()
Deprecated. Shuts down the pool. |
void |
suspend()
Deprecated. Disables the connection pool, suspending all operations on pool connections until the pool is re-enabled. |
String |
testPool()
Deprecated. Test the pool by reserving and releasing a connection from it. |
Methods inherited from interface weblogic.management.runtime.ComponentRuntimeMBean |
---|
getDeploymentState, getModuleId, getWorkManagerRuntimes |
Method Detail |
---|
int getConnectionLeakProfileCount()
Connection leak is a situation when connection from the pool was not closed explicitly by calling close() and was garbage collected.
This method should be used first before requesting connection leak profiles from the profile storage.
JDBCConnectionLeakProfile[] getConnectionLeakProfiles(int index, int count)
Connection leak profiling stores stack trace at the time when connection was created in case of connection leak. This enables you to identify where the leak occurred.
Connection leak is a situation when connection from the pool was not closed explicitly by calling close() and was garbage collected.
runtime.JDBCConnectionLeakProfile
int getStatementProfileCount()
SQL roundtrip profiling stores SQL statement text, execution time and other metrics.
This method should be used first before requesting SQL statement profiles from the profile storage.
JDBCStatementProfile[] getStatementProfiles(int index, int count)
SQL roundtrip profiling stores SQL statement text, execution time and other metrics.
runtime.JDBCStatementProfile
String testPool()
Test the pool by reserving and releasing a connection from it. If the pool configuration attribute TestConnectionsOnReserve or TestConnectionsOnRelease is enabled, the acquired connection is also tested as part of the reserve and release operation.
JDBCConnectionPoolMBean
int getLeakedConnectionCount()
boolean getPoolState()
true
if the pool enabled.
false
if the pool disabledboolean isEnabled()
true
if the pool is enabled.
false
if the pool is disabled.String getState()
The current state of the connection pool.
Possible values are:
Running
if the pool is enabled (deployed and not Suspended
). This is the
normal state of the connection pool.
Suspended
if the pool disabled.
Shutdown
if the pool is shutdown and all database connections have been closed.
Unknown
if the pool state is unknown.
Unhealthy
if all connections are unavailable (not because they are in use). This state occurs if the database server is unavailable when the connection pool is created (creation retry must be enabled) or if all connections have failed connection tests (on creation, on reserve, on release, or periodic testing).
int getFailuresToReconnectCount()
int getConnectionDelayTime()
int getActiveConnectionsCurrentCount()
int getWaitingForConnectionCurrentCount()
String getVersionJDBCDriver()
int getActiveConnectionsHighCount()
Note that this is an optimization method for a highly useful statistic that could be implemented less efficiently using change notification.
int getActiveConnectionsAverageCount()
int getWaitingForConnectionHighCount()
Note that this is an optimization method for a highly useful statistic that could be implemented less efficiently using change notification.
int getWaitSecondsHighCount()
int getConnectionsTotalCount()
The total number of JDBC connections in this
JDBCConnectionPoolRuntimeMBean
since the pool has been
instantiated.
int getMaxCapacity()
The maximum capacity of this connection pool.
int getCurrCapacity()
The current capacity of this connection pool.
int getNumAvailable()
The number of available connections in this pool.
int getHighestNumAvailable()
The highest number of available connections in this pool.
int getNumUnavailable()
The number of unavailable connections in this pool.
int getHighestNumUnavailable()
The highest number of unavailable connections in this pool.
void resetConnectionLeakProfile()
Resets connection leak profile.
void resetStatementProfile()
Resets SQL statement profile.
void shrink() throws Exception
Shrinks the named database ConnectionPool to the current number of reserved connections or the initial connection pool size, which ever is greater.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid reset() throws Exception
Resets the connection pool by shutting down and re-establishing
all available connecton pool connections. This method should be used when the
connection pool is in the Unhealthy
state and needs to be
reinitialized.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid suspend() throws Exception
Disables the connection pool, suspending all operations on pool connections until the pool is re-enabled.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid forceSuspend() throws Exception
Forcibly disables the pool, suspending all operations on pool connections until the pool is re-enabled. All current users of the pool are forcibly disconnected. All connections currently in use are closed and recreated.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid shutdown() throws Exception
Shuts down the pool. If any connections from the pool are currently in use, the operation will fail.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid forceShutdown() throws Exception
Forcibly shuts down the connection pool. All current users of the pool are forcibly disconnected.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid resume() throws Exception
Restores all access to and operations on a connection pool that has been suspended (marked as disabled).
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorvoid disableDroppingUsers() throws Exception
Disable the pool, immediately disconnecting all users.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorJDBCConnectionPoolRuntimeMBean.forceSuspend()
void disableFreezingUsers() throws Exception
Disable the pool, suspending all operations on pool connections until the pool is re-enabled.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorJDBCConnectionPoolRuntimeMBean.suspend()
void enable() throws Exception
Restore all access to and operations on the pool.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorJDBCConnectionPoolRuntimeMBean.resume()
Properties getProperties() throws Exception
Returns the properties for a pool.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
Exception
- if there is an errorboolean poolExists(String poolName) throws Exception
Indicates whether the specified pool exists.
This is a privileged method, and can only be invoked on a client that has specified an authorized Principal.
name
- Name of the pool being looked for
Exception
- if there is an errorvoid clearStatementCache() throws Exception
Clears the cache of Prepared and Callable Statements maintained for each connection in the connection pool.
Exception
- if there is an errorvoid dumpPool() throws Exception
Prints out the data structure of the connection pool in the following lists:
Exception
|
Documentation is available at http://download.oracle.com/docs/cd/E12839_01/web.1111/wls.htm Copyright 1996, 2009, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. Oracle Fusion Middleware Oracle WebLogic Server 10.3.1 MBean API Reference 11g Release 1 (10.3.1) Part Number E13945-02 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |