国土对接返回信息加密

rain

2024-08-21 2db1aa88e8ab53096a936163d686b90d8e056a99

 src/main/java/com/dji/sample/droneairport/service/RegistService.java

@@ -3,23 +3,26 @@
import com.dji.sample.common.model.ResponseResult;
import com.dji.sample.droneairport.model.Entity.DeviceExpanSionEntity;
import com.dji.sample.droneairport.model.param.ReturnTaskParam;
import org.bouncycastle.crypto.InvalidCipherTextException;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
import java.util.Map;

public interface RegistService {

    /**
     * 注册端口
     *
     * 该方法用于在系统中注册一个设备扩展端口的信息它接收一个DeviceExpanSionEntity对象作为参数，
     * 其中包含了设备扩展端口的相关信息这个方法的主要目的是将这个端口信息添加到系统的数据库中，
     * 以便于系统能够识别和管理这个端口
     *
     * @param airport 设备扩展端口实体对象，包含了需要注册的端口信息
     * @return 注册操作的状态信息，通常是一个字符串，比如"成功"或"失败"
     * 推送无人机机场信息
     */
    String registPort(DeviceExpanSionEntity airport);

    /**
     * 推送无人机设备
     *
     * @param workspceId 接收workspaceId,自动将该工作空间的机场以及无人机设备推送
     * @return 返回推送接口后返回的信息
     */
    String addDrone(String workspceId);

    /**
@@ -29,17 +32,14 @@
     * @return 返回一个包含无人机状态信息的ResponseResult对象
     * @throws Exception 如果在获取无人机状态过程中发生错误，将抛出异常
     */
    String getDroneState(String deviceId) throws Exception;
    Map<String, String>  getDroneState(String deviceId) throws Exception;

    /**
     * 执行授权操作
     *
     * @param base64 经过Base64编码的字符串，通常用于身份验证
     * @param Secret 应用的密钥，用于生成签名
     * @return 返回授权结果，包括成功与否、错误信息等
     * @throws Exception 如果授权过程中出现错误，可能会抛出异常
     */
//    ResponseResult authorization(String base64, String Secret) throws Exception;
    void noAuthorization(String sn);

    void Authorization(String sn);
@@ -53,7 +53,7 @@
     * @return 返回一个包含任务添加结果的ReturnParam对象，具体结果包括成功与否、错误信息等
     * @throws Exception 如果在任务添加过程中发生错误，将抛出异常
     */
    ReturnTaskParam AddTask(String base64, String Secret, String username) throws Exception;
    Map<String, String> AddTask(String base64, String Secret, String username) throws Exception;

    /**
     * 更新任务状态
@@ -64,7 +64,7 @@
     * @return 包含更新后任务状态信息的返回参数
     * @throws Exception 如果更新任务状态过程中发生错误，将抛出异常
     */
    ReturnTaskParam updateTask(String base64, String Secret, String username) throws Exception;
    Map<String, String>  updateTask(String base64, String Secret, String username) throws Exception;

    /**
     * 取消指定任务
@@ -72,7 +72,7 @@
     * @param taskId 任务ID，用于标识待取消的任务
     * @return 返回任务取消操作的结果，包含是否成功及可能的错误信息
     */
    ResponseResult cancelTask(String taskId);
    Map<String, String>  cancelTask(String taskId) throws InvalidCipherTextException, IOException;

    /**
     * 查询任务状态
@@ -90,5 +90,15 @@
     * @return 返回一个包含无人机状态信息的ResponseResult对象
     * @throws Exception 如果在获取无人机状态过程中发生错误，将抛出异常
     */
    String findDbFilesByTaskId(String taskId);
    Map<String,String> findDbFilesByTaskId(String taskId) throws InvalidCipherTextException, IOException;
    /**
     * 获取指定工作空间中不同任务的总数
     *
     * 此方法通过接收工作空间的ID，计算并返回该工作空间中不同任务的数量
     * 它用于度量工作空间中任务的多样性，帮助用户了解工作空间的任务分布情况
     *
     * @param workspaceId 工作空间的唯一标识符
     * @return 工作空间中不同任务的数量
     */
    Integer getDistinctTaskIdCount(String workspaceId);
}