generator-spring-jpa-crud-generator

Prerequirement

1. Java JDK 11 or newer (can be an open-jdk distro)
2. Gradle 2+
3. NPM
4. Yeoman
5. Maven 3+

About this package

This package is a spring-boot crud generator that uses jpa as the primary class for object and database mapping. The main goal of this package is to speed up the process of crud operations, which can take some time to implement. By installing this package, it can do all the work by creating the crude operation with just one command. Although this package will do everything for crud operation, the developer must be aware of certain limitations, how to use, install, and initiate the application properties, and how to add some dependencies on both Maven and Gredle that the package cannot handle.

Awareness

This package author use Gradle dependency for test, build the project and Intellij as the code editor. For the project to be processed, some of the below gradle dependency elements must be included:

implementation 'org.springframework.boot:spring-boot-starter'
implementation 'org.springframework.boot:spring-boot-starter-web'
implementation 'org.springframework.boot:spring-boot-starter-validation'
implementation 'org.springframework.boot:spring-boot-starter-data-jpa'
implementation 'org.projectlombok:lombok:1.18.24'
implementation "org.mapstruct:mapstruct:$mapstructVersion"
implementation "org.postgresql:postgresql:$postgresqlVersion"
implementation 'org.apache.commons:commons-lang3:3.12.0'

compileOnly 'org.projectlombok:lombok'
runtimeOnly 'org.postgresql:postgresql'
annotationProcessor 'org.projectlombok:lombok'
testCompileOnly 'org.projectlombok:lombok:1.18.24'
testAnnotationProcessor 'org.projectlombok:lombok:1.18.24'
annotationProcessor "org.mapstruct:mapstruct-processor:$mapstructVersion"

testImplementation 'org.springframework.boot:spring-boot-starter-test'

******* This is just the gradle that author use be aware that you can modify version or you wish to implement with maven; please want to make sure that the below gradle or maven dependency topics have been install:

• Lombok
• SpringWeb
• SpringDataJPA
• MapStruct
• Postgre (or any database)
• SpringValidation

***** Warning: The configuration of database have to be define by your own as well.

Installation

First, install Yeoman and generator-spring-jpa-crud-generator using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-spring-jpa-crud-generator

Then generate your new project:

yo spring-jpa-crud-generator

Getting To Know Yeoman

• Yeoman has a heart of gold.
• Yeoman is a person with feelings and opinions, but is very easy to work with.
• Yeoman can be too opinionated at times but is easily convinced not to be.
• Feel free to learn more about Yeoman.

How to use

1. Go to your spring boot project directory
2. Type in command "yo spring-jpa-crud-generator"
3. Provide domain of the project. ex: com.myapi.com
4. Finally, provide module of your crud. ex: user

*******NOTES: The author use snakeCase as the format when returning the client; therefore you can make your application.properties as "spring.jackson.property-naming-strategy=SNAKE_CASE". Since, in the unit test, the author checking with snake_case strategy, so to make the application test it correctly you can make change in your application.properties to be snake_case or if you wish to use camal_case please change in the unit test to be whatever you wish.

Features

Generation of fully-functional springboot REST API, using:

• Java 11
• Spring-boot 2.2 REST API
• Gredle 2+

Integrations

This generator allows to integrate the springboot REST API with:

• PostgreSQL
• Oracle
• SQL

Functionality

The crud generator will deliver the following:

• Generate clean architectural crud using OOP and SOLID concepts.
• Search object with Pagination (you will give all the field that you want for dynamic search purpose by including all those fields inside the searchDTO class)
• ControllerAdvise implementation which will give the global throwable json format
• Unit Test with RestTemplate

Notes:

This package uses JPA as the primary class for object and database mapping. Also keep in mind that the user can change any field in any of the classes used by the crud generator, particularly the entity class, depending on their needs. However, by default, we will only provide two basic fields, such as the id and description fields.

License

Apache-2.0 © SovathChean