S01L03 - Programa Java HelloWorld com Maven

html

Criando um Projeto Maven em IntelliJ IDEA: Um Guia Completo
Índice

Introdução
Configurando o Seu Projeto Maven

Iniciando o IntelliJ IDEA e Começando um Novo Projeto
Configurando Detalhes do Projeto


Entendendo pom.xml

Configurando Fonte e Alvo do Compilador
Definindo Tipo de Empacotamento


Criando e Gerenciando Pacotes

Adicionando Código de Exemplo


Construindo e Executando Sua Aplicação

Executando a Aplicação no IntelliJ IDEA
Gerando o Arquivo JAR Usando Maven


Problemas Comuns e Solução de Problemas
Conclusão


Introdução
Bem-vindo a este guia completo sobre como criar um projeto Maven no IntelliJ IDEA. Se você é um iniciante ou um desenvolvedor com conhecimento básico procurando otimizar o gerenciamento de seus projetos Java, o Maven é uma ferramenta essencial no seu conjunto de ferramentas. Este guia o levará pelo processo de configuração de um projeto Maven, configurando as definições essenciais, escrevendo código de exemplo e construindo sua aplicação em um arquivo JAR.
Por Que Usar Maven?
Maven simplifica a automação de builds de projetos, o gerenciamento de dependências e os padrões de estrutura de projetos. Ele aumenta a produtividade fornecendo um sistema de build uniforme e reduz as complexidades envolvidas no gerenciamento de projetos grandes.
Prós e Contras de Usar Maven


Prós
Contras


Simplifica o gerenciamento de dependências
Curva de aprendizado mais íngreme para iniciantes


Padroniza a estrutura do projeto
Pode ser verboso com configuração


Facilita a integração com IDEs
Depurar problemas do Maven pode ser desafiador


Aumenta a automação de builds
Pode introduzir sobrecarga em projetos pequenos


Quando Usar Maven
Maven é ideal para projetos Java de médio a grande porte que requerem processos de build padronizados e gerenciamento eficiente de dependências. É particularmente benéfico ao colaborar em equipes, garantindo consistência entre ambientes de desenvolvimento.

Configurando o Seu Projeto Maven
Iniciando o IntelliJ IDEA e Começando um Novo Projeto

Abra o IntelliJ IDEA: Inicie o aplicativo IntelliJ IDEA no seu computador.
Criar um Novo Projeto: Clique na opção "New Project" na tela de boas-vindas ou navegue até File > New > Project.

    

    

    Figura 1: Iniciando um Novo Projeto no IntelliJ IDEA.
  

Configurando Detalhes do Projeto

Selecionar Maven: Na janela "New Project", escolha Maven como o tipo do seu projeto.

    

    

    Figura 2: Selecionando Maven como o Tipo de Projeto.
  
Nome do Projeto e Localização:

Nome: Insira Hello World.
Localização: Use a localização padrão Idea Project ou especifique um diretório preferido.


Versão do JDK: Selecione JDK 17, a versão de Longo Suporte (LTS), garantindo compatibilidade e estabilidade.
Archetype Maven: Pule a seleção de um archetype Maven para simplicidade.
Group ID e Artifact ID:

Group ID: Insira org.studyeasy.
Artifact ID: Insira hello-world (certifique-se de não usar espaços).


Finalizar Criação: Clique em Create para gerar a estrutura do projeto Maven.


Entendendo pom.xml
O arquivo pom.xml é o coração do seu projeto Maven, gerenciando a configuração do projeto, dependências e definições de build.
Configurando Fonte e Alvo do Compilador




		
		
			
			
Java
			
			<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>org.studyeasy</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
</project>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
				
						<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>org.studyeasy</groupId>
    <artifactId>hello-world</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>
 
    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
    </properties>
</project>
					
				
			
		


Figura 3: Configuração de Exemplo do pom.xml.
Explicação:

maven.compiler.source e maven.compiler.target: Ambos definidos como 17, alinhando-se com a versão do JDK selecionada.
packaging: Definido como jar para especificar o tipo de artefato de saída.

Definindo Tipo de Empacotamento
Definir o tipo de empacotamento para jar garante que o processo de build gere um arquivo JAR, um formato comum para aplicações Java.

Criando e Gerenciando Pacotes
Adicionando Código de Exemplo
Após a criação do projeto, o IntelliJ IDEA gera os diretórios necessários e um arquivo Java de exemplo.

Pacote Padrão: Navegue para o diretório src/main/java para encontrar o arquivo main.java.
Criando um Novo Pacote (se necessário):

Clique com o botão direito em src/main/java.
Selecione New > Package.
Nomeie como org.studyeasy.


Código de Exemplo: Aqui está um programa Java simples para exibir uma mensagem de boas-vindas.





		
		
			
			
