Inherits from KMConnectionFactory : KCObject : NSObject
Declared in KMQueueConnectionFactory.h

Overview

A client uses a QueueConnectionFactory object to create QueueConnection objects with a point-to-point JMS provider.

KMQueueConnectionFactory is a JMS 1.0 API. KMConnectionFactory should be used instead.

QueueConnectionFactory can be used to create a QueueConnection, from which specialized queue-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

  • – createQueueConnection

    Creates a queue 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.

  • – createQueueConnection:password:

    Creates a queue 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

createQueueConnection

Creates a queue 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.

- (KMQueueConnection *)createQueueConnection

Return Value

a newly created queue connection

Exceptions

KMJMSException

if the JMS provider fails to create the queue connection due to some internal error.

KMJMSSecurityException

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

Declared In

KMQueueConnectionFactory.h

createQueueConnection:password:

Creates a queue 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.

- (KMQueueConnection *)createQueueConnection:(NSString *)userName password:(NSString *)password

Parameters

userName

the caller’s user name

password

the caller’s password

Return Value

a newly created queue connection

Exceptions

KMJMSException

if the JMS provider fails to create the queue connection due to some internal error.

KMJMSSecurityException

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

Declared In

KMQueueConnectionFactory.h