[PROTON-2547] [protonj2] Add a nextReceiver API for multiple receiver polling

• Type: New Feature
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: protonj2-1.0.0-M5
• Fix Version/s: protonj2-1.0.0-M6
• Component/s: protonj2
• Assignee: Timothy A. Bish
• Reporter: Timothy A. Bish
• Created: 18/May/22 20:43
• Updated: 18/May/22 21:28
• Resolved: 18/May/22 21:28

Description

Add a new API to Connection and Session that allows a caller to poll for the next receiver in a session that has a pending delivery or wait on one to arrive.

Basic code example:

try (Connection connection = client.connect(serverHost, serverPort, options)) {    
    connection.openReceiver(address1);
    connection.openReceiver(address2);                    

    final Delivery delivery1 = connection.nextReceiver().receive();

    ...
}