ConnectionFactory

Settings used when creating connections to resources, such as authentication preferences and pool settings.

Inherits from type J2EEResourceFactory and adds the following.

Attributes Summary
authMechanismPreference : AuthMechanismTypeThe value of this attribute specifies which of the defined authentication mechanisms for the corresponding resource adapter applies to this connection factory.
authDataAlias : StringAn alias to an AuthDataEntry (Specified by name).
manageCachedHandles : booleanWhether cached handles (handles held in inst vars in a bean) should be tracked by the container.
logMissingTransactionContext : booleanThe J2EE1.
xaRecoveryAuthAlias : StringThis optional field will be used to specify the authentication alias that should be used during XA Recovery processing.
connectionPool  : ConnectionPoolAn optional set of connection pool settings.
preTestConfig : ConnectionTestReference to ConnectionTest, for connection pretest options associated with this ConnectionFactory.
mapping : MappingModuleDeprecated.

Attribute Details

authMechanismPreference    -    The value of this attribute specifies which of the defined authentication mechanisms for the corresponding resource adapter applies to this connection factory. For example, if two authentication mechanism entries have been defined for a resource adapter, KerbV5 and Basic Password, this will specify one of those two types. If the authentication mechanism preference specified is not an available authentication mechanism on the corresponding resource adapter, it is ignored. Default=BASIC PASSWORD.
     data type: AuthMechanismType
     default Value:   unspecified
     Allowed Values:  BASIC_PASSWORD   KERBEROS  



authDataAlias    -    An alias to an AuthDataEntry (Specified by name). It is an alias into the AuthDataEntries list in security.xml.
     data type:  String
     default Value:   unspecified



manageCachedHandles    -    Whether cached handles (handles held in inst vars in a bean) should be tracked by the container. Tracking handles can cause large performance overhead if used at runtime; however, for debugging purposes it can be useful to enable handle management.
     data type: boolean
     default Value:   false
     Allowed Values:  true   false  



logMissingTransactionContext    -    The J2EE1.3 programming model indicates that connections should always have a transaction context; however, some applications do not correctly have a transaction context associated with them. This setting enables whether the container will log the condition that there is a missing transaction context at the time that the connection is obtained to the activity log.
     data type: boolean
     default Value:   true
     Allowed Values:  true   false  



xaRecoveryAuthAlias    -    This optional field will be used to specify the authentication alias that should be used during XA Recovery processing. If the ResourceAdapter does not support XA transactions, then this field should not be prompted for and, if it is specified, will be ignored. The default value will come from the authDataAlias (if specified).
     data type:  String
     default Value:   unspecified



connectionPool    -    An optional set of connection pool settings.
     data type: ConnectionPool



preTestConfig    -    Reference to ConnectionTest, for connection pretest options associated with this ConnectionFactory.
     data type: ConnectionTest



mapping    -    Deprecated. Reference to MappingModule for specifying container managed authentication data associated with this ConnectionFactory. The preferred way to specify container-managed authentication data is on each resource reference.
     data type: MappingModule


Copyright IBM Corp. 1997-2004