Sediakan projek Maven/Gradle dengan ketergantungan JAX-RS seperti Jersey; 2. Buat sumber rehat menggunakan anotasi seperti @Path dan @get; 3. Konfigurasi aplikasi melalui subclass aplikasi atau web.xml; 4. Tambah Jackson untuk JSON mengikat dengan memasukkan Jersey-Media-Json-Jackson; 5. Digunakan ke pelayan Jakarta EE atau servlet dan ujian dengan alat seperti curl; Jakarta EE menyediakan platform gred standard, perusahaan untuk membina API yang boleh dipercayai dan mudah alih menggunakan spesifikasi Java rasmi, menjadikannya sesuai untuk persekitaran yang mengutamakan kestabilan dan sokongan jangka panjang.

Membina API Restful di Java dengan Jakarta EE adalah pilihan yang kukuh untuk aplikasi gred perusahaan yang menghargai kestabilan, pematuhan piawaian, dan integrasi dengan ekosistem Java yang lebih luas. Jakarta EE (dahulunya Java EE) menyediakan platform yang didorong oleh spesifikasi yang mantap untuk membangunkan perkhidmatan REST yang berskala dan dikekalkan menggunakan JAX-RS (Jakarta Restful Web Services).

Inilah cara membina API RESTful di Java menggunakan Jakarta EE:

1. Sediakan projek Jakarta EE anda

Mulakan dengan menubuhkan projek Maven atau Gradle dengan kebergantungan yang diperlukan. Jika anda menggunakan Maven , masukkan API JAX-RS dan runtime yang serasi seperti Eclipse Jersey (pelaksanaan rujukan) atau Apache CXF , atau menggunakan pelayan Jakarta EE penuh seperti Payara , Wildfly , atau Liberty Terbuka .

Contoh pom.xml Snippet Menggunakan Jersey:

 <dependencies>
    <geterlihat>
        <groupid> org.glassfish.jersey.core </groupId>
        <stifactId> Jersey-Server </artifactid>
        <versi> 3.1.3 </versi>
    </ketergantungan>
    <geterlihat>
        <groupid> org.glassfish.jersey.containers </groupId>
        <stifactid> Jersey-Container-Servlet </artifactid>
        <versi> 3.1.3 </versi>
    </ketergantungan>
    <geterlihat>
        <groupId> org.glassfish.jersey.Inject </groupId>
        <stifactId> Jersey-Hk2 </artifactid>
        <versi> 3.1.3 </versi>
    </ketergantungan>
</dependencies>

Atau, jika anda menggunakan pelayan aplikasi Jakarta EE penuh (seperti Payara), kebanyakan API sudah dimasukkan.

2. Buat kelas sumber rehat

Gunakan anotasi JAX-RS untuk menentukan titik akhir. The @Path , @GET , @Produces , dan lain -lain, memudahkan untuk memetakan kaedah HTTP ke kaedah Java.

 import jakarta.ws.rs.*;
import jakarta.ws.rs.core.mediatype;
import jakarta.ws.rs.core.Response;

@Path ("/Pengguna")
@Produces (mediatype.application_json)
kelas awam userresource {

    @Get
    GetAllUsers Respons Public () {
        // dalam amalan, ambil dari perkhidmatan atau pangkalan data
        var pengguna = java.util.list.of (
            Pengguna Baru (1L, "Alice"),
            Pengguna Baru (2L, "Bob")
        );
        kembali respons.ok (pengguna) .build ();
    }

    @Get
    @Path ("/{id}")
    respons awam getUserbyId (@pathParam ("id") id panjang) {
        jika (id == 1) {
            return response.ok (pengguna baru (1L, "Alice")). Build ();
        } else {
            RETURN Response.Status (response.status.not_found) .build ();
        }
    }

    @Post
    @Consumes (mediatype.application_json)
    Respons Public CreateUser (pengguna pengguna) {
        // Simulasi penciptaan
        user.setId (3L); // Berikan ID
        return response.status (response.status.created) .Entity (user) .build ();
    }
}

Dan rekod User atau kelas yang mudah:

 Pengguna Rekod Awam (Long ID, Nama String) {
    public void setID (id panjang) {
        // diperlukan untuk beberapa pemetaan JSON jika menggunakan tingkah laku yang boleh berubah
    }
}

