Technische Konzepte: Config Manager - Versionsgeschichte

Bepf am 17. Mai 2012 um 14:18 Uhr

2012-05-17T14:18:28Z

← Nächstältere Version		Version vom 17. Mai 2012, 14:18 Uhr
Zeile 25:		Zeile 25:
	Da der ConfigManager statisch ist muss nichts initialisiert werden.		Da der ConfigManager statisch ist muss nichts initialisiert werden.
	Es sollte aber an einer zentralen Stelle das ConfigFile definiert werden (durch "readConfig(File file)), die angebene Datei bleibt zur Laufzeit gespeichert, alle anderen Methoden beziehen sich nun auf diese Datei.		Es sollte aber an einer zentralen Stelle das ConfigFile definiert werden (durch "readConfig(File file)), die angebene Datei bleibt zur Laufzeit gespeichert, alle anderen Methoden beziehen sich nun auf diese Datei.
		+
		+	== Grafische Benutzeroberfläche (GUI) ==
		+
		+	In der neuesten Version des Programms "Baumschule" wurde für den Konfigurationsmanager eine Oberfläche geschaffen, mit dem der Nutzer ohne einen Texteditor verschiedene Einstellungen bearbeiten kann. Der Konfigurationsmanager hat somit auch Methoden bekommen um Einstellungen zu editieren (und wieder in die Konfigurationsdatei zu schreiben).
		+	Die grafische Benutzeroberfläche bietet nun z.B. die Einstellung das Trennzeichen für das CSV-Format zu ändern, oder die Farben der angezeigten Bäume.

Chge: /* Wie kann ein Wert aus dem ConfigManager gelesen werden? */

2012-05-02T10:29:41Z

Wie kann ein Wert aus dem ConfigManager gelesen werden?

← Nächstältere Version		Version vom 2. Mai 2012, 10:29 Uhr
Zeile 13:		Zeile 13:

	Wie auch der Logger, so ist der ConfigManager nun statisch und braucht nicht initialisiert werden.		Wie auch der Logger, so ist der ConfigManager nun statisch und braucht nicht initialisiert werden.
−	Es kann eine komplette Liste gelesen werden aus einer Datei (oder aus einer Standarddatei), die Liste bleibt zur Laufzeit auch dem ConfigManager bekannt und muss nicht manuell verwaltet werden. Durch die Methode "getValueFromKey" wird durch einen Parameterangabe des Schlüssels ein Wert ~~herausgsucht~~ aus dieser Liste und zurückgegeben. Sollte die Liste leer sein, versucht das Programm eine Standarddatei zu lesen. Ist kein Schlüssel gefunden worden ist der zurückgegebene Wert "null".	+	Es kann eine komplette Liste gelesen werden aus einer Datei (oder aus einer Standarddatei), die Liste bleibt zur Laufzeit auch dem ConfigManager bekannt und muss nicht manuell verwaltet werden. Durch die Methode "getValueFromKey" wird durch einen Parameterangabe des Schlüssels ein Wert herausgesucht aus dieser Liste und zurückgegeben. Sollte die Liste leer sein, versucht das Programm eine Standarddatei zu lesen. Ist kein Schlüssel gefunden worden ist der zurückgegebene Wert "null".

	Durch die Methode "writeConfigLine" wird der zuletzt geöffneten Konfigurationsdatei eine Zeile hinzugefügt.		Durch die Methode "writeConfigLine" wird der zuletzt geöffneten Konfigurationsdatei eine Zeile hinzugefügt.
	Wurde noch keine Datei angegeben bleibt die Methode funktionslos.		Wurde noch keine Datei angegeben bleibt die Methode funktionslos.
−

	== Wo ist der ConfigManager zu finden? ==		== Wo ist der ConfigManager zu finden? ==

Chge: /* Einleitung */

2012-05-02T10:24:39Z

Einleitung

← Nächstältere Version		Version vom 2. Mai 2012, 10:24 Uhr
Zeile 1:		Zeile 1:
	== Einleitung ==		== Einleitung ==

