TopicConnectionFactory (Java EE 5)

TopicConnectionFactory 可用于创建 TopicConnection，可以从 TopicConnection 中创建专门的与主题有关的对象。一种更常用且建议采用的方法是使用 ConnectionFactory 对象。

应该使用 TopicConnectionFactory 对象支持现有代码。

A client uses a TopicConnectionFactory object to create TopicConnection objects with a publish/subscribe JMS provider.

A TopicConnectionFactory can be used to create a TopicConnection, from which specialized topic-related objects can be created. A more general, and recommended approach is to use the ConnectionFactory object.

The TopicConnectionFactory object should be used to support existing code.

Version:

1.1 - February 2, 2002

Author:

Mark Hapner, Rich Burridge, Kate Stout

See Also:

ConnectionFactory

public TopicConnection createTopicConnection() throws JMSException
创建带有默认用户身份的主题连接。以停止模式创建连接。在显式调用 Connection.start 方法前，不会传送任何消息。

return	新建的主题连接
Throws	JMSException: 如果 JMS 提供者由于某个内部错误无法创建主题连接。
Throws	JMSSecurityException: 如果客户端验证由于无效用户名或密码失败。

英文文档：

createTopicConnection

TopicConnection createTopicConnection()
                                      throws JMSException

Creates a topic connection with the default user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

public TopicConnection createTopicConnection(String userName, String password) throws JMSException
创建带有指定用户身份的主题连接。以停止模式创建连接。在显式调用 Connection.start 方法前，不会传送任何消息。

userName	调用者的用户名
password	调用者的密码
return	新建的主题连接
Throws	JMSException: 如果 JMS 提供者由于某个内部错误无法创建主题连接。
Throws	JMSSecurityException: 如果客户端验证由于无效用户名或密码失败。

英文文档：

createTopicConnection

TopicConnection createTopicConnection(String userName,
                                      String password)
                                      throws JMSException

Creates a topic connection with the specified user identity. The connection is created in stopped mode. No messages will be delivered until the Connection.start method is explicitly called.

Parameters:

userName - the caller's user name

password - the caller's password

Returns:

a newly created topic connection

Throws:

JMSException - if the JMS provider fails to create a topic connection due to some internal error.

JMSSecurityException - if client authentication fails due to an invalid user name or password.

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.