Kako koristiti Jakarta Servlet s Mavenom?

Jakarta Servlet predstavlja ključni dio Java EE (Enterprise Edition) platforme, omogućujući razvoj dinamičkih web aplikacija. U ovom članku istražit ćemo kako integrirati Jakarta Servlet s Mavenom, popularnim alat za upravljanje projektima i izgradnju u Java ekosustavu. Ova kombinacija omogućuje programerima da efikasno razvijaju, testiraju i implementiraju web aplikacije. U nastavku ćemo proći kroz osnovne korake za postavljanje projekta koristeći Maven i Jakarta Servlet.

Prvo, važno je razumjeti što je Maven i zašto je koristan. Maven je alat za automatizaciju izgradnje koji upravlja ovisnostima, omogućuje standardizaciju strukture projekta i pojednostavljuje proces izgradnje i implementacije aplikacija. Kada koristimo Maven, definiramo sve potrebne ovisnosti u pom.xml datoteci, koja služi kao centralno mjesto za konfiguraciju projekta.

Da bismo započeli, prvo ćemo instalirati Maven i postaviti naš razvojni okoliš. Preporučuje se da koristite JDK 11 ili noviji. Nakon instalacije JDK-a, preuzmite Maven s njegove službene web stranice i postavite ga na svoj sustav. Kada to učinite, provjerite instalaciju pokretanjem mvn -v u terminalu kako biste potvrdili da je Maven pravilno instaliran.

Kada je Maven instaliran, možemo stvoriti novi Maven projekt. U terminalu, koristite sljedeću naredbu:

mvn archetype:generate -DgroupId=com.example -DartifactId=my-servlet-app -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false

Ova naredba generira osnovnu strukturu web aplikacije koja uključuje direktorij za izvorne datoteke, resurse i konfiguracijske datoteke. Nakon što se projekt generira, pređite u direktorij projekta:

cd my-servlet-app

Sada trebamo dodati ovisnosti za Jakarta Servlet. Otvorite datoteku pom.xml i dodajte sljedeći odjeljak unutar <dependencies>:

<dependency>
    <groupId>jakarta.servlet</groupId>
    <artifactId>jakarta.servlet-api</artifactId>
    <version>6.0.0</version>
    <scope>provided</scope>
</dependency>

Ova ovisnost omogućava našem projektu korištenje Jakarta Servlet API-a. Napominjemo da je scope postavljen na provided jer će servlet kontejner (npr. Apache Tomcat) pružiti ovu knjižnicu tijekom izvođenja.

Sljedeći korak je izraditi naš servlet. U direktoriju src/main/java/com/example, izradite novu datoteku pod nazivom HelloServlet.java i unesite sljedeći kod:

package com.example;

import jakarta.servlet.ServletException;
import jakarta.servlet.annotation.WebServlet;
import jakarta.servlet.http.HttpServlet;
import jakarta.servlet.http.HttpServletRequest;
import jakarta.servlet.http.HttpServletResponse;

import java.io.IOException;
import java.io.PrintWriter;

@WebServlet("/hello")
public class HelloServlet extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {
        response.setContentType("text/html");
        PrintWriter out = response.getWriter();
        out.println("");
    }
}

Ovaj jednostavni servlet odgovara na GET zahtjev i prikazuje poruku “Hello, Jakarta Servlet!”. Nakon što ste kreirali servlet, trebate ga registrirati u web.xml datoteci koja se nalazi u src/main/webapp/WEB-INF direktoriju. Ako web.xml datoteka ne postoji, možete je stvoriti i dodati sljedeći sadržaj:

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee" 
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
          version="3.1">
    <servlet>
        <servlet-name>HelloServlet</servlet-name>
        <servlet-class>com.example.HelloServlet</servlet-class>
    </servlet>
    <servlet-mapping>
        <servlet-name>HelloServlet</servlet-name>
        <url-pattern>/hello</url-pattern>
    </servlet-mapping>
</web-app>

Ovim koracima, registrirali smo naš servlet unutar web aplikacije. Sada je vrijeme za izgradnju i pokretanje aplikacije. U terminalu, pokrenite:

mvn clean package

Ova naredba će izgraditi naš projekt i generirati WAR datoteku u direktoriju target. Možete koristiti Tomcat ili bilo koji drugi servlet kontejner za implementaciju vaše aplikacije. Ako koristite Tomcat, jednostavno kopirajte my-servlet-app.war u webapps direktorij Tomcata i pokrenite Tomcat.

Na kraju, otvorite web preglednik i idite na http://localhost:8080/my-servlet-app/hello. Trebali biste vidjeti poruku “Hello, Jakarta Servlet!”. Čestitam, upravo ste izradili svoj prvi Jakarta Servlet koristeći Maven!

Korištenje Mavena s Jakarta Servlet omogućuje brz razvoj i testiranje web aplikacija. Ova kombinacija pruža snažan alat za programere koji žele izgraditi moderne i skalabilne aplikacije u Java okruženju. Nadamo se da vam je ovaj članak bio koristan i da ste naučili nešto novo o razvoju s Jakarta Servlet i Mavenom.