Thema dieser Dokumentation / FirstSpirit Modul-Grundkonzeption / Komponenten / Komponenten-Typen / Webserver
Webserver
Eine Webserver-Komponente steuert einen laufenden Webserver. Beispiele hierfür sind die interne Webserver-Steuerung oder eine Tomcat-Unterstützung. Eine Webserver-Komponente implementiert die Steuerung eines bestimmten Webservers (beispielsweise Tomcat), zunächst das Deploy/Undeploy von Webanwendungen. Über den FirstSpirit ServerManager (Servereigenschaften - Webserver, siehe Webserver (→Dokumentation für Administratoren)) lassen sich Webserver hinzufügen und so dem FirstSpirit-Server bekannt machen.
Anwendungsbeispiel:
- Die Unterstützung für WebSphere wird als Modul (fs-ibmws.fsm) umgesetzt.
- Installation des Moduls.
- Server-Eigenschaften: WebSphere als "WS-1" hinzufügen, URLs und Passwörter konfigurieren.
- Projekt-Eigenschaften: Staging, Umschalten von "Intern" auf "WS-1".
Webserver implementiert das Interface WebServer:
- de.espirit.firstspirit.module.WebServer
- de.espirit.firstspirit.access.schedule.WebServerConfiguration
- de.espirit.firstspirit.access.schedule.DeployTarget
Webserver-Komponenten erweitern den <components>-Teil des Modul-Deskriptors (Beispiel siehe Webserver):
<web-server></web-server>
Sichtbarkeit: Webserver-Komponenten sind immer server-weit sichtbar, d.h. sie stehen nach der Installation auf dem Server zur Verfügung. Nach der Installation kann der Webserver den gewünschten Webbereichen (Preview, Staging, Live) eines (oder mehrerer) Projekte zugeordnet werden (Projekteigenschaften – Webkomponenten) (siehe Sichtbarkeit von Komponenten).
Konfiguration: Eine Webserver-Komponente kann eine Konfigurationsoberfläche zur Verfügung stellen, um beispielsweise Pfade, URLs, Passwörter u.ä. einzustellen, die innerhalb des FirstSpirit ServerManagers aufgerufen werden kann (Servereigenschaften - Webserver). Die entsprechende Konfigurationsklasse muss dazu das Interface Configuration<ServerEnvironment> implementieren (siehe Konfiguration von Komponenten):
- de.espirit.firstspirit.module.Configuration
- de.espirit.firstspirit.module.ServerEnvironment