Openclaw용 Java API Extractor

먼저 필요한 런타임 환경(Python 권장, Node.js도 지원)이 있는지 확인하십시오.

# 전체 프로젝트를 JSON으로 추출 (Python 엔진 - 기본 및 권장)
python scripts/extract_java_api.py --project "/path/to/msa-icmp-dev-manage" --output api-definitions.json

# 특정 Java 패키지에서 정의 추출
python scripts/extract_java_api.py --project "/path/to/msa-icmp-dev-manage" --package "com.example.user.controller" --output user-api.json

# 정의를 추출하여 대상 제품 플랫폼으로 직접 푸시
python scripts/extract_java_api.py --project "/path/to/msa-icmp-dev-manage" --prdid "PRD-2026-001" --push

# 자세한 모드로 실행하여 광범위한 디버그 세부 정보 기록
python3 scripts/extract_java_api.py --project "/path/to/project" --output api.json --verbose

또는 환경에 Python이 없는 경우 Node.js 버전의 Openclaw Skills 파서를 실행할 수 있습니다:

# Node.js 대체 파서 호출
node scripts/extract_java_api.js --project "/path/to/msa-icmp-dev-manage" --package "com.example.user.controller" --output user-api.json

출력 스키마는 원시 JSON으로 구성되어 표준 API 엔드포인트 구조와 일치합니다. 아래는 예시 형식입니다:

[
  {
    "name": "Create User",
    "path": "/api/user",
    "method": "POST",
    "description": "Creates a new user",
    "requestParams": [
      {
        "name": "userName",
        "type": "String",
        "required": true,
        "description": "Target username"
      }
    ],
    "responseSchema": {
      "type": "object",
      "properties": {
        "userId": {
          "type": "string",
          "description": "The generated user ID"
        }
      }
    }
  }
]

어노테이션 지원 매트릭스

데이터 타입 매핑 표준