Personalización de aplicaciones web con anotaciones

8.1 Introducción a las anotaciones de servlet

A partir de la versión 7, Tomcat comenzó a admitir la especificación de servlet web Servlet API 3.0 . En particular, apareció un paquete llamado javax.servlet.annotation. Contiene varios tipos de anotaciones que se pueden utilizar para anotar una clase de servlet. Si usa una anotación, no se requiere el descriptor de implementación (web.xml).

Lista de las anotaciones más útiles:

Ejemplo:

@WebServlet( urlPatterns = {"/api/*"} )
public class Example extends HttpServlet {
    protected void doGet( HttpServletRequest request, HttpServletResponse response) throws Exception {
         response.setContentType("text/html");
         PrintWriter out = response.getWriter();
         out.println("Hello World!");
    }
}

Una anotación es suficiente para declarar un servlet y mapearlo para atender todas las solicitudes que llegarán a la URL dada por el /api/*.

8.2 Configuración de la asignación de servlets

La anotación tiene @WebServletmuchos parámetros que permiten una configuración muy flexible del servlet que describe. Echemos un vistazo a los principales:

Hay varios puntos interesantes aquí.

Primero, tenga en cuenta que valuey urlPatternsson atributos intercambiables. Ambos le permiten especificar una lista de direcciones URL a las que debe asignarse el servlet.

En segundo lugar, el parámetro asyncSupportedindica si el servlet procesará correctamente las solicitudes asíncronas sobre el protocolo HTTP/2.

Y el tercer atributo importante es initParams, le permite establecer una lista de parámetros que se colocarán en el ServletContext.

Ejemplo:

@WebServlet(
        urlPatterns = {"/sendFile", "/uploadFile"},
        loadOnStartup = 1,
        asyncSupported = true,
        initParams = {
            @WebInitParam(name = "saveDir", value = "c:/uploaded"),
            @WebInitParam(name = "allowedTypes", value = "jpg,gif,png")
        }
)
public class ImageUploadServlet extends HttpServlet {

    public void doGet(HttpServletRequest request, HttpServletResponse response) throws Exception {
        String saveDir = getInitParameter("saveDir");
        String fileTypes = getInitParameter("allowedTypes");

        PrintWriter writer = response.getWriter();

        writer.println("saveDir = " + saveDir);
        writer.println("fileTypes = " + fileTypes);
    }
}

8.3 Configuración del mapeo de filtros

Como se mencionó anteriormente, los filtros son un tipo de utilidad de los servlets y se configuran como servlets. Estos son los atributos que tiene una anotación @WebFilter:

Un ejemplo de un filtro que intercepta todas las solicitudes a servlets específicos :

@WebFilter(servletNames = {"MyOwnServlet", "UploadServlet"})
public class MyFilter implements Filter {
    // implements Filter's methods here...
}

Un ejemplo de un filtro dado múltiples parámetros :

@WebFilter(
        urlPatterns = "/uploadFilter",
        initParams = @WebInitParam(name = "fileTypes", value = "doc;xls;zip;txt;jpg;png;gif")
)
public class UploadFilter implements Filter {
    // implements Filter's methods here...
}

Un ejemplo de un filtro de tipos dados para RequestDispatcher :

@WebFilter(
        urlPatterns = "/admin",
        dispatcherTypes = {DispatcherType.REQUEST, DispatcherType.FORWARD}
)
public class MyFilter implements Filter {
    // implements Filter's methods here...
}

Aprenderá más sobre el propósito de los filtros y servlets en las siguientes lecciones.