JDBCOracleParamsBean


Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

Contains the Oracle database-related parameters of a data source.

Configuration parameters for a data source's Oracle-specific behavior are specified using a Oracle 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.JDBCOracleParamsBean
Factory Methods No factory methods. Instances of this MBean are created automatically.
Access Points You can access this MBean from the following MBean attributes:


    Attributes

    This section describes the following attributes:


    ActiveGridlink

    Indicates a configured Active GridLink datasource. This attributed is set to true when using the console to create an Active GridLink datasource. It is ignored if FanEnabled is true or OnsNodeList is a non-null string.

           
    Privileges Read/Write
    Typeboolean

    AffinityPolicy

    The affinity policy determines how JDBC connections to specific Oracle RAC instances are selected and returned to the application. When an initial connection is returned to the application, an affinity context is created that identifies the RAC instance. The affinity context is stored in the application context (global transaction or http session), propagates with the context, and is used during subsequent connection requests to return a connection to the same instance.

    Options include:

    The affinity policy only applies to Active GridLink data sources.

           
    Privileges Read/Write
    Typejava.lang.String
    Default ValueSession
    Legal Values
    • Transaction
    • Session
    • Data
    • None

    ConnectionInitializationCallback

    The name of the Connection Initialization Callback class.

    This name is automatically passed to registerConnectionInitializationCallback when a data source is created. The class must implement oracle.ucp.jdbc.ConnectionInitializationCallback.

           
    Privileges Read/Write
    Typejava.lang.String

    FanEnabled

    Enables the data source to subscribe to and process Oracle FAN events.

    This attribute is only applicable for RAC configurations that publish FAN notification events using the ONS protocol.

           
    Privileges Read/Write
    Typeboolean

    OnsNodeList

    A comma-separate list of ONS daemon listen addresses and ports to which connect to for receiving ONS-based FAN events. It is required when connecting to Oracle 11g databases and optional when connecting to Oracle database releases 12c and higher.

           
    Privileges Read/Write
    Typejava.lang.String

    OnsWalletFile

    The location of the Oracle wallet file in which the SSL certificates are stored. Only required when the ONS client is configured to communicate with ONS daemons using SSL.

           
    Privileges Read/Write
    Typejava.lang.String

    OnsWalletPassword

    The wallet password attribute that is included as part of the ONS client configuration string. This attribute is only required when ONS is configured to use the SSL protocol.

    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

    OnsWalletPasswordEncrypted

    The encrypted database password as set with setOnsWalletPassword(), or with setOnsWalletPasswordEncrypted(byte[] bytes).

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

    OracleEnableJavaNetFastPath

    This option no longer does anything.

    Deprecated. 12.2.1.3.1

           
    Privileges Read/Write
    Typeboolean

    OracleOptimizeUtf8Conversion

    Enables the Oracle JDBC optimize UTF-8 conversion option (no longer supported).

    Deprecated. 14.1.2.0.0

           
    Privileges Read/Write
    Typeboolean

    OracleProxySession

    Enables Oracle JDBC Proxy Authentication.

           
    Privileges Read/Write
    Typeboolean

    RebalanceOnUpEvent

    Rebalancing connections incurs overhead due to connection creation to the new instance, and the closing of connections to existing instances, which may impact application performance under load, cause database logon storms, etc. When the value is set to false, connections to existing instances are preserved and new connections are distributed across running instances as necessary.

           
    Privileges Read/Write
    Typeboolean
    Default Valuetrue

    ReplayInitiationTimeout

    The amount of time, in seconds, a data source allows for Application Continuity replay processing before timing out and ending a replay session context.

           
    Privileges Read/Write
    Typeint
    Default Value3600
    Maximum value2147483647

    UseDatabaseCredentials

    If enabled, Oracle database credentials are used in getConnection instead of application server credentials. The database credentials are used to get a proxy session without requiring any work in the credential mapper.

           
    Privileges Read/Write
    Typeboolean


    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.