@ruiapp/rapid-core 0.5.2 → 0.5.4

package/dist/core/server.d.ts

@@ -1,4 +1,4 @@
-import { CreateEntityOptions, EmitServerEventOptions, EntityWatcherType, GetDataAccessorOptions, GetModelOptions, IDatabaseAccessor, IDatabaseConfig, IQueryBuilder, IRpdDataAccessor, RapidServerConfig, RpdApplicationConfig, RpdDataModel, RpdDataModelProperty, RpdServerEventTypes, UpdateEntityByIdOptions } from "../types";
+import { CreateEntityOptions, EmitServerEventOptions, EntityWatcherType, GetDataAccessorOptions, GetModelOptions, IDatabaseAccessor, IDatabaseClient, IDatabaseConfig, IQueryBuilder, IRpdDataAccessor, RapidServerConfig, RpdApplicationConfig, RpdDataModel, RpdDataModelProperty, RpdServerEventTypes, UpdateEntityByIdOptions } from "../types";
 import { IPluginActionHandler, ActionHandler, ActionHandlerContext } from "./actionHandler";
 import { Next, RouteContext } from "./routeContext";
 import EntityManager from "../dataAccess/entityManager";
@@ -12,8 +12,8 @@ export interface IRpdServer {
     registerFacilityFactory(factory: FacilityFactory): any;
     getFacility<TFacility = any>(name: string, options?: any): Promise<TFacility>;
     getDatabaseAccessor(): IDatabaseAccessor;
-    queryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>) => Promise<any[]>;
-    tryQueryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>) => Promise<any[]>;
+    queryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient) => Promise<any[]>;
+    tryQueryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient) => Promise<any[]>;
     registerMiddleware(middleware: any): void;
     registerActionHandler(plugin: RapidPlugin, options: IPluginActionHandler): void;
     getActionHandlerByCode(code: string): ActionHandler | undefined;

package/dist/dataAccess/entityManager.d.ts

