Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Message Queue, v4.5 API Specification
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

## com.sun.messaging
Class ConnectionFactory

    java.lang.Object
      com.sun.messaging.AdministeredObject
          com.sun.messaging.BasicConnectionFactory
              com.sun.messaging.ConnectionFactory

All Implemented Interfaces:
  java.io.Serializable, ConnectionFactory, javax.naming.Referenceable

Direct Known Subclasses:
  QueueConnectionFactory, TopicConnectionFactory, XAConnectionFactory

    public class ConnectionFactory

extends BasicConnectionFactory
implements javax.naming.Referenceable

A `ConnectionFactory` is used to create Connections with the Sun MQ Java Message Service (JMS) provider.

See Also:
  `javax.jms.ConnectionFactory`, `com.sun.messaging.ConnectionConfiguration`, Serialized Form

Field Summary

Fields inherited from class com.sun.messaging.AdministeredObject
`AO_PROPERTY_TYPE_BOOLEAN, AO_PROPERTY_TYPE_INTEGER, AO_PROPERTY_TYPE_LIST, AO_PROPERTY_TYPE_LONG, AO_PROPERTY_TYPE_PROPERTYOWNER, AO_PROPERTY_TYPE_STRING, cachedConfigurationMap, configuration, configurationLabels, configurationTypes, cr, storedVersion, VERSION`

Constructor Summary
`` | `ConnectionFactory()` Constructs a ConnectionFactory with the default configuration.
`protected` | `ConnectionFactory(java.lang.String defaultsBase)` Constructs a ConnectionFactory with the specified configuration.

Method Summary
`QueueConnection` | `createQueueConnection()` Creates a Queue Connection with the default user identity.
`QueueConnection` | `createQueueConnection(java.lang.String username, java.lang.String password)` Creates a Queue Connection with a specified user identity.
`TopicConnection` | `createTopicConnection()` Creates a Topic Connection with the default user identity.
`TopicConnection` | `createTopicConnection(java.lang.String username, java.lang.String password)` Creates a Topic Connection with a specified user identity.
`javax.naming.Reference` | `getReference()` Returns the reference to this object.

Methods inherited from class com.sun.messaging.BasicConnectionFactory
`createConnection, createConnection, getConnectionType, setConnectionType, setDefaultConfiguration, toString`

Methods inherited from class com.sun.messaging.AdministeredObject
`dump, enumeratePropertyNames, getConfiguration, getCurrentConfiguration, getLabelForGroup, getPropertiesForGroup, getProperty, getPropertyForListValue, getPropertyGroups, getPropertyLabel, getPropertyListOtherName, getPropertyListValues, getPropertyType, getPropertyValueForListValue, getStoredVersion, getVERSION, isPropertyDeprecated, isPropertyHidden, isReadOnly, isStoredVersionCompatible, setProperty, setReadOnly`

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

Constructor Detail

### ConnectionFactory

    public ConnectionFactory()

  Constructs a ConnectionFactory with the default configuration.

### ConnectionFactory

    protected ConnectionFactory(java.lang.String defaultsBase)

  Constructs a ConnectionFactory with the specified configuration.

Method Detail

### createQueueConnection

    public QueueConnection createQueueConnection()
                                          throws JMSException

  Creates a Queue Connection with the default user identity. The default user identity is defined by the `ConnectionFactory` properties `imqDefaultUsername` and `imqDefaultPassword`

  Returns:
    a newly created Queue Connection.
  Throws:
    `JMSException` - if a JMS error occurs.
  See Also:
    `ConnectionConfiguration.imqDefaultUsername`, `ConnectionConfiguration.imqDefaultPassword`

### createQueueConnection

    public QueueConnection createQueueConnection(java.lang.String username,
                                                 java.lang.String password)
                                          throws JMSException

  Creates a Queue Connection with a specified user identity.

  Parameters:
    `username` - the caller's user name
    `password` - the caller's password
  Returns:
    a newly created queue connection.
  Throws:
    `JMSException` - if a JMS error occurs.

### createTopicConnection

    public TopicConnection createTopicConnection()
                                          throws JMSException

  Creates a Topic Connection with the default user identity. The default user identity is defined by the `ConnectionFactory` properties `imqDefaultUsername` and `imqDefaultPassword`

  Returns:
    a newly created Topic Connection.
  Throws:
    `JMSException` - if a JMS error occurs.
  See Also:
    `ConnectionConfiguration.imqDefaultUsername`, `ConnectionConfiguration.imqDefaultPassword`

### createTopicConnection

    public TopicConnection createTopicConnection(java.lang.String username,
                                                 java.lang.String password)
                                          throws JMSException

  Creates a Topic Connection with a specified user identity.

  Parameters:
    `username` - the caller's user name
    `password` - the caller's password
  Returns:
    a newly created topic connection.
  Throws:
    `JMSException` - if a JMS error occurs.

### getReference

    public javax.naming.Reference getReference()

  Returns the reference to this object.

  Specified by:
    `getReference` in interface `javax.naming.Referenceable`
  Returns:
    The Reference Object that can be used to reconstruct this object

Overview | Package | Class | Use | Tree | Deprecated | Index | Help
| Message Queue, v4.5 API Specification
PREV CLASS NEXT CLASS | FRAMES NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD

Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved.