Maven, uma ferramenta de automação de construção e gerenciamento de projetos baseada em Java, desenvolvida pela Apache Software Foundation, simplifica significativamente o ciclo de vida do desenvolvimento de software. Seu foco principal é padronizar o processo de construção, gerenciar dependências de forma eficiente e unificar a estrutura do projeto, tudo isso centrado em um conceito chave: o Project Object Model (POM).

O que é o Project Object Model (POM)?

O POM é o cerne da funcionalidade do Maven. É um arquivo XML (pom.xml) que encapsula todas as informações e configurações pertinentes a um projeto, utilizadas pelo Maven para sua construção e gerenciamento. Ele descreve as dependências do projeto, os plugins a serem aplicados, a configuração dos repositórios, a estrutura esperada do projeto e uma vasta gama de outros metadados.

Capacidades Essenciais do Maven

• Construção Padronizada: Fornece um método uniforme e multiplataforma para tarefas como compilação de código, execução de testes e empacotamento de aplicações Java, garantindo consistência em diferentes ambientes de desenvolvimento.
• Gestão de Dependências: Facilita a integração de bibliotecas externas (JARs), automatizando o download, a inclusão no classpath e a resolução de conflitos de versão entre elas.
• Estrutura de Projeto Unificada: Impõe uma organização de diretórios padrão, o que melhora a clareza, a consistência e a capacidade de colaboração entre diferentes projetos e equipes de desenvolvimento.

Conceitos Fundamentais do Maven

Repositórios

São locais de armazenamento para artefatos de construção, como JARs, WARs e plugins Maven. Existem três tipos principais:

• Repositório Local: Uma cache no disco rígido da sua máquina, onde o Maven armazena todos os artefatos baixados de repositórios remotos. Isso evita downloads repetidos e acelera as construções subsequentes.
• Repositório Central: Mantido pela comunidade Maven, é o repositório padrão e mais comum de onde o Maven baixa dependências públicas.
• Repositório Remoto/Privado: Servidores configurados por organizações para hospedar seus próprios artefatos internos, espelhos de repositórios públicos ou para gerenciar dependências de forma mais controlada.

Coordenadas (Identificação de Artefatos)

Um conjunto de identificadores que definem univocamente um artefato dentro de qualquer repositório Maven. Uma coordenada é composta por:

• groupId: Identifica o projeto de forma única em todos os projetos. Geralmente representa o nome da organização ou grupo (ex: com.minhaorganizacao.aplicacao).
• artifactId: O nome do artefato (o projeto ou módulo propriamente dito) (ex: modulo-servicos-backend).
• version: A versão específica do artefato (ex: 1.0.0-SNAPSHOT para uma versão em desenvolvimento ou 2.1.5 para uma versão estável).
• packaging (opcional): O tipo de empacotamento do projeto (ex: jar, war, pom). O padrão é jar.

Configurações de Repositório no settings.xml

O arquivo settings.xml do Maven, geralmente localizado em ~/.m2/ (no diretório do usuário), permite personalizar o comportamento global do Maven para todos os projetos do usuário.

Definindo o Repositório Local

Você pode especificar um caminho alternativo para onde os artefatos baixados serão armazenados, se não quiser usar o local padrão.

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
   <!-- Caminho absoluto para o diretório de cache de artefatos baixados -->
   <localRepository>C:/maven/repositorio-pessoal</localRepository>
   <!-- Outras configurações globais... -->
</settings>

Configurando Espelhos (Mirrors)

Espelhos são repositórios alternativos que podem ser usados para substituir um repositório específico (como o Central) para o download de artefatos. Eles podem oferecer melhor desempenho, confiabilidade ou atender a requisitos de segurança corporativos.

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
   <mirrors>
       <mirror>
           <!-- Identificador único para este espelho, pode ser qualquer string -->
           <id>meu-espelho-corp</id>
           <!-- Qual repositório este espelho substitui. "central" é o mais comum. -->
           <mirrorOf>central</mirrorOf>
           <!-- Nome descritivo do espelho -->
           <name>Repositório de Espelho Corporativo</name>
           <!-- URL do serviço de espelho -->
           <url>https://artefatos.minhaempresa.net/nexus/content/groups/public</url>
       </mirror>
       <!-- Mais espelhos podem ser adicionados aqui, se necessário -->
   </mirrors>
   <!-- Outras configurações... -->
