Praca z projektami Maven w IntelliJ

1.1 Instalacja JDK

Aby potwierdzić wersję JDK, otwórz terminal i wpisz java -version. Jeśli widzisz wynik z określoną wersją, oznacza to, że masz zainstalowany JDK. W przeciwnym razie należy zapoznać się z oficjalną dokumentacją Java, aby pobrać i zainstalować najnowszą wersję JDK.

1.2 Konfiguracja JDK w IntelliJ IDEA

Aby dodać lub skonfigurować JDK w IntelliJ IDEA:

1. Otwórz IntelliJ IDEA i przejdź do Plik > Struktura projektu.
2. W oknie dialogowym, które się otworzy, w sekcji Ustawienia platformy kliknij opcję SDK.
3. Kliknij przycisk + i przejdź do lokalizacji zainstalowanego środowiska JDK.
4. Wybierz folder JDK i kliknij OK.
5. Kliknij Zastosuj, a następnie OK.

2.1 Rozpoczynanie nowego projektu

1. W IntelliJ IDEA przejdź do menu New > Project.

   IntelliJ IDEA

2. W oknie dialogowym, które się otworzy, wybierz Maven jako system kompilacji.

   Nowy projekt

3. Zaznacz pole "Utwórz z archetypu", co pozwoli Ci wybrać archetyp Maven — szablon dla nowego projektu. Dla tego przykładu, wybierz maven-archetype-quickstart.
4. Kliknij Dalej.

2.2 Ustawianie metadanych projektu

W następnym oknie:

1. Określ GroupId, ArtifactId oraz Version dla swojego projektu. Te właściwości identyfikują Twój projekt w lokalnym repozytorium Maven.
2. Wybierz lokalizację do przechowywania plików projektu.
3. Kliknij Dalej, sprawdź ustawienia Maven, a następnie kliknij Zakończ.

Twój nowy projekt Maven został utworzony! Strukturę projektu zobaczysz po lewej stronie w oknie narzędziowym.

2.3 Zrozumienie pliku pom.xml

Każdy projekt Maven posiada plik pom.xml, skrót od Project Object Model, znajdujący się w katalogu głównym projektu. Ten plik opisuje Twój projekt, jego zależności i inne właściwości.

Plik pom.xml

Plik może wydawać się skomplikowany na pierwszy rzut oka, ale jest prosty. Przeanalizujmy to:

1. <modelVersion>: To jest wersja modelu projektu, którą używa ten POM.
2. <groupId>: ID grupy projektu.
3. <artifactId>: ID artefaktu (projektu).
4. <version>: Wersja artefaktu (projektu).
5. <dependencies>: W tej sekcji określasz wszystkie zależności, których potrzebuje twój projekt.

3.1 Dodawanie zależności

3.2 Zarządzanie zależnościami

Zarządzanie zależnościami w Mavenie jest proste. Dodajesz, aktualizujesz lub usuwasz zależności, modyfikując sekcję <dependencies> pliku pom.xml.

• Dodawanie nowej zależności: Postępuj zgodnie z instrukcjami opisanymi powyżej.
• Aktualizacja zależności: Zmień version w odpowiednim bloku <dependency> i zapisz plik pom.xml. Maven następnie pobierze nową wersję i odpowiednio zaktualizuje projekt.
• Usuwanie zależności: Po prostu usuń odpowiadający blok <dependency> i zapisz plik pom.xml. Maven zaktualizuje projekt i zależność nie będzie już dostępna.

Pamiętaj, że za każdym razem, gdy modyfikujesz plik pom.xml, zawsze zaimportuj zmiany, aby mogły one wejść w życie. Dzięki temu procesowi Maven ułatwia zarządzanie zależnościami, pozwalając programistom skupić się bardziej na kodowaniu, a mniej na konfiguracji projektu.

4.1 Otwieranie okna narzędziowego Maven

Aby uzyskać dostęp do tego bogatego w funkcje okna narzędziowego:

1. Przejdź do menu Widok w środowisku IntelliJ IDEA.
2. Wybierz opcję Okna narzędziowe z menu rozwijanego.
3. Z wyświetlonej listy kliknij Maven.

Po wykonaniu tych kroków po prawej stronie środowiska IDE pojawi się okno narzędziowe Maven.

4.2 Realizacja celów Maven

Cele Maven reprezentują zadania, które można wykonać w ramach projektu. Przykłady takich celów to clean, compile, test i install.

Cele

Aby wykonać cel Maven:

1. Znajdź okno narzędziowe Maven i rozwiń sekcję Lifecycle. W tej sekcji znajdują się najczęstsze cele.
2. Kliknij prawym przyciskiem myszy na cel, który chcesz wykonać, np. kompilację, i wybierz opcję Uruchom kompilację Maven. IntelliJ IDEA wykona następnie wybrany cel.

5.1 Kompilacja projektu

Cel kompilacji Maven odpowiada za przekształcenie plików Java (.java) do formatu, który może wykonać Java Virtual Machine (JVM) (pliki .class). Oto jak to zrobić:

1. Przejdź do okna narzędziowego Maven i rozwiń sekcję Lifecycle.
2. Kliknij dwukrotnie na "kompiluj". Maven teraz przetworzy twoje pliki .java, kompilując je do plików .class i przechowując je w katalogu target/classes.

5.2 Uruchomienie projektu

Po skompilowaniu projektu możemy go uruchomić:

1. W oknie narzędziowym projektu znajdź katalog główny swojego projektu.
2. Kliknij prawym przyciskiem myszy i wybierz opcję Uruchom > Główne. Ta czynność rozpocznie realizację Twojego projektu.

Uwaga: Opcja Main może się różnić w zależności od konfiguracji projektu. Odnosi się ona do klasy głównej służącej jako punkt wejścia do aplikacji.

6.1 Ręczne importowanie zmian

Jeśli wolisz ręcznie kontrolować, kiedy zmiany mają zostać odzwierciedlone w projekcie, możesz:

1. Przejdź do okna narzędziowego Maven.
2. Znajdź i kliknij przycisk "Reimport All Maven Projects" (ikona z dwiema okrągłymi strzałkami). Ta czynność zaktualizuje Twój projekt w oparciu o najnowszy plik pom.xml.

6.2 Włączanie automatycznego importu

Jeśli wolisz, aby Twoje zmiany zostały automatycznie uwzględnione:

1. Przejdź do Plik > Ustawienia (lub IntelliJ IDEA > Preferencje w systemie macOS).
2. W ustawieniach przejdź do sekcji Kompilacja, uruchamianie, wdrażanie > Narzędzia kompilacji > Maven > Importowanie.
3. Zaznacz pole wyboru Włącz automatyczny import i kliknij OK.

Po włączeniu funkcji automatycznego importowania każda zmiana w pliku pom.xml spowoduje automatyczny import, dzięki czemu projekt będzie zawsze aktualny. Ta funkcja, szczególnie w dużych projektach, może pomóc w zachowaniu spójności i uniknięciu ręcznych, powtarzalnych zadań.