weblogic.management.configuration
Interface JoltConnectionPoolMBean

All Superinterfaces:

ConfigurationMBean, DeploymentMBean

public interface JoltConnectionPoolMBean
extends DeploymentMBean

This bean defines a Jolt connection pool.

getPrimaryAddresses

String[] getPrimaryAddresses()

The list of addresses for the primary Jolt Server Listeners (JSLs) on the Tuxedo system.

The format of each address is: //hostname:port. Multiple addresses should be separated by commas.

Returns:

The primaryAddresses value

setPrimaryAddresses

void setPrimaryAddresses(String[] args)
                         throws InvalidAttributeValueException

Sets the value of the PrimaryAddresses attribute.

Parameters:

args - The new primaryAddresses value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getPrimaryAddresses()

addPrimaryAddress

boolean addPrimaryAddress(String address)
                          throws InvalidAttributeValueException

Adds a feature to the PrimaryAddress attribute of the JoltConnectionPoolMBean object

Parameters:

address - The feature to be added to the PrimaryAddress attribute

Returns:

Throws:

InvalidAttributeValueException

removePrimaryAddress

boolean removePrimaryAddress(String address)
                             throws InvalidAttributeValueException

Parameters:

address -

Returns:

Throws:

InvalidAttributeValueException

getFailoverAddresses

String[] getFailoverAddresses()

The list of Jolt Server Listeners (JSLs) addresses that is used if the connection pool cannot estabilish connections to the Primary Addresses, or if the primary connections fail.

The format of each address is: //hostname:port. Multiple addresses should be separated by commas.

These JSLs need not reside on the same host as the primary JSLs.

Returns:

The failoverAddresses value

setFailoverAddresses

void setFailoverAddresses(String[] args)
                          throws InvalidAttributeValueException

Sets the value of the FailoverAddresses attribute.

Parameters:

args - The new failoverAddresses value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getFailoverAddresses()

addFailoverAddress

boolean addFailoverAddress(String address)
                           throws InvalidAttributeValueException

Adds a feature to the FailoverAddress attribute of the JoltConnectionPoolMBean object

Parameters:

address - The feature to be added to the FailoverAddress attribute

Returns:

Throws:

InvalidAttributeValueException

removeFailoverAddress

boolean removeFailoverAddress(String address)
                              throws InvalidAttributeValueException

Parameters:

address -

Returns:

Throws:

InvalidAttributeValueException

getMinimumPoolSize

int getMinimumPoolSize()

The minimum number of connections to be added to this Jolt connection pool when WebLogic Server starts.

Returns:

The minimumPoolSize value

Default Value:

0

setMinimumPoolSize

void setMinimumPoolSize(int size)
                        throws InvalidAttributeValueException

Sets the value of the MinimumPoolSize attribute.

Parameters:

size - The new minimumPoolSize value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getMinimumPoolSize()

Default Value:

0

Maximum Value:

java.lang.Integer.MAX_VALUE

Minimum Value:

0

getMaximumPoolSize

int getMaximumPoolSize()

The maximum number of connections that can be made from this Jolt connection pool.

Returns:

The maximumPoolSize value

Default Value:

1

setMaximumPoolSize

void setMaximumPoolSize(int size)
                        throws InvalidAttributeValueException

Sets the value of the MaximumPoolSize attribute.

Parameters:

size - The new maximumPoolSize value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getMaximumPoolSize()

Default Value:

1

Maximum Value:

java.lang.Integer.MAX_VALUE

Minimum Value:

1

getUserName

String getUserName()

A user name that applications specify to connect to this Jolt connection pool. If Security Context is enabled, this name must be the name of an authorized Tuxedo user. (Specifying a Tuxedo user name is required if the Tuxedo authentication level is USER_AUTH.)

Returns:

The userName value

setUserName

void setUserName(String name)
                 throws InvalidAttributeValueException

Sets the value of the UserName attribute.

Parameters:

name - The new userName value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getUserName()

getUserPassword

String getUserPassword()

The user password for this Jolt connection pool.

As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the UserPasswordEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the UserPasswordEncrypted attribute to the encrypted value.

Using this attribute (UserPassword) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use UserPasswordEncrypted.

Returns:

The userPassword value

See Also:

JoltConnectionPoolMBean.getUserPasswordEncrypted()

Access limited to the following security roles:

Deployer

setUserPassword

void setUserPassword(String password)
                     throws InvalidAttributeValueException

Sets the value of the UserPassword attribute.

Parameters:

password - The new userPassword value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getUserPassword()

getUserPasswordEncrypted

byte[] getUserPasswordEncrypted()

The user password for this connection pool.

To set this attribute, use weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.

To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.

Returns:

The userPassword value as an encrypted byte array.

setUserPasswordEncrypted

void setUserPasswordEncrypted(byte[] bytes)
                              throws InvalidAttributeValueException

