建立一個(gè)Maven/Gradle項(xiàng)目，并具有Jax-Rs依賴性等澤西島（Jersey）； 2。使用@path和@get等注釋創(chuàng)建一個(gè)REST資源； 3。通過(guò)應(yīng)用程序子類或web.xml配置應(yīng)用程序； 4。加上Jackson的JSON BINDING，包括包括澤西 - 媒體 - 杰森 - 杰克遜； 5。部署到雅加達(dá)EE服務(wù)器或servlet容器，并使用Curl等工具進(jìn)行測(cè)試； Jakarta EE提供了一個(gè)標(biāo)準(zhǔn)化的企業(yè)級(jí)平臺(tái)，可使用官方的Java規(guī)格來(lái)構(gòu)建可靠和便攜式的靜止API，使其非常適合優(yōu)先考慮穩(wěn)定性和長(zhǎng)期支持的環(huán)境。

使用Jakarta EE在Java中建造RESTFUL API是重視穩(wěn)定性，標(biāo)準(zhǔn)符合性并與更廣泛的Java生態(tài)系統(tǒng)集成的企業(yè)級(jí)應(yīng)用程序的可靠選擇。 Jakarta EE（以前為Java EE）提供了一個(gè)強(qiáng)大的，規(guī)格驅(qū)動(dòng)的平臺(tái)，用于使用JAX-RS（Jakarta Restful Web Services）開(kāi)發(fā)可擴(kuò)展和可維護(hù)的REST服務(wù)。

這是使用Jakarta EE在Java構(gòu)建REST的API的方法：

1。設(shè)置您的雅加達(dá)EE項(xiàng)目

首先設(shè)置具有必要依賴項(xiàng)的Maven或Gradle項(xiàng)目。如果您使用的是Maven ，請(qǐng)包括JAX-RS API和兼容的運(yùn)行時(shí)，例如Eclipse澤西島（參考實(shí)現(xiàn)）或Apache CXF ，或在Payara ， Wildfly或Open Liberty等完整的Jakarta EE服務(wù)器上部署。

示例使用澤西島的pom.xml片段：

 <依賴項(xiàng)>
    <依賴項(xiàng)>
        <groupId> org.glassfish.jersey.core </groupId>
        <Artifactid> Jersey-Server </artifactid>
        <版本> 3.1.3 </version>
    </dependency>
    <依賴項(xiàng)>
        <groupId> org.glassfish.jersey.containers </groupid>
        <Artifactid>澤西式 - 范圍 - 服務(wù)</artifactid>
        <版本> 3.1.3 </version>
    </dependency>
    <依賴項(xiàng)>
        <groupId> org.glassfish.jersey.igntion </groupId>
        <Artifactid> Jersey-HK2 </artifactid>
        <版本> 3.1.3 </version>
    </dependency>
</依賴項(xiàng)>

或者，如果您使用完整的Jakarta EE應(yīng)用程序服務(wù)器（例如Payara），則大多數(shù)API已包含在內(nèi)。

2。創(chuàng)建一個(gè)REST資源類

使用JAX-RS注釋定義端點(diǎn)。 @Path ， @GET ， @Produces produces等使得將HTTP方法映射到Java方法變得易于使用。

導(dǎo)入jakarta.ws.rs。
導(dǎo)入jakarta.ws.rs.core.mediatype;
導(dǎo)入jakarta.ws.rs.core.response;

@path（“/用戶”）
@produces（MediaType.Application_json）
公共類UserResource {

    @得到
    公共響應(yīng)getallusers（）{
        //實(shí)際上，從服務(wù)或數(shù)據(jù)庫(kù)獲取
        var用戶= java.util.list.of（
            新用戶（1L，“愛(ài)麗絲”），
            新用戶（2L，“鮑勃”）
        ）；
        返回響應(yīng)。ok（用戶）.build（）;
    }

    @得到
    @path（“/{id}”）
    公共響應(yīng)getuserbyId（@pathparam（“ id”）長(zhǎng)ID）{
        如果（id == 1）{
            返回響應(yīng)。ok（新用戶（1L，“ ALICE”））。build（）;
        } 別的 {
            返回響應(yīng)。STATUS（wendesp.status.not_found）.build（）;
        }
    }

    @郵政
    @Consumes（MediaType.Application_json）
    公共響應(yīng)createuser（用戶用戶）{
        //模擬創(chuàng)建
        user.setID（3L）; //分配ID
        返回響應(yīng)status（wendesp.status.greated）.entity（用戶）.build（）;
    }
}

