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.
Access Points You can access this MBean from the following MBean attributes:


    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 in an administration console.

                 
      Privileges Read/Write
      Security rolesRead access is granted only to the following roles:
      • Deployer
      Write 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.