oracle.jms

Class AQjmsDestinationFactory

java.lang.Object

oracle.jms.AQjmsDestinationFactory

All Implemented Interfaces:

javax.naming.spi.ObjectFactory

public class AQjmsDestinationFactory
extends java.lang.Object
implements javax.naming.spi.ObjectFactory

This is an Oracle class which implements javax.naming.spi.ObjectFactory. Factory class for producing JMS destination objects

Constructor Summary

Constructors

Constructor and Description
AQjmsDestinationFactory() Creates an AQjmsDestinationFactory object.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	getObjectInstance(java.lang.Object obj, javax.naming.Name name, javax.naming.Context nameCtx, java.util.Hashtable environment) Creates a destination.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AQjmsDestinationFactory

public AQjmsDestinationFactory()

Creates an AQjmsDestinationFactory object.

Method Detail

getObjectInstance

public java.lang.Object getObjectInstance(java.lang.Object obj,
                                          javax.naming.Name name,
                                          javax.naming.Context nameCtx,
                                          java.util.Hashtable environment)
                                   throws JMSException

Creates a destination. The destination is created using destination attributes obtained using name and nameCtx and table attributes obtained using environment.

Specified by:

getObjectInstance in interface javax.naming.spi.ObjectFactory

Parameters:

obj - a javax.naming.Reference indicating the destination class

name - the location containing the destination attributes

nameCtx - a javax.naming.directory.DirContext containing the following destination attributes at the above location:

• AQjmsConstants.LDAP_OWN_ATTR
• AQjmsConstants.LDAP_NAM_ATTR
• AQjmsConstants.LDAP_PTR_ATTR
• AQjmsConstants.LDAP_GEN_ATTR:
  • "queuetype" (AQQueueProperty.NORMAL_QUEUE or AQQueueProperty.EXCEPTION_QUEUE)
  • "maxretries"
  • "retryinterval"
  • "rentention" (retention time)

environment - used to create an InitialDirContext containing the following table attributes at the location indicated by the above AQjmsConstants.LDAP_PTR_ATTR attribute:

• AQjmsConstants.LDAP_NAM_ATTR
• AQjmsConstants.LDAP_GEN_ATTR:
  • "payloadtype"
  • "multiconsumers" (true for a topic, false for a queue)

Returns:

a new destination object, or null if:

• obj is invalid,
• looking up the provided name in the provided nameCtx fails,
• looking up the table attributes with the context created using environment fails, or
• any of the LDAP_*_ATTR attributes are not found

Throws:

JMSException - if a destination is not created for any reason other than those listed above (which result in a null return value).