Issue #4502 - add onClose tests for Jetty and Javax WS APIs

Signed-off-by: Lachlan Roberts <lachlan@webtide.com>

jetty-util/src/main/java/org/eclipse/jetty/util/FutureCallback.java

@@ -163,9 +163,7 @@ public void block(long timeout, TimeUnit unit) throws IOException
         {
             Throwable cause = e.getCause();
             if (cause instanceof RuntimeException)
-                throw (RuntimeException)cause;
-            else if (cause instanceof IOException)
-                throw (IOException)cause;
+                throw new RuntimeException(cause);
             else
                 throw new IOException(cause);
         }

jetty-websocket/websocket-javax-tests/src/main/java/org/eclipse/jetty/websocket/javax/tests/EventSocket.java

@@ -50,6 +50,7 @@ public class EventSocket
 
     public CountDownLatch openLatch = new CountDownLatch(1);
     public CountDownLatch closeLatch = new CountDownLatch(1);
+    public CountDownLatch errorLatch = new CountDownLatch(1);
 
     @OnOpen
     public void onOpen(Session session, EndpointConfig endpointConfig)
@@ -85,5 +86,6 @@ public void onError(Throwable cause)
         if (LOG.isDebugEnabled())
             LOG.debug("{}  onError(): {}", toString(), cause);
         error = cause;
+        errorLatch.countDown();
     }
 }

jetty-websocket/websocket-javax-tests/src/test/java/org/eclipse/jetty/websocket/javax/tests/JavaxOnCloseTest.java

