noterik/stageplayer-sbf-reader

SBFReader

镜像概述

SBFReader是一款读取32/64位SBF文件的工具，需打包为WAR文件部署到Java应用服务器。它在/stageplayer-sbf-reader路径下提供资源，并通过HTTP协议对外提供JSON API服务。

核心功能

1. 读取SBF文件的元数据：获取文件中的所有流信息（名称、测量单位、最小值/最大值等）
2. 查询SBF流数据：根据指定范围和分辨率提取特定流的数值数据
3. 支持多操作组合：可同时执行多个获取元数据或流数据的请求

使用场景

适用于需要通过API接口处理SBF文件的场景，例如：

• 科研数据分析（如水文、气象等领域的SBF数据解析）
• 数据可视化平台对接SBF数据源
• 自动化数据处理流程中的SBF文件解析环节

配置说明

配置文件需放置在/opt/noterik/sbfreader.properties路径下，示例配置如下：

properties
data_root="/export/data"  # 指定SBF文件的数据根目录

API使用示例

查询SBF元数据

向/stageplayer-sbf-reader发送POST请求，请求体格式：

json
{
    "getMeta": {
        "sbfs": [
            "/stage/DWB27321_300_0105001_039_001_200_17-03-2017_23-07-12_dat.sbf"
        ]
    }
}

响应示例：

json
{
    "metadata": [
        {
            "path": "/stage/DWB27321_300_0105001_039_001_200_17-03-2017_23-07-12_dat.sbf",
            "frequency": 40.01232105638765,
            "bits": 32,
            "streams": [
                {
                    "name": "TIMESIGNAL",
                    "unit": "s",
                    "min": 0.000528500007931143,
                    "max": 523.8391723632812
                },
                {
                    "name": "WAVE.F2",
                    "unit": "m",
                    "min": -6.818584442138672,
                    "max": 18.48550033569336
                }
            ]
        }
    ]
}

查询SBF流数据

请求体格式：

json
{
    "getData": {
        "sbf": "/stage/DWB27321_300_0105001_039_001_200_17-03-2017_23-07-12_dat.sbf",
        "start": -1000,
        "end": 2000,
        "resolution": 400,
        "streams": ["WAVE.F1", "WAVE.F2"]
    }
}

响应示例：

json
[
    {
        "sbf": "/stage/DWB27321_300_0105001_039_001_200_17-03-2017_23-07-12_dat.sbf",
        "data": [
            {
                "name": "WAVE.F1",
                "streams": [
                    [-1000, null],
                    [0.528500007931143, 0.044260941445827484]
                ]
            }
        ]
    }
]

组合多个操作

请求体格式：

json
[
    {
        "getMeta": {
            "sbfs": ["/stage/sample1.sbf"]
        }
    },
    {
        "getData": {
            "sbf": "/stage/sample2.sbf",
            "start": 0,
            "end": 1000,
            "resolution": 200,
            "streams": ["WAVE.F1"]
        }
    }
]

Docker部署示例

bash
docker run -d \
  -p 8080:8080 \
  -v /host/path/to/sbfreader.properties:/opt/noterik/sbfreader.properties \
  -v /host/path/to/data:/export/data \
  noterik/stageplayer-sbf-reader

说明：

• -p 8080:8080：映射容器端口到主机
• -v：挂载主机配置文件和数据目录到容器对应路径
• 访问API：http://localhost:8080/stageplayer-sbf-reader