Jar Plugin

Um dos plugins mais utilizandos no maven para compilação e geração de pacotes jar. Uma vez definido no pom.xml do projeto a tag packaging como jar, a sua definição padrão já será usada pelo build.

A declaração explicita do plugin no pom.xml, permite que possamos fazer algumas configurações adicionais no arquivo de saída, como a definição do manifest, para jar executáveis por exemplo. Alguns plugins do maven como o que estamos vendo, já são chamados automaticamente dentro de fases do ciclo de vida do build.

O jar plugin uma vez configudado no projeto, suas definições serão chamadas dentro da fase de empacotamento (package) do ciclo de vida Default do build.

Abaixo um exemplo de projeto com definição do plugin:

<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>br.com.javadev.jar</groupId>
  <artifactId>prj-jar</artifactId>
  <version>1.0</version>
  <packaging>jar</packaging>
  <name>Jar Plugin Projetc Example</name>
  <url>www.javadev.com.br</url>
  
  <properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  </properties>

  <build>
    <finalName>${project.artifactId}-${project.version}</finalName>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <version>2.4</version>
        <configuration>
          <sourceEncoding>${project.build.sourceEncoding}</sourceEncoding>
          <archive>
            <manifest>
              <mainClass>br.com.javadev.jar.MyApp</mainClass>
            </manifest>
          </archive>
        </configuration>
      </plugin>
    </plugins>
  </build>
</project>

Nesse exemplo estamos definindo um jar executável, uma vez que estamos definindo o atributo mainClass

  <manifest>
    <mainClass>br.com.javadev.jar.MyApp</mainClass>
  </manifest>

Efetuando os testes

Para que você possa acompanhar os testes, você pode fazer o download do exemplo, vai ficar mais fácil o entendimento.

Vamos acessar a pasta do projeto jar-prj caso tenha feito o download e fazermos a geração do projeto, para isso vamos digitar o comando:

mvn package

Estamos solicitando que o build seja executado até a fase de empacotamento (jar) que é o que estamos configurando, para gerar na saida um jar executável.

Assim que o build for finalizando será gerada a pasta target, acessar essa pasta (cd target) e executar o comando:

java -jar prj-jar-1.0.jar

Será exibida a mensagem abaixo:

Jar Plugin Project Example - 1.0

Pronto, finalizamos o primeiro passo na montagem de projeto simples com o maven, continue com os tutoriais do nosso site, pois a partir desse exemplo, vamos evoluir e adicionarmos mais recursos aos nossos projetos.