Karta ćwiczenia laboratoryjnego

📋 Informacje podstawowe

📝 Opis zadania laboratoryjnego

W projekcie (folder src_Spring_Lab6) dostarczonym razem z tą karą zaimplementowano przykład reprezentujący Spring Configuration Properties. W projekcie znajdują się 3 pliki: ConfigDemoApplication, MyAppProperties, application.properties. Umieść poniżej każdy z plików oraz kolorem czerwonym opisz działanie i istotne elementy kodu programu.

📦 Wymagania

Kod każdego z trzech plików projektu wraz z opisem należy umieścić w sekcji KOD PROGRAMU - REALIZACJA tego pliku. Opis działania i istotnych elementów kodu należy wpisać kolorem czerwonym (np. <span style="color:red">...</span>). Plik .md należy dodać do projektu.

Całość należy spakować do formatu .zip:

WSZIB_R3IN_NazwiskoImie_Spring_Lab6.zip

W miejscu NazwiskoImie należy wpisać swoje nazwisko i imię (uwaga na kolejność). Wynik pracy w formie archiwum zip powinien zawierać:

• folder Program z projektem Spring Boot (zawartość folderu src_Spring_Lab6),
• uzupełniony ten plik tj. .md.

Archiwum WSZIB_R3IN_NazwiskoImie_Spring_Lab6.zip należy uzupełnić o swoje dane w nazwie i przesłać poprzez:

🎯 Ogólny opis zadania

Celem zadania jest zapoznanie się z mechanizmem Spring Configuration Properties — sposobem mapowania właściwości z pliku application.properties na pola obiektu Javy oraz ich walidacji.

W dostarczonym projekcie (folder src_Spring_Lab6) aplikacja Spring Boot wczytuje grupę właściwości z prefiksem myapp do klasy MyAppProperties oznaczonej adnotacją @ConfigurationProperties. Wartości obejmują pola proste (name, version, enabled), obiekt zagnieżdżony (server z polami host i port) oraz listę (admins). Po uruchomieniu aplikacja w komponencie CommandLineRunner wypisuje wczytaną konfigurację na konsolę.

Klasa MyAppProperties wykorzystuje walidację (Jakarta Validation / Hibernate Validator) — m.in. @NotBlank, @Pattern, @NotEmpty, @Email, @Min, @Max oraz @Valid dla obiektu zagnieżdżonego. Adnotacja @Validated na klasie aktywuje sprawdzanie poprawności właściwości przy starcie aplikacji.

Zadaniem studenta jest przeanalizowanie i opisanie działania trzech plików projektu:

• ConfigDemoApplication.java — klasa startowa z CommandLineRunner,
• MyAppProperties.java — klasa właściwości z walidacją,
• application.properties — plik z wartościami konfiguracji.

✅ Wymagania funkcjonalne

🔧 Wymagania niefunkcjonalne

🧩 Diagram klas

classDiagram
    class ConfigDemoApplication {
        +main(String[] args) void
        +run(MyAppProperties props) CommandLineRunner
    }
    class MyAppProperties {
        -String name
        -String version
        -boolean enabled
        -Server server
        -List~String~ admins
        +getName() String
        +getVersion() String
        +isEnabled() boolean
        +getServer() Server
        +getAdmins() List~String~
    }
    class Server {
        -String host
        -int port
        +getHost() String
        +getPort() int
    }

    MyAppProperties *-- Server : zawiera
    ConfigDemoApplication --> MyAppProperties : @Bean / wstrzykiwanie

Legenda diagramu:

💻 KOD PROGRAMU - REALIZACJA

JAVA (ConfigDemoApplication.java)

// Wklej tutaj kod Java

Opis działania i istotnych elementów kodu:

JAVA (MyAppProperties.java)

// Wklej tutaj kod Java

Opis działania i istotnych elementów kodu:

PROPERTIES (application.properties)

# Wklej tutaj zawartość pliku application.properties

Opis działania i istotnych elementów pliku:

🏆 Ocena [wypełnia prowadzący]

Ocena kodu

Ocena końcowa