@@ -3,6 +3,7 @@ import { IRpdServer, RapidPlugin } from "../core/server";
 import { RouteContext } from "../core/routeContext";
 export type FindOneRelationEntitiesOptions = {
     server: IRpdServer;
+    routeContext?: RouteContext;
     mainModel: RpdDataModel;
     relationProperty: RpdDataModelProperty;
     relationEntityIds: any[];
@@ -10,6 +11,7 @@ export type FindOneRelationEntitiesOptions = {
 };
 export type FindManyRelationEntitiesOptions = {
     server: IRpdServer;
+    routeContext?: RouteContext;
     mainModel: RpdDataModel;
     relationProperty: RpdDataModelProperty;
     mainEntityIds: any[];

package/dist/helpers/metaHelper.d.ts

@@ -3,8 +3,8 @@ import { RpdDataModel, RpdDataModelProperty } from "../types";
 export declare function isRelationProperty(property: RpdDataModelProperty): boolean;
 export declare function isOneRelationProperty(property: RpdDataModelProperty): boolean;
 export declare function isManyRelationProperty(property: RpdDataModelProperty): boolean;
-export declare function getEntityProperties(server: IRpdServer, model: RpdDataModel): RpdDataModelProperty[];
-export declare function getEntityPropertiesIncludingBase(server: IRpdServer, model: RpdDataModel): RpdDataModelProperty[];
+export declare function getEntityProperties(server: IRpdServer, model: RpdDataModel, predicate?: (item: RpdDataModelProperty) => boolean): RpdDataModelProperty[];
+export declare function getEntityPropertiesIncludingBase(server: IRpdServer, model: RpdDataModel, predicate?: (item: RpdDataModelProperty) => boolean): RpdDataModelProperty[];
 export declare function getEntityPropertyByCode(server: IRpdServer, model: RpdDataModel, propertyCode: string): RpdDataModelProperty | undefined;
 export declare function getEntityProperty(server: IRpdServer, model: RpdDataModel, predicate: (item: RpdDataModelProperty) => boolean): RpdDataModelProperty | undefined;
 export declare function getEntityOwnPropertyByCode(model: RpdDataModel, propertyCode: string): RpdDataModelProperty | undefined;

package/dist/index.js

@@ -1712,6 +1712,13 @@ var bootstrapApplicationConfig = {
                     type: "text",
                     required: false,
                 },
+                {
+                    name: "entityDeletingReaction",
+                    code: "entityDeletingReaction",
+                    columnName: "entity_deleting_reaction",
+                    type: "text",
+                    required: false,
+                },
                 {
                     name: "readonly",
                     code: "readonly",
@@ -2119,22 +2126,41 @@ function isOneRelationProperty(property) {
 function isManyRelationProperty(property) {
     return isRelationProperty(property) && property.relation === "many";
 }
-function getEntityPropertiesIncludingBase(server, model) {
-    if (!model.base) {
+function getEntityProperties(server, model, predicate) {
+    if (!predicate) {
         return model.properties;
     }
+    return lodash.filter(model.properties, predicate);
+}
+function getEntityPropertiesIncludingBase(server, model, predicate) {
+    if (!model.base) {
+        return getEntityProperties(server, model, predicate);
+    }
     const baseModel = server.getModel({
         singularCode: model.base,
     });
     let baseProperties = [];
     if (baseModel) {
-        baseProperties = baseModel.properties.map((property) => {
+        if (predicate) {
+            baseProperties = lodash.filter(baseModel.properties, predicate);
+        }
+        else {
+            baseProperties = baseModel.properties;
+        }
+        baseProperties = baseProperties.map((property) => {
             property = lodash.cloneDeep(property);
             property.isBaseProperty = true;
             return property;
         });
     }
-    return [...baseProperties, ...model.properties];
+    let properties;
+    if (predicate) {
+        properties = lodash.filter(model.properties, predicate);
+    }
+    else {
+        properties = model.properties;
+    }
+    return [...baseProperties, ...properties];
 }
 function getEntityPropertyByCode(server, model, propertyCode) {
     return getEntityProperty(server, model, (e) => e.code === propertyCode);
@@ -2539,6 +2565,7 @@ async function findEntities(server, dataAccessor, options) {
                 if (isManyRelation) {
                     const relationLinks = await findManyRelationLinksViaLinkTable({
                         server,
+                        routeContext,
                         mainModel: relationModel,
                         relationProperty,
                         mainEntityIds: entityIds,
@@ -2556,6 +2583,7 @@ async function findEntities(server, dataAccessor, options) {
                 if (isManyRelation) {
                     relatedEntities = await findManyRelatedEntitiesViaIdPropertyCode({
                         server,
+                        routeContext,
                         mainModel: model,
                         relationProperty,
                         mainEntityIds: entityIds,
@@ -2566,6 +2594,7 @@ async function findEntities(server, dataAccessor, options) {
                     const targetEntityIds = lodash.uniq(lodash.reject(lodash.map(rows, (entity) => entity[relationProperty.targetIdColumnName]), isNullOrUndefined));
                     relatedEntities = await findOneRelatedEntitiesViaIdPropertyCode({
                         server,
+                        routeContext,
                         mainModel: model,
                         relationProperty,
                         relationEntityIds: targetEntityIds,
@@ -2782,7 +2811,7 @@ async function convertEntityFiltersToRowFilters(routeContext, server, model, bas
                     tableName: relationProperty.linkTableName,
                 })} WHERE ${server.queryBuilder.quoteObject(relationProperty.targetIdColumnName)} = ANY($1::int[])`;
                 const params = [targetEntityIds];
-                const links = await server.queryDatabaseObject(command, params);
+                const links = await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                 const selfEntityIds = links.map((link) => link[relationProperty.selfIdColumnName]);
                 replacedFilters.push({
                     field: {
@@ -2850,7 +2879,7 @@ async function convertEntityFiltersToRowFilters(routeContext, server, model, bas
     return replacedFilters;
 }
 async function findManyRelationLinksViaLinkTable(options) {
-    const { server, relationProperty, mainModel: relationModel, mainEntityIds, selectRelationOptions } = options;
+    const { server, routeContext, relationProperty, mainModel: relationModel, mainEntityIds, selectRelationOptions } = options;
     const command = `SELECT * FROM ${server.queryBuilder.quoteTable({
         schema: relationProperty.linkSchema,
         tableName: relationProperty.linkTableName,
@@ -2858,7 +2887,7 @@ async function findManyRelationLinksViaLinkTable(options) {
     ORDER BY id
   `;
     const params = [mainEntityIds];
-    const links = await server.queryDatabaseObject(command, params);
+    const links = await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
     const targetEntityIds = links.map((link) => link[relationProperty.targetIdColumnName]);
     const dataAccessor = server.getDataAccessor({
         namespace: relationModel.namespace,
@@ -3160,7 +3189,7 @@ async function createEntity(server, dataAccessor, options, plugin) {
                             tableName: property.linkTableName,
                         })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                         const params = [newEntity.id, newTargetEntity.id];
-                        await server.queryDatabaseObject(command, params);
+                        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                     }
                     newEntity[property.code].push(newTargetEntity);
                 }
@@ -3176,7 +3205,7 @@ async function createEntity(server, dataAccessor, options, plugin) {
                             tableName: property.linkTableName,
                         })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                         const params = [newEntity.id, relatedEntityId];
-                        await server.queryDatabaseObject(command, params);
+                        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                     }
                     else {
                         await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName]: newEntity.id }, routeContext?.getDbTransactionClient());
@@ -3198,7 +3227,7 @@ async function createEntity(server, dataAccessor, options, plugin) {
                         tableName: property.linkTableName,
                     })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                     const params = [newEntity.id, relatedEntityId];
-                    await server.queryDatabaseObject(command, params);
+                    await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                 }
                 else {
                     await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName]: newEntity.id }, routeContext?.getDbTransactionClient());
@@ -3441,9 +3470,12 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
             }
         }
     }
-    // save many-relation properties
+    // save many-relation properties (only 'overwrite' mode was supported right now)
     for (const property of manyRelationPropertiesToUpdate) {
         const relatedEntities = [];
+        const targetModel = server.getModel({
+            singularCode: property.targetSingularCode,
+        });
         const targetDataAccessor = server.getDataAccessor({
             singularCode: property.targetSingularCode,
         });
@@ -3469,24 +3501,55 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
             const targetLinks = await server.queryDatabaseObject(`SELECT ${server.queryBuilder.quoteObject(property.targetIdColumnName)} FROM ${server.queryBuilder.quoteTable({
                 schema: property.linkSchema,
                 tableName: property.linkTableName,
-            })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = $1`, [id]);
+            })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
             currentTargetIds = targetLinks.map((item) => item[property.targetIdColumnName]);
             await server.queryDatabaseObject(`DELETE FROM ${server.queryBuilder.quoteTable({
                 schema: property.linkSchema,
                 tableName: property.linkTableName,
             })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = $1
-              AND ${server.queryBuilder.quoteObject(property.targetIdColumnName)} <> ALL($2::int[])`, [id, targetIdsToKeep]);
+              AND ${server.queryBuilder.quoteObject(property.targetIdColumnName)} <> ALL($2::int[])`, [id, targetIdsToKeep], routeContext?.getDbTransactionClient());
         }
         else {
-            const targetModel = server.getModel({
-                singularCode: property.targetSingularCode,
-            });
             const targetRows = await server.queryDatabaseObject(`SELECT id FROM ${server.queryBuilder.quoteTable({
                 schema: targetModel.schema,
                 tableName: targetModel.tableName,
-            })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = $1`, [id]);
+            })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
             currentTargetIds = targetRows.map((item) => item.id);
         }
+        const targetIdsToRemove = currentTargetIds.filter((currentId) => !targetIdsToKeep.includes(currentId));
+        if (targetIdsToRemove.length) {
+            if (property.linkTableName) ;
+            else {
+                const updateRelationPropertiesOptions = lodash.get(options.relationPropertiesToUpdate, property.code);
+                let relationRemoveMode = "unlink";
+                if (updateRelationPropertiesOptions === true) {
+                    relationRemoveMode = "delete";
+                }
+                else {
+                    relationRemoveMode = updateRelationPropertiesOptions.relationRemoveMode;
+                }
+                const relationModel = server.getModel({
+                    singularCode: property.targetSingularCode,
+                });
+                if (relationRemoveMode === "unlink") {
+                    await server.queryDatabaseObject(`UPDATE ${server.queryBuilder.quoteTable({
+                        schema: relationModel.schema,
+                        tableName: relationModel.tableName,
+                    })}
+            SET ${server.queryBuilder.quoteObject(property.selfIdColumnName)} = null
+            WHERE id = ANY($1::int[])`, [targetIdsToRemove], routeContext?.getDbTransactionClient());
+                }
+                else {
+                    // relationRemoveMode === "delete"
+                    for (const targetIdToRemove of targetIdsToRemove) {
+                        await deleteEntityById(server, targetDataAccessor, {
+                            id: targetIdToRemove,
+                            routeContext,
+                        }, plugin);
+                    }
+                }
+            }
+        }
         for (const relatedEntityToBeSaved of relatedEntitiesToBeSaved) {
             let relatedEntityId;
             if (lodash.isObject(relatedEntityToBeSaved)) {
@@ -3507,7 +3570,7 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
                             tableName: property.linkTableName,
                         })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                         const params = [id, newTargetEntity.id];
-                        await server.queryDatabaseObject(command, params);
+                        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                     }
                     relatedEntities.push(newTargetEntity);
                 }
@@ -3548,7 +3611,7 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
                                 tableName: property.linkTableName,
                             })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                             const params = [id, relatedEntityId];
-                            await server.queryDatabaseObject(command, params);
+                            await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                         }
                         else {
                             await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName]: id }, routeContext?.getDbTransactionClient());
@@ -3572,7 +3635,7 @@ async function updateEntityById(server, dataAccessor, options, plugin) {
                             tableName: property.linkTableName,
                         })} (${server.queryBuilder.quoteObject(property.selfIdColumnName)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
                         const params = [id, relatedEntityId];
-                        await server.queryDatabaseObject(command, params);
+                        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
                     }
                     else {
                         await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName]: id }, routeContext?.getDbTransactionClient());
@@ -3654,6 +3717,146 @@ function getEntityDuplicatedErrorMessage(server, model, indexConfig) {
     });
     return `已存在 ${propertyNames.join(", ")} 相同的记录。`;
 }
+async function deleteEntityById(server, dataAccessor, options, plugin) {
+    // options is id
+    if (!lodash.isObject(options)) {
+        options = {
+            id: options,
+        };
+    }
+    const model = dataAccessor.getModel();
+    if (model.derivedTypePropertyCode) {
+        // TODO: should be allowed.
+        throw newEntityOperationError("Delete base entity directly is not allowed.");
+    }
+    const { id, routeContext } = options;
+    const entity = await findById(server, dataAccessor, {
+        id,
+        keepNonPropertyFields: true,
+        routeContext,
+    });
+    if (!entity) {
+        return;
+    }
+    if (model.softDelete) {
+        if (entity.deletedAt) {
+            return;
+        }
+    }
+    await server.emitEvent({
+        eventName: "entity.beforeDelete",
+        payload: {
+            namespace: model.namespace,
+            modelSingularCode: model.singularCode,
+            before: entity,
+        },
+        sender: plugin,
+        routeContext,
+    });
+    if (model.softDelete) {
+        const currentUserId = routeContext?.state?.userId;
+        await dataAccessor.updateById(id, {
+            deleted_at: getNowStringWithTimezone(),
+            deleter_id: currentUserId,
+        }, routeContext?.getDbTransactionClient());
+    }
+    else {
+        const relationPropertiesWithDeletingReaction = getEntityPropertiesIncludingBase(server, model, (property) => {
+            return isRelationProperty(property) && property.entityDeletingReaction && property.entityDeletingReaction !== "doNothing";
+        });
+        for (const relationProperty of relationPropertiesWithDeletingReaction) {
+            const relationDataAccessor = server.getDataAccessor({
+                singularCode: relationProperty.targetSingularCode,
+            });
+            if (relationProperty.entityDeletingReaction === "cascadingDelete") {
+                if (relationProperty.relation === "one") {
+                    const relatedEntityId = entity[relationProperty.targetIdColumnName];
+                    if (relatedEntityId) {
+                        await deleteEntityById(server, relationDataAccessor, {
+                            routeContext,
+                            id: relatedEntityId,
+                        }, plugin);
+                    }
+                }
+                else if (relationProperty.relation === "many") {
+                    if (relationProperty.linkTableName) {
+                        const targetLinks = await server.queryDatabaseObject(`SELECT ${server.queryBuilder.quoteObject(relationProperty.targetIdColumnName)} FROM ${server.queryBuilder.quoteTable({
+                            schema: relationProperty.linkSchema,
+                            tableName: relationProperty.linkTableName,
+                        })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
+                        const targetEntityIds = targetLinks.map((item) => item[relationProperty.targetIdColumnName]);
+                        await server.queryDatabaseObject(`DELETE FROM ${server.queryBuilder.quoteTable({
+                            schema: relationProperty.linkSchema,
+                            tableName: relationProperty.linkTableName,
+                        })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
+                        for (const targetEntityId of targetEntityIds) {
+                            await deleteEntityById(server, relationDataAccessor, {
+                                routeContext,
+                                id: targetEntityId,
+                            }, plugin);
+                        }
+                    }
+                    else {
+                        const targetModel = server.getModel({
+                            singularCode: relationProperty.targetSingularCode,
+                        });
+                        const targetRows = await server.queryDatabaseObject(`SELECT id FROM ${server.queryBuilder.quoteTable({
+                            schema: targetModel.schema,
+                            tableName: targetModel.tableName,
+                        })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
+                        const targetEntityIds = targetRows.map((item) => item.id);
+                        for (const targetEntityId of targetEntityIds) {
+                            await deleteEntityById(server, relationDataAccessor, {
+                                routeContext,
+                                id: targetEntityId,
+                            }, plugin);
+                        }
+                    }
+                }
+            }
+            else if (relationProperty.entityDeletingReaction === "unlink") {
+                if (relationProperty.relation === "one") ;
+                else if (relationProperty.relation === "many") {
+                    if (relationProperty.linkTableName) {
+                        await server.queryDatabaseObject(`DELETE FROM ${server.queryBuilder.quoteTable({
+                            schema: relationProperty.linkSchema,
+                            tableName: relationProperty.linkTableName,
+                        })}
+              WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
+                    }
+                    else {
+                        const relationModel = server.getModel({
+                            singularCode: relationProperty.targetSingularCode,
+                        });
+                        await server.queryDatabaseObject(`UPDATE ${server.queryBuilder.quoteTable({
+                            schema: relationModel.schema,
+                            tableName: relationModel.tableName,
+                        })}
+              SET ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = null
+              WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName)} = $1`, [id], routeContext?.getDbTransactionClient());
+                    }
+                }
+            }
+        }
+        await dataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
+        if (model.base) {
+            const baseDataAccessor = server.getDataAccessor({
+                singularCode: model.base,
+            });
+            await baseDataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
+        }
+    }
+    await server.emitEvent({
+        eventName: "entity.delete",
+        payload: {
+            namespace: model.namespace,
+            modelSingularCode: model.singularCode,
+            before: entity,
+        },
+        sender: plugin,
+        routeContext,
+    });
+}
 class EntityManager {
     #server;
     #dataAccessor;
@@ -3700,66 +3903,7 @@ class EntityManager {
         return await this.#dataAccessor.count(countRowOptions, routeContext?.getDbTransactionClient());
     }
     async deleteById(options, plugin) {
-        // options is id
-        if (!lodash.isObject(options)) {
-            options = {
-                id: options,
-            };
-        }
-        const model = this.getModel();
-        if (model.derivedTypePropertyCode) {
-            throw newEntityOperationError("Delete base entity directly is not allowed.");
-        }
-        const { id, routeContext } = options;
-        const entity = await this.findById({
-            id,
-            keepNonPropertyFields: true,
-            routeContext,
-        });
-        if (!entity) {
-            return;
-        }
-        await this.#server.emitEvent({
-            eventName: "entity.beforeDelete",
-            payload: {
-                namespace: model.namespace,
-                modelSingularCode: model.singularCode,
-                before: entity,
-            },
-            sender: plugin,
-            routeContext,
-        });
-        if (model.softDelete) {
-            let dataAccessor = model.base
-                ? this.#server.getDataAccessor({
-                    singularCode: model.base,
-                })
-                : this.#dataAccessor;
-            const currentUserId = routeContext?.state?.userId;
-            await dataAccessor.updateById(id, {
-                deleted_at: getNowStringWithTimezone(),
-                deleter_id: currentUserId,
-            }, routeContext?.getDbTransactionClient());
-        }
-        else {
-            await this.#dataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
-            if (model.base) {
-                const baseDataAccessor = this.#server.getDataAccessor({
-                    singularCode: model.base,
-                });
-                await baseDataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
-            }
-        }
-        await this.#server.emitEvent({
-            eventName: "entity.delete",
-            payload: {
-                namespace: model.namespace,
-                modelSingularCode: model.singularCode,
-                before: entity,
-            },
-            sender: plugin,
-            routeContext,
-        });
+        return await deleteEntityById(this.#server, this.#dataAccessor, options, plugin);
     }
     async addRelations(options, plugin) {
         const server = this.#server;
@@ -3792,7 +3936,7 @@ class EntityManager {
         WHERE ${queryBuilder.quoteObject(relationProperty.selfIdColumnName)}=$1 AND ${queryBuilder.quoteObject(relationProperty.targetIdColumnName)}=$2
       )`;
                 const params = [id, relation.id];
-                await server.queryDatabaseObject(command, params);
+                await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
             }
         }
         await server.emitEvent({
@@ -3832,7 +3976,7 @@ class EntityManager {
                 const command = `DELETE FROM ${queryBuilder.quoteTable({ schema: relationProperty.linkSchema, tableName: relationProperty.linkTableName })}
     WHERE ${queryBuilder.quoteObject(relationProperty.selfIdColumnName)}=$1 AND ${queryBuilder.quoteObject(relationProperty.targetIdColumnName)}=$2;`;
                 const params = [id, relation.id];
-                await server.queryDatabaseObject(command, params);
+                await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
             }
         }
         await server.emitEvent({
@@ -4139,18 +4283,18 @@ class RapidServer {
         }
         return await factory.createFacility(this, options);
     }
-    async queryDatabaseObject(sql, params) {
+    async queryDatabaseObject(sql, params, client) {
         try {
-            return await this.#databaseAccessor.queryDatabaseObject(sql, params);
+            return await this.#databaseAccessor.queryDatabaseObject(sql, params, client);
         }
         catch (err) {
             this.#logger.error("Failed to query database object.", { errorMessage: err.message, sql, params });
             throw err;
         }
     }
-    async tryQueryDatabaseObject(sql, params) {
+    async tryQueryDatabaseObject(sql, params, client) {
         try {
-            return await this.queryDatabaseObject(sql, params);
+            return await this.queryDatabaseObject(sql, params, client);
         }
         catch (err) {
             this.#logger.error("Failed to query database object.", { errorMessage: err.message, sql, params });

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { GetDataAccessorOptions, GetModelOptions, IDatabaseAccessor, IDatabaseConfig, IQueryBuilder, IRpdDataAccessor, RpdApplicationConfig, RpdDataModel, RpdServerEventTypes, RapidServerConfig, RpdDataModelProperty, CreateEntityOptions, UpdateEntityByIdOptions, EntityWatcherType, EmitServerEventOptions } from "./types";
+import { GetDataAccessorOptions, GetModelOptions, IDatabaseAccessor, IDatabaseConfig, IQueryBuilder, IRpdDataAccessor, RpdApplicationConfig, RpdDataModel, RpdServerEventTypes, RapidServerConfig, RpdDataModelProperty, CreateEntityOptions, UpdateEntityByIdOptions, EntityWatcherType, EmitServerEventOptions, IDatabaseClient } from "./types";
 import { ActionHandler, ActionHandlerContext, IPluginActionHandler } from "./core/actionHandler";
 import { IRpdServer, RapidPlugin } from "./core/server";
 import { Next } from "./core/routeContext";
@@ -41,8 +41,8 @@ export declare class RapidServer implements IRpdServer {
     configureApplication(): Promise<void>;
     registerFacilityFactory(factory: FacilityFactory): void;
     getFacility<TFacility = any>(name: string, options?: any, nullIfUnknownFacility?: boolean): Promise<TFacility>;
-    queryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>): Promise<any[]>;
-    tryQueryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>): Promise<any[]>;
+    queryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient): Promise<any[]>;
+    tryQueryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient): Promise<any[]>;
     get middlewares(): any[];
     handleRequest(request: Request, next: Next): Promise<Response>;
     beforeRunRouteActions(handlerContext: ActionHandlerContext): Promise<void>;

package/dist/types.d.ts

@@ -282,12 +282,17 @@ export interface RpdDataModelProperty {
      * 当设置了 linkTableName 时，可以设置关联关系表所在的 Schema。
      */
     linkSchema?: string;
+    /**
+     * 当删除实体时，针对关系属性的联动处理。
+     */
+    entityDeletingReaction?: RpdEntityDeleteRelationPropertyReaction;
     /**
      * 当设置为`true`时，仅允许在创建时设置此属性的值，不允许更新。
      */
     readonly?: boolean;
 }
 export type RpdDataPropertyTypes = "integer" | "long" | "float" | "double" | "decimal" | "text" | "boolean" | "date" | "time" | "datetime" | "json" | "relation" | "relation[]" | "option" | "option[]" | "file" | "file[]" | "image" | "image[]";
+export type RpdEntityDeleteRelationPropertyReaction = "doNothing" | "unlink" | "cascadingDelete";
 /**
  * 数据字典
  */
@@ -509,11 +514,15 @@ export interface UpdateEntityByIdOptions {
     /**
      * 指定需要更新关联对象的哪些属性。更新实体时，会创建关联对象，但是默认不更新关联对象的属性。
      */
-    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertyOptions>;
 }
-export type UpdateRelationPropertiesOptions = true | {
+export type UpdateRelationPropertyOptions = true | {
+    /**
+     * 当需移除关系时是删除关联实体，还是取消关联。默认为`delete`。此配置仅对没有配置`linkTableName`的属性有效。
+     */
+    relationRemoveMode?: "unlink" | "delete";
     propertiesToUpdate?: string[];
-    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+    relationPropertiesToUpdate?: Record<string, UpdateRelationPropertyOptions>;
 };
 export interface DeleteEntityOptions {
     routeContext?: RouteContext;

package/package.json

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

package/src/bootstrapApplicationConfig.ts

@@ -237,6 +237,13 @@ export default {
           type: "text",
           required: false,
         },
+        {
+          name: "entityDeletingReaction",
+          code: "entityDeletingReaction",
+          columnName: "entity_deleting_reaction",
+          type: "text",
+          required: false,
+        },
         {
           name: "readonly",
           code: "readonly",

package/src/core/server.ts

@@ -5,6 +5,7 @@ import {
   GetDataAccessorOptions,
   GetModelOptions,
   IDatabaseAccessor,
+  IDatabaseClient,
   IDatabaseConfig,
   IQueryBuilder,
   IRpdDataAccessor,
@@ -32,8 +33,8 @@ export interface IRpdServer {
   getFacility<TFacility = any>(name: string, options?: any): Promise<TFacility>;
 
   getDatabaseAccessor(): IDatabaseAccessor;
-  queryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>) => Promise<any[]>;
-  tryQueryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>) => Promise<any[]>;
+  queryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient) => Promise<any[]>;
+  tryQueryDatabaseObject: (sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient) => Promise<any[]>;
   registerMiddleware(middleware: any): void;
   registerActionHandler(plugin: RapidPlugin, options: IPluginActionHandler): void;
   getActionHandlerByCode(code: string): ActionHandler | undefined;

package/src/dataAccess/entityManager.ts

@@ -45,6 +45,7 @@ import {
   uniq,
 } from "lodash";
 import {
+  getEntityProperties,
   getEntityPropertiesIncludingBase,
   getEntityProperty,
   getEntityPropertyByCode,
@@ -60,6 +61,7 @@ import { RouteContext } from "~/core/routeContext";
 
 export type FindOneRelationEntitiesOptions = {
   server: IRpdServer;
+  routeContext?: RouteContext;
   mainModel: RpdDataModel;
   relationProperty: RpdDataModelProperty;
   relationEntityIds: any[];
@@ -68,6 +70,7 @@ export type FindOneRelationEntitiesOptions = {
 
 export type FindManyRelationEntitiesOptions = {
   server: IRpdServer;
+  routeContext?: RouteContext;
   mainModel: RpdDataModel;
   relationProperty: RpdDataModelProperty;
   mainEntityIds: any[];
@@ -269,6 +272,7 @@ async function findEntities(server: IRpdServer, dataAccessor: IRpdDataAccessor,
         if (isManyRelation) {
           const relationLinks = await findManyRelationLinksViaLinkTable({
             server,
+            routeContext,
             mainModel: relationModel,
             relationProperty,
             mainEntityIds: entityIds,
@@ -286,6 +290,7 @@ async function findEntities(server: IRpdServer, dataAccessor: IRpdDataAccessor,
         if (isManyRelation) {
           relatedEntities = await findManyRelatedEntitiesViaIdPropertyCode({
             server,
+            routeContext,
             mainModel: model,
             relationProperty,
             mainEntityIds: entityIds,
@@ -300,6 +305,7 @@ async function findEntities(server: IRpdServer, dataAccessor: IRpdDataAccessor,
           );
           relatedEntities = await findOneRelatedEntitiesViaIdPropertyCode({
             server,
+            routeContext,
             mainModel: model,
             relationProperty,
             relationEntityIds: targetEntityIds,
@@ -546,7 +552,7 @@ async function convertEntityFiltersToRowFilters(
           tableName: relationProperty.linkTableName!,
         })} WHERE ${server.queryBuilder.quoteObject(relationProperty.targetIdColumnName!)} = ANY($1::int[])`;
         const params = [targetEntityIds];
-        const links = await server.queryDatabaseObject(command, params);
+        const links = await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
         const selfEntityIds = links.map((link) => link[relationProperty.selfIdColumnName!]);
         replacedFilters.push({
           field: {
@@ -614,7 +620,7 @@ async function convertEntityFiltersToRowFilters(
 }
 
 async function findManyRelationLinksViaLinkTable(options: FindManyRelationEntitiesOptions) {
-  const { server, relationProperty, mainModel: relationModel, mainEntityIds, selectRelationOptions } = options;
+  const { server, routeContext, relationProperty, mainModel: relationModel, mainEntityIds, selectRelationOptions } = options;
   const command = `SELECT * FROM ${server.queryBuilder.quoteTable({
     schema: relationProperty.linkSchema,
     tableName: relationProperty.linkTableName!,
@@ -622,7 +628,7 @@ async function findManyRelationLinksViaLinkTable(options: FindManyRelationEntiti
     ORDER BY id
   `;
   const params = [mainEntityIds];
-  const links = await server.queryDatabaseObject(command, params);
+  const links = await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
   const targetEntityIds = links.map((link) => link[relationProperty.targetIdColumnName!]);
 
   const dataAccessor = server.getDataAccessor({
@@ -960,7 +966,7 @@ async function createEntity(server: IRpdServer, dataAccessor: IRpdDataAccessor,
               tableName: property.linkTableName,
             })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
             const params = [newEntity.id, newTargetEntity.id];
-            await server.queryDatabaseObject(command, params);
+            await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
           }
 
           newEntity[property.code].push(newTargetEntity);
@@ -977,7 +983,7 @@ async function createEntity(server: IRpdServer, dataAccessor: IRpdDataAccessor,
               tableName: property.linkTableName,
             })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
             const params = [newEntity.id, relatedEntityId];
-            await server.queryDatabaseObject(command, params);
+            await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
           } else {
             await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName!]: newEntity.id }, routeContext?.getDbTransactionClient());
             targetEntity[property.selfIdColumnName!] = newEntity.id;
@@ -998,7 +1004,7 @@ async function createEntity(server: IRpdServer, dataAccessor: IRpdDataAccessor,
             tableName: property.linkTableName,
           })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
           const params = [newEntity.id, relatedEntityId];
-          await server.queryDatabaseObject(command, params);
+          await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
         } else {
           await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName!]: newEntity.id }, routeContext?.getDbTransactionClient());
           targetEntity[property.selfIdColumnName!] = newEntity.id;
@@ -1265,9 +1271,12 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
     }
   }
 
