package com.se.simu.service;

import hdf.hdf5lib.exceptions.HDF5LibraryException;

/**
 * ibiz H5 文件解析器
 *
 * @author xingjinshuang@smartearth.cn
 * @date 2024/12/06
 */
public interface IBizH5FileParserService {

    /**
     * 打开HDF5文件
     *
     * @param filePath 文件路径
     * @return 文件ID
     */
    long openH5File(String filePath) ;


    /**
     * 读取指定数据集的数据
     *
     * @param fileId      文件ID
     * @param datasetName 数据集名称
     * @return 数据集的值
     */
    Object readDataset(long fileId, String datasetName);


    /**
     * 关闭HDF5文件
     *
     * @param fileId 文件ID
     */
    void closeH5File(long fileId) throws HDF5LibraryException;

    /**
     * 解析 H5 文件
     *
     * @param filePath
     * @return {@link Object}
     */
    Object parseH5File(String filePath);
}