Einführung
Einführung

Einführung / FirstSpirit ServerManager / Projekteigenschaften / Web-Komponenten

Web-Komponenten

Web-BereicheWeb-Komponente hinzufügenWeb-Komponente aktualisierenDeinstallierenWeb-Komponente konfigurierenWeb-Komponente löschenGewählter Webserverweb.xml bearbeitenWeb-KomponentenPluggabilityInstallieren / Aktualisieren
Inhaltsverzeichnis

In diesem Bereich können die Web-Komponenten für ein Projekt aktiviert werden.

Web-Bereiche

Es existieren für jedes Projekt vier unterschiedliche Web-Bereiche. Über die jeweilige Registerkarte können die Web-Komponenten für jeden Bereich einzeln aktiviert und konfiguriert werden:

  • Vorschau (Preview): Ort für die Projektinhalte, für die eine Vorschau angefordert wurde.
  • QA (Staging): Ort für die generierten Projektinhalte
  • Produktion (Live): Ort für die veröffentlichten Projektinhalte  
  • ContentCreator: Konfiguration für eine projektlokale ContentCreator-Instanz

Verwendung des FirstSpirit CXT ContentCreator

Design und technische Basis des FirstSpirit ContentCreator wurden überarbeitet. Der „alte“ ContentCreator wird planmäßig mit FirstSpirit 2020-07 entfallen. Zu detaillierteren Informationen siehe auch „FirstSpirit Release Notes“.
Während einer Übergangszeit kann zwischen der „alten“ und der überarbeiteten Version gewechselt werden. Dies geschieht über die Checkbox „Neues Design verwenden“ auf dem Register „ContentCreator“:
Ist die Checkbox in den Server-Eigenschaften aktiviert (unter Web-Applikationen), wirkt sich dies auf alle Projekte aus, die die globale ContentCreator-Instanz verwenden. („Globale ContentCreator-Instanz“: Auf dem Register „ContentCreator“ unter Projekt-Eigenschaften / Web-Komponenten ist kein Webserver konfiguriert: „[Keiner]“).
Gibt es projektlokale ContentCreator-Instanzen, muss auch für diese die Checkbox aktiviert werden, wenn für diese der FirstSpirit CXT ContentCreator verwendet werden soll (unter „Projekt-Eigenschaften / Web-Komponenten“, Register „ContentCreator“). („Projektlokale ContentCreator-Instanz“: Auf dem Register „ContentCreator“ unter „Projekt-Eigenschaften / Web-Komponenten“ ist ein anderer Webserver konfiguriert als unter „Server-Eigenschaften / Web-Applikationen“, Register „ContentCreator“.)

Wichtig Die Option „Pluggability“ muss jeweils auf „Aktiv“ stehen.
Wenn als Webserver „Jetty Web Server“ eingesetzt werden soll, muss FirstSpirit mindestens in Version 2019-12 verwendet werden.

Die Änderung muss anschließend deployed werden (Schaltfläche „Aktualisieren“ bzw. „Installieren“).

Verwendeter Webserver

In jedem Web-Bereich können die Web-Komponenten für jedes Projekt konfiguriert werden. Im Dialog wird der momentan aktive Webserver für jeden Bereich angezeigt.
Über die danebenliegende Combobox kann ein anderer Webserver ausgewählt werden. Zur Auswahl stehen alle Webserver, die im Bereich Webserver konfiguriert wurden. Abhängig vom Webserver-Typ sind zur Umstellung unterschiedliche Schritte erforderlich:

Installieren: Mit einem Klick auf die Schaltfläche Installieren werden alle Web-Komponenten im jeweiligen Web-Bereich des Projekts in einer WAR-Datei zusammengefasst und abhängig vom konfigurierten Webserver installiert. Der Button ist aktiv, wenn die Web-Komponente noch nicht installiert wurde und zur Installation bereit ist. Ist der Button deaktiv, wurden die Web-Komponenten bereits installiert.
Handelt es sich beim ausgewählten Webserver um einen generischen Webserver ohne die erforderliche Skript-Funktionalität oder ggf. einen Aggregating oder externen Webserver, wird stattdessen die Schaltfläche Download (siehe unten) angezeigt.             
Wurde die Webanwendung bereits installiert, anschließend aber die Konfiguration geändert (Schaltfläche „Konfigurieren“, siehe unten) oder eine Komponente hinzugefügt (Schaltfläche „Hinzufügen“, siehe unten) oder gelöscht (Schaltfläche „Löschen“, siehe unten), wird statt der Schaltfläche Installieren die Schaltfläche Aktualisieren angezeigt.