-  // save many-relation properties
+  // save many-relation properties (only 'overwrite' mode was supported right now)
   for (const property of manyRelationPropertiesToUpdate) {
     const relatedEntities: any[] = [];
+    const targetModel = server.getModel({
+      singularCode: property.targetSingularCode,
+    });
     const targetDataAccessor = server.getDataAccessor({
       singularCode: property.targetSingularCode!,
     });
@@ -1298,6 +1307,7 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
           tableName: property.linkTableName,
         })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName!)} = $1`,
         [id],
+        routeContext?.getDbTransactionClient(),
       );
       currentTargetIds = targetLinks.map((item) => item[property.targetIdColumnName]);
 
@@ -1308,21 +1318,63 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
         })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName!)} = $1
               AND ${server.queryBuilder.quoteObject(property.targetIdColumnName!)} <> ALL($2::int[])`,
         [id, targetIdsToKeep],
+        routeContext?.getDbTransactionClient(),
       );
     } else {
-      const targetModel = server.getModel({
-        singularCode: property.targetSingularCode,
-      });
       const targetRows = await server.queryDatabaseObject(
         `SELECT id FROM ${server.queryBuilder.quoteTable({
           schema: targetModel.schema,
           tableName: targetModel.tableName,
         })} WHERE ${server.queryBuilder.quoteObject(property.selfIdColumnName!)} = $1`,
         [id],
+        routeContext?.getDbTransactionClient(),
       );
       currentTargetIds = targetRows.map((item) => item.id);
     }
 
