Betrieb

Dieses Dokument behandelt die folgenden Themen:

Bereitstellung der Webanwendung mit Tomcat

Im Folgenden finden Sie einige spezifische Konfigurationen für Apache Tomcat®, falls Sie die Natural OpenAPI-Webanwendung mit Ihrem eigenen Tomcat bereitstellen möchten.

Bereitstellung der War-Datei

Die Datei NaturalOpenAPIServer.war muss in das Verzeichnis /tomcat/webapps/ kopiert werden.

Zusätzlich muss die Umgebungsvariable SPRING_CONFIG_LOCATION so konfiguriert werden, dass sie auf den Speicherort der Datei application.properties zeigt.

Konfiguration der Datei Server.XML

Alternativ kann die folgende Konfiguration bei der Bereitstellung des Natural OpenAPI-Servers zur Datei server.xml von Tomcat hinzugefügt werden. 

<Context path="/noa1" docBase="noa1" override="true">
      <Environment name="SPRING_CONFIG_LOCATION" value="/your-path/conf/application.properties" type="java.lang.String" />
</Context>

Bereitstellung von OpenAPI-Ressourcen

Um die im Abschnitt Developer Overview > Generating OpenAPI Resources beschriebenen Dienste bereitzustellen, muss der Natural OpenAPI Server mit dem Speicherort der Dienstdateien konfiguriert werden.

Der Speicherort der Dienstdateien kann auf folgende Weise konfiguriert werden:

  • Unter Verwendung von natural.integration.services.directory – Legen Sie diese Property in der Datei application.properties fest, um das Verzeichnis anzugeben, das die Dienstdateien enthält. Speichern Sie die Dienstdateien in dem angegebenen Verzeichnis.

  • Unter Verwendung von natural.integration.services.files – Legen Sie diese Property fest, um die Namen der spezifischen Dienstdateien anzugeben, die bereitgestellt werden sollen. Die angegebenen Dateien müssen sich im Class-Pfad der Anwendung befinden.

Beim Start des Natural OpenAPI-Servers werden die konfigurierten Dienstdateien geladen und die darin definierten OpenAPI-Dienste registriert.

Jede Dienstdatei enthält die Definitionen und Mapping-Informationen, die erforderlich sind, um ein Natural-Subprogramm als REST API-Dienst bereitzustellen. Sobald der Server erfolgreich gestartet wurde, stehen alle in den geladenen Dienstdateien definierten Dienste den Clients über den Natural OpenAPI Server zur Verfügung. Weitere Informationen finden Sie unter dem Parameter management.endpoints.web.exposure.include im Abschnitt Allgemeine Konfiguration section.

Um einen Dienst hinzuzufügen oder zu ändern, muss daher die entsprechende Dienstdatei aktualisiert und der Server neu gestartet werden oder der Reload-Aktuator-Endpunkt verwendet werden, damit die Änderungen geladen werden und die Dienste verfügbar sind.

On this page