Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-01

weblogic.management.configuration
Interface ForeignJMSConnectionFactoryMBean


Deprecated. 9.0.0.0 Replaced by the ForeignConnectionFactoryBean type in the new JMS module.

public interface ForeignJMSConnectionFactoryMBean

This class represents a JMS connection factory that resides on another server, and is accessed via JNDI. A remote connection factory can be used to refer to another instance of WebLogic JMS running in a different cluster or server, or a foreign JMS provider, as long as that provider supports JNDI. This MBean will always be a sub-element of the ForeignJMSServerMBean.


Method Summary
 String getConnectionHealthChecking()
          Deprecated. Enables the JMS connection testing mechanism that insures a connection created from this connection factory is still valid.
 String getLocalJNDIName()
          Deprecated.  
 String getPassword()
          Deprecated. The password that will be used in conjunction with the user name specified in the "Username" attribute.
 byte[] getPasswordEncrypted()
          Deprecated. The encrypted password that will be used in conjunction with the user name specified in the "Username" attribute.
 String getRemoteJNDIName()
          Deprecated.  
 String getUsername()
          Deprecated. The user name that will be passed when opening a connection to the remote JMS server (represented by this foreign JMS connection factory).
 void setConnectionHealthChecking(String value)
          Deprecated. Sets the value of the ConnectionHealthChecking attribute.
 void setLocalJNDIName(String name)
          Deprecated.  
 void setPassword(String passwd)
          Deprecated. Sets the value of the Password attribute.
 void setPasswordEncrypted(byte[] encryptedBytes)
          Deprecated. Encrypts the user password and sets the value of the PasswordEncrypted attribute.
 void setRemoteJNDIName(String name)
          Deprecated.  
 void setUsername(String name)
          Deprecated. Sets the value of the Username attribute.
 

Method Detail

setLocalJNDIName

void setLocalJNDIName(String name)
Deprecated. 
This method can NOT set a null value.

getLocalJNDIName

String getLocalJNDIName()
Deprecated. 

setRemoteJNDIName

void setRemoteJNDIName(String name)
Deprecated. 
This method can NOT set a null value.

getRemoteJNDIName

String getRemoteJNDIName()
Deprecated. 

setUsername

void setUsername(String name)
Deprecated. 

Sets the value of the Username attribute.

Parameters:
name - The new username value
See Also:
ForeignJMSConnectionFactoryMBean.getUsername()

getUsername

String getUsername()
Deprecated. 

The user name that will be passed when opening a connection to the remote JMS server (represented by this foreign JMS connection factory). If not set, then no user name will be used.

Returns:
The username value

setPassword

void setPassword(String passwd)
Deprecated. 

Sets the value of the Password attribute.

Parameters:
passwd - The new password value
See Also:
ForeignJMSConnectionFactoryMBean.getPassword()

getPassword

String getPassword()
Deprecated. 

The password that will be used in conjunction with the user name specified in the "Username" attribute.

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

  1. Retrieves the value of the PasswordEncrypted 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 PasswordEncrypted attribute to the encrypted value.

Using Password() 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 PasswordEncrypted.

Returns:
The password value

setConnectionHealthChecking

void setConnectionHealthChecking(String value)
Deprecated. 

Sets the value of the ConnectionHealthChecking attribute.

Parameters:
value - The new value for ConnectionHealthChecking
See Also:
ForeignJMSConnectionFactoryMBean.getConnectionHealthChecking()

getConnectionHealthChecking

String getConnectionHealthChecking()
Deprecated. 

Enables the JMS connection testing mechanism that insures a connection created from this connection factory is still valid. If not checked, then the connection testing mechanism will be disabled.

Returns:
The connectionHealthChecking value

getPasswordEncrypted

byte[] getPasswordEncrypted()
Deprecated. 

The encrypted password that will be used in conjunction with the user name specified in the "Username" attribute.

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 password value as an encrypted byte array

setPasswordEncrypted

void setPasswordEncrypted(byte[] encryptedBytes)
Deprecated. 
Encrypts the user password and sets the value of the PasswordEncrypted attribute.

Parameters:
encryptedBytes - The new password value as encrypted byte array
See Also:
ForeignJMSConnectionFactoryMBean.getPasswordEncrypted()

Copyright 1996, 2013, Oracle and/or its affiliates. All rights reserved. Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

Oracle Fusion Middleware
Java API Reference for Oracle WebLogic Server
12c (12.1.2)

Part Number E27170-01