Pag-customize ng Mga Web Application gamit ang Mga Anotasyon

8.1 Panimula sa servlet annotation

Simula sa bersyon 7, nagsimulang suportahan ng Tomcat ang Servlet API 3.0 web servlet specification . Sa partikular, lumitaw ang isang pakete sa tinatawag na javax.servlet.annotation. Naglalaman ito ng iba't ibang uri ng mga anotasyon na maaaring magamit upang i-annotate ang isang klase ng servlet. Kung gagamit ka ng annotation, hindi kinakailangan ang deployment descriptor (web.xml).

Listahan ng mga pinakakapaki-pakinabang na anotasyon:

Halimbawa:

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

Ang isang anotasyon ay sapat na upang magdeklara ng isang servlet at imapa ito upang maihatid ang lahat ng mga kahilingan na darating sa URL na ibinigay ng /api/*.

8.2 Pag-set up ng servlet mapping

Ang anotasyon ay may @WebServletmaraming mga parameter na nagbibigay-daan sa napaka-flexible na pagsasaayos ng servlet na inilalarawan nito. Tingnan natin ang mga pangunahing:

Mayroong ilang mga kagiliw-giliw na mga punto dito.

Una, tandaan na valueat urlPatternsmga mapagpapalit na katangian. Pareho silang nagpapahintulot sa iyo na tukuyin ang isang listahan ng mga URL kung saan dapat imapa ng servlet.

Pangalawa, ang parameter asyncSupporteday nagpapahiwatig kung ang servlet ay tama na magpoproseso ng mga asynchronous na kahilingan sa HTTP/2 protocol.

At ang pangatlong mahalagang katangian ay initParams, pinapayagan ka nitong magtakda ng listahan ng mga parameter na ilalagay sa ServletContext.

Halimbawa:

@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 Pag-set up ng filter mapping

Tulad ng nabanggit sa itaas, ang mga filter ay isang uri ng utility ng mga servlet, at sila ay na-configure tulad ng mga servlet. Narito ang mga katangian ng isang anotasyon @WebFilter:

Isang halimbawa ng isang filter na humarang sa lahat ng mga kahilingan sa mga partikular na servlet :

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

Isang halimbawa ng isang filter na binigyan ng maraming parameter :

@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...
}

Isang halimbawa ng isang filter na ibinigay na mga uri para sa RequestDispatcher :

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

Malalaman mo ang higit pa tungkol sa layunin ng mga filter at servlet sa mga sumusunod na lektura.