create-dp-koa 1.0.1 → 1.1.0

package/template/src/examples/TransactionManagerDemo.ts

@@ -1,377 +0,0 @@
-/**
- * TransactionManager 使用示例
- * 演示如何使用事务管理器处理各种数据库操作场景
- */
-
-import { transactionManager } from '@src/framework/utils/TransactionManager';
-import { logger } from '@src/framework/utils/logger';
-import { YtUserEntity } from '@src/entity/ytUser.entity';
-import { getDataSource } from '@src/framework/utils/db';
-import * as bcrypt from 'bcryptjs';
-
-/**
- * 示例 1: 基本事务使用
- * 创建用户并确保所有操作要么全部成功，要么全部失败
- */
-export async function example1_basicTransaction() {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 在这个事务中，所有操作都会在同一个事务上下文中执行
-            
-            // 操作 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = 'demo@example.com';
-            user.telnumber = '13800138000';
-            user.password = await bcrypt.hash('password123', 10);
-            
-            const savedUser = await manager.save(user);
-            
-            // 操作 2: 更新用户信息
-            savedUser.email = 'updated@example.com';
-            const updatedUser = await manager.save(savedUser);
-            
-            return updatedUser;
-        });
-        
-        logger.info('事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 2: 使用隔离级别
- * 使用 SERIALIZABLE 隔离级别确保最高的数据一致性
- */
-export async function example2_transactionWithIsolationLevel() {
-    try {
-        const result = await transactionManager.executeInTransaction(
-            async (manager) => {
-                // 在 SERIALIZABLE 隔离级别下执行操作
-                // 这会锁定相关数据，防止并发问题
-                
-                const users = await manager.find(YtUserEntity, {
-                    where: { email: 'demo@example.com' }
-                });
-                
-                // 执行一些需要高度一致性的操作
-                for (const user of users) {
-                    user.updateDate = new Date();
-                    await manager.save(user);
-                }
-                
-                return users;
-            },
-            'SERIALIZABLE' // 指定隔离级别
-        );
-        
-        logger.info('隔离事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('隔离事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 3: 只读事务
- * 用于优化只读操作的性能
- */
-export async function example3_readOnlyTransaction() {
-    try {
-        const result = await transactionManager.executeInReadOnlyTransaction(async (manager) => {
-            // 只读事务，不会对数据产生任何修改
-            // 适合报表查询、统计分析等操作
-            
-            const totalUsers = await manager.count(YtUserEntity);
-            const activeUsers = await manager.count(YtUserEntity, {
-                where: { status: 'normal' } as any
-            });
-            
-            return {
-                total: totalUsers,
-                active: activeUsers,
-                inactive: totalUsers - activeUsers
-            };
-        });
-        
-        logger.info('只读事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('只读事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 4: 批量操作事务
- * 一次性处理多个操作，确保原子性
- */
-export async function example4_batchTransaction() {
-    try {
-        const operations = [
-            // 操作 1: 创建用户 1
-            async (manager: any) => {
-                const user1 = new YtUserEntity();
-                user1.email = 'user1@example.com';
-                user1.telnumber = '13800138001';
-                user1.password = await bcrypt.hash('pass123', 10);
-                return await manager.save(user1);
-            },
-            
-            // 操作 2: 创建用户 2
-            async (manager: any) => {
-                const user2 = new YtUserEntity();
-                user2.email = 'user2@example.com';
-                user2.telnumber = '13800138002';
-                user2.password = await bcrypt.hash('pass123', 10);
-                return await manager.save(user2);
-            },
-            
-            // 操作 3: 更新用户 1
-            async (manager: any) => {
-                const user = await manager.findOne(YtUserEntity, {
-                    where: { email: 'user1@example.com' }
-                });
-                if (user) {
-                    user.updateDate = new Date();
-                    return await manager.save(user);
-                }
-                return null;
-            }
-        ];
-        
-        const results = await transactionManager.executeBatchTransaction(operations);
-        
-        logger.info('批量事务执行成功，创建了', results.length, '个操作');
-        return results;
-        
-    } catch (error) {
-        logger.error('批量事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 5: 嵌套事务
- * 当需要在已经存在的事务中执行额外操作时使用
- */
-export async function example5_nestedTransaction() {
-    try {
-        // 外层事务
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 创建主用户
-            const mainUser = new YtUserEntity();
-            mainUser.email = 'main@example.com';
-            mainUser.telnumber = '13800138000';
-            mainUser.password = await bcrypt.hash('pass123', 10);
-            const savedMainUser = await manager.save(mainUser);
-            
-            // 使用嵌套事务创建相关数据
-            await transactionManager.executeNestedTransaction(async (nestedManager) => {
-                // 这些操作会使用现有的事务（如果有）
-                const relatedUser = new YtUserEntity();
-                relatedUser.email = 'related@example.com';
-                relatedUser.telnumber = '13800138001';
-                relatedUser.password = await bcrypt.hash('pass123', 10);
-                await nestedManager.save(relatedUser);
-            });
-            
-            return savedMainUser;
-        });
-        
-        logger.info('嵌套事务执行成功:', result);
-        return result;
-        
-    } catch (error) {
-        logger.error('嵌套事务执行失败:', error as Error);
-        throw error;
-    }
-}
-
-/**
- * 示例 6: 错误处理和回滚
- * 演示当事务出错时如何自动回滚
- */
-export async function example6_errorHandlingAndRollback() {
-    try {
-        await transactionManager.executeInTransaction(async (manager) => {
-            // 操作 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = 'test@example.com';
-            user.telnumber = '13800138000';
-            user.password = await bcrypt.hash('pass123', 10);
-            await manager.save(user);
-            
-            // 操作 2: 故意引发错误（模拟业务逻辑错误）
-            if (user.email === 'test@example.com') {
-                throw new Error('模拟业务错误：测试用户不允许');
-            }
-            
-            // 这段代码不会被执行，因为上面抛出了错误
-            user.email = 'updated@example.com';
-            await manager.save(user);
-        });
-        
-    } catch (error) {
-        // 所有操作都会被回滚
-        logger.error('事务已回滚，所有更改已撤销');
-        
-        // 验证：检查用户是否真的被回滚了
-        const dataSource = getDataSource();
-        if (dataSource) {
-            const user = await dataSource.manager.findOne(YtUserEntity, {
-                where: { email: 'test@example.com' }
-            });
-            
-            if (!user) {
-                logger.info('✅ 回滚验证通过：用户未被创建');
-            } else {
-                logger.warn('❌ 回滚验证失败：用户仍然存在');
-            }
-        }
-        
-        throw error;
-    }
-}
-
-/**
- * 示例 7: 复杂业务场景
- * 用户注册时需要同时创建多个相关记录
- */
-export async function example7_complexBusinessScenario(
-    userData: any,
-    profileData: any,
-    preferences: any
-) {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            // 步骤 1: 创建用户
-            const user = new YtUserEntity();
-            user.email = userData.email;
-            user.telnumber = userData.telnumber;
-            user.password = userData.password;
-            const savedUser = await manager.save(user);
-            
-            // 步骤 2: 创建用户配置（假设有配置表）
-            // const profile = await manager.save(ProfileEntity, profileData);
-            
-            // 步骤 3: 创建用户偏好（假设有偏好表）
-            // const preferences = await manager.save(PreferencesEntity, preferencesData);
-            
-            // 步骤 4: 发送欢迎通知（假设有通知表）
-            // const notification = await manager.save(NotificationEntity, {
-            //     userId: savedUser.id,
-            //     message: '欢迎注册！'
-            // });
-            
-            return {
-                user: savedUser,
-                // profile,
-                // preferences
-            };
-        });
-        
-        logger.info('复杂业务场景执行成功');
-        return result;
-        
-    } catch (error) {
-        logger.error('复杂业务场景执行失败，所有更改已回滚');
-        throw error;
-    }
-}
-
-/**
- * 示例 8: 条件事务
- * 根据条件决定是否提交事务
- */
-export async function example8_conditionalTransaction(userData: any, shouldCommit: boolean) {
-    try {
-        const result = await transactionManager.executeInTransaction(async (manager) => {
-            const user = new YtUserEntity();
-            user.email = userData.email;
-            user.telnumber = userData.telnumber;
-            user.password = userData.password;
-            const savedUser = await manager.save(user);
-            
-            // 模拟一些业务逻辑
-            if (!shouldCommit) {
-                // 即使在 try-catch 中不抛出错误，也可以通过返回值控制
-                logger.warn('业务逻辑决定不提交事务');
-                // 如果抛出自定义错误，事务会回滚
-                throw new Error('Business logic error: 不符合提交条件');
-            }
-            
-            return savedUser;
-        });
-        
-        logger.info('条件事务执行成功');
-        return result;
-        
-    } catch (error) {
-        logger.error('条件事务被回滚');
-        throw error;
-    }
-}
-
-// 使用示例函数
-export async function runAllExamples() {
-    console.log('=== TransactionManager 使用示例 ===\n');
-    
-    try {
-        // 示例 1: 基本事务
-        console.log('\n1. 基本事务示例');
-        // await example1_basicTransaction();
-        
-        // 示例 2: 隔离级别
-        console.log('\n2. 带隔离级别的事务示例');
-        // await example2_transactionWithIsolationLevel();
-        
-        // 示例 3: 只读事务
-        console.log('\n3. 只读事务示例');
-        // await example3_readOnlyTransaction();
-        
-        // 示例 4: 批量操作
-        console.log('\n4. 批量操作事务示例');
-        // await example4_batchTransaction();
-        
-        // 示例 5: 嵌套事务
-        console.log('\n5. 嵌套事务示例');
-        // await example5_nestedTransaction();
-        
-        // 示例 6: 错误处理
-        console.log('\n6. 错误处理和回滚示例');
-        // await example6_errorHandlingAndRollback();
-        
-        // 示例 7: 复杂业务场景
-        console.log('\n7. 复杂业务场景示例');
-        // await example7_complexBusinessScenario({}, {}, {});
-        
-        // 示例 8: 条件事务
-        console.log('\n8. 条件事务示例');
-        // await example8_conditionalTransaction({}, true);
-        
-        console.log('\n=== 所有示例运行完成 ===');
-        
-    } catch (error) {
-        logger.error('运行示例时发生错误:', error as Error);
-    }
-}
-
-// 导出所有示例
-export const transactionManagerExamples = {
-    basic: example1_basicTransaction,
-    withIsolation: example2_transactionWithIsolationLevel,
-    readOnly: example3_readOnlyTransaction,
-    batch: example4_batchTransaction,
-    nested: example5_nestedTransaction,
-    errorHandling: example6_errorHandlingAndRollback,
-    complex: example7_complexBusinessScenario,
-    conditional: example8_conditionalTransaction,
-    runAll: runAllExamples
-};