Wiki-Quellcode von Properties

Zuletzt geändert von MACH formsolutions am 08.10.2025

version	line-number	content
1.1	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
3.2	11	## Zeichenkodierung
	12
6.1	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`
3.2	14
1.1	15	## Property-Typen
	16
3.1	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:
1.1	18
3.1	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.
1.1	29
	30	## Property-Sortierung
	31
3.1	32	> Wichtig!
	33	>
2.1	34	> Die Wichtigen bzw. notwendigen Properties müssen überprüft bzw. gesetzt werden, da die Anwendung sonst nicht lauffähig ist!
1.1	35
	36	Die Properties sind sortiert in
	37
3.1	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
7.1	43	Properties, die für interne Zwecke genutzt werden, und nur in Sonderfällen in Absprache mit MACH geändert werden sollten.
1.1	44
	45	## Mehrfachverwendung
	46
3.1	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.