@ruiapp/rapid-core 0.2.8 → 0.2.9

package/dist/index.js

@@ -3252,15 +3252,15 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
     const updatedEntityOneRelationProps = {};
     for (const property of oneRelationPropertiesToUpdate) {
         const rowToBeSaved = property.isBaseProperty ? baseRow : row;
-        const fieldValue = changes[property.code];
+        const relatedEntityToBeSaved = changes[property.code];
         const targetDataAccessor = server.getDataAccessor({
             singularCode: property.targetSingularCode,
         });
-        if (lodash.isObject(fieldValue)) {
-            const targetEntityId = fieldValue["id"];
-            if (!targetEntityId) {
+        if (lodash.isObject(relatedEntityToBeSaved)) {
+            const relatedEntityId = relatedEntityToBeSaved["id"];
+            if (!relatedEntityId) {
                 if (!property.selfIdColumnName) {
-                    const targetEntity = fieldValue;
+                    const targetEntity = relatedEntityToBeSaved;
                     const newTargetEntity = await createEntity(server, targetDataAccessor, {
                         routeContext,
                         entity: targetEntity,
@@ -3270,20 +3270,44 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
                 }
             }
             else {
-                const targetEntity = await findById(server, targetDataAccessor, {
-                    id: targetEntityId,
+                let targetEntity = await findById(server, targetDataAccessor, {
+                    id: relatedEntityId,
                     routeContext,
                 });
                 if (!targetEntity) {
-                    throw newEntityOperationError(`Create ${model.singularCode} entity failed. Property '${property.code}' was invalid. Related ${property.targetSingularCode} entity with id '${targetEntityId}' was not found.`);
+                    throw newEntityOperationError(`Update ${model.singularCode} entity failed. Property '${property.code}' was invalid. Related ${property.targetSingularCode} entity with id '${relatedEntityId}' was not found.`);
+                }
+                // update relation entity if options.relationPropertiesToUpdate is specified.
+                const updateRelationPropertiesOptions = lodash.get(options.relationPropertiesToUpdate, property.code);
+                let subRelationPropertiesToUpdate = undefined;
+                let relationEntityToUpdate = null;
+                if (updateRelationPropertiesOptions === true) {
+                    relationEntityToUpdate = targetEntity;
+                }
+                else if (updateRelationPropertiesOptions) {
+                    let propertiesToUpdate = lodash.uniq([
+                        "id",
+                        ...(updateRelationPropertiesOptions.propertiesToUpdate || []),
+                        ...Object.keys(updateRelationPropertiesOptions.relationPropertiesToUpdate || []),
+                    ]);
+                    relationEntityToUpdate = lodash.pick(relatedEntityToBeSaved, propertiesToUpdate);
+                    subRelationPropertiesToUpdate = updateRelationPropertiesOptions.relationPropertiesToUpdate;
+                }
+                if (relationEntityToUpdate) {
+                    targetEntity = await updateEntityById(server, targetDataAccessor, {
+                        routeContext: routeContext,
+                        id: relatedEntityId,
+                        entityToSave: relationEntityToUpdate,
+                        relationPropertiesToUpdate: subRelationPropertiesToUpdate,
+                    });
                 }
                 updatedEntityOneRelationProps[property.code] = targetEntity;
-                rowToBeSaved[property.targetIdColumnName] = targetEntityId;
+                rowToBeSaved[property.targetIdColumnName] = relatedEntityId;
             }
         }
-        else if (lodash.isNumber(fieldValue) || lodash.isString(fieldValue)) {
+        else if (lodash.isNumber(relatedEntityToBeSaved) || lodash.isString(relatedEntityToBeSaved)) {
             // fieldValue is id;
-            const targetEntityId = fieldValue;
+            const targetEntityId = relatedEntityToBeSaved;
             const targetEntity = await findById(server, targetDataAccessor, {
                 id: targetEntityId,
                 routeContext,
@@ -3417,9 +3441,33 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
                 }
                 else {
                     // related entity is existed
-                    const targetEntity = await targetDataAccessor.findById(relatedEntityId);
+                    let targetEntity = await targetDataAccessor.findById(relatedEntityId);
                     if (!targetEntity) {
-                        throw new Error(`Entity with id '${relatedEntityId}' in field '${property.code}' is not exists.`);
+                        throw new Error(`Entity with id '${relatedEntityId}' in field '${property.code}' does not exist.`);
+                    }
+                    // update relation entity if options.relationPropertiesToUpdate is specified.
+                    const updateRelationPropertiesOptions = lodash.get(options.relationPropertiesToUpdate, property.code);
+                    let subRelationPropertiesToUpdate = undefined;
+                    let relationEntityToUpdate = null;
+                    if (updateRelationPropertiesOptions === true) {
+                        relationEntityToUpdate = targetEntity;
+                    }
+                    else if (updateRelationPropertiesOptions) {
+                        let propertiesToUpdate = lodash.uniq([
+                            "id",
+                            ...(updateRelationPropertiesOptions.propertiesToUpdate || []),
+                            ...Object.keys(updateRelationPropertiesOptions.relationPropertiesToUpdate || []),
+                        ]);
+                        relationEntityToUpdate = lodash.pick(relatedEntityToBeSaved, propertiesToUpdate);
+                        subRelationPropertiesToUpdate = updateRelationPropertiesOptions.relationPropertiesToUpdate;
+                    }
+                    if (relationEntityToUpdate) {
+                        targetEntity = await updateEntityById(server, targetDataAccessor, {
+                            routeContext: routeContext,
+                            id: relatedEntityId,
+                            entityToSave: relationEntityToUpdate,
+                            relationPropertiesToUpdate: subRelationPropertiesToUpdate,
+                        });
                     }
                     if (!currentTargetIds.includes(relatedEntityId)) {
                         if (property.linkTableName) {
@@ -4905,11 +4953,16 @@ async function handler$l(plugin, ctx, options) {
     if (stateProperties) {
         delete mergedInput.$stateProperties;
     }
+    const relationPropertiesToUpdate = mergedInput.$relationPropertiesToUpdate;
+    if (relationPropertiesToUpdate) {
+        delete mergedInput.$relationPropertiesToUpdate;
+    }
     const updateEntityByIdOptions = {
         id: mergedInput.id,
         entityToSave: mergedInput,
         operation,
         stateProperties,
+        relationPropertiesToUpdate,
         routeContext: ctx.routerContext,
     };
     const entityManager = server.getEntityManager(options.singularCode);

package/dist/types.d.ts

@@ -487,9 +487,20 @@ export interface UpdateEntityByIdOptions {
     operation?: {
         type: string;
     };
+    /**
+     * 指定需要更新那几个状态属性（配置了`config.stateMachine`的属性）。当不指定时默认更新全部状态属性。
+     */
     stateProperties?: string[];
     postponeUniquenessCheck?: boolean;
+    /**
+     * 指定需要更新关联对象的哪些属性。更新实体时，会创建关联对象，但是默认不更新关联对象的属性。
+     */
+    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
 }
+export type UpdateRelationPropertiesOptions = true | {
+    propertiesToUpdate?: string[];
+    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+};
 export interface DeleteEntityOptions {
     routeContext?: RouteContext;
     filters?: EntityFilterOptions[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ruiapp/rapid-core",
-  "version": "0.2.8",
+  "version": "0.2.9",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/dataAccess/entityManager.ts

@@ -24,7 +24,26 @@ import { mapDbRowToEntity, mapEntityToDbRow } from "./entityMapper";
 import { mapPropertyNameToColumnName } from "./propertyMapper";
 import { IRpdServer, RapidPlugin } from "~/core/server";
 import { getEntityPartChanges } from "~/helpers/entityHelpers";
-import { cloneDeep, filter, find, first, forEach, isArray, isNumber, isObject, isPlainObject, isString, isUndefined, keys, map, reject, uniq } from "lodash";
+import {
+  cloneDeep,
+  concat,
+  filter,
+  find,
+  first,
+  forEach,
+  get,
+  isArray,
+  isNumber,
+  isObject,
+  isPlainObject,
+  isString,
+  isUndefined,
+  keys,
+  map,
+  pick,
+  reject,
+  uniq,
+} from "lodash";
 import {
   getEntityPropertiesIncludingBase,
   getEntityProperty,
@@ -1103,16 +1122,16 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
   const updatedEntityOneRelationProps = {};
   for (const property of oneRelationPropertiesToUpdate) {
     const rowToBeSaved = property.isBaseProperty ? baseRow : row;
-    const fieldValue = changes[property.code];
+    const relatedEntityToBeSaved = changes[property.code];
     const targetDataAccessor = server.getDataAccessor({
       singularCode: property.targetSingularCode!,
     });
 
-    if (isObject(fieldValue)) {
-      const targetEntityId = fieldValue["id"];
-      if (!targetEntityId) {
+    if (isObject(relatedEntityToBeSaved)) {
+      const relatedEntityId = relatedEntityToBeSaved["id"];
+      if (!relatedEntityId) {
         if (!property.selfIdColumnName) {
-          const targetEntity = fieldValue;
+          const targetEntity = relatedEntityToBeSaved;
           const newTargetEntity = await createEntity(server, targetDataAccessor, {
             routeContext,
             entity: targetEntity,
@@ -1121,21 +1140,46 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
           rowToBeSaved[property.targetIdColumnName!] = newTargetEntity["id"];
         }
       } else {
-        const targetEntity = await findById(server, targetDataAccessor, {
-          id: targetEntityId,
+        let targetEntity = await findById(server, targetDataAccessor, {
+          id: relatedEntityId,
           routeContext,
         });
         if (!targetEntity) {
           throw newEntityOperationError(
-            `Create ${model.singularCode} entity failed. Property '${property.code}' was invalid. Related ${property.targetSingularCode} entity with id '${targetEntityId}' was not found.`,
+            `Update ${model.singularCode} entity failed. Property '${property.code}' was invalid. Related ${property.targetSingularCode} entity with id '${relatedEntityId}' was not found.`,
           );
         }
+
+        // update relation entity if options.relationPropertiesToUpdate is specified.
+        const updateRelationPropertiesOptions = get(options.relationPropertiesToUpdate, property.code);
+        let subRelationPropertiesToUpdate = undefined;
+        let relationEntityToUpdate = null;
+        if (updateRelationPropertiesOptions === true) {
+          relationEntityToUpdate = targetEntity;
+        } else if (updateRelationPropertiesOptions) {
+          let propertiesToUpdate = uniq([
+            "id",
+            ...(updateRelationPropertiesOptions.propertiesToUpdate || []),
+            ...Object.keys(updateRelationPropertiesOptions.relationPropertiesToUpdate || []),
+          ]);
+          relationEntityToUpdate = pick(relatedEntityToBeSaved, propertiesToUpdate);
+          subRelationPropertiesToUpdate = updateRelationPropertiesOptions.relationPropertiesToUpdate;
+        }
+        if (relationEntityToUpdate) {
+          targetEntity = await updateEntityById(server, targetDataAccessor, {
+            routeContext: routeContext,
+            id: relatedEntityId,
+            entityToSave: relationEntityToUpdate,
+            relationPropertiesToUpdate: subRelationPropertiesToUpdate,
+          });
+        }
+
         updatedEntityOneRelationProps[property.code] = targetEntity;
-        rowToBeSaved[property.targetIdColumnName!] = targetEntityId;
+        rowToBeSaved[property.targetIdColumnName!] = relatedEntityId;
       }
-    } else if (isNumber(fieldValue) || isString(fieldValue)) {
+    } else if (isNumber(relatedEntityToBeSaved) || isString(relatedEntityToBeSaved)) {
       // fieldValue is id;
-      const targetEntityId = fieldValue;
+      const targetEntityId = relatedEntityToBeSaved;
       const targetEntity = await findById(server, targetDataAccessor, {
         id: targetEntityId,
         routeContext,
@@ -1289,9 +1333,33 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
           relatedEntities.push(newTargetEntity);
         } else {
           // related entity is existed
-          const targetEntity = await targetDataAccessor.findById(relatedEntityId);
+          let targetEntity = await targetDataAccessor.findById(relatedEntityId);
           if (!targetEntity) {
-            throw new Error(`Entity with id '${relatedEntityId}' in field '${property.code}' is not exists.`);
+            throw new Error(`Entity with id '${relatedEntityId}' in field '${property.code}' does not exist.`);
+          }
+
+          // update relation entity if options.relationPropertiesToUpdate is specified.
+          const updateRelationPropertiesOptions = get(options.relationPropertiesToUpdate, property.code);
+          let subRelationPropertiesToUpdate = undefined;
+          let relationEntityToUpdate = null;
+          if (updateRelationPropertiesOptions === true) {
+            relationEntityToUpdate = targetEntity;
+          } else if (updateRelationPropertiesOptions) {
+            let propertiesToUpdate = uniq([
+              "id",
+              ...(updateRelationPropertiesOptions.propertiesToUpdate || []),
+              ...Object.keys(updateRelationPropertiesOptions.relationPropertiesToUpdate || []),
+            ]);
+            relationEntityToUpdate = pick(relatedEntityToBeSaved, propertiesToUpdate);
+            subRelationPropertiesToUpdate = updateRelationPropertiesOptions.relationPropertiesToUpdate;
+          }
+          if (relationEntityToUpdate) {
+            targetEntity = await updateEntityById(server, targetDataAccessor, {
+              routeContext: routeContext,
+              id: relatedEntityId,
+              entityToSave: relationEntityToUpdate,
+              relationPropertiesToUpdate: subRelationPropertiesToUpdate,
+            });
           }
 
           if (!currentTargetIds.includes(relatedEntityId)) {

package/src/plugins/dataManage/actionHandlers/updateCollectionEntityById.ts

@@ -22,11 +22,17 @@ export async function handler(plugin: RapidPlugin, ctx: ActionHandlerContext, op
     delete mergedInput.$stateProperties;
   }
 
+  const relationPropertiesToUpdate = mergedInput.$relationPropertiesToUpdate;
+  if (relationPropertiesToUpdate) {
+    delete mergedInput.$relationPropertiesToUpdate;
+  }
+
   const updateEntityByIdOptions: UpdateEntityByIdOptions = {
     id: mergedInput.id,
     entityToSave: mergedInput,
     operation,
     stateProperties,
+    relationPropertiesToUpdate,
     routeContext: ctx.routerContext,
   };
   const entityManager = server.getEntityManager(options.singularCode);

package/src/types.ts

@@ -628,10 +628,24 @@ export interface UpdateEntityByIdOptions {
   operation?: {
     type: string;
   };
+  /**
+   * 指定需要更新那几个状态属性（配置了`config.stateMachine`的属性）。当不指定时默认更新全部状态属性。
+   */
   stateProperties?: string[];
   postponeUniquenessCheck?: boolean;
+  /**
+   * 指定需要更新关联对象的哪些属性。更新实体时，会创建关联对象，但是默认不更新关联对象的属性。
+   */
+  relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
 }
 
+export type UpdateRelationPropertiesOptions =
+  | true
+  | {
+      propertiesToUpdate?: string[];
+      relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+    };
+
 export interface DeleteEntityOptions {
   routeContext?: RouteContext;
   filters?: EntityFilterOptions[];