Richten Sie ein Maven/Gradle-Projekt mit JAX-RS-Abh?ngigkeiten wie Jersey ein; 2. Erstellen Sie eine REST -Ressource mit Anmerkungen wie @Path und @get; 3. Konfigurieren Sie die Anwendung über die Anwendungsunterklasse oder Web.xml; 4. Fügen Sie Jackson für JSON Binding hinzu, indem Sie Jersey-Media-Json-Jackson einbeziehen; 5. Bereitstellen auf einem Jakarta EE -Server oder Servlet -Container und Test mit Tools wie Curl; Jakarta EE bietet eine standardisierte Plattform für Unternehmensqualit?t, um zuverl?ssige und tragbare, erholsame APIs mithilfe offizieller JAVA-Spezifikationen aufzubauen, wodurch sie ideal für Umgebungen ist, die Stabilit?t und langfristige Unterstützung priorisieren.

Der Aufbau erholsamer APIs in Java mit Jakarta EE ist eine solide Wahl für Anwendungen für Unternehmensqualit?t, die Stabilit?t, Standardeinhaltung und Integration in das breitere Java-?kosystem bewerten. Jakarta EE (ehemals Java EE) bietet eine robuste, spezifikationsorientierte Plattform für die Entwicklung skalierbarer und aufhaltbarer REST-Dienste mit JAX-RS (Jakarta Rastful Web Services).

Hier erfahren Sie, wie Sie eine erholsame API in Java mit Jakarta EE bauen:

1. Richten Sie Ihr Jakarta EE -Projekt ein

Beginnen Sie mit den erforderlichen Abh?ngigkeiten ein Maven- oder Gradle -Projekt einrichten. Wenn Sie Maven verwenden, schlie?en Sie die JAX-RS-API und eine kompatible Laufzeit wie Eclipse Jersey (Referenzimplementierung) oder Apache CXF an oder bereitstellen Sie auf einem vollst?ndigen Jakarta-EE-Server wie Payara , Wildfly oder Open Liberty .

Beispiel pom.xml snippet mit Jersey:

 <Depecies>
    <De vorangehen>
        <GruppeId> org.glassfish.jersey.core </Groupid>
        <artifactid> Jersey-Server </artifactid>
        <version> 3.1.3 </Version>
    </abh?ngig>
    <De vorangehen>
        <GruppeId> org.glassfish.jersey.Containers </Groupid>
        <artifactId> Jersey-Container-Service </artifactid>
        <version> 3.1.3 </Version>
    </abh?ngig>
    <De vorangehen>
        <gruppe> org.glassfish.jersey.inject </Groupid>
        <artifactid> jersey-hk2 </artifactid>
        <version> 3.1.3 </Version>
    </abh?ngig>
</Abh?ngigkeiten>

Wenn Sie einen vollst?ndigen Jakarta EE -Anwendungsserver (wie Payara) verwenden, sind die meisten APIs bereits enthalten.

2. Erstellen Sie eine REST -Ressourcenklasse

Verwenden Sie JAX-RS-Anmerkungen, um Endpunkte zu definieren. Die @Path , @GET , @Produces usw. erleichtert es einfach, HTTP -Methoden auf Java -Methoden abzubilden.

 import Jakarta.ws.rs.*;
Import Jakarta.ws.rs.core.MediType;
importieren jakarta.ws.rs.core.response;

@Path ("/Benutzer")
@Produces (minyType.Application_json)
?ffentliche Klasse Userresource {

    @ERHALTEN
    ?ffentliche Antwort getAllusers () {
        // in der Praxis aus einem Dienst oder einer Datenbank abrufen
        var user = java.util.list.of (
            neuer Benutzer (1L, "Alice"),
            neuer Benutzer (2L, "Bob")
        );
        return response.ok (Benutzer) .build ();
    }

    @ERHALTEN
    @Path ("/{id}")
    ?ffentliche Antwort getUserById (@PathParam ("id") Long id) {
        if (id == 1) {
            return response.ok (neuer Benutzer (1L, "Alice")). Build ();
        } anders {
            return response.status (response.status.not_found) .build ();
        }
    }

    @POST
    @Consumes (minyType.Application_json)
    ?ffentliche Antwort createUser (Benutzerbenutzer) {
        // Erstellung simulieren
        user.setID (3L); // ID zuweisen
        return response.status (response.status.created) .Entity (Benutzer) .build ();
    }
}

