JAVA ΕΝΟΤΗΤΑ 2 – JAVA MAVEN PROJECT CREATION

 

ΕΙΣΑΓΩΓΗ

Στο σημερινό δωρεάν μάθημα Java θα δούμε βήμα-προς-βήμα πώς δημιουργούμε ένα Java project χρησιμοποιώντας το Maven, πως το κάνουμε compile και τέλος πως το εκτελούμε.

 Όλα τα παραπάνω βήματα θα τα πραγματοποιήσουμε με γραφικό τρόπο μέσα από το VS Code.

JAVA MAVEN PROJECT CREATION

Για να μπορέσουμε να δημιουργήσουμε μια Java εφαρμογή, θα πρέπει να ξεκινήσουμε από την δημιουργία ενός Java Maven project. Για αρχή δημιουργούμε ένα folder οπουδήποτε επιθυμείτε στο σκληρό σας δίσκο. Το όνομα του folder δεν έχει καμία απολύτως σημασία.

Τώρα ανοίγουμε το VS Code. Από το main menu επιλέγουμε File -> Open Folder και αφού επιλέξουμε το folder που δημιουργήσαμε στο προηγούμενο βήμα, πατάμε Select Folder. Το VS Code τώρα δείχνει τη τοποθεσία του folder που επιλέξαμε.

Το επόμενο βήμα είναι να δημιουργήσουμε ένα Java Project μέσα στο folder Java. Πηγαίνουμε στο View -> Command Palette.

Στο πεδίο εύρεσης γράφουμε Java για να μας εμφανιστούν όλες οι επιλογές που μας προσφέρει το VS Code (δια μέσω των extensions) για την συγκεκριμένη γλώσσα προγραμματισμού. Αν δεν είχατε εγκαταστήσει τα Java extensions (όπως κάναμε στην ΕΝΟΤΗΤΑ 1) οι επιλογές αυτές δεν θα υπήρχαν. Επιλέξτε το Java:Create Java Project.

Από τις εμφανιζόμενες επιλογές (εξαρτάται από τα extensions που έχετε εγκαταστήσει) διαλέξτε το Maven create from archetype.

Το Apache Maven, για να σας βοηθήσει με την δημιουργία ενός ολοκληρωμένου και πλήρως λειτουργικού Java Project σας προσφέρει archetypes – δηλαδή έτοιμα παραδείγματα που περιέχουν τις ελάχιστες απαιτήσεις που χρειάζεται ένα Java project για να εκτελεστεί σωστά. Από τις εμφανιζόμενες επιλογές διαλέξτε το template με το όνομα maven-archetype-quickstart.

Όταν επιλέξουμε το συγκεκριμένο archetype αμέσως μετά θα εμφανιστεί το version number του συγκεκριμένου archetype. Απλά επιλέξτε την πιο τελευταία έκδοση.

Στο επόμενο βήμα, το Maven μας προτείνει ένα default όνομα για το package μέσα στο οποίο θα βρίσκονται οι Java classes. Σκεφτείτε το package ότι είναι ένα folder μέσα στο οποίο θα βρίσκονται τα java αρχεία σας. Κάθε κλάση μπορεί να ανήκει στο ίδιο ή σε διαφορετικό package. Αργότερα που θα καταλάβετε την έννοια του package και πως μας βοηθάει στο κώδικα μας, θα δώσουμε καλύτερα ονόματα σε αυτά. Για τώρα απλά δεχτείτε το com.example όνομα που μας προτείνει το Maven. Τα packages στο Maven ονομάζονται επίσημα group id. Οπότε αν χρησιμοποιείτε διαφορετικό IDE και σας ζητάει να ονομάσετε το group id στην ουσία σας ζητάει να ορίσετε ένα default package μέσα στο οποίο θα μπουν τα java αρχεία σας. Επαναλαμβάνω ότι η παραπάνω εξήγηση για τα packages είναι πολύ φτωχή αλλά κύριος σκοπός της σημερινής ενότητας είναι να δούμε τα βήματα δημιουργίας ενός Java Maven Project και όχι να αναλύσουμε όλες τις λεπτομέρειες. Αυτές θα τις κατανοήσουμε σε μελλοντικές ενότητες. Πατήστε λοιπόν ENTER και δεχτείτε το προτεινόμενο όνομα για το group id.

Τώρα ήρθε η σειρά να επιλέξουμε το όνομα για το project μας. Το προτεινόμενο όνομα από το Maven είναι demo. Ας το αλλάξουμε και ας ονομάσουμε το πρώτο μας project employeemanagement. Ο επίσημος όρος που χρησιμοποιεί το Maven για το ονομάζει ένα project είναι artifact id. Όταν το γράψετε πατήστε ENTER.

