Web-Service-Methoden › REST-HTTP-Methoden

REST-HTTP-Methoden

Die REST-API unterstützt folgende HTTP-Methoden, um Ressourcen zu bearbeiten:

• POST (CREATE) erstellt eine Ressource.
• GET (READ) gibt eine Darstellung einer Ressource zurück.
• PUT (UPDATE) aktualisiert eine vorhandene Ressource.
• DELETE löscht die Ressource.

Verweisen Sie auf diesen grundlegenden Satz von Methoden als CRUD. Jede Methode funktioniert auf die gleiche Weise auf allen CA SDM-Ressourcen. Sie benötigen eine HTTP-Client-Bibliothek, die mit den meisten Programmiersprachen verfügbar ist. Verwenden Sie die HTML-Client-Bibliothek, um folgende Aufgaben abzuschließen:

• Greifen Sie auf zugeordnete (oder zugehörige) Ressourcen zu, und ändern Sie sie, indem Sie einen mehrstufigen URI-Pfad verwenden.
• Senden Sie eine HTTP-Request an den Server für die Ressource, die Sie bearbeiten möchten.
• Steuern Sie die Objektattribute, die durch die Verwendung von HTTP-Headern zurückgegeben werden sollen.

Nachdem Sie Majic-Objektdefinitionen aktualisiert und CA SDM zurückgeführt haben, wird das Produkt automatisch regeneriert und die entsprechenden "Plain Old Java Objects" (POJOs) werden im Verzeichnis "webapps" von REST-Tomcat erneut bereit.

Hinweis: Mit dem Befehlszeilenhilfsprogramm "pdm_rest_util" können Sie Java-Code, der REST-Webservices benötigt, manuell generieren, kompilieren und bereitstellen.

Wichtig! Requests für Attribute, die nicht antworten, zeigen einen ungültigen Attributwert an. Ändern Sie dementsprechend Ihren Client-Code, da REST keine ungültigen Attributwerte in Antworten anzeigt.

REST-Webservices bieten Anwendern eine skalierbare Konfiguration und bessere Flexibilität, indem sie die Möglichkeit bieten, eine Verbindung mit einem dedizierten "domsrvr" auf dem lokalen Server herzustellen. Standardmäßig übergibt CA SDM r12.9 die Variable "NX_REST_WEBSERVICE_DOMSRVR" an "domsrvr". Sie können "NX.env" bearbeiten, um diese Einstellung zu ändern.

CA SDM deaktiviert die REST-Beispieloberfläche für Mobilgeräte und zeigt standardmäßig alle Majic-Factorys über REST-Webservices an.

Wichtig! Die REST-API unterstützt keine Majic-Attribute vom Typ DOUBLE.

Folgende Tabelle zeigt, wie die REST-API HTTP-Methoden auf Ressourcen verwendet.