3.0.0

This release introduces the following changes:

• Extracted emitter to raml-java-tools #310
• Extracted pojo-to-raml to raml-java-tools #311
• Extracted raml-to-pojo to raml-java-tools #312

adds the following capabilities:

• Add possibility to generate uriParameters as longs #328
• RAML to POJO - description and displayName #324
• java.time APIs and RAML Types #294
• Generating Wrapper classes(java.lang.Long, java.math.BigDecimal) from the Raml1.0 schemas #298
• Add the possibility to rename the generated java interface corresponding to a resource #237
• RAML containing multipart form data does not generate compileable code #334
• Generating toString, hashCode and equals for Java classes generated from RAML DataTypes #223
• Support for jackson 1.x annotations( codehaus ) #303, #332
• java.util.UUID with jaxrs-to-raml #322
• Multiple ramlFiles #279, #315
• Default value in Jackson's @JsonProperty #330

and addresses the following issues:

• Imports generation issue with raml-to-jaxrs maven plugin #320
• Method name clash when dealing with path parameters #314
• Path parameters nowhere to be found #313
• Library referring to another Library #309
• Failed to execute goal org.raml.jaxrs:jaxrs-to-raml-maven-plugin:2.1.1:jaxrstoraml #329
• Jackson: Use 'As.EXISTING_PROPERTY' in super types with discriminator #331
• v2.1.0 - Inline generation doesn't seems to be recursive #285
• Duplicate Definitions added to the Resource Interface if there are multiple end points with the same return type #264
• minimum, maximum validations on integer are not populated. #306

2.1.1

This release addresses the following issues:

• NullPointerException with a certain RAML #265
• Discriminator field is 'null' in subtype #295
• @ramlGenerator: does not parse the property of a class #300
• Generate @DefaultValue annotation for query parameters with default values #304
• Complex types JSR 303 validation #302
• Created Enum types have private field "name" but no accessor #286
• classpath: and java: schema references setup. #317
• RAML-to-JAXRS CLI tool not generating model files in 2.1.x #296
• Inconsistent code generation #316
• Query parameter types are referenced but not generated #271
• Support for "inline" multiple inheritance #318

2.1.0

This release adds the following feature:

• Gradle plugin #239

and fixes the following issues:

• Wrong generated type for enum references #254
• Deserializer not referenced properly on internal class #261
• ClassCastException with recent changes #269
• NPE when @Provider used in class #260
• Missing intermediate paths #252
• RuntimeException with Unknown type #256
• Primitive types not usable in arrays #255
• RAML validation fails with ":" in description #258
• UnionDeserializationGenerator creates inconsistent "looksLike" method names #262
• Query parameter types are referenced but not generated #271
• Handle Java Reserved Words/Keywords #234
• Issue with generated class level @path annotation #231
• types is at the bottom of the outputted RAML #246
• ConcurrentModificationException when using raml-to-jaxrs-cli #226
• Exception if query parameters are defined as object type #229
• leading underscores are thrown away #233
• type: array with no items: defined does not generate proper List<...> entity #243
• CLI ignores generate-types-with parameter #242

2.0.0

This release constitutes a major refactoring, pretty much everything has changed. The 2.0.x version adds support for RAML 1.0 which is now the target for both halves of the system: raml-to-jaxrs and jaxrs-to-raml. Note that in this version, raml-to-jaxrs supports both RAML 0.8 and 1.0 while jaxrs-to-raml supports RAML 1.0 only. To generate RAML 0.8, you should use version 1.3.x. Both packages can be ran as either command-line or maven plugin.

What's new in raml-to-jaxrs?

There are two fundamental changes. The first one is that it now uses JavaPoet to generate code. The second one is that it leverages annotations introduced in RAML 1.0 to extend the generation. This means that some features are only available if using RAML 1.0 as input.

You can find an exhaustive list of changes here: #211.

What's new in jaxrs-to-raml?

The main difference with the previous versions is that the output is now in RAML 1.0 format. This means that: JAXB schemas are translated to RAML data types and RAML examples can now be expressed using a custom @Examples annotations.

This release adds support for multipart files using @FormDataParam. It now translates @DefaultValue to default: RAML property. Also, note that unsupported annotations, i.e. annotations that are not understood by the program, can be preserved and converted to RAML annotations.

You can find an exhaustive list of changes here: #212.

Where to start?

The documentation for both raml-to-jaxrs and jaxrs-to-raml are a good starting point. There are also several examples in each package that demonstrates the main features.

2.0.0-RC1

This is a preview of the 2.0.0 release

v1.3.4

1.3.4 release

v1.3.3

1.3.3 release. This is first one which is published to central