以及簡(jiǎn)單的User記錄或類：

公共記錄用戶（長(zhǎng)ID，字符串名稱）{
    public void setID（長(zhǎng)ID）{
        //某些JSON映射器所需的如果使用可變的行為
    }
}

3。配置應(yīng)用程序

您可以讓JAX-RS自動(dòng)發(fā)現(xiàn)資源，或創(chuàng)建Application子類以明確注冊(cè)它們。

導(dǎo)入jakarta.ws.rs.core.application;
導(dǎo)入java.util.set;

公共類Restapplication擴(kuò)展了應(yīng)用程序{
    @Override
    公共集<class <？>> getClasses（）{
        set <class <？>> class = new java.util.hashset <>（）;
        class.Add（userresource.class）;
        返回課程；
    }
}

然后在web.xml （如果使用）中注冊(cè)此：

 <Web-App>
    <servlet>
        <servlet-name> javax.ws.rs.core.application </servlet-name>
        <Servlet-class> org.glassfish.jersey.servlet.servletcontainer </servlet-class>
        <Init-Param>
            <param-name> jakarta.ws.rs.application </param-name>
            <Param-Value> com.example.restapplication </param-Value>
        </init-param>
        <開(kāi)始啟動(dòng)> 1 </load-on-on-on-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name> javax.ws.rs.core.application </servlet-name>
        <URL-Pattern>/api/*</url-Pattern>
    </servlet-mapping>
</web-app>

另外，現(xiàn)代的雅加達(dá)EE應(yīng)用程序可以省略web.xml并依靠注釋。

4。添加JSON支持（Moxy或Jackson）

默認(rèn)情況下，澤西島使用Moxy進(jìn)行JSON綁定。您可以切換到杰克遜以提高靈活性：

添加到pom.xml ：

 <依賴項(xiàng)>
    <groupId> org.glassfish.jersey.media </groupid>
    <Artifactid>澤西 - 梅迪亞 - 杰森 - 杰克遜</artifactid>
    <版本> 3.1.3 </version>
</dependency>

然后在您的Application類或Web.xml Init參數(shù)中注冊(cè)JacksonFeature 。

5。部署和測(cè)試

將戰(zhàn)爭(zhēng)檔案部署到雅加達(dá)EE或servlet容器：

• 獨(dú)立：與澤西島一起使用嵌入式碼頭或Tomcat。
• 完整平臺(tái)：部署到Payara Micro ， Wildfly或開(kāi)放的自由度，以獲得完整的Jakarta EE功能。

curl測(cè)試：

 curl http：// localhost：8080/yourapp/api/用戶
＃返回：[{“ id”：1，“ name”：“ alice”}，{“ id”：2，“ name”：“ bob”}]

雅加達(dá)EE的主要優(yōu)勢(shì)用于REST API

• 標(biāo)準(zhǔn)化：JAX-RS是一個(gè)規(guī)范 - 可在實(shí)現(xiàn)的范圍內(nèi)移植。
• 依賴注入：使用@Inject與CDI進(jìn)行清潔服務(wù)層集成。
• 安全性：與雅加達(dá)安全性集成（ @RolesAllowed等）。
• 驗(yàn)證：在請(qǐng)求實(shí)體上使用bean驗(yàn)證（ @NotNull ， @Size ）。
• 異步處理：支持長(zhǎng)期運(yùn)行任務(wù)的AsyncResponse 。

CDI的示例：

 @path（“/用戶”）
@requestscoped
公共類UserResource {

    @注入
    UserService userService;

    @得到
    公共響應(yīng)getall（）{
        返回響應(yīng)。ok（uservice.getAll（））。build（）;
    }
}

使用Jakarta EE構(gòu)建靜止的API為您提供了成熟的企業(yè)就緒基礎(chǔ)。盡管像Spring Boot這樣的新框架在微服務(wù)中更受歡迎，但Jakarta EE仍然是一種強(qiáng)大的基于標(biāo)準(zhǔn)的替代方案，尤其是在可移植性和長(zhǎng)期支持問(wèn)題的環(huán)境中。

基本上，如果您想使用官方的Java標(biāo)準(zhǔn)構(gòu)建可靠的可維護(hù)API，則使用JAX-RS的Jakarta EE是一條良好的道路。只需選擇您的運(yùn)行時(shí)，定義您的資源，然后就可以了。

以上是用雅加達(dá)EE在Java建立靜止的API的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！