Encrypts the user password and sets the value of the UserPasswordEncrypted attribute.

Parameters:

bytes - The new userPassword value as a byte array

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getUserPasswordEncrypted()

getApplicationPassword

String getApplicationPassword()

The application password for this Jolt connection pool. (This is required only when the security level in the Tuxedo domain is USER_AUTH, ACL or MANDATORY_ACL).

As of 8.1 sp4, when you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the ApplicationPasswordEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the ApplicationPasswordEncrypted attribute to the encrypted value.

Using this attribute (ApplicationPassword) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use ApplicationPasswordEncrypted.

Returns:

The applicationPassword value

See Also:

JoltConnectionPoolMBean.getApplicationPasswordEncrypted()

Access limited to the following security roles:

Deployer

setApplicationPassword

void setApplicationPassword(String password)
                            throws InvalidAttributeValueException

Sets the value of the ApplicationPassword attribute.

Parameters:

password - The new applicationPassword value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getApplicationPassword()

getApplicationPasswordEncrypted

byte[] getApplicationPasswordEncrypted()

The encrypted application password for this connection pool.

To set this attribute, use weblogic.management.EncryptionHelper.encrypt() to encrypt the value. Then set this attribute to the output of the encrypt() method.

To compare a password that a user enters with the encrypted value of this attribute, go to the same WebLogic Server instance that you used to set and encrypt this attribute and use weblogic.management.EncryptionHelper.encrypt() to encrypt the user-supplied password. Then compare the encrypted values.

Returns:

The applicationPassword value as an encrypted byte[] array.

setApplicationPasswordEncrypted

void setApplicationPasswordEncrypted(byte[] bytes)
                                     throws InvalidAttributeValueException

Encrypts the password and sets the value of the ApplicationPasswordEncrypted attribute.

Parameters:

bytes - The new applicationPassword value as a byte array

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getApplicationPasswordEncrypted()

getUserRole

String getUserRole()

The Tuxedo user role for this Jolt connection pool. (This is required only when the security level in the Tuxedo domain is USER_AUTH, ACL, or MANDATORY_ACL).

Returns:

The userRole value

setUserRole

void setUserRole(String role)
                 throws InvalidAttributeValueException

Sets the value of the UserRole attribute.

Parameters:

role - The new userRole value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getUserRole()

isSecurityContextEnabled

boolean isSecurityContextEnabled()

Indicates whether this Jolt connection pool passes the connection pool's security context (user name, password and other information) from the WebLogic Server user to the Tuxedo domain.

If you enable the connection pool to pass the security context, you must start the Jolt Service Handler (JSH) with the -a option. When the JSH gets a message with the caller's identity, it calls impersonate_user() to get the appkey for the user. JSH caches the appkey, so the next time the caller makes a request, the appkey is retrieved from the cache and the request is forwarded to the service. A cache is maintained by each JSH, which means that there will be a cache maintained for all the session pools connected to the same JSH.

You must enable Security Context if Tuxedo requires secured connections.

Returns:

The securityContextEnabled value

Default Value:

false

setSecurityContextEnabled

void setSecurityContextEnabled(boolean on)
                               throws InvalidAttributeValueException

Sets the value of the SecurityContextEnabled attribute.

Parameters:

on - The new securityContextEnabled value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.isSecurityContextEnabled()

getRecvTimeout

int getRecvTimeout()

The number of seconds the client waits to receive a response before timing out.

Returns:

The recvTimeout value

Default Value:

0

setRecvTimeout

void setRecvTimeout(int secs)
                    throws InvalidAttributeValueException

Sets the value of the RecvTimeout attribute.

Parameters:

secs - The new recvTimeout value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getRecvTimeout()

Default Value:

0

Maximum Value:

java.lang.Integer.MAX_VALUE

Minimum Value:

0

getKeyStoreName

String getKeyStoreName()

The path and file name of the keystore containing the private key used in SSL mutual authentication.

Returns:

The keyStoreName value

setKeyStoreName

void setKeyStoreName(String keyStoreName)
                     throws InvalidAttributeValueException

Sets the path and file name of the keystore containing the private key used in SSL mutual authentication.

Parameters:

keyStoreName - The new keyStoreName value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getKeyStoreName()

getTrustStoreName

String getTrustStoreName()

The path and file name of the keystore containing the trust certificates.

Returns:

The trustStoreName value

setTrustStoreName

void setTrustStoreName(String keyStoreName)
                       throws InvalidAttributeValueException

Sets the path and file name of the keystore containing the trust certificates.

Parameters:

keyStoreName - The new trustStoreName value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getTrustStoreName()

getKeyPassPhrase

String getKeyPassPhrase()

The encrypted identity passphrase.

When you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the KeyPassPhraseEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the KeyPassPhraseEncrypted attribute to the encrypted value.

