* Tests should start the server in their {@code setUp()} method and stop the * server in their {@code tearDown()} method. Only while started the server's * URL and/or port number can be obtained. */ public class AppServer { /** Realm name for the secure access areas. */ public static final String realm = "Secure Area"; /** Username for secured access areas. */ public static final String username = "agitter"; /** Password for {@link #username} in secured access areas. */ public static final String password = "letmein"; static { // Install a logger that throws warning messages. // final String prop = "org.eclipse.jetty.util.log.class"; System.setProperty(prop, RecordingLogger.class.getName()); } private final Server server; private final Connector connector; private final ContextHandlerCollection contexts; private final TestRequestLog log; public AppServer() { connector = new SelectChannelConnector(); connector.setPort(0); try { final InetAddress me = InetAddress.getByName("localhost"); connector.setHost(me.getHostAddress()); } catch (UnknownHostException e) { throw new RuntimeException("Cannot find localhost", e); } // We need a handful of threads in the thread pool, otherwise // our tests will deadlock when they can't open enough requests. // In theory we only need 1 concurrent connection at a time, but // I suspect the JRE isn't doing request pipelining on existing // connections like we want it to. // final QueuedThreadPool pool = new QueuedThreadPool(); pool.setMinThreads(1); pool.setMaxThreads(4); pool.setMaxQueued(8); contexts = new ContextHandlerCollection(); log = new TestRequestLog(); log.setHandler(contexts); server = new Server(); server.setConnectors(new Connector[] { connector }); server.setThreadPool(pool); server.setHandler(log); server.setStopAtShutdown(false); server.setGracefulShutdown(0); } /** * Create a new servlet context within the server. *
* This method should be invoked before the server is started, once for each * context the caller wants to register. * * @param path * path of the context; use "/" for the root context if binding * to the root is desired. * @return the context to add servlets into. */ public ServletContextHandler addContext(String path) { assertNotYetSetUp(); if ("".equals(path)) path = "/"; ServletContextHandler ctx = new ServletContextHandler(); ctx.setContextPath(path); contexts.addHandler(ctx); return ctx; } public ServletContextHandler authBasic(ServletContextHandler ctx) { assertNotYetSetUp(); auth(ctx, new BasicAuthenticator()); return ctx; } private void auth(ServletContextHandler ctx, Authenticator authType) { final String role = "can-access"; MappedLoginService users = new MappedLoginService() { @Override protected UserIdentity loadUser(String who) { return null; } @Override protected void loadUsers() throws IOException { putUser(username, new Password(password), new String[] { role }); } }; ConstraintMapping cm = new ConstraintMapping(); cm.setConstraint(new Constraint()); cm.getConstraint().setAuthenticate(true); cm.getConstraint().setDataConstraint(Constraint.DC_NONE); cm.getConstraint().setRoles(new String[] { role }); cm.setPathSpec("/*"); ConstraintSecurityHandler sec = new ConstraintSecurityHandler(); sec.setStrict(false); sec.setRealmName(realm); sec.setAuthenticator(authType); sec.setLoginService(users); sec.setConstraintMappings(new ConstraintMapping[] { cm }); sec.setHandler(ctx); contexts.removeHandler(ctx); contexts.addHandler(sec); } /** * Start the server on a random local port. * * @throws Exception * the server cannot be started, testing is not possible. */ public void setUp() throws Exception { RecordingLogger.clear(); log.clear(); server.start(); } /** * Shutdown the server. * * @throws Exception * the server refuses to halt, or wasn't running. */ public void tearDown() throws Exception { RecordingLogger.clear(); log.clear(); server.stop(); } /** * Get the URI to reference this server. *
* The returned URI includes the proper host name and port number, but does
* not contain a path.
*
* @return URI to reference this server's root context.
*/
public URI getURI() {
assertAlreadySetUp();
String host = connector.getHost();
if (host.contains(":") && !host.startsWith("["))
host = "[" + host + "]";
final String uri = "http://" + host + ":" + getPort();
try {
return new URI(uri);
} catch (URISyntaxException e) {
throw new RuntimeException("Unexpected URI error on " + uri, e);
}
}
/** @return the local port number the server is listening on. */
public int getPort() {
assertAlreadySetUp();
return ((SelectChannelConnector) connector).getLocalPort();
}
/** @return all requests since the server was started. */
public List