+    const targetIdsToRemove = currentTargetIds.filter((currentId) => !targetIdsToKeep.includes(currentId));
+    if (targetIdsToRemove.length) {
+      if (property.linkTableName) {
+        // do nothing. we've remove the link rows before.
+      } else {
+        const updateRelationPropertiesOptions = get(options.relationPropertiesToUpdate, property.code);
+        let relationRemoveMode: "unlink" | "delete" = "unlink";
+        if (updateRelationPropertiesOptions === true) {
+          relationRemoveMode = "delete";
+        } else {
+          relationRemoveMode = updateRelationPropertiesOptions.relationRemoveMode;
+        }
+        const relationModel = server.getModel({
+          singularCode: property.targetSingularCode,
+        });
+        if (relationRemoveMode === "unlink") {
+          await server.queryDatabaseObject(
+            `UPDATE ${server.queryBuilder.quoteTable({
+              schema: relationModel.schema,
+              tableName: relationModel.tableName,
+            })}
+            SET ${server.queryBuilder.quoteObject(property.selfIdColumnName!)} = null
+            WHERE id = ANY($1::int[])`,
+            [targetIdsToRemove],
+            routeContext?.getDbTransactionClient(),
+          );
+        } else {
+          // relationRemoveMode === "delete"
+          for (const targetIdToRemove of targetIdsToRemove) {
+            await deleteEntityById(
+              server,
+              targetDataAccessor,
+              {
+                id: targetIdToRemove,
+                routeContext,
+              },
+              plugin,
+            );
+          }
+        }
+      }
+    }
+
     for (const relatedEntityToBeSaved of relatedEntitiesToBeSaved) {
       let relatedEntityId: any;
       if (isObject(relatedEntityToBeSaved)) {
@@ -1344,7 +1396,7 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
               tableName: property.linkTableName,
             })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
             const params = [id, newTargetEntity.id];