Η default τοποθεσία του project μας θα είναι το folder το οποίο προσθέσαμε αρχικά στο VS Code. Αυτός είναι ο λόγος που όταν πατήσετε ENTER στο προηγούμενο βήμα, τώρα θα δείτε τα Windows να σας ανοίγουν το ίδιο folder σαν προκαθορισμένη τοποθεσία δημιουργίας του Java Maven Project. Απλά δεχτείτε την επιλογή πατώντας Select Destination Folder.

Σχεδόν τελειώσαμε. Τώρα στο Terminal του VS Code θα εμφανιστεί η διαδικασία κατά την οποία το Apache Maven δημιουργεί το project. Θα σταματήσει όμως σε κάποιο σημείο γιατί περιμένει από εμάς να αποφασίσουμε ποιο θα είναι το version του κώδικα. Όταν εργάζεστε σε ένα πολύ μεγάλο project λογικό είναι να κάνετε συνεχώς αναβαθμίσεις στο κώδικα. Οπότε θα αλλάζει και ο αριθμός έκδοσης της εφαρμογής σας. Όταν ακόμα ο κώδικας της εφαρμογής δεν έχει ολοκληρωθεί αλλά είναι in progress τότε συνηθίζουμε να βάζουμε τον αριθμό του version μαζί με την λέξη SNAPSHOT να ακολουθεί αμέσως μετά. Το Apache Maven λοιπόν θεωρεί ότι, αφού τώρα δημιουργείτε το project, ο κώδικας σας ακόμα δεν έχει ολοκληρωθεί και σας προτείνει ένα αρχικό αριθμό για να ξεκινήσετε το version μαζί με την λέξη SNAPSHOT. Απλά δεχόμαστε αυτή την επιλογή πατώντας ENTER.

Το τελευταίο βήμα είναι να δεχτούμε όλες τις επιλογές που κάναμε κατά την διάρκεια αυτής της διαδικασίας. Απλά πατήσετε ENTER και η δημιουργία του Java project μας θα ολοκληρωθεί.

Το Java Maven Project έχει δημιουργηθεί και μπορούμε να δούμε την δομή του στο EXPLORER του VS Code. Επίσης το extension Maven που είχαμε προσθέσει στην ENOTHTA 1 αναγνωρίζει το project μας σαν επίσημο Maven project.

MODIFYING THE POM.XML

Πριν κάνουμε compile το project μας, θα πρέπει να πραγματοποιήσουμε κάποιες μικρές αλλαγές σε αυτό που αφορούν τους αριθμούς των εκδόσεων των libraries. Ο λόγος είναι ότι το archetype που χρησιμοποιήσαμε έχει την java 7 σαν βάση ενώ εμείς χρησιμοποιούμε java 17. Κάνουμε λοιπόν κλικ επάνω στο pom.xml για να ανοίξουμε το αρχείο.

Η πρώτη και κύρια αλλαγή είναι να αλλάξουμε το maven.compiler.source και maven.compiler.target  από 1.7 σε 17 που είναι η έκδοση της Java που έχουμε εγκαταστήσει στο σύστημα μας.

Το pom.xml αρχείο είναι το μέρος στο οποίο δηλώνουμε όλα τα dependencies από τα οποία εξαρτάται το project μας για τη σωστή εκτέλεση του. Τα dependencies, μετά την δήλωση τους στο pom.xml, θα κατέβουν αυτόματα από το Maven repository.  Δεν χρειάζεται να καλύψουμε όλες τις λεπτομέρειες λειτουργίας του Apache Maven. Αυτό όμως που πρέπει να κάνουμε σαν δεύτερο βήμα είναι να αναβαθμίσουμε τις εκδόσεις του κάθε dependency που είναι δηλωμένο στο pom.xml.

Τώρα φυσικά θα αναρωτηθείτε πως είναι δυνατόν να γνωρίζετε τις εκδόσεις του κάθε dependency όταν μόλις ξεκινήσατε να μαθαίνετε Java. Μην στεναχωριέστε γιατί υπάρχει εύκολος τρόπος να γίνει αυτή η διαδικασία. Όπου βλέπετε το όνομα version θα διαγράψετε τον αριθμό που υπάρχει και θα πατήσετε Ctrl + Space Bar. Αυτός ο συνδυασμός θα σας εμφανίσει μια λίστα με τις διαθέσιμες εκδόσεις για το εκάστοτε dependency. Δεν θέλουμε όμως να επιλέξουμε τις εκδόσεις alpha ή beta.

Ας πάρουμε για παράδειγμα το dependency του JUnit.

Ακολουθήστε την ίδια λογική για να αναβαθμίσετε τις εκδόσεις των υπόλοιπων dependencies. Η τελική μορφή που θα έχει το pom.xml θα είναι η εξής:

<?xml version="1.0" encoding="UTF-8"?>

<project xmlns="http://maven.apache.org/POM/4.0.0"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://maven.apache.org/POM/4.0.0

