azure-sdk-for-cpp/sdk/core/azure-core-amqp
Anton Kolesnyk ec220be784
Shorten build-time paths when building in vcpkg (#4977)
* Shorten build-time paths when building in vcpkg

* if-guard

---------

Co-authored-by: Anton Kolesnyk <antkmsft@users.noreply.github.com>
2023-09-25 09:30:00 -07:00
..
inc Enable partial reads on EventHubs. (#4950) 2023-09-21 15:36:54 -07:00
samples AMQP Stack polls for operations in a background thread. (#4914) 2023-09-13 11:12:46 -07:00
src Enable partial reads on EventHubs. (#4950) 2023-09-21 15:36:54 -07:00
test Enable partial reads on EventHubs. (#4950) 2023-09-21 15:36:54 -07:00
vcpkg Shorten build-time paths when building in vcpkg (#4977) 2023-09-25 09:30:00 -07:00
cgmanifest.json
CHANGELOG.md Enable partial reads on EventHubs. (#4950) 2023-09-21 15:36:54 -07:00
CMakeLists.txt AMQP Stack polls for operations in a background thread. (#4914) 2023-09-13 11:12:46 -07:00
cspell.json
NOTICE.txt
README.md Convert most AMQP types to read-only; Significant API surface cleanup. (#4640) 2023-05-26 13:17:09 -07:00
vcpkg.json Update vcpkg baseline (#4772) 2023-07-10 14:22:40 -07:00

Azure SDK AMQP Library for C++

Azure::Core::Amqp (azure-core-amqp) provides an implementation to enable developers to create Azure SDKs which consume the AMQP protocol. Note that this is NOT a general purpose AMQP library, it is intended solely for the purposes of building Azure C++ SDK clients which communicate with Azure services over AMQP.

Getting started

Include the package

The easiest way to acquire the AMQP library is leveraging vcpkg package manager. See the corresponding Azure SDK for C++ readme section.

To install Azure Core AMQP package via vcpkg:

> vcpkg install azure-core-amqp-cpp

Then, use in your CMake file:

find_package(azure-core-amqp-cpp CONFIG REQUIRED)
target_link_libraries(<your project name> PRIVATE Azure::azure-core-amqp)

Key concepts

The AMQP Protocol is a relatively complicated protocol which is used by Azure services to communicate with clients. This library provides a set of classes which can be used to build Azure SDK clients which communicate with Azure services over AMQP.

The AMQP library provides the following classes:

  • AmqpClient - The basic client used to communicate with the AMQP server.
  • MessageSender - A class which is used to send messages to an AMQP server.
  • MessageReceiver - A class which is used to receive messages from an AMQP server.

Examples

Next steps

You can build and run the tests locally by executing azure-core-amqp-test. Explore the test folder to see advanced usage and behavior of the public classes.

Troubleshooting

If you run into issues while using this library, please feel free to file an issue.

Reporting security issues and security bugs

Security issues and bugs should be reported privately, via email, to the Microsoft Security Response Center (MSRC) secure@microsoft.com. You should receive a response within 24 hours. If for some reason you do not, please follow up via email to ensure we received your original message. Further information, including the MSRC PGP key, can be found in the Security TechCenter.

License

Azure SDK for C++ is licensed under the MIT license.

Impressions