Sessions

When a Context is established, one or more Sessions can be created within that Context. A Session creates a single, client connection to a Solace router for sending and receiving messages.

A Session provides the following primary services:

  • client connection
  • update and retrieve Session properties
  • retrieve Session statistics
  • add and remove subscriptions
  • create destinations and endpoints
  • publish and receive Direct messages
  • publish Guaranteed messages
  • make requests/replies (or create Requestors for the Java API)
  • create Guaranteed message Flows to receive Guaranteed messages
  • create Browsers (for the Java and .NET APIs only)
  • create cache sessions

When configuring a Session, the following must be provided:

  • Session properties to define the operating characteristics of the client connection to the Solace router.
  • A message callback for Direct messages that are received.
  • An event handling callback for events that occur for the Session (optional for the Java API).

Session APIs

Language

API

Java

com.solacesystems.jcsmp.JCSMPSession

Java RTO

com.solacesystems.solclientj.core.
handle.SessionHandle

C

solClient_opaqueSession_pt

solClient_session_create(...)

.NET

SolaceSystems.Solclient.Messaging.
ISession

The figure below shows some of the fundamental processing components that are dependent on a Session.

Session and its Aggregates

Handles

Handles are used in the Java RTO API. The Java RTO API is an implementation of Java Native Interface (JNI)-wrapped C, and is essentially an object-oriented abstraction of the C API.

A Handle is a Java interface representing a C object. Handles are created by Solclient.Allocator and are unbound (not associated with any C object) when created. Handles can be bound to (associated with) a C object through the Java RTO API.

When a Handle is bound to a C object, that C object can be manipulated through the Java RTO API.

Handles have the word Handle appended to their class name, as in ContextHandle or MessageHandle.