http://maven.apache.org/xsd/maven-4.0.0.xsd">

  <modelVersion>4.0.0</modelVersion>

  <groupId>com.example</groupId>

  <artifactId>employeemanagement</artifactId>

  <version>1.0-SNAPSHOT</version>

  <name>employeemanagement</name>

  <url>http://www.employeemanagement.com</url>

  <properties>

   

<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>

    <maven.compiler.source>17</maven.compiler.source>

    <maven.compiler.target>17</maven.compiler.target>

  </properties>

  <dependencies>

    <dependency>

      <groupId>junit</groupId>

      <artifactId>junit</artifactId>

      <version>4.13.2</version>

      <scope>test</scope>

    </dependency>

  </dependencies>

  <build>

    <pluginManagement>

      <plugins>

        <plugin>

          <artifactId>maven-clean-plugin</artifactId>

          <version>3.2.0</version>

        </plugin>

        <plugin>

          <artifactId>maven-resources-plugin</artifactId>

          <version>3.2.0</version>

        </plugin>

        <plugin>

          <artifactId>maven-compiler-plugin</artifactId>

          <version>3.10.1</version>

        </plugin>

        <plugin>

          <artifactId>maven-surefire-plugin</artifactId>

          <version>2.22.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-jar-plugin</artifactId>

          <version>3.2.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-install-plugin</artifactId>

          <version>2.5.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-deploy-plugin</artifactId>

          <version>2.8.2</version>

        </plugin>

        <plugin>

          <artifactId>maven-site-plugin</artifactId>

          <version>3.12.0</version>

        </plugin>

        <plugin>

         

<artifactId>maven-project-info-reports-plugin</artifactId>

          <version>3.3.0</version>

        </plugin>

      </plugins>

    </pluginManagement>

  </build>

</project>

MAVEN CLEAN & INSTALL COMMANDS

Τώρα είμαστε έτοιμοι να κάνουμε compile το project μας. Το VS Code, αν και μπορούμε να εκτελέσουμε τις ίδιες εντολές μέσα από το terminal, μας προσφέρει ένα γραφικό τρόπο για να τις επιλέξουμε και να τις εκτελέσουμε.

Για να δούμε τις εντολές, κάνουμε δεξί κλικ επάνω στο employeemanagement project κάτω από τη Maven κατηγορία. Από το εμφανιζόμενο μενού επιλέγουμε να εκτελέσουμε πρώτα την clean εντολή του Maven. Η συγκεκριμένη εντολή καθαρίζει την java εφαρμογή που είχε δημιουργηθεί από προηγούμενο compile. 

Ακολουθώντας την ίδια διαδικασία, τώρα θα πρέπει να εκτελέσουμε την install εντολή. Η συγκεκριμένη εντολή χτίζει πάλι το project μας εκ νέου και δημιουργεί ένα εκτελέσιμο αρχείο με κατάληξη jar.

RUNNING A JAVA PROJECT

Τώρα είμαστε έτοιμοι να τρέξουμε το πρόγραμμα μας. Κάθε Java εφαρμογή, για να είναι εκτελέσιμη, πρέπει να αποτελείται τουλάχιστον από μια κλάση και μια από τις κλάσεις να περιέχει την μέθοδο main( ). Αυτή η μέθοδο είναι το αρχικό σημείο εκτέλεσης κάθε Java εφαρμογής. Μην ανησυχείτε αν δεν καταλαβαίνετε όλες αυτές τις έννοιες. Έτσι και αλλιώς θα τις εξηγήσουμε όλες στην επόμενη ενότητα.

Για να μπορέσουμε λοιπόν να τρέξουμε την εφαρμογή μας, θα πρέπει να ανοίξουμε την κλάση App.java και να βρούμε την main( ) μέθοδο.

Το VS Code για να μας βοηθήσει με την εκτέλεση του προγράμματος μας, όταν αντιληφθεί ότι υπάρχει η main( ) μέθοδο μέσα στο κώδικα μας προσθέτει την επιλογή Run | Debug  ακριβώς πριν από τον ορισμό της μεθόδου. Πατήστε λοιπόν το Run για να τρέξει το πρόγραμμα μας από το οποίο περιμένουμε να δούμε σαν αποτέλεσμα το μήνυμα Hello World.

Με αυτή τη διαδικασία ολοκληρώσαμε την αναφορά μας στο πώς να δημιουργούμε και να εκτελούμε ένα Java Maven Project. Για τώρα, απλά κρατήστε το γεγονός, ότι κάθε φορά που γράφετε καινούργιο κώδικα ή αλλάζετε κώδικα που ήδη υπάρχει στην κλάση σας, θα πρέπει να εκτελείτε τις εντολές clean και install πριν τρέξετε την εφαρμογή σας.

Μην ξεχάσετε να κάνετε ένα μικρό donation έτσι ώστε αυτό το blog να μεγαλώσει ακόμα πιο πολύ και να έχει περισσότερες δυνατότητες στην online παράδοση δωρεάν μαθημάτων.

full-width