fix(client): add missing recover() restriction check in CompletionListener callback

Author: jeanouii

activemq-client/src/main/java/org/apache/activemq/ActiveMQSession.java

@@ -845,6 +845,7 @@ public boolean isClosed() {
     public void recover() throws JMSException {
 
         checkClosed();
+        checkNotInCompletionListenerCallback("recover");
         if (getTransacted()) {
             throw new IllegalStateException("This session is transacted");
         }

activemq-unit-tests/src/test/java/org/apache/activemq/jms2/ActiveMQJMS2ContextTest.java

@@ -23,6 +23,7 @@
 import static org.junit.Assert.fail;
 
 import java.util.Enumeration;
+import java.util.concurrent.atomic.AtomicReference;
 
 import jakarta.jms.CompletionListener;
 import jakarta.jms.Destination;
@@ -316,6 +317,34 @@ public void testProducerSendDestinationMessageQosParamsCompletionListener() thro
          messageProducer.send(session.createQueue(methodNameDestinationName), null, 1, 4, 0l, null);
     }
 
+    /**
+     * Jakarta Messaging 3.1 spec section 7.3.8: calling recover() from within a CompletionListener
+     * callback must throw IllegalStateException.
+     */
+    @Test
+    public void testRecoverThrowsIllegalStateFromCompletionListenerCallback() throws JMSException {
+        final AtomicReference<Exception> callbackException = new AtomicReference<>();
+
+        messageProducer.send(session.createTextMessage("test"), new CompletionListener() {
+            @Override
+            public void onCompletion(final Message message) {
+                try {
+                    session.recover();
+                } catch (final Exception e) {
+                    callbackException.set(e);
+                }
+            }
+
+            @Override
+            public void onException(final Message message, final Exception exception) {
+            }
+        });
+
+        assertNotNull("recover() must throw from within CompletionListener callback", callbackException.get());
+        assertTrue("recover() must throw IllegalStateException from within CompletionListener callback",
+                callbackException.get() instanceof jakarta.jms.IllegalStateException);
+    }
+
     protected static void sendMessage(JMSContext jmsContext, Destination testDestination, String textBody) {
         assertNotNull(jmsContext);
         JMSProducer jmsProducer = jmsContext.createProducer();