JARs no classpath: Como incluir todas as bibliotecas de uma pasta em 2025

Introdução: A Maldição dos Mil JARs

Você já se viu em uma situação onde seu projeto Java cresce, e a pasta lib/ se transforma em um verdadeiro zoológico com dezenas, ou até centenas, de arquivos JAR? E toda vez que inicia a aplicação, você fica se lembrando dolorosamente qual JAR você adicionou e qual esqueceu? Familiar, não é mesmo?

A pergunta "Including all the jars in a directory within the Java classpath" é uma das mais populares no Stack Overflow. E não é à toa. Uma tarefa aparentemente trivial se torna uma dor de cabeça se você não conhecer as ferramentas certas. Neste artigo, vamos abordar todas as formas: desde as antigas como dinossauros até as mais modernas que todo desenvolvedor Java que se preze usa em 2025.

Prepare-se, vamos embarcar em uma jornada fascinante pela selva do classpath!

Por que isso é um problema? (ou "A Epopeia do -cp")

Nos bons e velhos tempos (antes do Java 6), os desenvolvedores eram forçados a listar cada arquivo JAR manualmente. Era mais ou menos assim:

java -cp lib/guava.jar:lib/spring-core.jar:lib/log4j.jar:lib/jackson.jar MyApp

Agora imagine que você tem 30 bibliotecas. Um erro de digitação e a aplicação falha com ClassNotFoundException. Pesadelo! Foi então que a comunidade começou a buscar maneiras de incluir todos os jars no classpath Java em uma única linha.

Método nº1: Wildcard — O Salvador do Java 6

A partir do Java 6, a JVM ganhou uma capacidade mágica — o wildcard (curinga). Você simplesmente indica o caminho para a pasta com um asterisco, e a JVM carrega automaticamente todos os arquivos JAR de lá.

Como funciona:

java -cp "lib/*" MyApp

Importante! Observe as aspas. Sem elas, em alguns shells (por exemplo, no Unix), o asterisco pode ser interpretado pelo shell, e você não obterá o que espera. As aspas garantem que o * seja passado diretamente para a JVM.

Este método ainda é relevante. É simples, elegante e resolve 90% dos problemas. Mas há um detalhe: o wildcard não funciona recursivamente. Se você tiver pastas aninhadas (lib/subdir/), o conteúdo delas não será carregado. Para isso, é necessário indicar cada nível manualmente:

java -cp "lib/*:lib/subdir/*" MyApp

Quando usar wildcard?

\n
• Você está escrevendo um script ou utilitário simples.
\n
• Você não tem um sistema de build (Maven/Gradle).
\n
• Você precisa executar algo rapidamente "de improviso".
\n

Método nº2: Maven — O Padrão da Indústria

Se você trabalha em um projeto real, provavelmente usa Maven. E a pergunta "como incluir todos os JARs de uma pasta" é resolvida no nível do build.

O Maven gerencia as dependências por conta própria. Você simplesmente as declara no pom.xml, e o Maven baixa os JARs necessários e os adiciona ao classpath automaticamente.

Exemplo de pom.xml:

<dependencies>\n    <dependency>\n        <groupId>org.springframework.boot</groupId>\n        <artifactId>spring-boot-starter-web</artifactId>\n        <version>3.2.0</version>\n    </dependency>\n    <dependency>\n        <groupId>com.google.code.gson</groupId>\n        <artifactId>gson</artifactId>\n        <version>2.10.1</version>\n    </dependency>\n</dependencies>

Ao compilar (por exemplo, mvn package), o Maven cria um fat JAR (ou usa o plugin maven-dependency-plugin), que inclui todas as dependências. Você não precisa mais se preocupar com o classpath — ele está empacotado internamente.

Mas e se você precisar incluir todos os JARs de alguma pasta local, não gerenciada pelo Maven? Para isso, existem as System Dependencies (embora isso seja considerado um antipadrão):

<dependency>\n    <groupId>com.example&