XMSFactoryFactory

If an application is not using administered objects, use this class to create connection factories, queues, and topics.

    Inheritance hierarchy:
    None

Parent topic: .NET interfaces


.NET properties

    Summary of .NET properties:

    .NET property Description
    MetaData Get the metadata that is appropriate to the connection type of the XMSFactoryFactory object.


Metadata - Retrieve metadata

    Interface:
    IConnectionMetaData MetaData

Get the metadata that is appropriate to the connection type of the XMSFactoryFactory object.

    Exceptions:
    None


Methods

    Summary of methods:

    Method Description
    CreateConnectionFactory Create a ConnectionFactory object of the declared type.
    CreateQueue Create a Destination object to represent a queue in the messaging server.
    CreateTopic Create a Destination object to represent a topic.
    GetInstance Create an instance of XMSFactoryFactory. An XMS application uses an XMSFactoryFactory object to get a reference to a ConnectionFactory object that is appropriate to the required type of protocol. This ConnectionFactory object can then produce connections for that protocol type only.


CreateConnectionFactory - Create Connection Factory

    Interface:
    IConnectionFactory CreateConnectionFactory();

Create a ConnectionFactory object of the declared type.

    Parameters:
    None

    Returns:
    The ConnectionFactory object.

    Exceptions:

    • XMSException


CreateQueue - Create Queue

    Interface:
    IDestination CreateQueue(String name);

Create a Destination object to represent a queue in the messaging server.

This method does not create the queue in the messaging server. We must create the queue before an application can call this method.

    Parameters:

      name (input)
      A String object encapsulating the name of the queue, or encapsulating a uniform resource identifier (URI) that identifies the queue.

    Returns:
    The Destination object representing the queue.

    Exceptions:

    • XMSException


CreateTopic - Create Topic

    Interface:
    IDestination CreateTopic(String name);

Create a Destination object to represent a topic.

    Parameters:

      name (input)
      A String object encapsulating the name of the topic, or encapsulating a uniform resource identifier (URI) that identifies the topic.

    Returns:
    The Destination object representing the topic.

    Exceptions:

    • XMSException


GetInstance - Get an instance of XMSFactoryFactory

    Interface:
    static XMSFactoryFactory GetInstance(int connectionType);

Create an instance of XMSFactoryFactory. An XMS application uses an XMSFactoryFactory object to get a reference to a ConnectionFactory object that is appropriate to the required type of protocol. This ConnectionFactory object can then produce connections for that protocol type only.

    Parameters:

      connectionType (input)
      The type of connection for which the ConnectionFactory object produces connections:

      • XMSC.CT_WPM
      • XMSC.CT_RTT
      • XMSC.CT_WMQ

    Returns:
    The XMSFactoryFactory object dedicated to the declared connection type.

    Exceptions:

    • NotSupportedException