Using this attribute (KeyPassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use KeyPassPhraseEncrypted.

Returns:

The keyPassPhrase value

See Also:

JoltConnectionPoolMBean.getKeyPassPhraseEncrypted()

setKeyPassPhrase

void setKeyPassPhrase(String passPhrase)
                      throws InvalidAttributeValueException

Sets the value of the KeyPassPhrase attribute.

Parameters:

passPhrase - The new keyPassPhrase value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getKeyPassPhrase(), JoltConnectionPoolMBean.setKeyPassPhraseEncrypted(byte[])

getKeyPassPhraseEncrypted

byte[] getKeyPassPhraseEncrypted()

Returns encrypted identity pass phrase.

Returns:

The encrypted keyPassPhrase value

Changes take effect after you redeploy the module or restart the server.

Default Value:

null

setKeyPassPhraseEncrypted

void setKeyPassPhraseEncrypted(byte[] passPhraseEncrypted)

Sets the encrypted value of the keyPassPhrase attribute.

Parameters:

passPhraseEncrypted - The new encrypted keyPassPhrase value

See Also:

JoltConnectionPoolMBean.getKeyPassPhraseEncrypted()

getKeyStorePassPhrase

String getKeyStorePassPhrase()

The encrypted identity keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.

When you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the KeyStorePassPhraseEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the KeyStorePassPhraseEncrypted attribute to the encrypted value.

Using this attribute (KeyStorePassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use KeyStorePassPhraseEncrypted.

Returns:

The keyStorePassPhrase value

See Also:

JoltConnectionPoolMBean.getKeyStorePassPhraseEncrypted()

setKeyStorePassPhrase

void setKeyStorePassPhrase(String passPhrase)
                           throws InvalidAttributeValueException

Sets the value of the KeyStorePassPhrase attribute.

Parameters:

passPhrase - The new keyStorePassPhrase value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getKeyStorePassPhrase(), JoltConnectionPoolMBean.setKeyStorePassPhraseEncrypted(byte[])

getKeyStorePassPhraseEncrypted

byte[] getKeyStorePassPhraseEncrypted()

Returns encrypted pass phrase defined when creating the keystore.

Returns:

The encrypted keyStorePassPhrase value

Changes take effect after you redeploy the module or restart the server.

Default Value:

null

setKeyStorePassPhraseEncrypted

void setKeyStorePassPhraseEncrypted(byte[] passPhraseEncrypted)

Sets the encrypted value of the keyStorePassPhrase attribute.

Parameters:

passPhraseEncrypted - The new encrypted keyStorePassPhrase value

See Also:

JoltConnectionPoolMBean.getKeyStorePassPhraseEncrypted()

getTrustStorePassPhrase

String getTrustStorePassPhrase()

The encrypted trust keystore's passphrase. If empty or null, then the keystore will be opened without a passphrase.

When you get the value of this attribute, WebLogic Server does the following:

1. Retrieves the value of the TrustStorePassPhraseEncrypted attribute.
2. Decrypts the value and returns the unencrypted password as a String.

When you set the value of this attribute, WebLogic Server does the following:

1. Encrypts the value.
2. Sets the value of the TrustStorePassPhraseEncrypted attribute to the encrypted value.

Using this attribute (TrustStorePassPhrase) is a potential security risk because the String object (which contains the unencrypted password) remains in the JVM's memory until garbage collection removes it and the memory is reallocated. Depending on how memory is allocated in the JVM, a significant amount of time could pass before this unencrypted data is removed from memory.

Instead of using this attribute, use TrustStorePassPhraseEncrypted.

Returns:

The trustStorePassPhrase value

See Also:

JoltConnectionPoolMBean.getTrustStorePassPhraseEncrypted()

setTrustStorePassPhrase

void setTrustStorePassPhrase(String passPhrase)
                             throws InvalidAttributeValueException

Sets the value of the TrustStorePassPhrase attribute.

Parameters:

passPhrase - The new trustStorePassPhrase value

Throws:

InvalidAttributeValueException

See Also:

JoltConnectionPoolMBean.getTrustStorePassPhrase(), JoltConnectionPoolMBean.setTrustStorePassPhraseEncrypted(byte[])

getTrustStorePassPhraseEncrypted

byte[] getTrustStorePassPhraseEncrypted()

Returns encrypted pass phrase defined when creating the keystore.

Returns:

The encrypted trustStorePassPhrase value

Changes take effect after you redeploy the module or restart the server.

Default Value:

null

setTrustStorePassPhraseEncrypted

void setTrustStorePassPhraseEncrypted(byte[] passPhraseEncrypted)

Sets the encrypted value of the TrustStorePassPhrase attribute.

Parameters:

passPhraseEncrypted - The new encrypted trustStorePassPhrase value

See Also:

JoltConnectionPoolMBean.getTrustStorePassPhraseEncrypted()