Generator-jhipster-mysql-uuid-converter NPM

generator-jhipster-mysql-uuid-converter

JHipster module for converting mysql keys from Long to UUID

Introduction

This is a JHipster module, that is meant to be used in a JHipster application. The purpose of this module is to convert a monolithic JHipster application using Long primary keys to UUID based primary keys.

It is important to note that since we don't know what relations may exist, the module converts all Long members of Entity classes. You might need to do some manual adjustments to converted code.

Prerequisites

As this is a JHipster module, we expect you have JHipster and its related tools already installed:

Installing JHipster

Installation

With Yarn

To install this module:

yarn global add generator-jhipster-mysql-uuid-converter

To update this module:

yarn global upgrade generator-jhipster-mysql-uuid-converter

With NPM

To install this module:

npm install -g generator-jhipster-mysql-uuid-converter

To update this module:

npm update -g generator-jhipster-mysql-uuid-converter

Usage

Once a monolithic JHipster application using mysql is generated, install the module as listed above. On installation, the module will convert the generated code to use UUIDs (entities are not affected).

For entities you will need to regenerate the entities. After regeneration Jhipster will call this module as a post entity creation hook and module will convert that entity to UUID based. Any new entity that is generated after the installation of this module will automatically be UUID based.

Known Issues

In some cases tests may not compile as some number conversion may be incorrect.
ElasticSearch probably won't work as it does not accepts a UUID primary key. As per my understanding a converter is needed. I don't know how to write that so any suggestions are welcome.