Chapter 1. Overview
AMQ .NET is a lightweight AMQP 1.0 library for the .NET platform. It enables you to write .NET applications that send and receive AMQP messages.
AMQ .NET is part of AMQ Clients, a suite of messaging libraries supporting multiple languages and platforms. For an overview of the clients, see AMQ Clients Overview. For information about this release, see AMQ Clients 2.8 Release Notes.
AMQ .NET is based on AMQP.Net Lite. For detailed API documentation, see the AMQ .NET API reference.
1.1. Key features
- SSL/TLS for secure communication
- Flexible SASL authentication
- Seamless conversion between AMQP and native data types
- Access to all the features and capabilities of AMQP 1.0
- An integrated development environment with full IntelliSense API documentation
1.2. Supported standards and protocols
AMQ .NET supports the following industry-recognized standards and network protocols:
- Version 1.0 of the Advanced Message Queueing Protocol (AMQP)
- Versions 1.0, 1.1, 1.2, and 1.3 of the Transport Layer Security (TLS) protocol, the successor to SSL
- Simple Authentication and Security Layer (SASL) mechanisms ANONYMOUS, PLAIN, and EXTERNAL
- Modern TCP with IPv6
1.3. Supported configurations
AMQ .NET supports the OS and language versions listed below. For more information, see Red Hat AMQ 7 Supported Configurations.
- Red Hat Enterprise Linux 7 and 8 with .NET Core 3.1
- Microsoft Windows 10 Pro with .NET Core 3.1 or .NET Framework 4.7
- Microsoft Windows Server 2012 R2 and 2016 with .NET Core 3.1 or .NET Framework 4.7
AMQ .NET is supported in combination with the following AMQ components and versions:
- All versions of AMQ Broker
- All versions of AMQ Interconnect
- A-MQ 6 versions 6.2.1 and newer
1.4. Terms and concepts
This section introduces the core API entities and describes how they operate together.
| Entity | Description |
|---|---|
| Connection | A channel for communication between two peers on a network |
| Session | A context for sending and receiving messages |
| Sender link | A channel for sending messages to a target |
| Receiver link | A channel for receiving messages from a source |
| Source | A named point of origin for messages |
| Target | A named destination for messages |
| Message | A mutable holder of application data |
AMQ .NET sends and receives messages. Messages are transferred between connected peers over links. Links are established over sessions. Sessions are established over connections.
A sending peer creates a sender link to send messages. The sender link has a target that identifies a queue or topic at the remote peer. A receiving client creates a receiver link to receive messages. The receiver link has a source that identifies a queue or topic at the remote peer.
1.5. Document conventions
The sudo command
In this document, sudo is used for any command that requires root privileges. Exercise caution when using sudo because any changes can affect the entire system. For more information about sudo, see Using the sudo command.
File paths
In this document, all file paths are valid for Linux, UNIX, and similar operating systems (for example, /home/andrea). On Microsoft Windows, you must use the equivalent Windows paths (for example, C:\Users\andrea).
Variable text
This document contains code blocks with variables that you must replace with values specific to your environment. Variable text is enclosed in arrow braces and styled as italic monospace. For example, in the following command, replace <project-dir> with the value for your environment:
$ cd <project-dir>