This project is all about two way transformation of JAX-RS-annotated Java code to RAML API description and back.
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
build-tools new version Sep 16, 2018
jaxrs-to-raml Fix to stuff in the pom.xml. Oct 14, 2018
raml-to-jaxrs Fix to stuff in the pom.xml. Oct 14, 2018
utilities new version Sep 16, 2018
.gitignore mvn versions:set -DnewVersion=2.1.0 Jul 12, 2017
.travis.yml Changing travis...release ? Apr 2, 2018
LICENSE_HEADER.txt Licenses adjusted.... Jun 23, 2018 updating POM and README Mar 20, 2018
pom.xml Preparing release. Oct 14, 2018



The goal of RAML for JAX-RS is to provide a set of tools to work with these technologies in a way of being able to scaffold a JAVA + JAX-RS application based on an existing RAML API definition (Code Generation), or its roundtrip, generate the RAML API definition based on an existing JAVA + JAX-RS application (Documentation).


There are two projects:

NOTE: raml-to-jaxrs supports both RAML 0.8 and 1.0. jaxrs-to-raml supports RAML 1.0 only, to generate RAML 0.8, you can use version 1.3.x of raml-for-jax-rs.

Maven artifacts

Maven artifacts are available at:

Releases are also available on Maven Central.


If you are interested in contributing some code to this project, thanks! Please submit a Contributors Agreement acknowledging that you are transferring ownership.

To discuss this project:

  • bug/feature request: please file a github issue
  • If you're not sure: you can use the RAML forum or Slack