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

====== Sonatype ======

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


===== Regisztráció =====

  * https://central.sonatype.com/

===== Hozzáférés beállítása =====

  * /home/user/.m2/settings.xml

<code xml settings.xml>
<settings>
  <servers>
    <server>
      <id>central</id>
      <username>token user</username>
      <password>token password</password>
    </server>
  </servers>
</settings>
</code>

===== JAVA_HOME =====

Állítsuk be a környezeti változót. Például:

  export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/

===== mvn parancs =====

Szükségünk van egy mvn parancsra. 

Linuxon:
  apt install maven


===== Publikálás mvn paranccsal =====

pom.xml fájl:

<code xml pom.xml>

<project>
    <modelVersion>4.0.0</modelVersion>

    <groupId>foo.bar</groupId>
    <artifactId>myproject</artifactId>
    <version>0.1.0</version>

    <name>myproject</name>
    <description>Project demo</description>
    <url>https://foo.bar/</url>    

    <properties>
        <maven.compiler.source>11</maven.compiler.source>
        <maven.compiler.target>11</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>        
    </properties>

    <dependencies>
        <!--...-->
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.10.1</version>
                <configuration>
                    <outputDirectory>${basedir}/docs</outputDirectory>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.2.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.4.0</version>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>1.5</version>
                <executions>
                <execution>
                <id>sign-artifacts</id>
                <phase>verify</phase>
                <goals>
                <goal>sign</goal>
                </goals>
                </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.sonatype.central</groupId>
                <artifactId>central-publishing-maven-plugin</artifactId>
                <version>0.6.0</version>
                <extensions>true</extensions>
                <configuration>
                    <publishingServerId>central</publishingServerId>
                </configuration>
            </plugin>
        </plugins>
    </build>

  <licenses>
    <license>
      <name>MIT License</name>
      <url>https://opensource.org/license/mit</url>
    </license>
  </licenses>

  <developers>
    <developer>
      <name>My Name</name>
      <email>someone@foo.bar</email>
      <organization>Name</organization>
      <organizationUrl>https://foo.bar</organizationUrl>
    </developer>
  </developers>

  <scm>
    <connection>scm:git:git://github.com/someone/myproject.git</connection>
    <developerConnection>scm:git:ssh://github.com:soneone/myproject.git</developerConnection>
    <url>https://github.com/someone/myproject/tree/master</url>
   </scm>

</project>
</code>

===== Publikáció =====

  mvn clean install

  mvn deploy

A weboldalon folytassuk:
  * https://central.sonatype.com/

===== Verzió szám a forrásfájlokban =====

Ha van egy Valami.java nevű állományunk amiben van egy
class Valami {}, a javadoc-ban ne növeljük a verziószámot 
egy újabb kiadás során. 

<note important>Ez a verziószám azt jelöli melyik
kiadásba került be, és nem az aktuális kiadást!</note>


<code java>
/**
 * Valami alkalmazás.
 * 
 * @author Erős István
 * @author zold.lan
 * @version 0.0.1
 * @see     Masikosztaly
 */
</code>


===== Moduláris =====

Moduláris alkalmazás esetén szükség van **module-info.java** fájlra.

<code java>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <source>11</source>
                    <target>11</target>
                </configuration>                
            </plugin>
</code>