|
|
| Zeile 1: |
Zeile 1: |
| − | == Einleitung ==
| + | #REDIRECT [[Technische Konzepte: Config Manager]] |
| − | | + | |
| − | 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.
| + | |
| − | Das 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
| + | |
| − | | + | |
| − | Der Logger benutzt Standardmäßig das LogLevel INFO
| + | |