3. Konfigurasikan permohonan

Anda boleh membiarkan sumber-sumber automatik JAX-RS, atau membuat subclass Application untuk mendaftarkannya secara eksplisit.

 import jakarta.ws.rs.core.application;
import java.util.set;

Restapplication kelas awam memanjangkan aplikasi {
    @Override
    set awam <class <? >> getClasses () {
        Set <class <? >> classes = new java.util.hashset <> ();
        classes.add (userRresource.class);
        Kelas kembali;
    }
}

Kemudian daftar ini di web.xml (jika menggunakannya):

 <Beb-App>
    <ervlet>
        <ervlet-name> javax.ws.rs.core.application </servlet-name>
        <Servlet-Class> org.glassfish.jersey.servlet.ServletContainer </servlet-class>
        <Init-Raram>
            <param-name> jakarta.ws.rs.application </param-name>
            <Param-Value> com.example.restapplication </param-value>
        </init-param>
        <LOAD-ON-STARTUP> 1 </LOAD-ON-STARTUP>
    </servlet>
    <ervlet-papping>
        <ervlet-name> javax.ws.rs.core.application </servlet-name>
        <RL-Pattern>/Api/*</url-corak>
    </servlet-mapping>
</web-app>

Sebagai alternatif, aplikasi Jakarta EE moden boleh menghilangkan web.xml dan bergantung pada anotasi.

4. Tambah Sokongan JSON (Moxy atau Jackson)

Secara lalai, Jersey menggunakan moxy untuk mengikat JSON. Anda boleh beralih ke Jackson untuk lebih fleksibel:

Tambah ke pom.xml :

 <geterlihat>
    <groupid> org.glassfish.jersey.media </groupId>
    <sttifactid> Jersey-Media-Json-Jackson </artifactid>
    <versi> 3.1.3 </versi>
</ketergantungan>

Kemudian daftar JacksonFeature dalam kelas Application anda atau melalui parameter Web.xml init.

5. Menyebarkan dan menguji

Sediakan fail perang anda ke bekas Jakarta atau servlet:

• Standalone : Gunakan jeti tertanam atau tomcat dengan jersi.
• Platform Penuh : Deplek ke Payara Micro , Wildfly , atau Liberty Terbuka untuk ciri -ciri Jakarta EE penuh.

Uji dengan curl :

 Curl http: // localhost: 8080/yourapp/api/pengguna
# Returns: [{"id": 1, "name": "Alice"}, {"id": 2, "name": "bob"}]

Kelebihan utama Jakarta EE untuk API rehat

• Standardisasi : JAX-RS adalah spesifikasi-mudah alih merentasi pelaksanaan.
• Suntikan Ketergantungan : Gunakan @Inject dengan CDI untuk integrasi lapisan perkhidmatan bersih.
• Keselamatan : Bersepadu dengan Jakarta Security ( @RolesAllowed , dll.).
• Pengesahan : Gunakan Pengesahan Bean ( @NotNull , @Size ) pada badan permintaan.
• Pemprosesan Asynchronous : Sokongan untuk AsyncResponse untuk tugas-tugas jangka panjang.

Contoh dengan CDI:

 @Path ("/Pengguna")
@RequestScoped
kelas awam userresource {

    @Inject
    Pengguna Pengguna Pengguna;

    @Get
    GetAll Response Public () {
        kembali response.ok (userService.getAll ()). binaan ();
    }
}

Membina API yang tenang dengan Jakarta EE memberi anda asas yang matang dan siap sedia. Walaupun rangka kerja yang lebih baru seperti Spring Boot lebih popular untuk microservices, Jakarta EE kekal sebagai alternatif berasaskan piawaian yang kuat-terutamanya dalam persekitaran di mana mudah alih dan perkara sokongan jangka panjang.

Pada asasnya, jika anda ingin membina API yang boleh dipercayai dan boleh dikekalkan menggunakan piawaian Java rasmi, Jakarta EE dengan JAX-RS adalah jalan yang terbukti. Hanya pilih runtime anda, tentukan sumber anda, dan pergi.

Atas ialah kandungan terperinci Membina API Restful di Jawa dengan Jakarta EE. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!