-            await server.queryDatabaseObject(command, params);
+            await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
           }
 
           relatedEntities.push(newTargetEntity);
@@ -1386,7 +1438,7 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
                 tableName: property.linkTableName,
               })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
               const params = [id, relatedEntityId];
-              await server.queryDatabaseObject(command, params);
+              await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
             } else {
               await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName!]: id }, routeContext?.getDbTransactionClient());
               targetEntity[property.selfIdColumnName!] = id;
@@ -1409,7 +1461,7 @@ async function updateEntityById(server: IRpdServer, dataAccessor: IRpdDataAccess
               tableName: property.linkTableName,
             })} (${server.queryBuilder.quoteObject(property.selfIdColumnName!)}, ${property.targetIdColumnName}) VALUES ($1, $2) ON CONFLICT DO NOTHING;`;
             const params = [id, relatedEntityId];
-            await server.queryDatabaseObject(command, params);
+            await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
           } else {
             await targetDataAccessor.updateById(targetEntity.id, { [property.selfIdColumnName!]: id }, routeContext?.getDbTransactionClient());
             targetEntity[property.selfIdColumnName!] = id;
@@ -1508,6 +1560,199 @@ function getEntityDuplicatedErrorMessage(server: IRpdServer, model: RpdDataModel
   return `已存在 ${propertyNames.join(", ")} 相同的记录。`;
 }
 
+async function deleteEntityById(
+  server: IRpdServer,
+  dataAccessor: IRpdDataAccessor,
+  options: DeleteEntityByIdOptions | string | number,
+  plugin?: RapidPlugin,
+): Promise<void> {
+  // options is id
+  if (!isObject(options)) {
+    options = {
+      id: options,
+    };
+  }
+
+  const model = dataAccessor.getModel();
+  if (model.derivedTypePropertyCode) {
+    // TODO: should be allowed.
+    throw newEntityOperationError("Delete base entity directly is not allowed.");
+  }
+
+  const { id, routeContext } = options;
+
+  const entity = await findById(server, dataAccessor, {
+    id,
+    keepNonPropertyFields: true,
+    routeContext,
+  });
+
+  if (!entity) {
+    return;
+  }
+
+  if (model.softDelete) {
+    if (entity.deletedAt) {
+      return;
+    }
+  }
+
+  await server.emitEvent({
+    eventName: "entity.beforeDelete",
+    payload: {
+      namespace: model.namespace,
+      modelSingularCode: model.singularCode,
+      before: entity,
+    },
+    sender: plugin,
+    routeContext,
+  });
+
+  if (model.softDelete) {
+    const currentUserId = routeContext?.state?.userId;
+    await dataAccessor.updateById(
+      id,
+      {
+        deleted_at: getNowStringWithTimezone(),
+        deleter_id: currentUserId,
+      },
+      routeContext?.getDbTransactionClient(),
+    );
+  } else {
+    const relationPropertiesWithDeletingReaction = getEntityPropertiesIncludingBase(server, model, (property) => {
+      return isRelationProperty(property) && property.entityDeletingReaction && property.entityDeletingReaction !== "doNothing";
+    });
+
+    for (const relationProperty of relationPropertiesWithDeletingReaction) {
+      const relationDataAccessor = server.getDataAccessor({
+        singularCode: relationProperty.targetSingularCode,
+      });
+      if (relationProperty.entityDeletingReaction === "cascadingDelete") {
+        if (relationProperty.relation === "one") {
+          const relatedEntityId = entity[relationProperty.targetIdColumnName];
+          if (relatedEntityId) {
+            await deleteEntityById(
+              server,
+              relationDataAccessor,
+              {
+                routeContext,
+                id: relatedEntityId,
+              },
+              plugin,
+            );
+          }
+        } else if (relationProperty.relation === "many") {
+          if (relationProperty.linkTableName) {
+            const targetLinks = await server.queryDatabaseObject(
+              `SELECT ${server.queryBuilder.quoteObject(relationProperty.targetIdColumnName)} FROM ${server.queryBuilder.quoteTable({
+                schema: relationProperty.linkSchema,
+                tableName: relationProperty.linkTableName,
+              })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = $1`,
+              [id],
+              routeContext?.getDbTransactionClient(),
+            );
+            const targetEntityIds = targetLinks.map((item) => item[relationProperty.targetIdColumnName]);
+
+            await server.queryDatabaseObject(
+              `DELETE FROM ${server.queryBuilder.quoteTable({
+                schema: relationProperty.linkSchema,
+                tableName: relationProperty.linkTableName,
+              })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = $1`,
+              [id],
+              routeContext?.getDbTransactionClient(),
+            );
+
+            for (const targetEntityId of targetEntityIds) {
+              await deleteEntityById(
+                server,
+                relationDataAccessor,
+                {
+                  routeContext,
+                  id: targetEntityId,
+                },
+                plugin,
+              );
+            }
+          } else {
+            const targetModel = server.getModel({
+              singularCode: relationProperty.targetSingularCode,
+            });
+            const targetRows = await server.queryDatabaseObject(
+              `SELECT id FROM ${server.queryBuilder.quoteTable({
+                schema: targetModel.schema,
+                tableName: targetModel.tableName,
+              })} WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = $1`,
+              [id],
+              routeContext?.getDbTransactionClient(),
+            );
+            const targetEntityIds = targetRows.map((item) => item.id);
+            for (const targetEntityId of targetEntityIds) {
+              await deleteEntityById(
+                server,
+                relationDataAccessor,
+                {
+                  routeContext,
+                  id: targetEntityId,
+                },
+                plugin,
+              );
+            }
+          }
+        }
+      } else if (relationProperty.entityDeletingReaction === "unlink") {
+        if (relationProperty.relation === "one") {
+          // do nothing, entity will be deleted later.
+        } else if (relationProperty.relation === "many") {
+          if (relationProperty.linkTableName) {
+            await server.queryDatabaseObject(
+              `DELETE FROM ${server.queryBuilder.quoteTable({
+                schema: relationProperty.linkSchema,
+                tableName: relationProperty.linkTableName,
+              })}
+              WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = $1`,
+              [id],
+              routeContext?.getDbTransactionClient(),
+            );
+          } else {
+            const relationModel = server.getModel({
+              singularCode: relationProperty.targetSingularCode,
+            });
+            await server.queryDatabaseObject(
+              `UPDATE ${server.queryBuilder.quoteTable({
+                schema: relationModel.schema,
+                tableName: relationModel.tableName,
+              })}
+              SET ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = null
+              WHERE ${server.queryBuilder.quoteObject(relationProperty.selfIdColumnName!)} = $1`,
+              [id],
+              routeContext?.getDbTransactionClient(),
+            );
+          }
+        }
+      }
+    }
+
+    await dataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
+    if (model.base) {
+      const baseDataAccessor = server.getDataAccessor({
+        singularCode: model.base,
+      });
+      await baseDataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
+    }
+  }
+
+  await server.emitEvent({
+    eventName: "entity.delete",
+    payload: {
+      namespace: model.namespace,
+      modelSingularCode: model.singularCode,
+      before: entity,
+    },
+    sender: plugin,
+    routeContext,
+  });
+}
+
 export default class EntityManager<TEntity = any> {
   #server: IRpdServer;
   #dataAccessor: IRpdDataAccessor;
@@ -1563,76 +1808,7 @@ export default class EntityManager<TEntity = any> {
   }
 
   async deleteById(options: DeleteEntityByIdOptions | string | number, plugin?: RapidPlugin): Promise<void> {
-    // options is id
-    if (!isObject(options)) {
-      options = {
-        id: options,
-      };
-    }
-
-    const model = this.getModel();
-    if (model.derivedTypePropertyCode) {
-      throw newEntityOperationError("Delete base entity directly is not allowed.");
-    }
-
-    const { id, routeContext } = options;
-
-    const entity = await this.findById({
-      id,
-      keepNonPropertyFields: true,
-      routeContext,
-    });
-
-    if (!entity) {
-      return;
-    }
-
-    await this.#server.emitEvent({
-      eventName: "entity.beforeDelete",
-      payload: {
-        namespace: model.namespace,
-        modelSingularCode: model.singularCode,
-        before: entity,
-      },
-      sender: plugin,
-      routeContext,
-    });
-
-    if (model.softDelete) {
-      let dataAccessor = model.base
-        ? this.#server.getDataAccessor({
-            singularCode: model.base,
-          })
-        : this.#dataAccessor;
-      const currentUserId = routeContext?.state?.userId;
-      await dataAccessor.updateById(
-        id,
-        {
-          deleted_at: getNowStringWithTimezone(),
-          deleter_id: currentUserId,
-        },
-        routeContext?.getDbTransactionClient(),
-      );
-    } else {
-      await this.#dataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
-      if (model.base) {
-        const baseDataAccessor = this.#server.getDataAccessor({
-          singularCode: model.base,
-        });
-        await baseDataAccessor.deleteById(id, routeContext?.getDbTransactionClient());
-      }
-    }
-
-    await this.#server.emitEvent({
-      eventName: "entity.delete",
-      payload: {
-        namespace: model.namespace,
-        modelSingularCode: model.singularCode,
-        before: entity,
-      },
-      sender: plugin,
-      routeContext,
-    });
+    return await deleteEntityById(this.#server, this.#dataAccessor, options, plugin);
   }
 
   async addRelations(options: AddEntityRelationsOptions, plugin?: RapidPlugin): Promise<void> {
@@ -1669,7 +1845,7 @@ export default class EntityManager<TEntity = any> {
         WHERE ${queryBuilder.quoteObject(relationProperty.selfIdColumnName!)}=$1 AND ${queryBuilder.quoteObject(relationProperty.targetIdColumnName!)}=$2
       )`;
         const params = [id, relation.id];
-        await server.queryDatabaseObject(command, params);
+        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
       }
     }
 
