java.lang.Object | |
↳ | org.springframework.jms.connection.UserCredentialsConnectionFactoryAdapter |
An adapter for a target JMS javax.jms.ConnectionFactory, applying the
given user credentials to every standard createConnection()
call,
that is, implicitly invoking createConnection(username, password)
on the target. All other methods simply delegate to the corresponding methods
of the target ConnectionFactory.
Can be used to proxy a target JNDI ConnectionFactory that does not have user
credentials configured. Client code can work with the ConnectionFactory without
passing in username and password on every createConnection()
call.
In the following example, client code can simply transparently work with the preconfigured "myConnectionFactory", implicitly accessing "myTargetConnectionFactory" with the specified user credentials.
<bean id="myTargetConnectionFactory" class="org.springframework.jndi.JndiObjectFactoryBean"> <property name="jndiName" value="java:comp/env/jms/mycf"/> </bean> <bean id="myConnectionFactory" class="org.springframework.jms.connection.UserCredentialsConnectionFactoryAdapter"> <property name="targetConnectionFactory" ref="myTargetConnectionFactory"/> <property name="username" value="myusername"/> <property name="password" value="mypassword"/> </bean>
If the "username" is empty, this proxy will simply delegate to the standard
createConnection()
method of the target ConnectionFactory.
This can be used to keep a UserCredentialsConnectionFactoryAdapter bean
definition just for the option of implicitly passing in user credentials
if the particular target ConnectionFactory requires it.
Public Constructors | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Invoked by a BeanFactory after it has set all bean properties supplied
(and satisfied BeanFactoryAware and ApplicationContextAware).
| |||||||||||
Delegate the call straight to the target ConnectionFactory.
| |||||||||||
Determine whether there are currently thread-bound credentials,
using them if available, falling back to the statically specified
username and password (i.e.
| |||||||||||
Delegate the call straight to the target QueueConnectionFactory.
| |||||||||||
Determine whether there are currently thread-bound credentials,
using them if available, falling back to the statically specified
username and password (i.e.
| |||||||||||
Delegate the call straight to the target TopicConnectionFactory.
| |||||||||||
Determine whether there are currently thread-bound credentials,
using them if available, falling back to the statically specified
username and password (i.e.
| |||||||||||
Remove any user credentials for this proxy from the current thread.
| |||||||||||
Set user credententials for this proxy and the current thread.
| |||||||||||
Set the password that this adapter should use for retrieving Connections.
| |||||||||||
Set the target ConnectionFactory that this ConnectionFactory should delegate to.
| |||||||||||
Set the username that this adapter should use for retrieving Connections.
|
Protected Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
This implementation delegates to the
createConnection(username, password)
method of the target ConnectionFactory, passing in the specified user credentials. | |||||||||||
This implementation delegates to the
createQueueConnection(username, password)
method of the target QueueConnectionFactory, passing in the specified user credentials. | |||||||||||
This implementation delegates to the
createTopicConnection(username, password)
method of the target TopicConnectionFactory, passing in the specified user credentials. |
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
| |||||||||||
From interface
org.springframework.beans.factory.InitializingBean
|
Invoked by a BeanFactory after it has set all bean properties supplied (and satisfied BeanFactoryAware and ApplicationContextAware).
This method allows the bean instance to perform initialization only possible when all bean properties have been set and to throw an exception in the event of misconfiguration.
Delegate the call straight to the target ConnectionFactory.
JMSException |
---|
Determine whether there are currently thread-bound credentials, using them if available, falling back to the statically specified username and password (i.e. values of the bean properties) else.
JMSException |
---|
Delegate the call straight to the target QueueConnectionFactory.
JMSException |
---|
Determine whether there are currently thread-bound credentials, using them if available, falling back to the statically specified username and password (i.e. values of the bean properties) else.
JMSException |
---|
Delegate the call straight to the target TopicConnectionFactory.
JMSException |
---|
Determine whether there are currently thread-bound credentials, using them if available, falling back to the statically specified username and password (i.e. values of the bean properties) else.
JMSException |
---|
Remove any user credentials for this proxy from the current thread. Statically specified user credentials apply again afterwards.
Set user credententials for this proxy and the current thread.
The given username and password will be applied to all subsequent
createConnection()
calls on this ConnectionFactory proxy.
This will override any statically specified user credentials, that is, values of the "username" and "password" bean properties.
username | the username to apply |
---|---|
password | the password to apply |
Set the password that this adapter should use for retrieving Connections. Default is no specific password.
Set the target ConnectionFactory that this ConnectionFactory should delegate to.
Set the username that this adapter should use for retrieving Connections. Default is no specific user.
This implementation delegates to the createConnection(username, password)
method of the target ConnectionFactory, passing in the specified user credentials.
If the specified username is empty, it will simply delegate to the standard
createConnection()
method of the target ConnectionFactory.
username | the username to use |
---|---|
password | the password to use |
JMSException |
---|
This implementation delegates to the createQueueConnection(username, password)
method of the target QueueConnectionFactory, passing in the specified user credentials.
If the specified username is empty, it will simply delegate to the standard
createQueueConnection()
method of the target ConnectionFactory.
username | the username to use |
---|---|
password | the password to use |
JMSException |
---|
This implementation delegates to the createTopicConnection(username, password)
method of the target TopicConnectionFactory, passing in the specified user credentials.
If the specified username is empty, it will simply delegate to the standard
createTopicConnection()
method of the target ConnectionFactory.
username | the username to use |
---|---|
password | the password to use |
JMSException |
---|