−	Für viele Bereiche unserer Anwendung sind Konfigurationen notwendig. In unserem Projekt sollen aus einer ~~KonigurationsDatei~~ verschiedene Einstellungen ~~herausgelesen~~ werden können. Diese können z.B. einfach irgendwelche Ports / Addressen beinhalten, die nicht statisch im Quelltext vorliegen ~~sollten~~. Natürlich ~~könnten~~ diese Konfigurationen auch in der Oberfläche verwaltet werden, manche Einstellungen sollen aber z.B. garnicht für einen Nutzer sichtbar sein oder es würde sich schlichtweg nicht lohnen dafür eine Oberfläche zu entwerfen.	+	Für viele Bereiche unserer Anwendung sind Konfigurationen notwendig. In unserem Projekt sollen aus einer Konigurations-Datei verschiedene Einstellungen ausgelesen werden können. Diese können z.B. einfach irgendwelche Ports / Addressen beinhalten, die nicht statisch im Quelltext vorliegen sollen. Natürlich können diese Konfigurationen auch in der Oberfläche verwaltet werden, manche Einstellungen sollen aber z.B. garnicht für einen Nutzer sichtbar sein oder es würde sich schlichtweg nicht lohnen dafür eine Oberfläche zu entwerfen.

	== Format für die Einstellungen ==		== Format für die Einstellungen ==

Jonw: /* Format für die Einstellungen */

2012-01-30T20:35:59Z

Format für die Einstellungen

← Nächstältere Version		Version vom 30. Januar 2012, 20:35 Uhr
Zeile 8:		Zeile 8:
	Dabei gibt es immer einen Schlüssel und einen dazugehörigen Wert. Beide sind durch ein Gleichheitszeichen voneinander getrennt.		Dabei gibt es immer einen Schlüssel und einen dazugehörigen Wert. Beide sind durch ein Gleichheitszeichen voneinander getrennt.

−	'''Beispielschlüssel = ~~Beeispielwert~~'''	+	'''Beispielschlüssel = Beispielwert'''

	== Wie kann ein Wert aus dem ConfigManager gelesen werden? ==		== Wie kann ein Wert aus dem ConfigManager gelesen werden? ==

Jonw: Die Seite wurde neu angelegt: „== Einleitung == Für viele Bereiche unserer Anwendung sind Konfigurationen notwendig. In unserem Projekt sollen aus einer KonigurationsDatei verschiedene Einste…“

2012-01-30T20:35:45Z

Die Seite wurde neu angelegt: „== Einleitung == Für viele Bereiche unserer Anwendung sind Konfigurationen notwendig. In unserem Projekt sollen aus einer KonigurationsDatei verschiedene Einste…“

Neue Seite

== Einleitung ==

Für viele Bereiche unserer Anwendung sind Konfigurationen notwendig. In unserem Projekt sollen aus einer KonigurationsDatei verschiedene Einstellungen herausgelesen werden können. Diese können z.B. einfach irgendwelche Ports / Addressen beinhalten, die nicht statisch im Quelltext vorliegen sollten. Natürlich könnten diese Konfigurationen auch in der Oberfläche verwaltet werden, manche Einstellungen sollen aber z.B. garnicht für einen Nutzer sichtbar sein oder es würde sich schlichtweg nicht lohnen dafür eine Oberfläche zu entwerfen.

== Format für die Einstellungen ==

In einer textlich lesbaren Datei sind die Einstellungen gespeichert. Pro Zeile soll eine Konfiguration verwendet werden.
Dabei gibt es immer einen Schlüssel und einen dazugehörigen Wert. Beide sind durch ein Gleichheitszeichen voneinander getrennt.

'''Beispielschlüssel = Beeispielwert'''

== Wie kann ein Wert aus dem ConfigManager gelesen werden? ==

Wie auch der Logger, so ist der ConfigManager nun statisch und braucht nicht initialisiert werden.
Es kann eine komplette Liste gelesen werden aus einer Datei (oder aus einer Standarddatei), die Liste bleibt zur Laufzeit auch dem ConfigManager bekannt und muss nicht manuell verwaltet werden. Durch die Methode "getValueFromKey" wird durch einen Parameterangabe des Schlüssels ein Wert herausgsucht aus dieser Liste und zurückgegeben. Sollte die Liste leer sein, versucht das Programm eine Standarddatei zu lesen. Ist kein Schlüssel gefunden worden ist der zurückgegebene Wert "null".

Durch die Methode "writeConfigLine" wird der zuletzt geöffneten Konfigurationsdatei eine Zeile hinzugefügt.
Wurde noch keine Datei angegeben bleibt die Methode funktionslos.

== Wo ist der ConfigManager zu finden? ==

Der ConfigManager ist Bestandteil des Jar-Files "tools", dass auch noch den Logger beherbergt.
Das Paket ist mit einer Classpath Variable bereits in unserem Projekt eingebunden.
Er kann einfach mit ConfigManager.xx (xx für die entsprechende Methode) benutzt werden.
Da der ConfigManager statisch ist muss nichts initialisiert werden.
Es sollte aber an einer zentralen Stelle das ConfigFile definiert werden (durch "readConfig(File file)), die angebene Datei bleibt zur Laufzeit gespeichert, alle anderen Methoden beziehen sich nun auf diese Datei.