AMQ Clients 2.3 Release Notes
Release Notes for Red Hat AMQ Clients
Abstract
Chapter 1. Features Copy linkLink copied to clipboard!
- AMQ Clients 2.3 adds support for Microsoft Windows 10 Pro and Windows Server 2016.
- AMQ C++ and AMQ Python can now use a configuration file to control connection behavior.
- This release improves the overall performance of AMQ JMS.
Chapter 2. Enhancements Copy linkLink copied to clipboard!
2.1. AMQ Spring Boot Starter Copy linkLink copied to clipboard!
ENTMQCL-1172 - Spring Boot 2.1.x support
AMQ Spring Boot Starter now supports version 2.1 of the Spring Boot framework.
Chapter 3. Resolved issues Copy linkLink copied to clipboard!
3.1. AMQ C++ Copy linkLink copied to clipboard!
ENTMQCL-1176 - Drain gets stuck on
In earlier releases of the product, in some cases the client library failed to disable drain mode when the drain operation was complete.
In this release, the library stops draining credit when the drain operation ends.
Chapter 4. Known issues Copy linkLink copied to clipboard!
4.1. AMQ Python Copy linkLink copied to clipboard!
ENTMQCL-483 - Selectors fail with non-Unicode strings
The
Selectoroption onContainer.create_receiver()accepts a string. If the string is not supplied as Unicode (in Python 2,u"somestring"), any elements escaped with backslashes might not be processed correctly.Workaround: Users of Python 2 should use an explicit Unicode string in filter declarations to avoid the problem.
ENTMQCL-546 - Transactions introduce unexpected link events
Starting a transaction internally opens a sending link for controlling the transaction. This special link can trigger extra application events.
Workaround: Code using transactions should ensure link handler functions are processing the link they expect.
4.2. AMQ .NET Copy linkLink copied to clipboard!
ENTMQCL-794 - Transactions do not work with .NET Core
Rolling back transactions when using AMQ .NET on .NET Core is not working as expected.
Workaround: Use .NET Framework 4.5 instead of .NET Core if you require transactions.
Chapter 5. Important notes Copy linkLink copied to clipboard!
5.1. AMQ C++ Copy linkLink copied to clipboard!
Unsettled interfaces
The AMQ C++ messaging API includes classes and methods that are not yet proven and can change in future releases. Be aware that use of these interfaces might require changes to your application code in the future.
These interfaces are marked Unsettled API in the API reference. They include the interfaces in the
proton::codecandproton::ionamespaces and the following interfaces in theprotonnamespace.-
listen_handler -
reconnect_options -
ssl_certificate,ssl_client_options, andssl_server_options -
work_queueandwork -
The
on_connection_wakemethod onmessaging_handler -
The
wakemethod onconnection -
The
on_sender_drain_startandon_sender_drain_finishmethods onmessaging_handler -
The
drainingandreturn_creditmethods onsender -
The
draininganddrainmethods onreceiver
API elements present in header files but not yet documented are considered unsettled and are subject to change.
-
Deprecated interfaces
Interfaces marked Deprecated in the API reference are scheduled for removal in a future release.
This release deprecates the following interfaces in the
protonnamespace.-
void_function0- Use theworkclass or C++11 lambdas instead. -
default_container- Use thecontainerclass instead. -
urlandurl_error- Use a third-party URL library instead.
-
5.2. Preferred clients Copy linkLink copied to clipboard!
In general, AMQ clients that support the AMQP 1.0 standard are preferred for new application development. However, the following exceptions apply:
- If your implementation requires distributed transactions, use the AMQ Core Protocol JMS client.
- If you require MQTT or STOMP in your domain (for IoT applications, for instance), use community-supported MQTT or STOMP clients.
The considerations above do not necessarily apply if you are already using:
- The AMQ OpenWire JMS client (the JMS implementation previously provided in A-MQ 6)
- The AMQ Core Protocol JMS client (the JMS implementation previously provided with HornetQ)
5.3. Legacy clients Copy linkLink copied to clipboard!
Deprecation of the CMS and NMS APIs
The ActiveMQ CMS and NMS messaging APIs are deprecated in AMQ 7. It is recommended that users of the CMS API migrate to AMQ C++, and users of the NMS API migrate to AMQ .NET. The CMS and NMS APIs might have reduced functionality in AMQ 7.
Deprecation of the legacy AMQ C++ client
The legacy AMQ C[]+ client (the C+ client previously provided in MRG Messaging) is deprecated in AMQ 7. It is recommended that users of this API migrate to AMQ C++.
The Core API is unsupported
The Artemis Core API client is not supported. This client is distinct from the AMQ Core Protocol JMS client, which is supported.
5.4. Upstream versions Copy linkLink copied to clipboard!
- AMQ C++, AMQ Python, and AMQ Ruby are now based on Qpid Proton 0.27.0
- AMQ JavaScript is now based on Rhea 0.3.9
- AMQ JMS is now based on Qpid JMS 0.40.0
- AMQ .NET is now based on AMQP.Net Lite 2.1.6
Chapter 6. Important links Copy linkLink copied to clipboard!
Revised on 2019-03-18 15:33:45 UTC