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

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

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

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

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

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

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

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

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

使用JAX-RS註釋定義端點。 @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（）{
        //實際上，從服務(wù)或數(shù)據(jù)庫獲取
        var用戶= java.util.list.of（
            新用戶（1L，“愛麗絲”），
            新用戶（2L，“鮑勃”）
        ）；
        返迴響應(yīng)。 ok（用戶）.build（）;
    }

    @得到
    @path（“/{id}”）
    公共響應(yīng)getuserbyId（@pathparam（“ id”）長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（）;
    }
}

以及簡單的User記錄或類：

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

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

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

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

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

然後在web.xml （如果使用）中註冊此：

 <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>
        <開始啟動> 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進行JSON綁定。您可以切換到傑克遜以提高靈活性：

添加到pom.xml ：

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

然後在您的Application類或Web.xml Init參數(shù)中註冊JacksonFeature 。

5。部署和測試

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

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

curl測試：

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

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

• 標(biāo)準(zhǔn)化：JAX-RS是一個規(guī)範(fàn) - 可在實現(xiàn)的範(fàn)圍內(nèi)移植。
• 依賴注入：使用@Inject與CDI進行清潔服務(wù)層集成。
• 安全性：與雅加達(dá)安全性集成（ @RolesAllowed等）。
• 驗證：在請求實體上使用bean驗證（ @NotNull ， @Size ）。
• 異步處理：支持長期運行任務(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仍然是一種強大的基於標(biāo)準(zhǔn)的替代方案，尤其是在可移植性和長期支持問題的環(huán)境中。

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

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