Servlet Depuración

Probar/depurar Servlets siempre es un desafío en el proceso de desarrollo. Los Servlets suelen involucrar muchas interacciones cliente/servidor y pueden aparecer errores que son difíciles de reproducir.

Aquí hay algunos consejos y sugerencias que pueden ayudarle a depurar.

System.out.println()

System.out.println() se utiliza como marcador para comprobar si un bloque específico de código se ha ejecutado. También podemos imprimir los valores de las variables. Además:

  • Dado que el objeto System es parte de los objetos centrales de Java, se puede usar en cualquier lugar sin necesidad de instalar clases adicionales. Esto incluye Servlets, JSP, RMI, EJB, Beans y clases ordinarias, así como aplicaciones independientes.
  • A diferencia de detenerse en un punto de interrupción, escribir en System.out no interfiere con el flujo de ejecución normal de la aplicación, lo que lo hace especialmente valioso cuando la temporización es crucial.

A continuación se muestra la sintaxis para usar System.out.println():

System.out.println("Debugging message");

Todos los mensajes generados mediante la sintaxis anterior se registrarán en el archivo de registro del servidor web.

Registro de mensajes

Usar métodos de registro apropiados para registrar todos los mensajes de depuración, advertencia y error es una muy buena idea; se recomienda usarlog4Jpara registrar todos los mensajes.

La API de Servlet también proporciona una forma simple de generar información usando el método log(), como se muestra a continuación:

// 导入必需的 java 库
import java.io.*;
import javax.servlet.*;
import javax.servlet.http.*;

public class ContextLog extends HttpServlet {
  public void doGet(HttpServletRequest request, 
      HttpServletResponse response) throws ServletException,
         java.io.IOException {
    
      String par = request.getParameter("par1");
      // 调用两个 ServletContext.log 方法
      ServletContext context = getServletContext( );

      if (par == null || par.equals(""))
      // 通过 Throwable 参数记录版本
      context.log("No message received:",
          new IllegalStateException("Missing parameter"));
      else
          context.log("Here is the visitor's message: " + par);
      
      response.setContentType("text/html;charset=UTF-8");
      java.io.PrintWriter out = response.getWriter( );
      String title = "Context Log";
      String docType = "<!DOCTYPE html> \n";
      out.println(docType +
        "<html>\n" +
        "<head><title>" + title + "</title></head>\n" +
        "<body bgcolor=\"#F0F0F0\">\n" +
        "<h1 align=\"center\">" + title + "</h1>\n" +
        "<h2 align=\"center\">Messages sent</h2>\n" +
        "</body></html>");
    } //doGet
}

ServletContext registra sus mensajes de texto en el archivo de registro del contenedor de Servlet. Para Tomcat, estos registros se pueden encontrar en el directorio <Tomcat-installation-directory>/logs.

Estos archivos de registro realmente indican la frecuencia de nuevos errores o problemas. Por eso, se recomienda usar el método log() en las cláusulas catch de excepciones que normalmente no ocurren.

Usar el depurador JDB

Puede usar el comando jdb, que se utiliza para depurar applets o aplicaciones, para depurar Servlets.

Para depurar un Servlet, podemos depurar sun.servlet.http.HttpServer y luego considerarlo como si HttpServer ejecutara el Servlet para responder a las solicitudes HTTP del navegador. Esto es muy similar a depurar applets. A diferencia de la depuración de applets, en la que el programa realmente depurado es sun.applet.AppletViewer.

La mayoría de los depuradores ocultan automáticamente los detalles de cómo depurar applets. De manera similar, para los servlets, usted debe ayudar al depurador a realizar lo siguiente:

  • Configure el classpath de su depurador para que pueda encontrar sun.servlet.http.Http-Server y las clases relacionadas.
  • Configure el classpath de su depurador para que pueda encontrar su servlet y las clases de soporte, generalmente en server_root/servlets y server_root/classes.

Normalmente no querrá que server_root/servlets esté en su classpath, porque esto deshabilitaría la recarga de servlets. Sin embargo, esta regla de inclusión es muy útil para la depuración. Permite que su depurador establezca puntos de interrupción en el Servlet antes de que el cargador de Servlets personalizado en HttpServer cargue el Servlet.

Si ya ha configurado el classpath correcto, puede comenzar a depurar sun.servlet.http.HttpServer. Puede establecer puntos de interrupción en el código del Servlet que desea depurar y luego usar un navegador web para enviar una solicitud a HttpServer con el Servlet dado (http://localhost:8080/servlet/ServletToDebug). Verá que la ejecución se detiene en el punto de interrupción.

Uso de comentarios

Los comentarios en el código ayudan a depurar de diversas maneras. Los comentarios se pueden utilizar en muchos otros aspectos del proceso de depuración.

Este Servlet usa comentarios de Java. Los comentarios de una sola línea (//...) y los comentarios de varias líneas (/* ...*/) se pueden usar para eliminar temporalmente parte del código Java. Si el error desaparece, examine cuidadosamente el código que acaba de comentar y encuentre el problema.

Información de cabeceras del cliente y del servidor

A veces, cuando un Servlet no se comporta como se esperaba, es muy útil revisar la solicitud y la respuesta HTTP originales. Si está familiarizado con la estructura de HTTP, puede leer la solicitud y la respuesta para ver qué son exactamente estas cabeceras.

Técnicas importantes de depuración

A continuación se enumeran algunas técnicas de depuración de Servlets:

  • Tenga en cuenta que server_root/classes no se recarga, mientras que server_root/servlets puede recargarse.
  • Pídale al navegador que muestre el contenido original de la página que está mostrando. Esto ayuda a identificar problemas de formato. Generalmente es una opción en el menú 'Ver'.
  • Asegúrese de que el navegador no haya almacenado en caché la salida de la solicitud anterior forzando una recarga completa de la página. En Netscape Navigator, use Shift-Reload; en Internet Explorer, use Shift-Refresh.
  • Verifique que el método init() del servlet acepte un parámetro ServletConfig y llame a super.init(config).
Otras extensiones