Menggunakan MicroProfile untuk pemprosesan JAX-RS dalam pembangunan API Java

Java telah menjadi teknologi yang sangat popular sejak beberapa tahun kebelakangan ini dan ia memainkan peranan penting dalam pembangunan aplikasi web. Teknologi API Java secara khusus menggunakan JAX-RS untuk membina perkhidmatan web gaya RESTful. Walau bagaimanapun, membina keseluruhan perkhidmatan menggunakan API JAX-RS masih sangat menyusahkan, jadi kami perlu menggunakan MicroProfile untuk memudahkan pemprosesan JAX-RS. Artikel ini menerangkan apa itu MicroProfile dan cara menggunakannya untuk pemprosesan JAX-RS dalam pembangunan Java.

MicroProfile ialah pakatan organisasi sumber terbuka yang terdiri daripada IBM, Red Hat, Tomitribe, Payara, LJC dan syarikat lain, yang bertujuan membantu pembangun membina penyelesaian untuk seni bina perkhidmatan mikro. Ia adalah satu set spesifikasi penyepaduan untuk menyokong perkhidmatan mikro pada platform Java EE. MicroProfile terdiri daripada spesifikasi API seperti JAX-RS, CDI, JSON-B dan JSON-P.

Rangka kerja MicroProfile menyediakan banyak fungsi, termasuk OpenAPI, Pemeriksaan Kesihatan, Toleransi Kesalahan, Metrik, Pemantauan dan banyak lagi. MicroProfile memanjangkan JAX-RS dengan menyediakan anotasi berfungsi dalam konteks JAX-RS, membolehkan kami menambah pelbagai fungsi dengan mudah pada aplikasi kami. Sekarang, mari kita lihat cara menggunakan MicroProfile untuk pemprosesan JAX-RS.

Sebelum melakukan ini, pastikan anda sudah mempunyai aplikasi JAX-RS yang mudah.

Untuk menggunakan MicroProfile anda perlu menambah kebergantungan berikut dalam maven:

    <dependency>
        <groupId>org.eclipse.microprofile</groupId>
        <artifactId>microprofile</artifactId>
        <version>3.3</version>
    </dependency>

Ini akan menambah set kebergantungan MicroProfile yang diperlukan. Menambah senarai pergantungan ini secara manual selalunya sukar, terutamanya jika anda baru menggunakan MicroProfile API. Nasib baik, Pelayan Payara dan Pelayan OpenLiberty secara automatik menambah pakej pemasangan API MicroProfile, yang merupakan sumber yang hebat untuk pembangunan praktikal.

Seterusnya, tambah anotasi @OpenAPIDefinition untuk mentakrifkan elemen spesifikasi OpenAPI. Pendekatan ini semudah mencipta kelas baharu atau menambah anotasi @OpenAPIDefinition pada kelas sumber JAX-RS sedia ada.

@OpenAPIDefinition(info = @Info(
        title = "Microprofile with JAX-RS",
        version = "1.0",
        description = "A simple app using Microprofile APIs with JAX-RS as backend"))
@Path("/hello")
public class GreetingsResource {}

Ini akan menambah sumber maklumat dan laluan kepada spesifikasi OpenAPI. Kini, kami juga perlu menambah anotasi @Operation dan @APIResponse untuk mentakrifkan operasi sumber dan respons API. Gabungan anotasi ini sangat berkuasa dalam aplikasi MicroProfile.

    @GET
    @Operation(
            summary = "Say hello",
            description = "Returns a simple hello message"
    )
    @APIResponse(
            responseCode = "200",
            content = @Content(
                    mediaType = MediaType.TEXT_PLAIN,
                    schema = @Schema(
                            type = SchemaType.STRING
                    )
            )
    )
    public String hello() {
        return "Hello from MicroProfile with JAX-RS!";
    }

Kod di atas menggunakan @Operation untuk mentakrifkan operasi sumber dan menggunakan anotasi @APIResponse untuk mentakrifkan bentuk respons API.

Selepas proses di atas selesai, kita perlu menambah fail web.xml dan mentakrifkan Servlet di dalamnya.

<servlet-name>Jersey Servlet</servlet-name>
<servlet-class>org.glassfish.jersey.servlet.ServletContainer</servlet-class>
<init-param>
    <param-name>jersey.config.server.provider.packages</param-name>
    <param-value>com.example.microprofile</param-value>
</init-param>
<load-on-startup>1</load-on-startup>

Dalam fail web.xml ini, kami mentakrifkan bekas Servlet dan secara khusus menentukan laluan pakej yang diperlukan. Kini anda boleh melancarkan aplikasi anda dan mengujinya dengan memasukkan URL: http://localhost:8080/hello dalam penyemak imbas anda.

Dengan menggunakan MicroProfile untuk pemprosesan JAX-RS, kami dapat melihat bahawa anotasi yang kami tambahkan menjadikan aplikasi sangat mudah, dan kami juga boleh menggunakan perkara seperti OpenAPI, Pemeriksaan Kesihatan, Toleransi Kesalahan, Metrik, Pemantauan, dsb. Pelbagai anotasi berfungsi dengan mudah menambah beberapa aplikasi. Ini menjadikan pembangunan Java lebih mudah dan lebih menyeronokkan.

Ringkasnya, MicroProfile menyediakan kaedah pengaturcaraan JAX-RS yang lebih mudah dan cekap, yang boleh membantu pembangun merealisasikan pembinaan aplikasi seni bina perkhidmatan mikro. Artikel ini telah membincangkan cara menggunakan MicroProfile untuk pemprosesan JAX-RS. Saya harap pembaca dapat menguasai teknologi ini dan menggunakannya dalam pembangunan sebenar.

Atas ialah kandungan terperinci Menggunakan MicroProfile untuk pemprosesan JAX-RS dalam pembangunan API Java. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!