Types & Errors

Java messages are immutable builder types (EventMessage, QueueMessage, CommandMessage, etc.). Responses map to EventSendResult, QueuesPollResponse, CommandResponseMessage, and QueryResponseMessage.

Exception hierarchy

KubeMQException
  ├── ConnectionException (retryable)
  ├── KubeMQTimeoutException (retryable)
  ├── AuthenticationException (non-retryable)
  ├── AuthorizationException (non-retryable)
  ├── ValidationException (non-retryable)
  └── GRPCException (varies)

Error codes

Use ErrorCode on KubeMQException for structured handling. Retryable exceptions are safe to retry with exponential backoff when the underlying operation is idempotent.

Performance tips

1. Reuse client instances — one client per pattern handles all channels
2. Use batch APIs for high-throughput queue workloads
3. Do not block subscription callbacks — offload heavy work to executors
4. Close clients when done — all classes implement AutoCloseable

Resources

• GitHub Repository
• Maven Central
• Javadoc
• Examples

See Also

• Java SDK Getting Started