@@ -1714,7 +1890,7 @@ export default class EntityManager<TEntity = any> {
         const command = `DELETE FROM ${queryBuilder.quoteTable({ schema: relationProperty.linkSchema, tableName: relationProperty.linkTableName })}
     WHERE ${queryBuilder.quoteObject(relationProperty.selfIdColumnName!)}=$1 AND ${queryBuilder.quoteObject(relationProperty.targetIdColumnName!)}=$2;`;
         const params = [id, relation.id];
-        await server.queryDatabaseObject(command, params);
+        await server.queryDatabaseObject(command, params, routeContext?.getDbTransactionClient());
       }
     }
 

package/src/helpers/metaHelper.ts

@@ -1,4 +1,4 @@
-import { cloneDeep } from "lodash";
+import { cloneDeep, filter, find } from "lodash";
 import { IRpdServer } from "~/core/server";
 import { RpdDataModel, RpdDataModelProperty } from "~/types";
 
@@ -14,13 +14,17 @@ export function isManyRelationProperty(property: RpdDataModelProperty) {
   return isRelationProperty(property) && property.relation === "many";
 }
 
-export function getEntityProperties(server: IRpdServer, model: RpdDataModel) {
-  return model.properties;
+export function getEntityProperties(server: IRpdServer, model: RpdDataModel, predicate?: (item: RpdDataModelProperty) => boolean) {
+  if (!predicate) {
+    return model.properties;
+  }
+
+  return filter(model.properties, predicate);
 }
 
-export function getEntityPropertiesIncludingBase(server: IRpdServer, model: RpdDataModel) {
+export function getEntityPropertiesIncludingBase(server: IRpdServer, model: RpdDataModel, predicate?: (item: RpdDataModelProperty) => boolean) {
   if (!model.base) {
-    return model.properties;
+    return getEntityProperties(server, model, predicate);
   }
 
   const baseModel = server.getModel({
@@ -28,14 +32,25 @@ export function getEntityPropertiesIncludingBase(server: IRpdServer, model: RpdD
   });
   let baseProperties: RpdDataModelProperty[] = [];
   if (baseModel) {
-    baseProperties = baseModel.properties.map((property) => {
+    if (predicate) {
+      baseProperties = filter(baseModel.properties, predicate);
+    } else {
+      baseProperties = baseModel.properties;
+    }
+    baseProperties = baseProperties.map((property) => {
       property = cloneDeep(property);
       property.isBaseProperty = true;
       return property;
     });
   }
 
-  return [...baseProperties, ...model.properties];
+  let properties: RpdDataModelProperty[];
+  if (predicate) {
+    properties = filter(model.properties, predicate);
+  } else {
+    properties = model.properties;
+  }
+  return [...baseProperties, ...properties];
 }
 
 export function getEntityPropertyByCode(server: IRpdServer, model: RpdDataModel, propertyCode: string): RpdDataModelProperty | undefined {

package/src/server.ts

@@ -17,6 +17,7 @@ import {
   EntityWatcherType,
   RpdEntityCreateEventPayload,
   EmitServerEventOptions,
+  IDatabaseClient,
 } from "./types";
 
 import QueryBuilder from "./queryBuilder/queryBuilder";
@@ -373,18 +374,18 @@ export class RapidServer implements IRpdServer {
     return await factory.createFacility(this, options);
   }
 
-  async queryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>): Promise<any[]> {
+  async queryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient): Promise<any[]> {
     try {
-      return await this.#databaseAccessor.queryDatabaseObject(sql, params);
+      return await this.#databaseAccessor.queryDatabaseObject(sql, params, client);
     } catch (err) {
       this.#logger.error("Failed to query database object.", { errorMessage: err.message, sql, params });
       throw err;
     }
   }
 
-  async tryQueryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>): Promise<any[]> {
+  async tryQueryDatabaseObject(sql: string, params?: unknown[] | Record<string, unknown>, client?: IDatabaseClient): Promise<any[]> {
     try {
-      return await this.queryDatabaseObject(sql, params);
+      return await this.queryDatabaseObject(sql, params, client);
     } catch (err) {
       this.#logger.error("Failed to query database object.", { errorMessage: err.message, sql, params });
     }

package/src/types.ts

@@ -314,6 +314,11 @@ export interface RpdDataModelProperty {
    */
   linkSchema?: string;
 
+  /**
+   * 当删除实体时，针对关系属性的联动处理。
+   */
+  entityDeletingReaction?: RpdEntityDeleteRelationPropertyReaction;
+
   /**
    * 当设置为`true`时，仅允许在创建时设置此属性的值，不允许更新。
    */
@@ -341,6 +346,8 @@ export type RpdDataPropertyTypes =
   | "image"
   | "image[]";
 
+export type RpdEntityDeleteRelationPropertyReaction = "doNothing" | "unlink" | "cascadingDelete";
+
 /**
  * 数据字典
  */
@@ -652,14 +659,21 @@ export interface UpdateEntityByIdOptions {
   /**
    * 指定需要更新关联对象的哪些属性。更新实体时，会创建关联对象，但是默认不更新关联对象的属性。
    */
-  relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+  relationPropertiesToUpdate?: Record<string, UpdateRelationPropertyOptions>;
 }
 
-export type UpdateRelationPropertiesOptions =
+export type UpdateRelationPropertyOptions =
   | true
   | {
+      // TODO: impl savingMode 'patch'
+      // savingMode?: "overwrite" | "patch";
+
+      /**
+       * 当需移除关系时是删除关联实体，还是取消关联。默认为`delete`。此配置仅对没有配置`linkTableName`的属性有效。
+       */
+      relationRemoveMode?: "unlink" | "delete";
       propertiesToUpdate?: string[];
-      relationPropertiesToUpdate?: Record<string, UpdateRelationPropertiesOptions>;
+      relationPropertiesToUpdate?: Record<string, UpdateRelationPropertyOptions>;
     };
 
 export interface DeleteEntityOptions {