Class BaseProcessor

modules/base.py:69–181

处理模块基类 所有处理模块都应该继承此类并实现 process() 方法。 子模块职责： 1. 处理自己负责的元素类型 2. 生成对应的mxCell XML代码 3. 设置 element.xml_fragment 和 element.layer_level 使用示例: class MyProcessor(BaseProcessor): def process(self, context: ProcessingContext) -> Proce

class BaseProcessor(ABC):
    """
    处理模块基类
    
    所有处理模块都应该继承此类并实现 process() 方法。
    
    子模块职责：
        1. 处理自己负责的元素类型
        2. 生成对应的mxCell XML代码
        3. 设置 element.xml_fragment 和 element.layer_level
    
    使用示例:
        class MyProcessor(BaseProcessor):
            def process(self, context: ProcessingContext) -> ProcessingResult:
                for elem in context.elements:
                    if self._should_process(elem):
                        xml = self._generate_xml(elem)
                        elem.xml_fragment = xml
                        elem.layer_level = LayerLevel.BASIC_SHAPE.value
                return ProcessingResult(success=True, elements=context.elements)
    """
    
    def __init__(self, config: Optional['ProcessingConfig'] = None):
        """
        初始化处理器
        
        Args:
            config: 处理配置，如果为None则使用默认配置
        """
        from .data_types import ProcessingConfig
        self.config = config or ProcessingConfig()
        self._model = None  # 延迟加载的模型实例
    
    @property
    def name(self) -> str:
        """模块名称（用于日志和标识）"""
        return self.__class__.__name__
    
    @abstractmethod
    def process(self, context: ProcessingContext) -> 'ProcessingResult':
        """
        处理入口 - 子类必须实现
        
        Args:
            context: 处理上下文，包含输入数据和共享状态
            
        Returns:
            ProcessingResult: 处理结果
            
        子类实现要点：
            1. 遍历 context.elements，找到需要处理的元素
            2. 生成 mxCell XML字符串
            3. 设置 element.xml_fragment = xml_string
            4. 设置 element.layer_level = 合适的层级
            5. 返回 ProcessingResult
        """
        pass