// Copyright 2018 The Nomulus Authors. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. package google.registry.proxy; import static com.google.common.truth.Truth.assertThat; import static google.registry.proxy.TestUtils.assertHttpRequestEquivalent; import static google.registry.proxy.TestUtils.assertHttpResponseEquivalent; import static google.registry.proxy.TestUtils.makeHttpGetRequest; import static google.registry.proxy.TestUtils.makeHttpResponse; import io.netty.buffer.ByteBuf; import io.netty.channel.embedded.EmbeddedChannel; import io.netty.handler.codec.http.DefaultHttpRequest; import io.netty.handler.codec.http.FullHttpRequest; import io.netty.handler.codec.http.FullHttpResponse; import io.netty.handler.codec.http.HttpClientCodec; import io.netty.handler.codec.http.HttpObjectAggregator; import io.netty.handler.codec.http.HttpResponseStatus; import org.junit.Test; import org.junit.runner.RunWith; import org.junit.runners.JUnit4; /** * End-to-end tests for {@link WebWhoisProtocolsModule}. * *
This protocol defines a connection in which the proxy behaves as a standard http server (sans * the redirect operation which is excluded in end-to-end testing). Because non user-defined * handlers are used, the tests here focus on verifying that the request written to the network * socket by a client is reconstructed faithfully by the server, and vice versa, that the response a * client decoded from incoming bytes is equivalent to the response sent by the server. * *
These tests only ensure that the server represented by this protocol is compatible with a * client implementation provided by Netty itself. They test the self-consistency of various Netty * handlers that deal with HTTP protocol, but not whether the handlers converts between bytes and * HTTP messages correctly, which is presumed correct. * *
Only the HTTP redirect protocol is tested as both protocols share the same handlers except for * those that are excluded ({@code SslServerInitializer}, {@code WebWhoisRedirectHandler}). */ @RunWith(JUnit4.class) public class WebWhoisProtocolsModuleTest extends ProtocolModuleTest { private static final String HOST = "test.tld"; private static final String PATH = "/path/to/test"; private final EmbeddedChannel clientChannel = new EmbeddedChannel(new HttpClientCodec(), new HttpObjectAggregator(512 * 1024)); public WebWhoisProtocolsModuleTest() { super(TestComponent::httpWhoisHandlers); } /** * Tests that the client converts given {@link FullHttpRequest} to bytes, which is sent to the * server and reconstructed to a {@link FullHttpRequest} that is equivalent to the original. Then * test that the server converts given {@link FullHttpResponse} to bytes, which is sent to the * client and reconstructed to a {@link FullHttpResponse} that is equivalent to the original. * *
The request and response equivalences are tested in the same method because the client codec * tries to pair the response it receives with the request it sends. Receiving a response without * sending a request first will cause the {@link HttpObjectAggregator} to fail to aggregate * properly. */ private void requestAndRespondWithStatus(HttpResponseStatus status) { ByteBuf buffer; FullHttpRequest requestSent = makeHttpGetRequest(HOST, PATH); // Need to send a copy as the content read index will advance after the request is written to // the outbound of client channel, making comparison with requestReceived fail. assertThat(clientChannel.writeOutbound(requestSent.copy())).isTrue(); buffer = clientChannel.readOutbound(); assertThat(channel.writeInbound(buffer)).isTrue(); // We only have a DefaultHttpRequest, not a FullHttpRequest because there is no HTTP aggregator // in the server's pipeline. But it is fine as we are not interested in the content (payload) of // the request, just its headers, which are contained in the DefaultHttpRequest. DefaultHttpRequest requestReceived = channel.readInbound(); // Verify that the request received is the same as the request sent. assertHttpRequestEquivalent(requestSent, requestReceived); FullHttpResponse responseSent = makeHttpResponse(status); assertThat(channel.writeOutbound(responseSent.copy())).isTrue(); buffer = channel.readOutbound(); assertThat(clientChannel.writeInbound(buffer)).isTrue(); FullHttpResponse responseReceived = clientChannel.readInbound(); // Verify that the request received is the same as the request sent. assertHttpResponseEquivalent(responseSent, responseReceived); } @Test public void testSuccess_OkResponse() { requestAndRespondWithStatus(HttpResponseStatus.OK); } @Test public void testSuccess_NonOkResponse() { requestAndRespondWithStatus(HttpResponseStatus.BAD_REQUEST); } }