Zum Inhalt springen

Wiki-Quellcode von Properties

Zuletzt geändert von MACH formsolutions am 08.10.2025
Zeige letzte Bearbeiter
1 Wenn von der Standardkonfiguration abgewichen werden soll, dann können die meisten Konfigurationseinstellungen mit der Hilfe von `properties`-Dateien überschrieben werden. Diese müssen in das Verzeichnis
2
3 ```text
4 <user-home>/.formsolutions
5 ```
6
7 eingetragen werden. Die Hauptdatei für die Konfigurationen muss `general.properties` heißen. `<user-home>` wird sich im Fall dieser Anleitung auf `/opt/wildfly/` beziehen.
8
9 Eine genaue Erklärung wie die Dateien zu benennen sind und wo sie sich befinden, findet man [[hier|01_Speicherorte]].
10
11 ## Zeichenkodierung
12
13 Property-Dateien (.properties) in Java und Spring sollten standardmäßig in ISO-8859-1 (Latin-1) kodiert sein – das ist die ursprüngliche Spezifikation gemäß der Java-Properties-Klassen (wie java.util.Properties). Nicht-ASCII-Zeichen (z. B. Umlaute, kyrillisch, etc.) müssen in diesem Fall als Unicode-Escapes und gespeichert sein. Beispiel: `ä = \u00e4`, `Ö = \u00D6`, `ß = \u00DF`
14
15 ## Property-Typen
16
17 Die folgenden Properties sind konfigurierbar. Sie sind nach Anwendungsgebieten sortiert und können alle in der Hauptkonfiguration eingetragen werden. Es gibt auch die Möglichkeit einer anwendungsspezifischen Detailkonfiguration. Die PropertyTypen sind:
18
19 * **int**
20 Eine Ganzzahl.
21 * **string**
22 Ein einfacher Text.
23 * **URL**
24 Eine URL, die entweder absolut (mit Protokoll, Hostname, Port etc.) oder relativ angegeben werden kann.
25 * **path**
26 Eine Pfadangabe, die sich auf das Dateisystem bezieht. Generell sind diese absolut anzugeben.
27 * **boolean**
28 Ein on/off-Schalter, der mit den Werten `true` und `false` gesetzt wird.
29
30 ## Property-Sortierung
31
32 > **Wichtig!**
33 >
34 > Die Wichtigen bzw. notwendigen Properties **müssen** überprüft bzw. gesetzt werden, da die Anwendung sonst nicht lauffähig ist!
35
36 Die Properties sind sortiert in
37
38 * **Wichtige bzw. notwendige Properties**
39 Properties, die unbedingt auf ihre Standardwerte geprüft und entsprechend angepasst werden müssen.
40 * **Optionale Properties**
41 Properties, die überprüft und ggf. angepasst werden können.
42 * **Interne Properties**
43 Properties, die für interne Zwecke genutzt werden, und nur in Sonderfällen in Absprache mit MACH geändert werden sollten.
44
45 ## Mehrfachverwendung
46
47 Es kommt vor, dass Properties verschieden benamt sind, sich aber auf den gleichen Wert beziehen (dies kommt bei Datenbankanbindungen oft vor). Zu diesem Thema gibt es [[hier|10_Beispiele]] ein paar Beispiele, wie diese Dateien aussehen können, und wie sie Properties mehrfach verwenden.