QAUP_Management/adxp-adapter

ADXP SDK Adapter Service

ADXP 数据中台 SDK 适配器服务 - 基于 JDK 8 运行的独立微服务

功能说明

将青岛机场数据中台 SDK (adxp-client-2.6.9.jar) 封装为 REST API 服务，解决 SDK 与现代 Java 版本的兼容性问题。

技术栈

• Java: JDK 8
• 框架: Spring Boot 2.7.18
• 构建: Maven
• 容器化: Docker

快速开始

方式1：Docker Compose（推荐）

# 1. 构建并启动服务
docker-compose up -d

# 2. 查看日志
docker-compose logs -f

# 3. 停止服务
docker-compose down

方式2：本地运行（需要 JDK 8）

# 1. 编译
mvn clean package

# 2. 运行
java -jar target/adxp-adapter.jar \
  --adxp.host=localhost \
  --adxp.port=7001

API 文档

1. 登录

POST /api/adxp/login
Content-Type: application/json

{
  "username": "dianxin",
  "password": "dianxin@123"
}

响应：

{
  "success": true,
  "sessionId": "550e8400-e29b-41d4-a716-446655440000",
  "message": "登录成功"
}

2. 接收消息

GET /api/adxp/messages?sessionId=550e8400-e29b-41d4-a716-446655440000

响应：

{
  "success": true,
  "messages": [
    {
      "serviceCode": "ARR",
      "actionCode": "ADD",
      "content": "<xml>...</xml>"
    }
  ],
  "message": null
}

3. 登出

POST /api/adxp/logout
Content-Type: application/json

{
  "sessionId": "550e8400-e29b-41d4-a716-446655440000"
}

4. 健康检查

GET /api/adxp/health

响应：

{
  "status": "UP",
  "activeSessions": 1
}

快速测试

# 健康检查
curl http://localhost:8086/api/adxp/health
# 预期输出: {"status":"UP","activeSessions":0}

# 登录
curl -X POST http://localhost:8086/api/adxp/login \
  -H "Content-Type: application/json" \
  -d '{"username":"dianxin","password":"dianxin@123"}'

# 接收消息（替换为实际的 sessionId）
curl "http://localhost:8086/api/adxp/messages?sessionId=YOUR_SESSION_ID"

配置说明

环境变量

变量名	说明	默认值
ADXP_HOST	ADXP 数据中台主机地址	localhost
ADXP_PORT	ADXP 数据中台端口	7001
SPRING_PROFILES_ACTIVE	Spring Profile	prod

application.yml

adxp:
  host: ${ADXP_HOST:localhost}
  port: ${ADXP_PORT:7001}

部署说明

开发环境

# 1. 启动 mock ADXP 服务器
cd /path/to/QAUP-Management/tools
python3 mock_adxp.py --auto --interval 10

# 2. 启动适配器（默认指向 localhost）
docker-compose up -d

生产环境

# 1. 创建环境变量文件
cat > .env << EOF
ADXP_HOST=10.10.10.100  # 真实数据中台 IP
ADXP_PORT=7001          # 真实数据中台端口
EOF

# 2. 启动服务
docker-compose up -d

开发说明

项目结构

adxp-adapter/
├── pom.xml               # Maven 配置
├── Dockerfile            # Docker 镜像定义
├── docker-compose.yml    # Docker Compose 配置
├── libs/                 # 数据中台 SDK
│   ├── adxp-client-2.6.9.jar
│   └── mq.allclient-9.0.jar
└── src/                  # 源代码

核心依赖

• adxp-client-2.6.9.jar: 数据中台 SDK
• Apache CXF 3.2.4: SOAP 协议支持
• Jackson 1.9.13: JSON 序列化
• Spring Boot 2.7.18: 应用框架

许可证

内部项目