Em projetos SpringBoot, é comum precisar incluir bibliotecas externas que não estão disponíveis em repositórios Maven públicos. Este documento aborda como adicionar essas dependências ao projeto e configurá-las para serem incorporadas no pacote final da aplicação.

Configuração Inicial: Diretório de Bibliotecas

Crie uma pasta denominada libs na raiz do projeto para armazenar os arquivos JAR externos. Em seguida, adicione a dependência correspondente no arquivo pom.xml utliizando o escopo system para indicar que o JAR é obtido localmente.

<dependency>
    <groupId>com.example</groupId>
    <artifactId>minha-biblioteca</artifactId>
    <version>2.1.0</version>
    <scope>system</scope>
    <systemPath>${pom.basedir}/libs/minha-biblioteca-2.1.jar</systemPath>
</dependency>

O parâmetro scope definido como system indica que o artefato não será baixado de um repositório remoto, mas sim carregado do sistema de arquivos local. A propriedade systemPath deve apontar para o caminho absoluto do JAR, usando ${pom.basedir} para referenciar o diretório raiz do projeto. Os campos groupId, artifactId e version podem ter valores arbitrários, desde que sejam consistentes.

Empacotamento das Dependências Externas

Para graantir que as bibliotecas externas sejam incluídas no JAR gerado pelo SpringBoot, é necessário ajustar a seção build do pom.xml. Isso envolve a configuração do plugin spring-boot-maven-plugin e a definição de recursos adicionais.

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <includeSystemScope>true</includeSystemScope>
            </configuration>
        </plugin>
    </plugins>
    <resources>
        <resource>
            <directory>libs</directory>
            <targetPath>BOOT-INF/lib/</targetPath>
            <includes>
                <include>**/*.jar</include>
            </includes>
        </resource>
    </resources>
</build>

A opção includeSystemScope no plugin do SpringBoot instrui o Maven a incorporar dependências com escopo system no pacote final. A seção resources mapeia o diretório libs para o caminho BOOT-INF/lib/ dentro do JAR resultante, incluindo todos os arquivos .jar através do padrão **/*.jar. Durante o desenvolvimento em IDE, pode ser necessário ajustar temporariamente as configurações de recursos para evitar conflitos na leitura de arquivos de configuração.