当前页面: 在线文档首页 > Java Platform, Enterprise Edition v5.0 API Specifications

TopicConnectionFactory (Java EE 5 SDK) - Java Platform, Enterprise Edition v5.0 API Specifications

Overview  Package   Class  Tree  Deprecated  Index  Help		Java EE 5 SDK
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

javax.jms
Interface TopicConnectionFactory

All Superinterfaces:

ConnectionFactory

All Known Subinterfaces:

XATopicConnectionFactory

---

public interface TopicConnectionFactory
extends ConnectionFactory

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

---

Method Summary
TopicConnection	createTopicConnection()           Creates a topic connection with the default user identity.
TopicConnection	createTopicConnection(String userName, String password)           Creates a topic connection with the specified user identity.

 

Methods inherited from interface javax.jms.ConnectionFactory
createConnection, createConnection

 

Method Detail

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.

---

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.

---

Overview  Package   Class  Tree  Deprecated  Index  Help		Java EE 5 SDK
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature

Copyright 2006 Sun Microsystems, Inc. All rights reserved.