| commit | 26e8967d35ba53299a1ffd51fb1b406c43c8dc00 | [log] [tgz] |
|---|---|---|
| author | Sebastian Kürten <sebastian@topobyte.de> | Wed Apr 13 11:19:36 2016 +0200 |
| committer | Sebastian Kürten <sebastian@topobyte.de> | Wed Apr 13 11:19:36 2016 +0200 |
| tree | 44d4d305dab1085594a628bf0f6bbf6e46aa94c4 | |
| parent | 9d352b5a434df7e9525d3c843a0ba33376c367a5 [diff] |
New classes: InstanceJavaParser, CommentsInserter Added the class 'InstanceJavaParser' as a thin wrapper around ASTParser with a few convenience methods for parsing CompilationUnits, Blocks, Statements, etc. Added the class 'CommentsInsert' to encapsulate code for assigning comments to nodes of the AST. Refactored JavaParser to be based on both InstanceJavaParser and CommentsInserter. This keeps the established API while having the logic for making calls to the ASTParser in a single location. Enabled the COMMON_TOKEN_ACTION=true option in the java_1_8.jj file. Implemented a CommonTokenAction(Token token) method in the TOKEN_MGR_DECLS that collects encountered tokens in a list. Added a getter for this list of tokens in the ASTParser.
- javaparser-core/src/main/java/com/github/javaparser/CommentsInserter.java[Added - diff]
- javaparser-core/src/main/java/com/github/javaparser/InstanceJavaParser.java[Added - diff]
- javaparser-core/src/main/java/com/github/javaparser/JavaParser.java[diff]
- javaparser-core/src/main/javacc/java_1_8.jj[diff]
- pom.xml[diff]
- dev-files/
- javaparser-core/
- javaparser-testing/
- .gitignore
- .travis.yml
- changelog.txt
- LICENSE
- LICENSE.APACHE
- LICENSE.GPL
- LICENSE.LGPL
- pom.xml
- readme.md
Java Parser and Abstract Syntax Tree
This package contains a Java 1.8 Parser with AST generation and visitor support.
The AST records the source code structure, javadoc and comments. It is also possible to change the AST nodes or create new ones to modify the source code.
Features
- Light weight
- Performant
- Easy to use
- Modifiable AST
- Create AST from scratch
- Support of comments
Dependency Management
The project binaries are available in Maven Central. Just add the following to your maven configuration or tailor to your own dependency management system.
Current 1.8 Release
<dependency> <groupId>com.github.javaparser</groupId> <artifactId>javaparser-core</artifactId> <version>2.4.0</version> </dependency>
Final 1.7 Release
<dependency> <groupId>com.google.code.javaparser</groupId> <artifactId>javaparser</artifactId> <version>1.0.11</version> </dependency>
How To Compile Sources
If you have checkout 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 generate the additional source files; otherwise you will get many compilation complaints in the IDE
mvn javacc:javacc
Manual
Examples of how to use the library can be found on the Manual page of the wiki
Troubleshooting
In the first instance try the wiki
In the second instance please feel free to open an issue.
Javadoc
The libraries javadoc can be found here
History
This parser is based on work by Sreenivasa Viswanadha and Júlio Vilmar Gesser. The original project, now inactive, was originally hosted at Google Code and supported only parsing Java 1.5.
The project now supports parsing Java 1.8 and aims to continue support for features in future versions of the Java language.
Related projects
From JavaParser other projects have been derived:
- Walkmod: a tool to automatically correct violations of code conventions
- jooby spec: analyze and exports jooby routes to raml and Swagger
Credits
This project has been maintained thanks to the joint efforts of many contributors: we are extremely grateful to all of them.
In particular we are thankful to the contributions we received by the Walkmod project which permitted to finalize support for Java 8. The author granted us the permissions to release that code also under the Apache License and we have greatly appreciated that.
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.