Deinstallieren: Mit einem Klick auf die Schaltfläche Deinstallieren werden die Web-Komponenten im jeweiligen Web-Bereich des Projekts wieder vom Webserver gelöscht. Diese Aktion wird für alle Web-Komponenten des jeweiligen Bereichs ausgeführt. Abhängig vom verwendeten Webserver wird die Deinstallation analog zur Installation einer Web-Komponente ausgeführt. Ist der Button deaktiv, wurden die Web-Komponenten noch nicht installiert.

Download: Mit einem Klick auf die Schaltfläche Download kann eine WAR-Datei der Anwendung heruntergeladen werden, die manuell auf dem Webserver installiert werden muss (siehe Externen Webserver für eine Web-Applikation konfigurieren, Option „Download der War-Datei“). Die Schaltfläche wird nur für die Konfiguration von generischen Webservern ohne die erforderliche Skript-Funktionalität und ggf. externe Webserver angezeigt sowie für Aggregating Web Server, wenn für einen der ausgewählten Webserver keine Steuerung durch FirstSpirit möglich ist.

Pluggability: Mit Version 3.0 der Java Servlet Specification wurden sogenannte Pluggability-Features eingeführt. Diese ermöglichen etwa die Modularisierung der web.xml oder ein Konfigurieren von Komponenten über Java-Annotationen. Letztere Funktion erfordert jedoch, dass beim Deployment der Web-Applikation (und damit implizit bei jedem Start des Application-Servers) alle Klassen auf Annotationen gescannt werden müssen.
Da dieser Vorgang viel Zeit in Anspruch nehmen kann, bietet FirstSpirit die Möglichkeit, Pluggability-Features global oder für einzelne Web-Applikationen zu deaktivieren. Für Web-Komponenten erfolgt dies über das Auswahlfeld „Pluggability“: 

  • Aktiv: Pluggability-Features werden aktiviert, Java-Klassen werden beim Deployment auf Annotationen gescannt. Dies ist der Standardwert.
  • Inaktiv: Pluggability-Features werden deaktiviert, es erfolgt kein Scan der Java-Klassen.

Web-Komponenten

Hinzufügen: Mit einem Klick auf diese Schaltfläche öffnet sich der Dialog „Hinzufügen“. In der Liste werden alle Web-Komponenten angezeigt, die für diese Web-Applikation zum Hinzufügen zur Verfügung stehen (siehe Module).
Diese Web-Komponenten können den einzelnen Web-Bereichen (Preview, Staging, Live, ContentCreator) innerhalb des gewünschten Projekts zugefügt werden. Anschließend besteht die Möglichkeit, diese Komponenten zu konfigurieren (siehe „Konfigurieren“ unten), entweder mit einer von der Komponente erzeugten oder einer generischen GUI.

Löschen: Mit einem Klick auf die Schaltfläche Löschen können zuvor hinzugefügte Komponenten wieder entfernt werden. Diese Komponenten werden in der Tabelle nicht mehr angezeigt und sind bei der nächsten Veröffentlichung kein Bestandteil der WAR-Datei mehr. Damit die Änderungen wirksam werden, muss eine Veröffentlichung auf dem Webserver erfolgen (Button „Installieren“, siehe oben).

Konfigurieren: Mit einem Klick auf die Schaltfläche Konfigurieren kann die Konfiguration für eine zuvor hinzugefügte Komponente bearbeitet werden (vgl. Module). Abhängig von der Komponente, erfolgt die Konfiguration in der Regel über eine von der Komponente erzeugte GUI.

Aktualisieren: Mit einem Klick auf diese Schaltfläche kann die Komponente aktualisiert werden. Die Aktualisierung erfolgt gegen die aktuelle Version der Komponente auf dem FirstSpirit-Server. Ist dort eine aktuellere Version verfügbar, wird die Aktualisierung für das jeweilige Projekt angestoßen.

web.xml: Werden eine oder mehrere Web-Komponenten für einen Web-Bereich konfiguriert, wird automatisch eine Datei web.xml erstellt, die aus den einzelnen web.xmls der jeweiligen Komponenten besteht. Die Datei web.xml kann manuell editiert werden. Mit einem Klick auf die Schaltfläche web.xml öffnet sich das Dialog-Fenster zur manuellen Konfiguration der Datei. Nach dem Speichern der Änderungen wird in der Übersicht in der Spalte „web.xml“ nicht mehr der Wert „Standard“, sondern der Wert „Editiert“ angezeigt:

© 2005 - 2020 e-Spirit AG | Alle Rechte vorbehalten. | FirstSpirit 2020-01 | Datenschutz | Impressum | Kontakt