Switch branches/tags
javaparser-parent-3.5.10 javaparser-parent-3.5.9 javaparser-parent-3.5.8 javaparser-parent-3.5.7 javaparser-parent-3.5.6 javaparser-parent-3.5.5 javaparser-parent-3.5.4 javaparser-parent-3.5.3 javaparser-parent-3.5.2 javaparser-parent-3.5.1 javaparser-parent-3.5.0 javaparser-parent-3.4.4 javaparser-parent-3.4.3 javaparser-parent-3.4.2 javaparser-parent-3.4.1 javaparser-parent-3.4.0 javaparser-parent-3.3.5 javaparser-parent-3.3.4 javaparser-parent-3.3.3 javaparser-parent-3.3.2 javaparser-parent-3.3.1 javaparser-parent-3.3.0 javaparser-parent-3.2.12 javaparser-parent-3.2.11 javaparser-parent-3.2.10 javaparser-parent-3.2.9 javaparser-parent-3.2.8 javaparser-parent-3.2.7 javaparser-parent-3.2.6 javaparser-parent-3.2.5 javaparser-parent-3.2.4 javaparser-parent-3.2.3 javaparser-parent-3.2.2 javaparser-parent-3.2.1 javaparser-parent-3.2.0 javaparser-parent-3.1.4 javaparser-parent-3.1.3 javaparser-parent-3.1.2 javaparser-parent-3.1.1 javaparser-parent-3.1.0 javaparser-parent-3.1.0-beta.2 javaparser-parent-3.0.1 javaparser-parent-3.0.0 javaparser-parent-3.0.0-alpha.11 javaparser-parent-3.0.0-alpha.10 javaparser-parent-3.0.0-alpha.9 javaparser-parent-3.0.0-alpha.8 javaparser-parent-3.0.0-alpha.7 javaparser-parent-3.0.0-alpha.6 javaparser-parent-3.0.0-alpha.5 javaparser-parent-3.0.0-alpha.4 javaparser-parent-3.0.0-alpha.3 javaparser-parent-3.0.0-alpha.2 javaparser-parent-3.0.0-alpha.1 javaparser-parent-3.0.0-RC.4 javaparser-parent-3.0.0-RC.3 javaparser-parent-3.0.0-RC.2 javaparser-parent-3.0.0-RC.1 javaparser-parent-2.5.1 javaparser-parent-2.5.0 javaparser-parent-2.4.0 javaparser-parent-2.3.0 javaparser-parent-2.2.2 javaparser-parent-2.2.1 javaparser-parent-2.2.0 javaparser-parent-2.1.0 javaparser-parent-2.0.0 javaparser-2.0.0 javaparser-1.0.11 javaparser-1.0.10 javaparser-1.0.9 javaparser-1.0.8 javaparser-1.0.7 javaparser-1.0.6 3.1.0-beta.1
Nothing to show
Clone or download
Pull request Compare This branch is 2 commits behind javaparser:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dev-files
javaparser-core-generators
javaparser-core-metamodel-generator
javaparser-core-serialization
javaparser-core-testing
javaparser-core
javaparser-symbol-solver-core
javaparser-symbol-solver-logic
javaparser-symbol-solver-model
javaparser-symbol-solver-testing
.gitignore
.travis.yml
CONTRIBUTING.md
LICENSE
LICENSE.APACHE
LICENSE.GPL
LICENSE.LGPL
appveyor.yml
changelog.md
pom.xml
readme.md
run_core_generators.sh
run_core_metamodel_generator.sh

readme.md

JavaParser

Maven Central Build Status Coverage Status Join the chat at https://gitter.im/javaparser/javaparser

This project contains a set of libraries implementing a Java 1.0 - Java 11 Parser with advanced analysis functionalities.

Our main site is at JavaParser.org

Setup

The project binaries are available in Maven Central.

We strongly advise users to adopt Maven, Gradle or another build system for their projects. If you are not familiar with them we suggest taking a look at the maven quickstart projects (javaparser-maven-sample, javasymbolsolver-maven-sample).

Just add the following to your maven configuration or tailor to your own dependency management system.

Please refer to the Migration Guide when upgrading from 2.5.1 to 3.0.0+

Maven:

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

Gradle:

compile 'com.github.javaparser:javaparser-symbol-solver-core:3.6.26'

Since Version 3.5.10, the JavaParser project includes the JavaSymbolSolver. While JavaParser generates an Abstract Syntax Tree, JavaSymbolSolver analyzes that AST and is able to find the relation between an element and its declaration (e.g. for a variable name it could be a parameter of a method, providing information about its type, position in the AST, ect).

Using the dependency above will add both JavaParser and JavaSymbolSolver to your project. If you only need the core functionality of parsing Java source code in order to traverse and manipulate the generated AST, you can reduce your projects boilerplate by only including JavaParser to your project:

Maven:

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

Gradle:

compile 'com.github.javaparser:javaparser-core:3.6.26'

Since version 3.6.17 the AST can be serialized to JSON. There is a separate module for this:

Maven:

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

Gradle:

compile 'com.github.javaparser:javaparser-core-serialization:3.6.26'

How To Compile Sources

If you checked out the project from GitHub you can build the project with maven using:

mvn clean install

If you checkout the sources and want to view the project in an IDE, it is best to first generate some of the source files; otherwise you will get many compilation complaints in the IDE. (mvn clean install already does this for you.)

mvn javacc:javacc

If you modify the code of the AST nodes, specifically if you add or remove fields or node classes, the code generators will update a lot of code for you. The run_metamodel_generator.sh script will rebuild the metamodel, which is used by the code generators which are run by run_core_generators.sh Make sure that javaparser-core at least compiles before you run these.

More information

JavaParser.org is the main information site.

License

JavaParser is available either under the terms of the LGPL License or the Apache License. You as the user are entitled to choose the terms under which adopt JavaParser.

For details about the LGPL License please refer to LICENSE.LGPL.

For details about the Apache License please refer to LICENSE.APACHE.