Java
			
			package org.studyeasy;

public class Main {
    public static void main(String[] args) {
        System.out.println("Hello and welcome.");
    }
}
			
				
					
				
					1
2
3
4
5
6
7
				
						package org.studyeasy;
 
public class Main {
    public static void main(String[] args) {
        System.out.println("Hello and welcome.");
    }
}
					
				
			
		


Figura 4: Código Java de Exemplo com Comentários.
Explicação:

Declaração do Pacote: org.studyeasy garante uma estrutura de código organizada.
Classe Principal: Contém o método main, o ponto de entrada da aplicação.
Declaração de Impressão: Exibe "Hello and welcome." no console.


Construindo e Executando Sua Aplicação
Executando a Aplicação no IntelliJ IDEA

Executar o Programa:

Clique no botão Run na barra de ferramentas.
Alternativamente, clique com o botão direito na classe Main e selecione Run 'Main.main()'.


    

    Figura 5: Executando a Aplicação.
  
Saída:




		
		
			
			
Java
			
			Hello and welcome.
			
				
					
				
					1
				
						Hello and welcome.
					
				
			
		


Isso confirma que a aplicação está sendo executada com sucesso.


Gerando o Arquivo JAR Usando Maven

Editar Configuração:

Navegue até Run > Edit Configurations.
Clique no ícone + para adicionar uma nova configuração.
Selecione Maven.


Definir Metas do Maven:

Linha de Comando: Insira clean package.

clean: Remove o diretório target para garantir um build limpo.
package: Compila o código e empacota-o em um arquivo JAR conforme definido no pom.xml.



      

      Figura 6: Configurando Metas do Maven.
    

Executar Build do Maven: Clique em Apply e depois em Run. O Maven executará as metas definidas, gerando o arquivo JAR no diretório target.
Tratando Avisos:

Você pode encontrar avisos relacionados ao arquivo manifest. Estes são comuns e podem ser abordados em tutoriais subsequentes.




Problemas Comuns e Solução de Problemas
Erro no Arquivo Manifest
Após gerar o arquivo JAR, tentar executá-lo pode resultar em um erro no arquivo manifest. Isso ocorre porque o JAR não possui os metadados necessários para executar o método main.
Solução:

Defina o mainClass no pom.xml para especificar o ponto de entrada.





		
		
			
			
Java
			
			<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>org.studyeasy.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
			
				
					
				
					1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
				
						<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-jar-plugin</artifactId>
            <version>3.2.0</version>
            <configuration>
                <archive>
                    <manifest>
                        <mainClass>org.studyeasy.Main</mainClass>
                    </manifest>
                </archive>
            </configuration>
        </plugin>
    </plugins>
</build>
					
				
			
		


Explicação:

maven-jar-plugin: Especifica a configuração do plugin JAR.
mainClass: Aponta para a classe Main que contém o método main.


Reconstruir o Projeto: Execute clean package novamente para gerar o JAR atualizado com o manifest correto.

Abordagem Alternativa:

Use o Shade Plugin do Maven ou outros plugins de assembly para necessidades de empacotamento mais complexas.


Conclusão
Criar um projeto Maven no IntelliJ IDEA é um processo simplificado que aprimora seu fluxo de trabalho no desenvolvimento Java. Seguindo este guia, você aprendeu como configurar um projeto Maven, configurar definições essenciais, escrever código de exemplo e construir sua aplicação em um arquivo JAR executável. A estrutura padronizada do Maven e suas capacidades de gerenciamento de dependências o tornam uma ferramenta inestimável tanto para iniciantes quanto para desenvolvedores experientes.
Pontos Principais

Integração Maven: Integra-se perfeitamente com o IntelliJ IDEA, simplificando a configuração do projeto.
Configuração do pom.xml: Centraliza as definições do projeto, dependências e instruções de build.
Processo de Build Eficiente: Comandos como clean package automatizam builds e empacotamentos.
Solução de Problemas: Entender problemas comuns como erros no arquivo manifest é crucial para um desenvolvimento sem interrupções.

Abrace o Maven para elevar seus projetos Java, garantindo consistência, escalabilidade e eficiência em seus esforços de desenvolvimento.

#Maven #IntelliJIDEA #JavaDevelopment #ProjetoMaven #GuiaCompleto #DesenvolvimentoJava #BuildAutomation #GerenciamentoDeDependências #JavaJAR #SoluçõesTech
Prós	Contras
Simplifica o gerenciamento de dependências	Curva de aprendizado mais íngreme para iniciantes
Padroniza a estrutura do projeto	Pode ser verboso com configuração
Facilita a integração com IDEs	Depurar problemas do Maven pode ser desafiador
Aumenta a automação de builds	Pode introduzir sobrecarga em projetos pequenos