Und ein einfacher User oder eine einfache Klasse:

 public record user (long id, string name) {
    public void setid (Long id) {
        // für einige JSON -Mapper ben?tigt, wenn sie ver?nderliches Verhalten verwenden
    }
}

3. Konfigurieren Sie die Anwendung

Sie k?nnen JAX-RS automatische Entdeckungsressourcen lassen oder eine Application erstellen, um sie explizit zu registrieren.

 importieren jakarta.ws.rs.core.application;
Java.util.set importieren;

RESTAPLIKING PUBLECT CLASS ANWENDUNG ANWENDUNG {
    @Override
    public set <class <? >> getClassSes () {
        Set <class <? >> classes = new java.util.hashset <> ();
        classes.add (usserresource.class);
        Rücklaufklassen;
    }
}

Registrieren Sie dies dann in web.xml (wenn es verwendet wird):

 <NEW-App>
    <servlet>
        <servlet-name> javax.ws.rs.core.application </servlet-name>
        <Servlet-Class> org.glassfish.jersey.servlet.servletContainer </Servlet-Klasse>
        <init-param>
            <Param-name> jakarta.ws.rs.application </param-name>
            <Param-value> com.example.Restapplication </param-value>
        </init-param>
        <Load-on-Startups> 1 </Load-on-Startup>
    </servlet>
    <Servlet-Mapping>
        <servlet-name> javax.ws.rs.core.application </servlet-name>
        <URL-Muster>/API/*</url-pattern>
    </Servlet-Mapping>
</web-App>

Alternativ k?nnen moderne Jakarta EE -Apps web.xml weglassen und sich auf Anmerkungen verlassen.

4. Fügen Sie JSON -Support (Moxy oder Jackson) hinzu

Standardm??ig verwendet Jersey Moxy für die JSON -Bindung. Sie k?nnen zu Jackson wechseln, um mehr Flexibilit?t zu erhalten:

Zu pom.xml hinzufügen:

 <De vorangehen>
    <GruppeId> org.glassfish.jersey.media </Groupid>
    <artifactid> jersey-media-json-jackson </artifactid>
    <version> 3.1.3 </Version>
</abh?ngig>

Registrieren Sie dann die JacksonFeature in Ihrer Application oder über Web.xml -Init -Parameter.

5. Bereitstellen und Test

Stellen Sie Ihre Kriegsdatei in einem Jakarta EE- oder Servlet -Container ein:

• Standalone : Verwenden Sie eingebettete Steg oder Tomcat mit Jersey.
• Vollst?ndige Plattform : Bereitstellung in Payara Micro , Wildfly oder Open Liberty für vollst?ndige Jakarta EE -Funktionen.

Test mit curl :

 curl http: // localhost: 8080/yourapp/api/user
# Gibt zurück: [{"id": 1, "name": "alice"}, {"id": 2, "name": "bob"}]

Wichtige Vorteile von Jakarta EE für REST -APIs

• Standardisiert : JAX-RS ist eine Spezifikation-tragbar über Implementierungen hinweg.
• Abh?ngigkeitsinjektion : Verwenden Sie @Inject mit CDI für die Integration der Clean Service Layer.
• Sicherheit : Integrieren Sie sich in Jakarta Security ( @RolesAllowed usw.).
• Validierung : Verwenden Sie die Bean -Validierung ( @NotNull , @Size ) auf Antragsk?rper.
• Asynchrone Verarbeitung : Unterstützung für AsyncResponse bei langj?hrigen Aufgaben.

Beispiel mit CDI:

 @Path ("/Benutzer")
@RequestScoped
?ffentliche Klasse Userresource {

    @Injizieren
    UserService UserService;

    @ERHALTEN
    ?ffentliche Antwort getall () {
        return response.ok (userService.getall ()). Build ();
    }
}

Auf dem Bauen von erholsamen APIs mit Jakarta EE erhalten Sie eine reife, unternehmungsl?sliche Grundlage. W?hrend neuere Frameworks wie Spring Boot für Microservices beliebter sind, bleibt Jakarta EE eine starke, standardbasierte Alternative-insbesondere in Umgebungen, in denen Portabilit?t und langfristige Unterstützung von Bedeutung sind.

Wenn Sie mit offiziellen Java-Standards zuverl?ssige, aufrechterhaltene APIs aufbauen m?chten, ist Jakarta EE mit JAX-RS ein bew?hrter Weg. W?hlen Sie einfach Ihre Laufzeit aus, definieren Sie Ihre Ressourcen und gehen Sie.

Das obige ist der detaillierte Inhalt vonAufbau erholsamer APIs in Java mit Jakarta EE. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!