</settings>

O Ciclo de Vida de Construção do Maven

O Maven organiza o processo de construção em um conjunto de fases padronizadas, que são sequenciais. Ao executar uma fase, todas as fases anteriores a ela no mesmo ciclo de vida são também executadas em ordem. Existem três ciclos de vida principais: default (construção), clean (limpeza) e site (documentação).

Fases Comuns do Ciclo de Vida default:

• mvn validate: Valida se o projeto está correto e todas as informações necessárias estão disponíveis (por exemplo, a estrutura do diretório é válida).
• mvn compile: Compila o código-fonte principal do projeto Java. Os arquivos .class resultantes são colocados no diretório target/classes.
• mvn test-compile: Compila o código-fonte dos testes. Os arquivos .class dos testes são colocados em target/test-classes.
• mvn test: Executa os testes unitários utilizando um framework de testes (como JUnit ou TestNG). Gera relatórios detalhados em target/surefire-reports.
• mvn package: Empacota o código compilado e os recursos em um formato distribuível, como um arquivo JAR ou WAR, para o diretório target/.
• mvn install: Instala o artefato empacotado no repositório Maven local. Isso o torna disponível para outros projetos locais que possam depender dele.
• mvn deploy: Copia o artefato final para um repositório remoto. Esta fase é geralmente utilizada em ambientes corporativos para publicar artefatos em servidores de artefatos centralizados.

Outras Fases e Comandos Úteis:

• mvn clean: Remove os arquivos gerados pela construção anterior, como o diretório target/, garantindo uma construção limpa.
• mvn site: Gera a documentação do projeto, incluindo relatórios e informações configuradas no POM.

Gerenciamento de Dependências

O Maven simplifica a inclusão de bibliotecas externas, declarando-as de forma clara e estruturada no arquivo pom.xml.

<dependencies>
   <dependency>
       <groupId>org.apache.commons</groupId>
       <artifactId>commons-lang3</artifactId>
       <version>3.12.0</version>
       <scope>compile</scope> <!-- Padrão, disponível em tempo de compilação, teste e runtime -->
   </dependency>
   <dependency>
       <groupId>org.junit.jupiter</groupId>
       <artifactId>junit-jupiter-api</artifactId>
       <version>5.9.1</version>
       <scope>test</scope> <!-- Disponível apenas para compilação e execução de testes -->
   </dependency>
</dependencies>

Dependências Transitivas

Se o Projeto A depende do Projeto B, e o Projeto B, por sua vez, depende do Projeto C, o Projeto A terá uma dependência transitiva no Projeto C. O Maven gerencia essas dependências automaticamente, incluindo todas as dependências transitivas necessárias.

Resolução de Conflitos de Dependência

Quando diferentes versões do mesmo artefato são introduzidas por caminhos de dependência distintos, o Maven resolve o conflito utilizando as seguintes regras:

• Caminho Mais Curto: A versão da dependência que está "mais perto" do projeto no grafo de dependências (ou seja, com menos saltos) é a escolhida.
• Primeira Declaração: Se duas dependências conflitantes estiverem na mesma profundidade (caminho mais curto idêntico), a dependência declarada primeiro no pom.xml é selecionada.

Exclusão de Dependências

É possível excluir uma dependência transitiva indesejada de um projeto, por exemplo, para evitar conflitos ou remover bibliotecas não utilizadas.

<dependency>
   <groupId>com.minhaempresa</groupId>
   <artifactId>minha-lib-externa</artifactId>
   <version>1.0.0</version>
   <exclusions>
       <exclusion>
           <groupId>org.slf4j</groupId>
           <artifactId>slf4j-log4j12</artifactId>
       </exclusion>
   </exclusions>
</dependency>

Dependências Opcionais

Uma dependência pode ser marcada como opcional (<optional>true</optional>). Isso significa que ela não será transitivamente incluída em projetos que dependem do módulo atual. O consumidor do módulo deve declarar explicitamente essa dependência se precisar dela.

Projetos Multimódulo (Agregação)

A agregação permite que um POM pai gerencie um grupo de subprojetos (módulos). Isso possibilita que todos os módulos sejam construídos de uma só vez com um único comando Maven executado no diretório do projeto pai. O POM pai deve ter um tipo de empacotamento (packaging) de pom.

