import org.eclipse.jetty.server.Handler;
import org.eclipse.jetty.server.Server;
+import org.eclipse.jetty.server.ServerConnector;
import org.eclipse.jetty.server.handler.ContextHandler;
import org.eclipse.jetty.server.handler.HandlerCollection;
import org.eclipse.jetty.util.thread.QueuedThreadPool;
/**
- * An HttpServer built on Jetty
+ * An HttpServer built on Jetty. To use it
+ * <ul>
+ * <li>call getInstance() to create and start the server</li>
+ * <li>call registerHandler to add a handler for a path (below /jalview)</li>
+ * <li>when finished, call removedHandler</li>
+ * </ul>
*
* @author gmcarstairs
* @see http://eclipse.org/jetty/documentation/current/embedding-jetty.html
*/
public class HttpServer
{
- private static final String JALVIEW_PATH = "/jalview";
+ /*
+ * 'context root' - actually just prefixed to the path for each handler for
+ * now - see registerHandler
+ */
+ private static final String JALVIEW_PATH = "jalview";
/*
* Singleton instance of this server
}
/**
- * Start the http server with a default thread pool size of 1
+ * Start the http server
*
* @throws BindException
*/
{
try
{
- // problem: how to both limit thread pool size and
- // pick a random free port - two alternative constructors
- QueuedThreadPool tp = new QueuedThreadPool(1, 1);
- // server = new Server(tp); // ? fails with URI null
- server = new Server(0); // pick a free port number
+ /*
+ * Create a server with a small number of threads; jetty will allocate a
+ * free port
+ */
+ QueuedThreadPool tp = new QueuedThreadPool(4, 1); // max, min
+ server = new Server(tp);
+ // 2 selector threads to handle incoming connections
+ ServerConnector connector = new ServerConnector(server, 0, 2);
+ server.addConnector(connector);
/*
* HttpServer shuts down with Jalview process
/*
* Create a mutable set of handlers (can add handlers while the server is
- * running)
+ * running). Using vanilla handlers here rather than servlets
*/
- // TODO how to combine this with context root "/jalview"
+ // TODO how to properly configure context root "/jalview"
contextHandlers = new HandlerCollection(true);
server.setHandler(contextHandlers);
-
server.start();
+ // System.out.println(String.format(
+ // "HttpServer started with %d threads", server.getThreadPool()
+ // .getThreads()));
contextRoot = server.getURI();
System.out.println("Jalview endpoint " + contextRoot);
} catch (Exception e)
// http://stackoverflow.com/questions/20043097/jetty-9-embedded-adding-handlers-during-runtime
ContextHandler ch = new ContextHandler();
ch.setAllowNullPathInfo(true);
- ch.setContextPath("/" + path);
+ ch.setContextPath("/" + JALVIEW_PATH + "/" + path);
ch.setResourceBase(".");
ch.setClassLoader(Thread.currentThread()
.getContextClassLoader());