| /** |
| * Licensed to the Apache Software Foundation (ASF) under one |
| * or more contributor license agreements. See the NOTICE file |
| * distributed with this work for additional information |
| * regarding copyright ownership. The ASF licenses this file |
| * to you 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 org.apache.hadoop.http; |
| |
| import org.apache.hadoop.net.NetUtils; |
| import org.apache.hadoop.security.authorize.AccessControlList; |
| import org.junit.Assert; |
| import org.apache.hadoop.conf.Configuration; |
| import org.apache.hadoop.http.HttpServer2.Builder; |
| |
| import java.io.File; |
| import java.io.IOException; |
| import java.io.InputStream; |
| import java.net.HttpURLConnection; |
| import java.net.URI; |
| import java.net.URL; |
| import java.net.MalformedURLException; |
| |
| import javax.servlet.ServletException; |
| import javax.servlet.http.HttpServlet; |
| import javax.servlet.http.HttpServletRequest; |
| import javax.servlet.http.HttpServletResponse; |
| |
| /** |
| * This is a base class for functional tests of the {@link HttpServer2}. |
| * The methods are static for other classes to import statically. |
| */ |
| public class HttpServerFunctionalTest extends Assert { |
| @SuppressWarnings("serial") |
| public static class LongHeaderServlet extends HttpServlet { |
| @Override |
| public void doGet(HttpServletRequest request, |
| HttpServletResponse response |
| ) throws ServletException, IOException { |
| Assert.assertEquals(63 * 1024, request.getHeader("longheader").length()); |
| response.setStatus(HttpServletResponse.SC_OK); |
| } |
| } |
| |
| /** JVM property for the webapp test dir : {@value} */ |
| public static final String TEST_BUILD_WEBAPPS = "test.build.webapps"; |
| /** expected location of the test.build.webapps dir: {@value} */ |
| private static final String BUILD_WEBAPPS_DIR = "build/test/webapps"; |
| |
| /** name of the test webapp: {@value} */ |
| private static final String TEST = "test"; |
| protected static URL baseUrl; |
| |
| /** |
| * Create but do not start the test webapp server. The test webapp dir is |
| * prepared/checked in advance. |
| * |
| * @return the server instance |
| * |
| * @throws IOException if a problem occurs |
| * @throws AssertionError if a condition was not met |
| */ |
| public static HttpServer2 createTestServer() throws IOException { |
| prepareTestWebapp(); |
| return createServer(TEST); |
| } |
| |
| /** |
| * Create but do not start the test webapp server. The test webapp dir is |
| * prepared/checked in advance. |
| * @param conf the server configuration to use |
| * @return the server instance |
| * |
| * @throws IOException if a problem occurs |
| * @throws AssertionError if a condition was not met |
| */ |
| public static HttpServer2 createTestServer(Configuration conf) |
| throws IOException { |
| prepareTestWebapp(); |
| return createServer(TEST, conf); |
| } |
| |
| public static HttpServer2 createTestServer(Configuration conf, AccessControlList adminsAcl) |
| throws IOException { |
| prepareTestWebapp(); |
| return createServer(TEST, conf, adminsAcl); |
| } |
| |
| /** |
| * Create but do not start the test webapp server. The test webapp dir is |
| * prepared/checked in advance. |
| * @param conf the server configuration to use |
| * @return the server instance |
| * |
| * @throws IOException if a problem occurs |
| * @throws AssertionError if a condition was not met |
| */ |
| public static HttpServer2 createTestServer(Configuration conf, |
| String[] pathSpecs) throws IOException { |
| prepareTestWebapp(); |
| return createServer(TEST, conf, pathSpecs); |
| } |
| |
| /** |
| * Prepare the test webapp by creating the directory from the test properties |
| * fail if the directory cannot be created. |
| * @throws AssertionError if a condition was not met |
| */ |
| protected static void prepareTestWebapp() { |
| String webapps = System.getProperty(TEST_BUILD_WEBAPPS, BUILD_WEBAPPS_DIR); |
| File testWebappDir = new File(webapps + |
| File.separatorChar + TEST); |
| try { |
| if (!testWebappDir.exists()) { |
| if (!testWebappDir.mkdirs()) { |
| fail("Test webapp dir " + testWebappDir.getCanonicalPath() |
| + " can not be created"); |
| } |
| } |
| } catch (IOException e) { |
| } |
| } |
| |
| /** |
| * Create an HttpServer instance on the given address for the given webapp |
| * @param host to bind |
| * @param port to bind |
| * @return the server |
| * @throws IOException if it could not be created |
| */ |
| public static HttpServer2 createServer(String host, int port) |
| throws IOException { |
| prepareTestWebapp(); |
| return new HttpServer2.Builder().setName(TEST) |
| .addEndpoint(URI.create("http://" + host + ":" + port)) |
| .setFindPort(true).build(); |
| } |
| |
| /** |
| * Create an HttpServer instance for the given webapp |
| * @param webapp the webapp to work with |
| * @return the server |
| * @throws IOException if it could not be created |
| */ |
| public static HttpServer2 createServer(String webapp) throws IOException { |
| return localServerBuilder(webapp).setFindPort(true).build(); |
| } |
| /** |
| * Create an HttpServer instance for the given webapp |
| * @param webapp the webapp to work with |
| * @param conf the configuration to use for the server |
| * @return the server |
| * @throws IOException if it could not be created |
| */ |
| public static HttpServer2 createServer(String webapp, Configuration conf) |
| throws IOException { |
| return localServerBuilder(webapp).setFindPort(true).setConf(conf).build(); |
| } |
| |
| /** |
| * Create a test server with xFrame options enabled. |
| * @param xFrameEnabled - true to enable xFrameSupport |
| * @param xFrameOptionValue - Option Value |
| * @param conf the configuration to use for the server |
| * @return |
| * @throws IOException |
| */ |
| public static HttpServer2 createServer(boolean xFrameEnabled, |
| String xFrameOptionValue, |
| Configuration conf) |
| throws IOException { |
| return localServerBuilder(TEST).setFindPort(true) |
| .configureXFrame(xFrameEnabled) |
| .setXFrameOption(xFrameOptionValue) |
| .setConf(conf) |
| .build(); |
| } |
| |
| public static HttpServer2 createServer(String webapp, Configuration conf, AccessControlList adminsAcl) |
| throws IOException { |
| return localServerBuilder(webapp).setFindPort(true).setConf(conf).setACL(adminsAcl).build(); |
| } |
| |
| private static Builder localServerBuilder(String webapp) { |
| return new HttpServer2.Builder().setName(webapp).addEndpoint( |
| URI.create("http://localhost:0")); |
| } |
| |
| /** |
| * Create an HttpServer instance for the given webapp |
| * @param webapp the webapp to work with |
| * @param conf the configuration to use for the server |
| * @param pathSpecs the paths specifications the server will service |
| * @return the server |
| * @throws IOException if it could not be created |
| */ |
| public static HttpServer2 createServer(String webapp, Configuration conf, |
| String[] pathSpecs) throws IOException { |
| return localServerBuilder(webapp).setFindPort(true).setConf(conf).setPathSpec(pathSpecs).build(); |
| } |
| |
| /** |
| * Create and start a server with the test webapp |
| * |
| * @return the newly started server |
| * |
| * @throws IOException on any failure |
| * @throws AssertionError if a condition was not met |
| */ |
| public static HttpServer2 createAndStartTestServer() throws IOException { |
| HttpServer2 server = createTestServer(); |
| server.start(); |
| return server; |
| } |
| |
| /** |
| * If the server is non null, stop it |
| * @param server to stop |
| * @throws Exception on any failure |
| */ |
| public static void stop(HttpServer2 server) throws Exception { |
| if (server != null) { |
| server.stop(); |
| } |
| } |
| |
| /** |
| * Pass in a server, return a URL bound to localhost and its port |
| * @param server server |
| * @return a URL bonded to the base of the server |
| * @throws MalformedURLException if the URL cannot be created. |
| */ |
| public static URL getServerURL(HttpServer2 server) |
| throws MalformedURLException { |
| assertNotNull("No server", server); |
| return new URL("http://" |
| + NetUtils.getHostPortString(server.getConnectorAddress(0))); |
| } |
| |
| /** |
| * Read in the content from a URL |
| * @param url URL To read |
| * @return the text from the output |
| * @throws IOException if something went wrong |
| */ |
| protected static String readOutput(URL url) throws IOException { |
| StringBuilder out = new StringBuilder(); |
| InputStream in = url.openConnection().getInputStream(); |
| byte[] buffer = new byte[64 * 1024]; |
| int len = in.read(buffer); |
| while (len > 0) { |
| out.append(new String(buffer, 0, len)); |
| len = in.read(buffer); |
| } |
| return out.toString(); |
| } |
| |
| /** |
| * Test that verifies headers can be up to 64K long. |
| * The test adds a 63K header leaving 1K for other headers. |
| * This is because the header buffer setting is for ALL headers, |
| * names and values included. */ |
| protected void testLongHeader(HttpURLConnection conn) throws IOException { |
| StringBuilder sb = new StringBuilder(); |
| for (int i = 0 ; i < 63 * 1024; i++) { |
| sb.append("a"); |
| } |
| conn.setRequestProperty("longheader", sb.toString()); |
| assertEquals(HttpURLConnection.HTTP_OK, conn.getResponseCode()); |
| } |
| } |