<!-- pom.xml do projeto pai -->
<modelVersion>4.0.0</modelVersion>
<groupId>com.minhaorganizacao.aplicacao</groupId>
<artifactId>projeto-principal</artifactId>
<version>1.0.0-SNAPSHOT</version>
<packaging>pom</packaging>

<modules>
   <module>modulo-core</module&
   <module>modulo-web</module>
   <module>modulo-servicos-api</module>
</modules>

Herança de Configurações (POM Pai)

Projetos filhos podem herdar configurações de um POM pai, promovendo a reutilização de código e a padronização em toda a base de código. Isso é frequentemente utilizado para centralizar a gestão de versões de dependências (usando <dependencyManagement>) e configurações de plugins.

<!-- pom.xml de um projeto filho -->
<modelVersion>4.0.0</modelVersion>

<parent>
   <groupId>com.minhaorganizacao.aplicacao</groupId>
   <artifactId>projeto-principal</artifactId>
   <version>1.0.0-SNAPSHOT</version>
   <relativePath>../projeto-principal/pom.xml</relativePath> <!-- Opcional: Caminho relativo para o POM pai -->
</parent>

<artifactId>modulo-web</artifactId> <!-- groupId e version são herdados -->
<packaging>war</packaging>

<dependencies>
   <!-- A versão desta dependência pode ser omitida se gerenciada no POM pai -->
   <dependency>
       <groupId>com.outraorganizacao</groupId>
       <artifactId>framework-util</artifactId>
   </dependency>
</dependencies>

Propriedades do Maven

Propriedades são valores que podem ser referenciados em um pom.xml ou arquivos de recursos. Elas são usadas para evitar repetição, gerenciar versões de dependências e configurar plugins de forma flexível.

Definição:

<properties>
   <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   <maven.compiler.source>17</maven.compiler.source>
   <minha.versao.biblioteca.comum>2.5.0</minha.versao.biblioteca.comum>
</properties>

Uso:

<dependency>
   <groupId>org.exemplo</groupId>
   <artifactId>biblioteca-exemplo</artifactId>
   <version>${minha.versao.biblioteca.comum}</version>
</dependency>

<build>
   <plugins>
       <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-compiler-plugin</artifactId>
           <configuration>
               <source>${maven.compiler.source}</source>
               <target>${maven.compiler.source}</target>
           </configuration>
       </plugin>
   </plugins>
</build>

Repositórios Privados (Nexus/Artifactory)

Organizações frequentemente empregam repositórios privados (como Nexus ou Artifactory) para hospedar artefatos itnernos, armazenar cópias de artefatos públicos e exercer um controle mais rigoroso sobre o fluxo de dependências. A configuração para interagir com esses repositórios é feita principalmente no settings.xml.

Espelhos para Download (mirrors):

Redireciona solicitações de download para o repositório privado em vez de diretamente para os repositórios públicos, permitindo centralização e controle.

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
   <mirrors>
       <mirror>
           <id>meu-repositorio-nexus</id>
           <mirrorOf>*</mirrorOf> <!-- Redireciona TODAS as solicitações de repositórios remotos -->
           <name>Repositório Corporativo de Artefatos</name>
           <url>https://nexus.minhaempresa.com/repository/todos-os-publicos/</url>
       </mirror>
   </mirrors>
   <!-- ... -->
</settings>

Autenticação para Upload (servers):

Configura as credenciais necessárias para implantar (fase deploy) artefatos em repositórios privados. O <id> do servidor aqui deve corresponder ao <id> do repositório de distribuição (<distributionManagement>) definido no pom.xml do seu projeto.

<settings xmlns="http://maven.apache.org/SETTINGS/1.2.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.2.0 https://maven.apache.org/xsd/settings-1.2.0.xsd">
   <servers>
       <server>
           <id>id-do-repositorio-releases</id> <!-- Corresponde ao id em distributionManagement no POM -->
           <username>usuario.dev</username>
           <password>senhaUltraSecreta</password>
       </server>
       <server>
           <id>id-do-repositorio-snapshots</id> <!-- Corresponde ao id em distributionManagement no POM -->
           <username>usuario.dev</username>
           <password>senhaUltraSecreta</password>
       </server>
   </servers>
   <!-- ... -->
</settings>