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

AQjmsDestinationFactory()
Creates an AQjmsDestinationFactory object.

Method Summary

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).