Konfiguration von Komponenten

Jede Komponente innerhalb der FirstSpirit-Umgebung kann konfiguriert werden. Dazu muss zunächst eine Klasse für die grafische Konfigurationsoberfläche erstellt werden, die das typisierte Interface Configuration<E extends ServerEnvironment> implementiert: 

public class MyComponentConfigPanel
        implements Configuration<ServerEnvironment> {
    ...
}

Das Interface ist typisiert, d. h. der zu verwaltende Wertetyp wird über die (Java 5) Generics-Funktionalität innerhalb der Implementierung festgelegt. Abhängig vom Komponententyp (vgl. Komponenten-Typen) bzw. vom gewünschten Gültigkeitsbereich (vgl. Gültigkeitsbereich) wird hier eine mehr oder weniger umfangreiche Schnittstelle verwendet, die die Umgebung eines installierten Moduls wiederspiegelt:

• Interface ServerEnvironment: Wird für serverweit-gültige Komponenten (beispielsweise Bibliotheken) verwendet und stellt nützliche Informationen bereit, wie z. B. das Modul-Konfigurations-Verzeichnis oder das Modul-Verzeichnis für Logdateien (siehe Komponenten-Konfigurationsdateien).    
• Interface ProjectEnvironment Wird für projektlokal-gültige Komponenten (Projektanwendungen – siehe Projektanwendung) verwendet und erweitert die Informationen aus dem Interface ServerEnvironment, um projektspezifische Informationen, wie z. B. die Project-ID.
• Interface WebEnvironment: Wird für weblokal-gültige Komponenten (Webanwendungen – siehe Webanwendung) verwendet und erweitert die Informationen aus dem Interface ProjectEnvironment, um webspezifische Informationen, wie den Zugriff auf die web.xml der betreffenden Webanwendung.

Anschließend muss innerhalb des Komponenten-Deskriptors das Attribut <configurable/> hinzugefügt werden:

<module>
    ...
    <components>
        ...
        <public>
            <configurable>MyComponentConfigPanel</configurable>
        </public>
    </components>
</module>

Nach der Installation des Moduls ist die entsprechende Komponente konfigurierbar. Abhängig vom Komponententyp bzw. vom Gültigkeitsbereich erfolgt diese Konfiguration serverweit, projekt- oder weblokal. Der Button „Konfigurieren“ im  FirstSpirit ServerManager (Servereigenschaften – Module bzw. Projekteigenschaften – Projekt- bzw. Web-Komponenten) ist aktiv. Siehe dazu Projekt-Komponenten (→Dokumentation für Administratoren) und Web-Komponenten (→Dokumentation für Administratoren)

Beispiel siehe Modul-Implementierung mit den Komponenten-Typen - PUBLIC, SERVICE, LIBRARY.