2 Overview of the WebLogic JMS .NET Client

Constants

The Constants family of classes is used to define commonly used constants/enumerations for the API.

ContextFactory

A ContextFactory is used to create contexts, which are network connections from the .NET client to the client host.

IContext

An IContext object represents a network connection from the .NET client to the client host. It is used to lookup destinations and connection factories, and to close the network connection when it is no longer needed.

IConnectionFactory

An IConnectionFactory object encapsulates JMS connection configuration information. A JMS .NET client looks up a connection factory using an IContext object, and then uses it to create an IConnection with a JMS server.

IConnection

An IConnection object is the active connection between the JMS .NET client host and the JMS connection host. Authentication optionally takes place during the creation of the connection. A connection is used to create sessions.

ISession

An ISession object is a single-threaded entity for producing and consuming messages. A session can create and service multiple message producers and consumers.

IDestination

An IDestination object identifies a queue or topic. Queue and topic destinations manage the messages delivered from the point-to-point and pub/sub messaging models, respectively.

ITopic

An ITopic object is pub/sub IDestination that encapsulates a provider-specific topic name. It is the way a client specifies the identity of a topic to JMS API methods. For those methods that use an IDestination as a parameter, an ITopic object may be used as an argument. For example, an ITopic can be used to create an IMessageConsumer and an IMessageProducer by calling:

ISession.CreateConsumer(IDestination destination)
ISession.CreateProducer(IDestination destination)

IQueue

An IQueue object is a point-to-point IDestination that encapsulates a provider-specific queue name. It is the way a client specifies the identity of a queue to JMS API methods.

Since IQueue and ITopic both inherit from IDestination, for those methods that use an IDestination as a parameter, an IQueue object can be used as the argument. For example, an IQueue can be used to create an IMessageConsumer and an IMessageProducer by calling:

ISession.CreateConsumer(IQueue queue)
ISession.CreateProducer(IQueue queue)

IMessageConsumer

A JMS .NET client uses an IMessageConsumer object to receive messages from a destination. An IMessageConsumer object is created by passing an IDestination object to a message-consumer creation method supplied by a session.

IMessageProducer

A JMS .NET client uses an IMessageProducer object to send messages to a destination. An IMessageProducer object is created by passing an IDestination object to a message-producer creation method supplied by a session.

IMessage

The IMessage interface is the root interface of all JMS messages. It defines the message header and the Acknowledge method used for all messages.

JMS messages are composed of the following parts:

Header - All messages support the same set of header fields. Header fields contain values used by both clients and providers to identify and route messages.

Properties - Each message contains a built-in facility for supporting application-defined property values. Properties provide an efficient mechanism for supporting application-defined message filtering.

Body - The JMS API defines several types of message body, which cover the majority of messaging styles currently in use.

IMapMessage

An IMapMessage object is used to send a set of name-value pairs. The names are String objects, and the values are primitive data types in the Java and C# programming languages. The names must have a value that is not null, and not an empty string. The entries can be accessed sequentially or randomly by name. The order of the entries is undefined. IMapMessage inherits from the IMessage interface and adds a message body that contains a map.

IObjectMessage

An IObjectMessage object is used to send a message that contains a serializable object in the Java and C# programming languages. It inherits from the IMessage interface and adds a body containing a single reference to an object. C# objects cannot be read by Java programs, and vice versa. For more information, see Exchanging Messages Between Different Language Environments.

IStreamMessage

An IStreamMessage object is used to send a stream of primitive types in the Java programming language. It is filled and read sequentially. It inherits from the IMessage interface and adds a stream message body. Its methods are based largely on those found in java.io.DataInputStream and java.io.DataOutputStream.

ITextMessage

An ITextMessage object is used to send a message containing a String. It inherits from the IMessage interface and adds a text message body.

IBytesMessage

An IBytesMessage object is used to send a message containing a stream of uninterpreted bytes. It inherits from the IMessage interface and adds a bytes message body. The receiver of the message supplies the interpretation of the bytes.