Jetty-6 Notes for Benjy's Guide for Constructing CD-Based Dynamic Web Sites

These notes refer to Benjy's Guide for Constructing CD-Based Dynamic Web Sites, which is a cookbook for creating a dynamic servlet and/or JSP site that runs from a CD. I used Jetty-5 for the examples on that page; however, if you use Jetty-6, you'll need to modify the cookbook steps. Here are my notes for using Jetty-6:

The stop servlet for Jetty-5 will not work with Jetty-6. There is no HttpServer object in Jetty-6 for gaining access to Jetty servers from a servlet. The new approach uses the Jetty control port feature. Jetty is started with "-DSTOP.PORT=8079 -DSTOP.KEY=stopJetty" arguments, which causes Jetty to listen to TCP port 8087 for a stop command that uses the key "stopJetty". The new stop servlet sends the stop sequence to Jetty, which then shuts down.

package com.benjysbrain.servlet ;

import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.* ;
import java.util.* ;
import java.io.BufferedReader;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.InetAddress;
import java.net.Socket;

// Copyright (c) 2006 by Ben E. Cline. All rights reserved.

/**
  Shutdown Jetty.  This version tailored for Jetty 6.  Start Jetty
  with -DSTOP.PORT=8079 -DSTOP.KEY=stopJetty.
*/

public class stop extends HttpServlet {
   public final static int _port=8079 ;
   public final static String _key = "stopJetty" ;  // Not very secret.

   public void doPost(HttpServletRequest request, 
		      HttpServletResponse response) throws ServletException, 
							   IOException {
      response.setContentType("text/html") ;
      PrintWriter out = response.getWriter() ;
      out.println("<HTML><HEAD><TITLE>Stop</TITLE></HEAD><BODY>") ;
      out.println("<h2>Stopping Jetty</h2>") ;
      out.println("</body></html>") ;
      out.close() ;

      // From org.mortbay.start.  Send key and stop message to control
      // port.

      try {
	 Socket s=new Socket(InetAddress.getByName("127.0.0.1"),_port);
	 OutputStream outStream=s.getOutputStream();
	 outStream.write((_key+"\r\nstop\r\n").getBytes());
	 outStream.flush();
	 s.close();
      }
      catch (Exception e) {
	 e.printStackTrace();
      }   
   }
}

Here's a startup run.bat replacement. See the "Autorun files" section of the main cookbook.

ECHO OFF

cd jetty-6.0.2
start ..\jre1.5.0_03\bin\javaw -DSTOP.PORT=8079 -DSTOP.KEY=stopJetty -jar start.jar etc/cd.xml

At least under Windows XP, Jetty-6 compiles JSP files to temporary space instead of the Jetty-5/work directory. So you can test your dynamic site CD without precompiling JSP files. However, the overhead in compiling each JSP file into a servlet each time your users start the CD can slow your site down. So precompiling seems like a reasonable thing to do for production versions of your site. See the next item for details.
Precompiling JSP files under Jetty-6 requires a different set of library files than under Jetty-5. I suggest including the following .jar files in your CLASSPATH when you precompile:
From the Jetty 6 lib/jsp-2.1 directory, include
- jsp-api-2.1.jar
- ant-1.6.5.jar
- core-3.1.1.jar
- jsp-2.1.jar
From the Jetty 6 lib directory, include
- servlet-api-2.5-6.0.2.jar
- jetty-6.0.2.jar
- jetty-util-6.0.2.jar
The version numbers embedded in the jar file names might change with subsequent releases of Jetty.

I want to give a special thanks to Hobi Haque and David Wilson-Burns of After Hours Programmer for inquiring about using Jetty-6 and for the suggestions they made.

This site © copyright 2006 by Ben E. Cline. E-Mail: