BEA Systems, Inc.

WebLogic Server 6.1 API Reference

weblogic.management.configuration
Interface JDBCDataSourceMBean


public interface JDBCDataSourceMBean
extends DeploymentMBean

Author:
Copyright © 2001 BEA Systems, Inc. All Rights Reserved.

Fields inherited from class weblogic.management.configuration.DeploymentMBean
DEFAULT_ORDER, MAX_ORDER, MIN_ORDER
 
Method Summary
 java.lang.String getJNDIName()
          Returns the JNDI path to where this DataSource is bound
 java.lang.String getPoolName()
          Returns name of the connection pool which the DataSource is associated with.
 int getRowPrefetchSize()
          The number of rows that will be prefetched between client and WebLogic Server for each ResultSet.
 int getStreamChunkSize()
          Data chunk size for steaming datatypes.
 boolean isRowPrefetchEnabled()
          Returns true if row prefetching is enabled between client and WebLogic Server for each ResultSet.
 void setJNDIName(java.lang.String name)
          Sets the JNDI path to where this DataSource is bound.
 void setPoolName(java.lang.String pool)
          Sets the name of the JDBC connection pool that is associated with this DataSource.
 void setRowPrefetchEnabled(boolean enable)
          Set to true to enable row prefetching between client and WebLogic Server for each ResultSet.
 void setRowPrefetchSize(int prefetch)
           
 void setStreamChunkSize(int chunk_size)
           
 
Methods inherited from interface weblogic.management.configuration.DeploymentMBean
addTarget, getDeploymentOrder, getTargets, removeTarget, setDeploymentOrder, setTargets
 
Methods inherited from interface weblogic.management.configuration.ConfigurationMBean
getNotes, setNotes, setPersistenceEnabled
 
Methods inherited from interface weblogic.management.WebLogicMBean
getMBeanInfo, getName, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setName, setParent
 
Methods inherited from interface javax.management.DynamicMBean
getAttribute, getAttributes, invoke, setAttribute, setAttributes
 
Methods inherited from interface javax.management.MBeanRegistration
postDeregister, postRegister, preDeregister, preRegister
 
Methods inherited from interface javax.management.NotificationBroadcaster
addNotificationListener, getNotificationInfo, removeNotificationListener
 

Method Detail

getJNDIName

public java.lang.String getJNDIName()
Returns the JNDI path to where this DataSource is bound

Legal NULL: false

setJNDIName

public void setJNDIName(java.lang.String name)
                 throws javax.management.InvalidAttributeValueException
Sets the JNDI path to where this DataSource is bound. Applications that look up the JNDI path will get a javax.sql.DataSource instance that corresponds to this DataSource. Note that the old style usage of DriverManager.getConnection() or Driver.connect() has been deprecated in favor of looking up a datasource to obtain a connection.

Legal Value: ((value != null) && (value.trim().length() > 0))

getPoolName

public java.lang.String getPoolName()
Returns name of the connection pool which the DataSource is associated with.


setPoolName

public void setPoolName(java.lang.String pool)
                 throws javax.management.InvalidAttributeValueException
Sets the name of the JDBC connection pool that is associated with this DataSource. Calls to getConnection() on this DataSource will return a connection from the associated connection pool.

Legal Value: (value != null) && (value.trim().length() > 0)

isRowPrefetchEnabled

public boolean isRowPrefetchEnabled()
Returns true if row prefetching is enabled between client and WebLogic Server for each ResultSet.

Default Value: false

setRowPrefetchEnabled

public void setRowPrefetchEnabled(boolean enable)
Set to true to enable row prefetching between client and WebLogic Server for each ResultSet. When an external client does JDBC access through Weblogic Server, row prefetching improves performance by fetching multiple rows from the server to the client in one server access. The WebLogic Server will ignore this setting and not use row prefetching when the client and WebLogic Server are in the same JVM.

Default Value: false

getRowPrefetchSize

public int getRowPrefetchSize()
The number of rows that will be prefetched between client and WebLogic Server for each ResultSet. The optimal value is very dependent on the particulars of the query. Generally, increasing this number will increase performance, until a particular value is reached. At that point further increases do not result in any significant performance increase. Very rarely will increased performance result from exceeding 100 rows. The default value should be reasonable for most situations.

Default Value: 48
Legal Minimum Value: 2
Legal Maximum Value: 65536

setRowPrefetchSize

public void setRowPrefetchSize(int prefetch)


getStreamChunkSize

public int getStreamChunkSize()
Data chunk size for steaming datatypes. Streaming datatypes (for example resulting from a call to getBinaryStream()) will be pulled in StreamChunkSize sized chunks from the WebLogic Server to the client as needed.

Default Value: 256
Legal Minimum Value: 1
Legal Maximum Value: 65536

setStreamChunkSize

public void setStreamChunkSize(int chunk_size)


Documentation is available at
http://download.oracle.com/docs/cd/E13222_01/wls/docs61

WebLogic classes and methods that do not appear in this reference are not public and are not supported.