@@ -0,0 +1,226 @@
+//
+// ========================================================================
+// Copyright (c) 1995-2020 Mort Bay Consulting Pty Ltd and others.
+//
+// This program and the accompanying materials are made available under
+// the terms of the Eclipse Public License 2.0 which is available at
+// https://www.eclipse.org/legal/epl-2.0
+//
+// This Source Code may also be made available under the following
+// Secondary Licenses when the conditions for such availability set
+// forth in the Eclipse Public License, v. 2.0 are satisfied:
+// the Apache License v2.0 which is available at
+// https://www.apache.org/licenses/LICENSE-2.0
+//
+// SPDX-License-Identifier: EPL-2.0 OR Apache-2.0
+// ========================================================================
+//
+
+package org.eclipse.jetty.websocket.javax.tests;
+
+import java.io.IOException;
+import java.net.URI;
+import java.nio.channels.ClosedChannelException;
+import java.util.Objects;
+import java.util.concurrent.CountDownLatch;
+import java.util.concurrent.TimeUnit;
+import java.util.function.Consumer;
+import javax.websocket.ClientEndpoint;
+import javax.websocket.CloseReason;
+import javax.websocket.CloseReason.CloseCodes;
+import javax.websocket.EndpointConfig;
+import javax.websocket.Session;
+import javax.websocket.server.ServerEndpoint;
+
+import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.server.ServerConnector;
+import org.eclipse.jetty.servlet.ServletContextHandler;
+import org.eclipse.jetty.util.BlockingArrayQueue;
+import org.eclipse.jetty.websocket.javax.client.JavaxWebSocketClientContainer;
+import org.eclipse.jetty.websocket.javax.server.config.JavaxWebSocketServletContainerInitializer;
+import org.junit.jupiter.api.AfterEach;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import static org.hamcrest.MatcherAssert.assertThat;
+import static org.hamcrest.Matchers.containsString;
+import static org.hamcrest.Matchers.instanceOf;
+import static org.hamcrest.Matchers.is;
+import static org.junit.jupiter.api.Assertions.assertDoesNotThrow;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+public class JavaxOnCloseTest
+{
+    private static BlockingArrayQueue<OnCloseEndpoint> serverEndpoints = new BlockingArrayQueue<>();
+
+    private Server server;
+    private ServerConnector connector;
+    private JavaxWebSocketClientContainer client = new JavaxWebSocketClientContainer();
+
+    @ServerEndpoint("/")
+    public static class OnCloseEndpoint extends EventSocket
+    {
+        private Consumer<Session> onClose;
+
+        public void setOnClose(Consumer<Session> onClose)
+        {
+            this.onClose = onClose;
+        }
+
+        @Override
+        public void onOpen(Session session, EndpointConfig endpointConfig)
+        {
+            super.onOpen(session, endpointConfig);
+            serverEndpoints.add(this);
+        }
+
+        @Override
+        public void onClose(CloseReason reason)
+        {
+            super.onClose(reason);
+            onClose.accept(session);
+        }
+    }
+
+    @ClientEndpoint
+    public static class BlockingClientEndpoint extends EventSocket
+    {
+        private CountDownLatch blockInClose = new CountDownLatch(1);
+
+        public void unBlockClose()
+        {
+            blockInClose.countDown();
+        }
+
+        @Override
+        public void onClose(CloseReason reason)
+        {
+            try
+            {
+                blockInClose.await();
+                super.onClose(reason);
+            }
+            catch (InterruptedException e)
+            {
+                throw new RuntimeException(e);
+            }
+        }
+    }
+
+    @BeforeEach
+    public void start() throws Exception
+    {
+        server = new Server();
+        connector = new ServerConnector(server);
+        connector.setPort(0);
+        server.addConnector(connector);
+
+        ServletContextHandler contextHandler = new ServletContextHandler(ServletContextHandler.SESSIONS);
+        contextHandler.setContextPath("/");
+        server.setHandler(contextHandler);
+
+        JavaxWebSocketServletContainerInitializer.configure(contextHandler, ((servletContext, container) ->
+            container.addEndpoint(OnCloseEndpoint.class)));
+
+        client.start();
+        server.start();
+    }
+
+    @AfterEach
+    public void stop() throws Exception
+    {
+        client.stop();
+        server.stop();
+    }
+
+    @Test
+    public void changeStatusCodeInOnClose() throws Exception
+    {
+        EventSocket clientEndpoint = new EventSocket();
+        URI uri = new URI("ws://localhost:" + connector.getLocalPort() + "/");
+        client.connectToServer(clientEndpoint, uri);
+
+        OnCloseEndpoint serverEndpoint = Objects.requireNonNull(serverEndpoints.poll(5, TimeUnit.SECONDS));
+        serverEndpoint.setOnClose((session) -> assertDoesNotThrow(() ->
+                session.close(new CloseReason(CloseCodes.SERVICE_RESTART, "custom close reason"))));
+        assertTrue(serverEndpoint.openLatch.await(5, TimeUnit.SECONDS));
+
+        clientEndpoint.session.close();
+        assertTrue(clientEndpoint.closeLatch.await(5, TimeUnit.SECONDS));
+        assertThat(clientEndpoint.closeReason.getCloseCode(), is(CloseCodes.SERVICE_RESTART));
+        assertThat(clientEndpoint.closeReason.getReasonPhrase(), is("custom close reason"));
+    }
+
+    @Test
+    public void secondCloseFromOnCloseFails() throws Exception
+    {
+        EventSocket clientEndpoint = new EventSocket();
+        URI uri = new URI("ws://localhost:" + connector.getLocalPort() + "/");
+        client.connectToServer(clientEndpoint, uri);
+
+        OnCloseEndpoint serverEndpoint = Objects.requireNonNull(serverEndpoints.poll(5, TimeUnit.SECONDS));
+        assertTrue(serverEndpoint.openLatch.await(5, TimeUnit.SECONDS));
+        serverEndpoint.setOnClose((session) -> assertThrows(ClosedChannelException.class, session::close));
+
+        serverEndpoint.session.close(new CloseReason(CloseCodes.NORMAL_CLOSURE, "first close"));
+        assertTrue(clientEndpoint.closeLatch.await(5, TimeUnit.SECONDS));
+        assertThat(clientEndpoint.closeReason.getCloseCode(), is(CloseCodes.NORMAL_CLOSURE));
+        assertThat(clientEndpoint.closeReason.getReasonPhrase(), is("first close"));
+    }
+
+    @Test
+    public void abnormalStatusDoesNotChange() throws Exception
+    {
+        BlockingClientEndpoint clientEndpoint = new BlockingClientEndpoint();
+        URI uri = new URI("ws://localhost:" + connector.getLocalPort() + "/");
+        client.connectToServer(clientEndpoint, uri);
+
+        OnCloseEndpoint serverEndpoint = Objects.requireNonNull(serverEndpoints.poll(5, TimeUnit.SECONDS));
+        assertTrue(serverEndpoint.openLatch.await(5, TimeUnit.SECONDS));
+        serverEndpoint.setOnClose((session) ->
+        {
+            assertThrows(ClosedChannelException.class,
+                () -> session.close(new CloseReason(CloseCodes.UNEXPECTED_CONDITION, "abnormal close 2")));
+            clientEndpoint.unBlockClose();
+        });
+
+        serverEndpoint.session.close(new CloseReason(CloseCodes.PROTOCOL_ERROR, "abnormal close 1"));
+        assertTrue(clientEndpoint.closeLatch.await(5, TimeUnit.SECONDS));
+        assertThat(clientEndpoint.closeReason.getCloseCode(), is(CloseCodes.PROTOCOL_ERROR));
+        assertThat(clientEndpoint.closeReason.getReasonPhrase(), is("abnormal close 1"));
+    }
+
+    @Test
+    public void onErrorOccurringAfterOnClose() throws Exception
+    {
+        EventSocket clientEndpoint = new EventSocket();
+        URI uri = new URI("ws://localhost:" + connector.getLocalPort() + "/");
+        client.connectToServer(clientEndpoint, uri);
+
+        OnCloseEndpoint serverEndpoint = Objects.requireNonNull(serverEndpoints.poll(5, TimeUnit.SECONDS));
+        assertTrue(serverEndpoint.openLatch.await(5, TimeUnit.SECONDS));
+        serverEndpoint.setOnClose((session) ->
+        {
+            throw new RuntimeException("trigger onError from onClose");
+        });
+
+        try
+        {
+            clientEndpoint.session.close();
+        }
+        catch (IOException e)
+        {
+            // Ignore. This only occurs in the rare case where the
+            // close response is received while we are still sending the message.
+        }
+
+        assertTrue(clientEndpoint.closeLatch.await(5, TimeUnit.SECONDS));
+        assertThat(clientEndpoint.closeReason.getCloseCode(), is(CloseCodes.UNEXPECTED_CONDITION));
+        assertThat(clientEndpoint.closeReason.getReasonPhrase(), containsString("trigger onError from onClose"));
+
+        assertTrue(serverEndpoint.errorLatch.await(5, TimeUnit.SECONDS));
+        assertThat(serverEndpoint.error, instanceOf(RuntimeException.class));
+        assertThat(serverEndpoint.error.getMessage(), containsString("trigger onError from onClose"));
+    }
+}