Uruchomienie z wykorzystaniem pliku properties

[kmisztal]

W projekcie znajduje się plik cecconfig.properties,
proszę przygotować możliwość uruchomienie aplikacji na podstawie tego pliku

https://docs.oracle.com/javase/tutorial/essential/environment/properties.html

Dodatkowo zadanie to jest związane z GUI, tzn. chciałbym aby w GUI była możliwość wczytania i zapisania aktualnego stanu na podstawie takiego pliku.

[smmileey]

• klasa CECProperties umożliwia odczytanie/zapis parametrów z pliku konfiguracyjnego,
• klasa posiada dwa tryby działania: z uwzględnieniem komentarzy, a także bez ich uwzględniania,
• plik konfiguracyjny musi posiadać odpowiednią postać: sekcja z ustawieniami ogólnymi, sekcje poszczególnych gęstości,
• sekcja z ustawieniami ogólnymi rozpoczyna się od pierwszej poprawnie zdefiniowanej pary "klucz - wartość" w następujący sposób: klucz => general.nazwa_właściwości, np. general.iterations, łącznik => znak równości, wartość => dowolna wartość; przykład: general.iterations=10; nazwa_wlasciwości jest ściśle określona jako jedna z następujących możliwości: cores, nstart, iterations, input.filename, input.type, output.filename, output.directory;
• każda para zapisywana jest w osobnej linii, kolejność definiowania jest dowolna,
• sekcja z ustawieniami ogólnymi kończy się po osiągnięciu w pliku pustego wiersza; dopuszcza się stosowanie więcej niż jednego pustego wiersza, jednak wówczas tryb uwzględniający komentarze w pliku nie będzie działał poprawnie (przy zapisie nadmiarowe puste wiersze są pomijane),
• sekcje poszczególnych gęstości również oddzielone są pustymi wierszami (zasada dotycząca wielu pustych wierszy taka jak dla sekcji ustawień ogólnych),
• każda sekcja gęstości składa się z dwóch częsci: pierwsza cześć musi zaczynać się od zdefiniowania dwóch par "klucz-wartość": pierwsza para wskazuje typ gęstości i przyjmuje formę type=nazwa_typu, przy czym nazwa typu musi być jedną ze zdefiniowanych w typie wyliczeniowym Densities; druga para wskazuje liczbę powtórzeń i pętli i przyjmuje postać: repeat=wartość, przy czym wartość musi być poprawną liczbą całkowitą; pary muszą być podane dokładnie w takiej kolejności,
• druga część zawiera zbiór par "klucz - wartość" definiowanych następująco:klucz jest wartością dowolną, przy czym powtórzenie klucza skutkuje nadpisaniem wcześniej ustalonej wartości bieżącą wartością; kolejność stosowania kluczy jest dowolna; wartość może być pojedynczą wartością typu całkowitego, bądź sekwencją liczb całkowitych oddzielonych przecinkami,
• wszystkie pary z obu części sekcji gęstości zapisywane są w osobnych liniach; nie ma dodatkowego rozróżnienia pomiędzy dwoma opisanymi częściami tej sekcji; liczba definiowanych par jest dowolna,
• w dowolnym miejscu w pliku, który nie jest częścią żadnej z powyższych sekcji (stanowi osobną wiersz) mogą być definiowane komentarze: linia komentarza oznaczana jest znakiem #; dopuszczalne są komentarze obejmujące wiele linii, każdy z nich musi być oznaczony hashem,
• po ostatniej sekcji gęstości dopuszcza się stosowanie dowolnej ilości kombinacji komentarzy oraz pustych wierszy (także kilku pod rząd); nie wpływa to na zapis w żadnym z dwóch trybów,
• dane ustawień z sekcji ogólnych można uzyskać metodą getGeneralSettings() w formie LinkedHashMap<GeneralSettings, String>; GeneralSettings jest wartością z dostarczonego typu wyliczeniowego o tej nazwie,
• dane ustawień z poszczególnych sekcji gęstości można uzyskać metodą getDensities() w formie LinkedHashMap<Density, DensityWrapper>; Density jest wartością z dostarczonego typu wyliczeniowego o tej nazwie (odpowiada wartości dla argumentu type z danej sekcji); DensityWrapper jest abstrakcją zawierającą wszystkie informacje na temat danego rodzaju gęstości; w szczególności definiuje ona metodę getTypeOptions() zwracającą obiekt typu TypeOptions (typ zdefiniowany poprzednio w projekcie, jako rozszerzenie HashMapy), który zawiera wszystkie pary "klucz - wartość" zapisane w pliku konfiguracyjnym tej sekcji,
• wszystkie parametry można dowolnie modyfikować w czasie działania programu; skorzystanie z jednej z dostępnych metod zapisu powoduje zapis aktualnie przechowywanego stanu właściwości,
• podczas operacji zapisu można jawnie podać ścieżkę do pliku; w przypadku braku argumentu, nadpisany zostanie plik, z którego odczytano właściwości; jeżeli nie były one wcześniej wczytywane,a nie zostanie określona ścieżka zapisu pliku, spowoduje to zgłoszenie wyjątku,
• podczas operacji zapisu należy przekazać flagę informującą o tym, czy należy zachować komentarze z pliku źródłowego; zachowanie komentarzy umożliwia ich odtworzenie podczas zapisu zmodyfikowanych właściwości (również poprzez ustawienie flagi); w przypadku wybrania opcji nie zachowywania komentarzy podczas wczytywania pliku, zapis do pliku zawsze powoduje ignorowanie komentarzy (nawet jeśli przekażemy flagę true),
• w przypadku zastosowania trybu odczytu z zachowaniem komentarzy, nie należy w czasie działania programu dodawać do poszczególnych sekcji gęstości par "klucz-wartość" innych niż te odczytane z pliku źródłowego, w przeciwnym wypadku podczas zapisu zmodyfikowanych ustawień komentarze nie zostaną poprawnie odwzorowane,
• nieprawidłowości związane z niepoprawnym formatem pliku konfiguracyjnego skutkować będą zgłoszeniem odpowiednich wyjątków,
• przykład prawidłowego pliku konfiguracyjnego jest dołączony do projektu,
• klasa Test.java zawiera przykładowy kod korzystający z klasy CECProperties,

Uwagi techniczne:

• w celu w pełni poprawnego działania klasy w trybie z zachowaniem komentarzy, konieczna była modyfikacja klasy TypeOptions. Zmieniono jej klasę bazową z HashMap na LinkedHashMap i jest to związane z zachowaniem kolejności elementów dodawanych do mapy. Zmiana na nie ma wpływu na poprawność działania klasy w trybie nieuwzględniającym komentarzy.
• wkrótce pojawi się pull request,