[[oktatas:programozás:java|< Java]]


====== maven ======

  * **Szerző:** Sallai András
  * Copyright (c) 2014, Sallai András
  * Szerkesztve: 2014, 2020, 2022
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC BY-SA 4.0]]
  * Web: https://szit.hu

===== A Mavenről =====

A Java projektek számára kitalált összeszerkesztő, menedzselő eszköz.

Ha **Visual Studio Code** kódszerkesztőt használunk a **Maven** támogatás **bővítmény formájában** telepíthető. Az újabb **Netbeans** alapértelmezetten **tartalmazza a Maven**-t. De használható önálló eszközként is. Itt most az **önálló használatról** lesz szó.

Linux alatt a maven csomagot kell telepíteni. 
Telepítés után kapunk egy **mvn** parancsot. 


===== Telepítés =====

Telepítés Linuxon:
<code>
apt install maven
</code>

Telepítés Windowson, a Chocolatey csomagkezelővel:

<code>
choco install maven -y
</code>

Ellenőrizzük a verziót:
<code>
mvn --version
</code>
Windowson ha Chocolatey csomagkezelővel telepítettük, csak új parancsablakban érhető el a parancs.

===== Példa =====

Projektekről információt a XML fájlokban tárolunk. Itt egy példa:

<code xml>
<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.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <packaging>jar</packaging>
  <version>1.0-SNAPSHOT</version>
  <name>Maven Quick Start Archetype</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>
</code>
===== Projekt generálása =====

Egy projekt generáláshoz kiterjedt kapcsolókat kell használni:

<code>
mvn archetype:generate \
  -DarchetypeGroupId=org.apache.maven.archetypes \
  -DgroupId=hu.valami.my-app \
  -DartifactId=my-app
</code>

==== Eredmény ====


<code>
my-app/
   |--src/
   |   |--main/
   |   |   `--java/
   |   |       `--hu/
   |   |          `--valami/
   |   |               `--my-app/
   |   |                    `--App.java
   |   `--test/
   |       `--java/
   |           `--hu/
   |              `--valami/
   |                   `--my-app/
   |                       `--AppTest.java
   `--pom.xml
</code>


<code java App.java>
package hu.szit.my-app;

/**
 * Hello world!
 *
 */
public class App 
{
    public static void main( String[] args )
    {
        System.out.println( "Hello World!" );
    }
}
</code>



<code java AppTest.java>
package hu.szit.my-app;

import junit.framework.Test;
import junit.framework.TestCase;
import junit.framework.TestSuite;

/**
 * Unit test for simple App.
 */
public class AppTest 
    extends TestCase
{
    /**
     * Create the test case
     *
     * @param testName name of the test case
     */
    public AppTest( String testName )
    {
        super( testName );
    }

    /**
     * @return the suite of tests being tested
     */
    public static Test suite()
    {
        return new TestSuite( AppTest.class );
    }

    /**
     * Rigourous Test :-)
     */
    public void testApp()
    {
        assertTrue( true );
    }
}
</code>

==== Fordítás ====

<code>
cd my-app
mvn compile
</code>

A my-app könyvtárban létrejön egy target könyvtár.

<code>
my-app/
   |--...
   `--target/
        |--classes/
        |    `--...
        |--generated-sources/
        |    `--...
        `--maven-status/
             `--...
</code>

==== Futtatás ====

<code>
mvn exec:java -Dexec.mainClass=hu.szit.my-app.App
</code>

==== Csomag készítés ====

<code>
mvn package
</code>

Létrejön egy .jar kiterjesztésű fájl:
<code>
my-app-1.0-SNAPSHOT.jar
</code>


<code>
mvn clean package
</code>

==== Futtatás ====

<code>
java -cp target/my-app-1.0-SNAPSHOT.jar hu.szit.app.App
</code>

==== Webhely készítése ====

<code>
mvn site
</code>

A target könyvtárban létrejön egy site könyvtár.

<code>
my-app/
   `--target/
        `--site/
</code>

==== Teszt futtatása ====

<code>
mvn -Dtest=AppTest test
</code>


Csak egy metódus tesztelése:
<code>
mvn -Dtest=UsersServiceImpl#testSzamolHaromszog test
</code>

===== Függőségek =====

A függőségeket a <dependencies> elemek közzé tesszük.

Példa:

<code xml>
<dependencies>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.11.0</version>
    </dependency>
</dependencies>
</code>

==== Teszt függőség ====

A test függőségeit jelöljük meg, hogy csak a teszt számára szükséges.

Példa:

<code xml>
<dependencies>
    <dependency>
        <groupId>com.google.code.gson</groupId>
        <artifactId>gson</artifactId>
        <version>2.11.0</version>
    </dependency>
    <dependency>
        <groupId>org.testng</groupId>
        <artifactId>testng</artifactId>
        <version>7.10.2</version>
        <scope>test</scope>
    </dependency>        
</dependencies>
</code>

===== JAR fájl helyi könyvtárból =====

A függőségek közzé vegyük fel scope és systemPath elemekkel:

<code xml>
<dependency>
    <groupId>foo.bar</groupId>
    <artifactId>projectname</artifactId>
    <version>1.0.0</version>
    <scope>system</scope>
    <systemPath>${basedir}/lib/projectname-1.0.0.jar</systemPath>
</dependency>
</code>

===== Maven tároló =====

  * https://mvnrepository.com/
  * https://central.sonatype.com/


===== Linkek =====

  * https://maven.apache.org/
    * https://maven.apache.org/guides/
    * https://maven.apache.org/guides/getting-started/index.html#How_do_I_compile_my_application_sources
  * https://www.vogella.com/tutorials/ApacheMaven/article.html (2020)