77 lines
2.1 KiB
Python
77 lines
2.1 KiB
Python
|
# @line_count 100
|
|||
|
|
"""JSON解析模块，提取功能点和章节信息"""
|
|||
|
|
import json
|
|||
|
|
from pathlib import Path
|
|||
|
|
from typing import List, Dict, Any, Optional
|
|||
|
|
from .parser_adapters.parser_factory import ParserFactory
|
|||
|
|
|
|||
|
|
|
|||
|
|
class JSONParser:
|
|||
|
|
"""JSON文档解析器（门面模式）"""
|
|||
|
|
|
|||
|
|
def __init__(self, json_path: str):
|
|||
|
|
"""
|
|||
|
|
初始化JSON解析器
|
|||
|
|
|
|||
|
|
Args:
|
|||
|
|
json_path: JSON文件路径
|
|||
|
|
"""
|
|||
|
|
self.json_path = Path(json_path)
|
|||
|
|
self.data: Dict[str, Any] = {}
|
|||
|
|
self.adapter = None
|
|||
|
|
self.load_json()
|
|||
|
|
|
|||
|
|
def load_json(self):
|
|||
|
|
"""加载JSON文件并创建适配器"""
|
|||
|
|
if not self.json_path.exists():
|
|||
|
|
raise FileNotFoundError(f"JSON文件不存在: {self.json_path}")
|
|||
|
|
|
|||
|
|
with open(self.json_path, 'r', encoding='utf-8') as f:
|
|||
|
|
self.data = json.load(f)
|
|||
|
|
|
|||
|
|
# 自动检测格式并创建适配器
|
|||
|
|
self.adapter = ParserFactory.create_adapter(self.data)
|
|||
|
|
|
|||
|
|
def extract_function_points(self) -> List[Dict[str, Any]]:
|
|||
|
|
"""
|
|||
|
|
提取功能点列表
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
功能点列表，每个功能点包含：
|
|||
|
|
- module_name: 所属模块
|
|||
|
|
- function_name: 功能名称
|
|||
|
|
- description: 功能描述
|
|||
|
|
- operation_steps: 操作步骤（可选）
|
|||
|
|
- requirement_id: 需求编号（可选）
|
|||
|
|
- requirement_type: 需求类型（可选）
|
|||
|
|
"""
|
|||
|
|
return self.adapter.extract_function_points()
|
|||
|
|
|
|||
|
|
def get_document_info(self) -> Dict[str, Any]:
|
|||
|
|
"""
|
|||
|
|
获取文档基本信息
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
文档信息字典
|
|||
|
|
"""
|
|||
|
|
return self.adapter.get_document_info()
|
|||
|
|
|
|||
|
|
def get_sections(self) -> List[Dict[str, Any]]:
|
|||
|
|
"""
|
|||
|
|
获取所有章节信息
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
章节列表
|
|||
|
|
"""
|
|||
|
|
return self.adapter.get_sections()
|
|||
|
|
|
|||
|
|
def get_module_summary(self) -> List[Dict[str, Any]]:
|
|||
|
|
"""
|
|||
|
|
获取模块摘要
|
|||
|
|
|
|||
|
|
Returns:
|
|||
|
|
模块摘要列表
|
|||
|
|
"""
|
|||
|
|
return self.adapter.get_module_summary()
|
|||
|
|
|