Class StringUUID

back/src/models/__init__.py:19–192

字符串格式的 UUID 数据类型。 这是一个 SQLAlchemy 自定义类型，用于在数据库中存储 UUID 值。 支持多种数据库后端，自动处理不同格式之间的转换。 特性： - 支持 MySQL、PostgreSQL、SQLite 等多种数据库 - 自动处理 UUID 对象、字符串、None 值的转换 - 统一的 36 字符长度存储格式（带连字符） - 高性能缓存支持 - 完整的错误处理和日志记录 存储格式： - MySQL: CHAR(36) - "550e8400-e29

class StringUUID(TypeDecorator):
    """
    字符串格式的 UUID 数据类型。
    
    这是一个 SQLAlchemy 自定义类型，用于在数据库中存储 UUID 值。
    支持多种数据库后端，自动处理不同格式之间的转换。
    
    特性：
    - 支持 MySQL、PostgreSQL、SQLite 等多种数据库
    - 自动处理 UUID 对象、字符串、None 值的转换
    - 统一的 36 字符长度存储格式（带连字符）
    - 高性能缓存支持
    - 完整的错误处理和日志记录
    
    存储格式：
    - MySQL: CHAR(36) - "550e8400-e29b-41d4-a716-446655440000"
    - PostgreSQL: 优先使用原生 UUID 类型，回退到 CHAR(36)
    - 其他数据库: CHAR(36)
    
    使用示例：
        class User(Base):
            id = Column(StringUUID(), primary_key=True, default=lambda: str(uuid.uuid4()))
            name = Column(String(255))
    """
    
    # 指定基础实现类型
    impl = CHAR
    
    # 允许 SQLAlchemy 缓存这个类型，提高查询性能
    cache_ok = True
    
    def __init__(self, length: int = 36):
        """
        初始化 StringUUID 类型。
        
        Args:
            length (int): 存储长度，默认 36 字符（标准 UUID 格式）
        """
        self.length = length
        super().__init__()

    def load_dialect_impl(self, dialect):
        """
        根据不同的数据库方言加载适当的类型实现。
        
        为不同的数据库选择最优的存储类型：
        - PostgreSQL: 优先使用原生 UUID 类型
        - MySQL: 使用 MySQL 优化的 CHAR 类型
        - 其他: 使用标准 CHAR 类型
        
        Args:
            dialect: SQLAlchemy 数据库方言对象
            
        Returns:
            适合当前数据库的类型描述符
        """
        if dialect.name == "postgresql":
            # PostgreSQL 有原生 UUID 支持，性能更好