Type-Safe Access to BEA WebLogic Server 9.2 MBeans (Deprecated)

(Methods marked with @since 9.0.0.0 are not available through the deprecated MBeanHome interface.)

weblogic.management.configuration
Interface ForeignJMSConnectionFactoryMBean

All Superinterfaces:

ConfigurationMBean, weblogic.descriptor.DescriptorBean, DynamicMBean, weblogic.management.configuration.ForeignJNDIObjectMBean, MBeanRegistration, NotificationBroadcaster, weblogic.descriptor.SettableBean, weblogic.management.WebLogicMBean

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

public interface ForeignJMSConnectionFactoryMBean

extends weblogic.management.configuration.ForeignJNDIObjectMBean

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.

Deprecation of MBeanHome and Type-Safe Interfaces

This is a type-safe interface for a WebLogic Server MBean, which you can import into your client classes and access through weblogic.management.MBeanHome. As of 9.0, the MBeanHome interface and all type-safe interfaces for WebLogic Server MBeans are deprecated. Instead, client classes that interact with WebLogic Server MBeans should use standard JMX design patterns in which clients use the javax.management.MBeanServerConnection interface to discover MBeans, attributes, and attribute types at runtime. For more information, see "Developing Manageable Applications with JMX" on http://www.oracle.com/technology/documentation/index.html.

Field Summary

Fields inherited from interface weblogic.management.configuration.ConfigurationMBean

DEFAULT_EMPTY_BYTE_ARRAY

Method Summary

String	getLocalJNDIName() Deprecated. The name that the remote object will be bound to in the local server's JNDI tree.
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. The name of the remote object that will be looked up in the remote JNDI directory.
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	setLocalJNDIName(String name) Deprecated. Sets the value of the LocalJNDIName attribute.
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. Sets the value of the RemoteJNDIName attribute.
void	setUsername(String name) Deprecated. Sets the value of the Username attribute.

Methods inherited from interface weblogic.management.configuration.ConfigurationMBean

freezeCurrentValue, getName, getNotes, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet

Methods inherited from interface weblogic.management.WebLogicMBean

getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent

Methods inherited from interface javax.management.DynamicMBean

getAttribute, getAttributes, invoke, setAttribute, setAttributes

Methods inherited from interface javax.management.MBeanRegistration

postDeregister, postRegister, preDeregister, preRegister

Methods inherited from interface javax.management.NotificationBroadcaster

addNotificationListener, getNotificationInfo, removeNotificationListener

Methods inherited from interface weblogic.descriptor.DescriptorBean

addBeanUpdateListener, addPropertyChangeListener, createChildCopy, createChildCopyIncludingObsolete, getDescriptor, getParentBean, isEditable, removeBeanUpdateListener, removePropertyChangeListener

Method Detail

getLocalJNDIName

public String getLocalJNDIName()

Deprecated.

Description copied from interface: weblogic.management.configuration.ForeignJNDIObjectMBean

The name that the remote object will be bound to in the local server's JNDI tree. This is the name that should be used to look up the object on the local server.

Specified by:

getLocalJNDIName in interface weblogic.management.configuration.ForeignJNDIObjectMBean

Returns:

The localJNDIName value

getPassword

public 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

getPasswordEncrypted

public 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

See Also:

weblogic.management.EncryptionHelper

getRemoteJNDIName

public String getRemoteJNDIName()

Deprecated.

Description copied from interface: weblogic.management.configuration.ForeignJNDIObjectMBean

The name of the remote object that will be looked up in the remote JNDI directory.

Specified by:

getRemoteJNDIName in interface weblogic.management.configuration.ForeignJNDIObjectMBean

Returns:

The remoteJNDIName value

getUsername

public 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

setLocalJNDIName

public void setLocalJNDIName(String name)

Deprecated.

Description copied from interface: weblogic.management.configuration.ForeignJNDIObjectMBean

Sets the value of the LocalJNDIName attribute.

Specified by:

setLocalJNDIName in interface weblogic.management.configuration.ForeignJNDIObjectMBean

Parameters:

name - The new localJNDIName value

See Also:

ForeignJNDIObjectMBean.getLocalJNDIName()

setPassword

public void setPassword(String passwd)

Deprecated.

Sets the value of the Password attribute.

Parameters:

passwd - The new password value

See Also:

getPassword()

setPasswordEncrypted

public void setPasswordEncrypted(byte[] encryptedBytes)

Deprecated.

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

See Also:

getPasswordEncrypted()

setRemoteJNDIName

public void setRemoteJNDIName(String name)

Deprecated.

Description copied from interface: weblogic.management.configuration.ForeignJNDIObjectMBean

Sets the value of the RemoteJNDIName attribute.

Specified by:

setRemoteJNDIName in interface weblogic.management.configuration.ForeignJNDIObjectMBean

Parameters:

name - The new remoteJNDIName value

See Also:

ForeignJNDIObjectMBean.getRemoteJNDIName()

setUsername

public void setUsername(String name)

Deprecated.

Sets the value of the Username attribute.

Parameters:

name - The new username value

See Also:

getUsername()