Personalizarea aplicațiilor web cu adnotări

8.1 Introducere în adnotările servlet

Începând cu versiunea 7, Tomcat a început să accepte specificația de servlet web Servlet API 3.0 . În special, a apărut un pachet numit javax.servlet.annotation. Conține diferite tipuri de adnotări care pot fi folosite pentru a adnota o clasă de servlet. Dacă utilizați o adnotare, atunci descriptorul de implementare (web.xml) nu este necesar.

Lista celor mai utile adnotări:

Exemplu:

@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!");
    }
}

O adnotare este suficientă pentru a declara un servlet și a-l mapa pentru a servi toate solicitările care vor ajunge la adresa URL dată de /api/*.

8.2 Configurarea mapării servlet-urilor

Adnotarea are @WebServletmulți parametri care permit configurarea foarte flexibilă a servlet-ului pe care îl descrie. Să aruncăm o privire la cele principale:

Există mai multe puncte interesante aici.

În primul rând, rețineți că valueși urlPatternssunt atribute interschimbabile. Ambele vă permit să specificați o listă de adrese URL la care ar trebui să mapați servletul.

În al doilea rând, parametrul asyncSupportedindică dacă servletul va procesa corect cererile asincrone prin protocolul HTTP/2.

Și al treilea atribut important este initParams, vă permite să setați o listă de parametri care vor fi plasați în ServletContext.

Exemplu:

@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 Configurarea mapării filtrului

După cum am menționat mai sus, filtrele sunt un tip utilitar de servlet-uri și sunt configurate ca servlet-uri. Iată atributele pe care le are o adnotare @WebFilter:

Un exemplu de filtru care interceptează toate solicitările către anumite servlet-uri :

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

Un exemplu de filtru dat cu mai mulți parametri :

@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 exemplu de filtru date tipuri pentru RequestDispatcher :

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

Veți afla mai multe despre scopul filtrelor și servlet-urilor în următoarele prelegeri.