会话
当建立一个上下文（Context）时，可以在该上下文中创建一个或多个会话（Session）。会话创建一个单一的客户端连接到事件代理，用于发送和接收消息。
会话提供以下主要服务：
- 客户端连接
- 更新和检索会话属性
- 检索会话统计信息
- 添加和移除订阅
- 创建目的地和端点
- 发布和接收直接消息
- 发布保证消息
- 发送请求/回复（或为 JCSMP 创建请求者）
- 创建保证消息流以接收保证消息
- 创建浏览器（仅限 JCSMP 和 .NET API）
- 创建缓存会话
在配置会话时，必须提供以下内容：
- 会话属性，用于定义客户端连接到事件代理的操作特性。
- 接收直接消息的消息回调。
- 会话事件的事件处理回调（对于 JCSMP 是可选的）。
| PubSub+ 消息 API | 使用 |
|---|---|
| JCSMP | com.solacesystems.jcsmp.JCSMPSession |
| Java RTO | com.solacesystems.solclientj.core.handle.SessionHandle |
| C | solClient_opaqueSession_pt |
| solClient_session_create(...) | |
| .NET | SolaceSystems.Solclient.Messaging.ISession |
| JavaScript 和 Node.js | solace.Session |
会话 API
下图显示了依赖于会话的一些基本处理组件。
会话及其聚合
句柄
句柄在 Java RTO API 中使用。Java RTO API 是 Java Native Interface (JNI) 包装的 C 的实现，本质上是 C API 的面向对象抽象。
句柄是一个 Java 接口，表示一个 C 对象。句柄由 Solclient.Allocator 创建，并在创建时未绑定（不与任何 C 对象关联）。通过 Java RTO API，句柄可以绑定到（与）一个 C 对象。
当句柄绑定到一个 C 对象时，可以通过 Java RTO API 操作该 C 对象。
句柄在其类名后附加了 Handle ，例如 ContextHandle 或 MessageHandle。