by forge

forge / roaster

A Java Parser library that allows easy parsing and formatting of Java source files

455 Stars 81 Forks Last release: Not found Other 747 Commits 72 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Roaster - The only Java source parser library you'll ever need

image:["Actions Status", link=""] image:["License", link=""] image:["Maven Central", link=""]

Roaster (formerly known as java-parser) is a library that allows easy parsing and formatting of java source files. Roaster introduces a fluent interface to manipulate Java source files, like adding fields, methods, annotations and so on.


  • If you are using Maven, add the following dependencies to your project:



  • Otherwise, download and extract (or build from sources) the most recent|ga|1|a%3A%22roaster-distribution%22[distribution] containing the Roaster distribution and command line tools



Execute roaster by running the following script (add these to your $PATH for convenience):


bin/roaster (Unix/Linux/OSX)

bin/roaster.bat (Windows)

Options described here:


$ roaster -h

Usage: roaster [OPTION]... FILES ... The fastest way to build applications, share your software, and enjoy doing it.

-c, --config [CONFIG_FILE] specify the path to the Eclipse code format profile (usually found at '$PROJECT/.settings/org.eclipse.jdt.core.prefs')

-r, --recursive format files in found sub-directories recursively

FILES... specify one or more space-separated files or directories to format

-h, --help

display this help and exit

Java Parser API


Roaster.parse(JavaClassSource.class, "public class HelloWorld {}");

Java Source Code Generation API

Roaster provides a fluent API to generate java classes. Here an example:

final JavaClassSource javaClass = Roaster.create(JavaClassSource.class);

javaClass.addInterface(Serializable.class); javaClass.addField() .setName("serialVersionUID") .setType("long") .setLiteralInitializer("1L") .setPrivate() .setStatic(true) .setFinal(true);

javaClass.addProperty(Integer.class, "id").setMutable(false); javaClass.addProperty(String.class, "firstName"); javaClass.addProperty("String", "lastName");

javaClass.addMethod() .setConstructor(true) .setPublic() .setBody(" = id;") .addParameter(Integer.class, "id");

Will produce:



public class Person implements Serializable {

private static final long serialVersionUID = 1L; private final Integer id; private String firstName; private String lastName;

public Integer getId() { return id; }

public String getFirstName() { return firstName; }

public void setFirstName(String firstName) { this.firstName = firstName; }

public String getLastName() { return lastName; }

public void setLastName(String lastName) { this.lastName = lastName; }

public Person(Integer id) { = id; } }

Java Source Code Modification API

Of course it is possible to mix both approaches (parser and writer) to modify Java code programmatically:

JavaClassSource javaClass = 
  Roaster.parse(JavaClassSource.class, "public class SomeClass {}");
  .setBody("System.out.println(\"Hello World\");")
  .addParameter("java.lang.String[]", "args");

JavaDoc creation and parsing

Here is an example on how to add JavaDoc to a class:

JavaClassSource javaClass = 
  Roaster.parse(JavaClassSource.class, "public class SomeClass {}");
JavaDocSource javaDoc = javaClass.getJavaDoc();

javaDoc.setFullText("Full class documentation"); // or javaDoc.setText("Class documentation text"); javaDoc.addTagValue("@author","George Gastaldi");


Formatting the Java Source Code

Roaster formats the Java Source Code by calling the

String javaCode = "public class MyClass{ private String field;}";
String formattedCode = Roaster.format(javaCode);

Parsing the java unit

The link:[Java Language Specification] allows you to define multiple classes in the same .java file. Roaster supports parsing the entire unit by calling the parseUnit() method:

String javaCode = "public class MyClass{ private String field;} public class AnotherClass {}";

JavaUnit unit = Roaster.parseUnit(javaCode);

JavaClassSource myClass = unit.getGoverningType(); JavaClassSource anotherClass = (JavaClassSource) unit.getTopLevelTypes().get(1);

Validate Code Snippets

Roaster validates Java snippets and reports as Problem objects by calling the


Example: ```java List problem = Roaster.validateSnippet("public class HelloWorld {}"); // problem.size() == 0

List problem = Roaster.validateSnippet("public class MyClass {"); // problem.size() == 1 containing a new Problem("Syntax error, insert \"}\" to complete ClassBody", 21, 21, 1)

Building from sources

Just run mvn clean install to build the sources

Issue tracker[ROASTER on JBossDeveloper]. You might need to log in, in order to view the issues.

Get in touch

Roaster uses the same forum and mailing lists as the[JBoss Forge] project. See the[JBoss Forge Community] page.

Related / Similar projects

For the writer part:

License[Eclipse Public License - v 1.0]

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.