Das Boot-Verfahren

Das Boot-Verfahren#

Beim Starten sucht die Anwendung an vordefinierten Orten nach Konfigurationsdateien, um z.B. eine Verbindung zur Datenbank herstellen zu können.

Im folgenden wird beschrieben, wie die Anwendung startet (Boot-Vorgang).

  • Die Anwendung sucht im Verzeichnis webapps des Servlet Containers nach einer Datei namens Torque.<Kontext>.properties. Ist die Anwendung z.B. unter webapps/demo installiert, würde nach der Datei Torque.demo.properties gesucht werden. Dies erlaubt es, mehrere Instanzen im selben Container auszuführen.

  • Falls diese Datei gefunden wurde, wird die Konfiguration der Datenbankverbindung von dort übernommen. Innerhalb dieser Datei sucht die Anwendung nach einer Eigenschaft namens ALLEGRA_HOME. Wird diese Eigenschaft gefunden, wird bis zur Herstellung der Datenbankverbindung dieser Wert für das Home-Verzeichnis verwendet. Nach Herstellung der Datenbankverbindung wird der Wert aus der Datenbank übernommen. Ist er undefiniert, wird die Datenbank mit dem Wert von ALLEGRA_HOME initialisiert.

  • Wenn zu diesem Zeitpunkt ALLEGRA_HOME noch nicht gesetzt wurde, sucht die Anwendung nach einer Umgebungsvariablen ALLEGRA_BOOT. Wurde diese gefunden, wird im entsprechenden Verzeichnis nach einer Datei Torque.properties gesucht. Wurde diese gefunden, wird mit dieser Konfiguration die Datenbankverbindung aufgebaut.

  • Innerhalb dieser Datei sucht die Anwendung nach einer Eigenschaft namens ALLEGRA_HOME. Sie wird falls vorhanden diesen Wert benutzen, bis er von der Datenbank-Konfiguration überschrieben wird. Wurde die Datenbank noch nicht konfiguriert, wird der ALLEGRA_HOME-Wert verwendet, um die Datenbank zu initialisieren.

  • Wenn entweder ALLEGRA_BOOT oder Torque.properties nicht gefunden wurden, sucht die Anwendung nach einer Umgebungsvariablen ALLEGRA_HOME.

  • Wurde diese gefunden, wird im entsprechenden Verzeichnis nach einer Datei Torque.properties gesucht. Wurde diese gefunden, wird mit dieser Konfiguration die Datenbankverbindung aufgebaut.

  • Innerhalb dieser Datei sucht die Anwendung nach einer Eigenschaft namens ALLEGRA_HOME. Sie wird falls vorhanden diesen Wert benutzen, bis er von der Datenbank-Konfiguration überschrieben wird. Wurde die Datenbank noch nicht konfiguriert, wird der ALLEGRA_HOME-Wert verwendet, um die Datenbank zu initialisieren.

  • Wenn an diesem Punkt ALLEGRA_HOME noch nicht gesetzt wurde, wird im Klassenpfad nach einer Datei Torque.properties gesucht. Da in der dann gefundenen Datei eine Standardkonfiguration ist, funktioniert die Anwendung normalerweise nicht.