There are special use-cases that each language supports; this document pertains to Java models.
- Include equals function for the class
- Include hashCode function for the class
- Change the collection type for arrays
- Include toString function for the class
- Include JavaDoc for properties
- Include Javax validation constraint annotations for properties
- Generate serializer and deserializer functionality
- Integrate Modelina into Maven
To overwrite the equal method, use the preset JAVA_COMMON_PRESET and provide the option equal: true.
Check out this example for a live demonstration.
To overwrite the hashCode method, use the preset JAVA_COMMON_PRESET and provide the option hashCode: true.
Check out this example for a live demonstration.
Sometimes, we might want to render a different collection type, and instead of the default Array use as List type. To do so, provide the option collectionType: 'List'.
Check out this example for a live demonstration.
To overwrite the toString method, use the preset JAVA_COMMON_PRESET and provide the option classToString: true.
Check out this example for a live demonstration.
To generate models containing JavaDocs from description and examples, use the JAVA_DESCRIPTION_PRESET option.
Check out this example for a live demonstration.
In some cases, when you generate the models from JSON Schema, you may want to include javax.validation.constraint annotations.
Check out this example for a live demonstration.
The most widely used usecase for Modelina is to generate models that include serilization and deserialization functionality to convert the models into payload data. This payload data can of course be many different kinds, JSON, XML, raw binary, you name it.
As you normally only need one library to do this, we developers can never get enough with creating new stuff, therefore there might be one specific library you need or want to integrate with. Therefore there is not one specific preset that offers everything. Below is a list of all the supported serialization presets.
Here are all the supported presets and the libraries they use:
To generate Java data models with Jackson annotation using JAVA_JACKSON_PRESET option.
Check out this example for a live demonstration.
External dependencies Requires com.fasterxml.jackson.annotation to work.
Sometimes you just want to convert your class to JSON without the use of annotations such as Jackson.
Check out this example for a live demonstration.
External dependencies Requires org.json package to work.
Currently not supported, let everyone know you need it!
Currently not supported, let everyone know you need it!
We have created an example Maven project to show you how to generate AsyncAPI payload models from your AsyncAPI file and integrate it into the build process. You can find the integration example here.