KMTopicConnectionFactory Class Reference
Inherits from | KMConnectionFactory : KCObject : NSObject |
Declared in | KMTopicConnectionFactory.h |
Overview
A client uses a TopicConnectionFactory object to create TopicConnection objects with a publish/subscribe JMS provider.
KMTopicConnectionFactory is a JMS 1.0 API. KMConnectionFactory should be used instead.
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.
Warning: Use KMStompConnectionFactory to create JMS Connections.
Tasks
-
– createTopicConnection
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.
-
– createTopicConnection:password:
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.
Instance Methods
createTopicConnection
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.
- (KMTopicConnection *)createTopicConnection
Return Value
a newly created topic connection
Exceptions
- KMJMSException
if the JMS provider fails to create a topic connection due to some internal error.
- KMJMSSecurityException
if client authentication fails due to an invalid user name or password.
Declared In
KMTopicConnectionFactory.h
createTopicConnection:password:
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.
- (TopicConnection *)createTopicConnection:(NSString *)userName password:(NSString *)password
Parameters
- userName
the caller’s user name
- password
the caller’s password
Return Value
a newly created topic connection
Exceptions
- KMJMSException
if the JMS provider fails to create a topic connection due to some internal error.
- KMJMSSecurityException
if client authentication fails due to an invalid user name or password.
Declared In
KMTopicConnectionFactory.h