JDBCDriverParamsBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

Contains the driver parameters of a data source.

Configuration parameters for the JDBC Driver used by a data source are specified using a driver parameters bean.

       
Security rolesThe following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:
  • Deployer
Fully Qualified Interface NameIf you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.j2ee.descriptor.wl.JDBCDriverParamsBean
Factory Methods No factory methods. Instances of this MBean are created automatically.


Related MBeans

This section describes attributes that provide access to other MBeans.


    Properties

    The list of properties passed to the JDBC driver when creating physical database connections.

    To enable driver-level features, add the driver property and its value to the Properties list. WebLogic Server sets driver-level properties in the Properties list on the driver's ConnectionPoolDataSource object.

    Note: For Security reasons, when WebLogic Server is running in Production mode, you cannot specify database passwords in this properties list. Data source deployment will fail if a password is specified in the properties list. To override this security check, use the command line argument "weblogic.management.allowClearTextPasswords" when starting the server.

           
    Factory Methods No explicit creator method. The child shares the lifecycle of its parent.
    Privileges Read only
    TypeJDBCPropertiesBean
    Relationship type: Containment.


    Attributes

    This section describes the following attributes:


    DriverName

    The full package name of JDBC driver class used to create the physical database connections in the connection pool in the data source.

    For example: oracle.jdbc.OracleDriver

    The driver must be the name of a class that implements the java.sql.Driver interface. Check the driver documentation to find the full pathname.

    Note that the driver class must be in the classpath of any server to which the data source is deployed.

           
    Privileges Read/Write
    Typejava.lang.String

    Password

    The password attribute passed to the JDBC driver when creating physical database connections.

    The value is stored in an encrypted form in the descriptor file and when displayed on the Administration Console.

               
    Privileges Read/Write
    Security rolesRead access is granted only to the following roles:
    • Deployer
    Typejava.lang.String
    Encryptedtrue

    PasswordEncrypted

    The encrypted database password as set with setPassword(), setPasswordEncrypted(byte[] bytes), or as a key=value pair in the list of JDBC driver properties.

               
    Privileges Read/Write
    Security rolesRead access is granted only to the following roles:
    • Deployer
    Typebyte[]
    Encryptedtrue

    Url

    The URL of the database to connect to. The format of the URL varies by JDBC driver.

    The URL is passed to the JDBC driver to create the physical database connections.

           
    Privileges Read/Write
    Typejava.lang.String

    UsePasswordIndirection

    Specifies whether the database credentials are to be obtained from the credential mapper using the "user" property as the key. When true, the credentials are obtained from the credential mapper. When false, the database user name and password are obtained from the "user" property and Password element, respectively.

    For more information, see:

           
    Privileges Read/Write
    Typeboolean

    UseXaDataSourceInterface

    Specifies that WebLogic Server should use the XA interface of the JDBC driver.

    If the JDBC driver class used to create database connections implements both XA and non-XA versions of a JDBC driver, you can set this attribute to indicate that WebLogic Server should treat the JDBC driver as an XA driver or as a non-XA driver.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue


    Operations

    This section describes the following operations:


      isSet

      Return true if the given property has been explicitly set in this bean.

         
      Operation Name"isSet"
      ParametersObject [] {  propertyName }

      where:

      • propertyName is an object of type java.lang.String that specifies:

        property to check

      SignatureString [] { "java.lang.String" }
      Returns boolean
      Exceptions
      • java.lang.IllegalArgumentException
        IllegalArgumentException if propertyName is not a recognized property

      unSet

      Restore the given property to its default value.

         
      Operation Name"unSet"
      ParametersObject [] {  propertyName }

      where:

      • propertyName is an object of type java.lang.String that specifies:

        property to restore

      SignatureString [] { "java.lang.String" }
      Returns void
      Exceptions
      • java.lang.IllegalArgumentException
        UnsupportedOperationException if called on a runtime implementation.