sogis/ilivalidator-web-service

INTERLIS传输文件验证服务镜像

镜像概述

本镜像是一个基于Spring Boot框架构建的Web服务，专门用于验证INTERLIS格式的传输文件。INTERLIS（Interactive Listing and Information System）是一种用于数据交换、验证和集成的标准格式，广泛应用于地理信息系统（GIS）及相关领域的数据交换场景。该服务通过HTTP接口提供文件验证功能，支持对INTERLIS传输文件的结构、语法及业务规则进行校验，便于集成到数据处理流水线中。

核心功能与特性

• INTERLIS文件验证：支持对标准INTERLIS格式（如.xtf、.itf等）传输文件的完整性和合规性验证
• REST API接口：提供简洁的HTTP接口，支持文件上传验证及验证结果返回
• 轻量级部署：基于Docker容器化部署，简化环境依赖管理，支持跨平台运行
• 验证结果反馈：返回详细的验证报告，包括错误信息、警告及合规性检查结果
• 可配置化：支持通过环境变量调整服务端口、日志级别等基础配置

使用场景和适用范围

适用场景

• 地理信息系统（GIS）数据交换平台的文件验证环节
• ***或企业级地理空间数据管理系统的前置校验流程
• 需要自动化验证INTERLIS格式文件的应用系统集成
• 开发环境中对INTERLIS文件生成工具的测试验证

适用范围

• 开发、测试及生产环境的INTERLIS文件验证服务部署
• 需要标准化数据交换流程的组织或机构
• 基于Spring Boot生态的应用系统扩展

使用方法和配置说明

环境要求

• Docker Engine 1.13.0+
• 至少1GB可用内存
• 网络环境支持HTTP请求（默认端口可自定义）

基础部署（Docker Run）

通过以下命令启动服务容器：

bash
docker run -d \
  -p 8080:8080 \
  --name interlis-validator \
  --restart unless-stopped \
  [镜像名称]:[标签]

说明：

• -p 8080:8080：将容器内8080端口映射到宿主机8080端口（可根据需求修改宿主机端口）
• --name interlis-validator：指定容器名称为interlis-validator
• [镜像名称]:[标签]：替换为实际的Docker镜像名称和标签

Docker Compose部署

创建docker-compose.yml文件：

yaml
version: '3'
services:
  interlis-validator:
    image: docker.xuanyuan.run/[镜像名称]:[标签]
    container_name: interlis-validator
    ports:
      - "8080:8080"
    restart: unless-stopped
    environment:
      - SERVER_PORT=8080  # 服务端口（默认8080，可自定义）
      - LOG_LEVEL=INFO     # 日志级别（可选：DEBUG, INFO, WARN, ERROR）

启动服务：

bash
docker-compose up -d

环境变量配置

API使用示例

验证INTERLIS文件

通过POST请求上传文件并获取验证结果：

bash
curl -X POST "http://localhost:8080/api/validate" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@/path/to/your/interlis-file.xtf"

响应示例（JSON格式）

json
{
  "valid": false,
  "filename": "interlis-file.xtf",
  "validationTime": "2024-05-20T14:30:00Z",
  "errors": [
    {
      "code": "SYNTAX_ERROR",
      "message": "Invalid XML structure at line 42",
      "line": 42
    }
  ],
  "warnings": [
    {
      "code": "DEPRECATED_FIELD",
      "message": "Field 'oldField' is deprecated in INTERLIS 2.3"
    }
  ]
}

注意事项

1. 服务依赖宿主机网络环境，确保容器可正常访问外部资源（如需在线验证规则更新）
2. 大文件验证可能需要调整VALIDATION_TIMEOUT参数及宿主机内存配置
3. 生产环境建议结合反向代理（如Nginx）进行SSL终止及请求限流
4. 验证结果日志默认输出至容器标准输出，可通过Docker日志驱动配置持久化存储

注：由于缺乏镜像详细信息，部分配置参数及API路径可能需根据实际镜像文档调整。建议结合官方镜像说明文档进行部署配置。