Add possibility to use MongoDB as database (jhipster#717)

Add possibility to use MongoDB as database (jhipster#717)

Author: Zenrac

.github/workflows/test-integration-jwt.yml

@@ -18,6 +18,8 @@ jobs:
                     - jwt-with-blazor-cqrs-app
                     - jwt-with-mssql-app
                     - jwt-with-mysql-app
+                    - jwt-with-mongo-app
+                    - jwt-with-mongo-cqrs-app
                     - jwt-with-postgres-app
                     - jwt-with-react-app
                     - jwt-with-vue-app
@@ -34,6 +36,10 @@ jobs:
                       arg: 'no'
                     - app-type: jwt-with-mysql-app
                       arg: 'no'
+                    - app-type: jwt-with-mongo-app
+                      arg: 'import-jdl'
+                    - app-type: jwt-with-mongo-cqrs-app
+                      arg: 'import-jdl'
                     - app-type: jwt-with-postgres-app
                       arg: 'no'
                     - app-type: jwt-with-react-app

.github/workflows/test-integration-oauth.yml

@@ -16,6 +16,8 @@ jobs:
                   - oauth-with-angular-cqrs-app
                   - oauth-with-mssql-app
                   - oauth-with-mysql-app
+                  - oauth-with-mongo-app
+                  - oauth-with-mongo-cqrs-app
                   - oauth-with-oracle-app
                   - oauth-with-postgres-app
                   - oauth-with-react-app
@@ -29,6 +31,10 @@ jobs:
                     arg: 'no'
                   - app-type: oauth-with-mysql-app
                     arg: 'no'
+                  - app-type: oauth-with-mongo-app
+                    arg: 'no'
+                  - app-type: oauth-with-mongo-cqrs-app
+                    arg: 'no'
                   - app-type: oauth-with-oracle-app
                     arg: 'no'
                   - app-type: oauth-with-postgres-app

docs/Features/cypress.md

@@ -0,0 +1,29 @@
+# Cypress
+
+When generating an application, you are able to automatically generate Cypress tests.
+
+## Introduction
+
+Cypress is a next generation front end testing tool built for the modern web. It allows to run multiple end to end tests on all your application features.
+
+## Pre-requisites
+
+When generating your application, make sure to check "Cypress" in your optional testing framworks (by pressing the space bar).
+
+![cypress-choice](../assets/cypress-choice.png)
+
+## How to use it
+
+Once your application is generated, you can optionally add some entities, it will automatically generate the corresponding tests for your entities. To begin, go to your ClientApp folder:
+```bash
+cd src/YourApplication/ClientApp
+```
+Then execute one of the following commands:
+```bash
+npx cypress open
+```
+or
+```bash
+./node_modules/.bin/cypress open
+```
+For futher information you can visit [Cypress wiki](https://docs.cypress.io/guides/guides/command-line#How-to-run-commands).

docs/Features/entity-auditing.md

@@ -20,7 +20,7 @@ public abstract class AuditedEntityBase
     public DateTime LastModifiedDate { get; set; }
 }
 ```
-## Audit of generated Entities 
+## Audit of generated Entities
 
 For example, if we have a ```Task``` entity and we want to add audit functionality we would inherit from our ```AuditedEntityBase``` like that:
 ```csharp

docs/Features/mongodb.md

@@ -0,0 +1,29 @@
+# MongoDB
+
+When generating an application, you can choose to use a NoSQL Database thanks to MongoDB.
+
+## Introduction
+
+[MongoDB](https://www.mongodb.com/) is a document-oriented NoSQL database used for high volume data storage. Instead of using tables and rows as in the traditional relational databases, MongoDB makes use of collections and documents.
+
+## Pre-requisites
+
+When generating your application, make sure to choose "MongoDB" as your database.
+
+![mongodb-choice](../assets/mongodb-choice.png)
+
+## Difference with SQL databases
+
+The main difference with the other SQL databases is that your IDs are handled as string and are stored in ObjectID instead of long.
+
+Also, some classes are replaced in order to support MongoDB :
+```
+BaseEntity => MongoBaseEntity
+GenericRepository => MongoGenericRepository
+ReadOnlyGenericRepository => MongoReadOnlyGenericRepository
+FluentRepository => NoSqlFluentRepository
+```
+
+## WIP
+
+Currently, MongoDB is only used for entities. Users/Accounts are managed with a in-memory Sqlite. This feature is still under development.

docs/Features/services.md

@@ -14,25 +14,25 @@ Or by using JDL:
 
 Notice that only the service with interface option (serviceImpl) is enabled on this generator.
 
-## Extending and Customizing Services 
+## Extending and Customizing Services
 
 One common use case is to customize service classes to suit different business needs. When using the jhipster generator to edit an existing entity or upgrading the generator's version, changes to the generated service classes might be overwritten. Altough it is possible to make changes directly to generated service classes, It might get tricky keeping track of changes.
 
 Optionally, you can extend and customize service classes to avoid service class code overwriting.
 
 Example:
-Add an Author entity with service generation enabled by using the generator's cli. 
+Add an Author entity with service generation enabled by using the generator's cli.
 Then create the following class named `AuthorExtendedService.cs`:
 
 ```csharp
 namespace MyCompany.Domain.Services {
-    public class AuthorExtendedService : AuthorService, IAuthorService 
+    public class AuthorExtendedService : AuthorService, IAuthorService
     {
         public CountryExtendedService(ApplicationDatabaseContext applicationDatabaseContext) : base(applicationDatabaseContext)
-        {   
+        {
         }
-        
-        public override async Task Delete(long id) 
+
+        public override async Task Delete(long id)
         {
             // add custom business logic before delete
             await base.Delete(id);

docs/assets/cypress-choice.png

@@ -23,6 +23,6 @@ namespace <%= namespace %>.Application.Commands
 {
     public class <%= pascalizedEntityClass %>DeleteCommand : IRequest<Unit>
     {
-        public long Id { get; set; }
+        public <%= primaryKeyType %> Id { get; set; }
     }
 }

docs/assets/mongodb-choice.png

@@ -55,13 +55,15 @@ namespace <%= namespace %>.Application.Queries
         public async Task<<%= hasDto ? "Page" : "IPage" %><<%= hasDto ? asDto(pascalizedEntityClass) : pascalizedEntityClass %>>> Handle(<%= pascalizedEntityClass %>GetAllQuery request, CancellationToken cancellationToken)
         {
             var page = await _<%= camelCasedEntityClass %>Repository.QueryHelper()
+            <%_ if (databaseType != 'mongodb') { _%>
             <%_ relationships.forEach( relationship => {
                 if (relationship.relationshipType === 'many-to-one' || relationship.relationshipType === 'one-to-one') { _%>
                 .Include(<%= camelCasedEntityClass %> => <%= camelCasedEntityClass %>.<%= relationship.relationshipFieldNamePascalized %>)
                 <%_ } else if (relationship.relationshipType === 'many-to-many' && relationship.ownerSide) { _%>
                 .Include(<%= camelCasedEntityClass %> => <%= camelCasedEntityClass %>.<%= relationship.relationshipFieldNamePascalizedPlural %>)
                 <%_ }
                 }); _%>
+                <%_ } _%>
                 .GetPageAsync(request.Page);
             <%_ if (hasDto) { _%>
             return new Page<<%= asDto(pascalizedEntityClass) %>>(page.Content.Select(entity => _mapper.Map<<%= asDto(pascalizedEntityClass) %>>(entity)).ToList(), request.Page, page.TotalElements);