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 roles The following roles have read, write, and invoke permission for all non-encrypted attributes and operations in this MBean:

  • Deployer
   
Fully Qualified Interface Name If 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. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.

     

    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    
    Type JDBCPropertiesBean
    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: com.pointbase.jdbc.jdbcUniversalDriver

    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    
    Type java.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 roles Read access is granted only to the following roles:

    • Deployer
       
    Type java.lang.String
    Encrypted true

     

    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    
    Type byte[]
    Encrypted true

     

    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    
    Type java.lang.String

     

    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    
    Type boolean
    Default Value true

    Operations

    This section describes the following operations:

       

      isSet

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

      Operation Name "isSet"    
      Parameters Object [] {  propertyName }

      where:

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

        property to check

      Signature String [] { "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"    
      Parameters Object [] {  propertyName }

      where:

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

        property to restore

      Signature String [] { "java.lang.String" }
      Returns void
      Exceptions

      • java.lang.IllegalArgumentException
        UnsupportedOperationException if called on a runtime implementation.