javaparser

JavaParser

Este projeto contém um conjunto de bibliotecas que implementam um analisador Java 1.0 - Java 21 com funcionalidades de análise avançadas.

Nosso site principal é JavaParser.org

Patrocinadores

Apoie este projeto tornando-se um patrocinador! Torne-se um patrocinador. Sua doação ajudará o projeto a viver e crescer com sucesso.

Javaparser usa OpenCollective para arrecadar dinheiro.

Obrigado aos nossos patrocinadores!

Configurar

Os binários do projeto estão disponíveis no Maven Central.

Aconselhamos fortemente os usuários a adotarem Maven, Gradle ou outro sistema de construção para seus projetos. Se você não estiver familiarizado com eles, sugerimos dar uma olhada nos projetos de início rápido do maven (javaparser-maven-sample, javasymbolsolver-maven-sample).

Basta adicionar o seguinte à sua configuração do maven ou adaptá-lo ao seu próprio sistema de gerenciamento de dependências.

Consulte o Guia de migração ao atualizar de 2.5.1 para 3.0.0+

Maven :

< dependency >
    < groupId >com.github.javaparser</ groupId >
    < artifactId >javaparser-symbol-solver-core</ artifactId >
    < version >3.26.2</ version >
</ dependency >

Gradil :

 implementation 'com.github.javaparser:javaparser-symbol-solver-core:3.26.2'

Desde a versão 3.5.10, o projeto JavaParser inclui o JavaSymbolSolver. Enquanto JavaParser gera uma Árvore de Sintaxe Abstrata, JavaSymbolSolver analisa esse AST e é capaz de encontrar a relação entre um elemento e sua declaração (por exemplo, para um nome de variável pode ser um parâmetro de um método, fornecendo informações sobre seu tipo, posição no AST , etc.).

Usar a dependência acima adicionará JavaParser e JavaSymbolSolver ao seu projeto. Se você precisar apenas da funcionalidade principal de análise do código-fonte Java para percorrer e manipular o AST gerado, poderá reduzir o padrão do seu projeto incluindo apenas o JavaParser em seu projeto:

Maven :

< dependency >
    < groupId >com.github.javaparser</ groupId >
    < artifactId >javaparser-core</ artifactId >
    < version >3.26.2</ version >
</ dependency >

Gradil :

 implementation 'com.github.javaparser:javaparser-core:3.26.2'

Desde a versão 3.6.17 o AST pode ser serializado para JSON. Existe um módulo separado para isso:

Maven :

< dependency >
    < groupId >com.github.javaparser</ groupId >
    < artifactId >javaparser-core-serialization</ artifactId >
    < version >3.26.2</ version >
</ dependency >

Gradil :

 implementation 'com.github.javaparser:javaparser-core-serialization:3.26.2'

Como compilar fontes

Se você verificou o código-fonte do projeto no GitHub, poderá construir o projeto com maven usando:

 ./mvnw clean install

Se desejar gerar os arquivos jar empacotados a partir dos arquivos de origem, execute o seguinte comando maven:

 ./mvnw package

NOTA os arquivos jar para os dois módulos podem ser encontrados em:

• javaparser/javaparser-core/target/javaparser-core-<version>.jar
• javaparser-symbol-solver-core/target/javaparser-symbol-solver-core-<version>.jar

Se você fizer check-out dos fontes e quiser visualizar o projeto em um IDE, é melhor primeiro gerar alguns dos arquivos de origem; caso contrário, você receberá muitas reclamações de compilação no IDE. ( ./mvnw clean install já faz isso para você.)

 ./mvnw javacc:javacc

Se você modificar o código dos nós AST, especificamente se adicionar ou remover campos ou classes de nós, os geradores de código atualizarão muito código para você. O script run_metamodel_generator.sh reconstruirá o metamodelo, que é usado pelos geradores de código executados por run_core_generators.sh Certifique-se de que javaparser-core pelo menos compile antes de executá-los.

Nota : para Eclipse IDE siga as etapas descritas no wiki: https://github.com/javaparser/javaparser/wiki/Eclipse-Project-Setup-Guide

Mais informações

JavaParser.org é o principal site de informações ou consulte a página wiki https://github.com/javaparser/javaparser/wiki.

Licença

JavaParser está disponível sob os termos da Licença LGPL ou da Licença Apache. Você, como usuário, tem o direito de escolher os termos sob os quais adotar o JavaParser.

Para obter detalhes sobre a Licença LGPL, consulte LICENSE.LGPL.

Para obter detalhes sobre a licença Apache, consulte LICENSE.APACHE.