Praca z projektami Maven w IntelliJ

1.1 Instalacja JDK

Aby sprawdzić 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. W tym przykładzie wybierz maven-archetype-quickstart.
4. Kliknij Dalej.

2.2 Ustawianie metadanych projektu

W następnym oknie:

1. Określ GroupId, ArtifactId i 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>: Jest to wersja modelu projektu używana przez ten plik POM.
2. <groupId>: Identyfikator grupy projektu.
3. <artifactId>: Identyfikator artefaktu (projektu).
4. <version>: Wersja artefaktu (projektu).
5. <dependencies>: W tej sekcji określa się wszystkie zależności potrzebne w projekcie.

3.1 Dodawanie zależności

3.2 Zarządzanie zależnościami

Zarządzanie zależnościami w Mavenie jest proste. Możesz dodawać, aktualizować lub usuwać zależności, modyfikując sekcję <dependencies> w 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 pobierze wtedy nową wersję i odpowiednio zaktualizuje projekt.
• Usuwanie zależności: Wystarczy usunąć odpowiedni blok <dependency> i zapisać plik pom.xml. Maven zaktualizuje projekt, a zależność nie będzie już dostępna.

Pamiętaj, że za każdym razem, gdy modyfikujesz plik pom.xml, zawsze importuj zmiany, aby zaczęły obowiązywać. 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ładami takich celów są clean, compile, test oraz 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 przetworzy teraz pliki .java, kompilując je do plików .class i zapisują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ń.