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