Hash工具使用说明
1. 功能描述
提供给客户计算 Hash 值，分为 java SDK 版本与 bjcahash 服务版本。
目前支持文件格式有：pdf、xml、html、xslt、gif、tiff、java、txt、png、ofd、doc、docx、xlsx、xmind、zip、sh、exe、rar、dwg、mp4、json、jpg
2. 使用场景
Java SDK 版本需要集成在客户业务系统代码中；bjcahash 服务版本需要部署在客户本地。
3. 接口定义
3.1 SDK
引入 SDK 后，直接调用 BjcaHash 下的 digestForFile 方法
| 字段名称 | 描述 | 是否必须 | 示例 |
|---|---|---|---|
| file | 待计Hash的文件 | 是 | .pdf文件 |
| algIdentifier | Hash 算法 | 否 | 支持的 hash 算法sm3/sha256,默认 sha256； 注意：该值需要与摘要保全的 signAlgIdentifier 参数保持对应关系：sm3 -> SM3withSM2 sha256 -> SHA256withRSA |
3.2 http服务
| 接口地址 | /getHashServer |
|---|---|
| 请求类型 | POST |
| Content Type | multipart/form-data; |
参数
| 字段名称 | 描述 | 是否必须 | 示例 |
|---|---|---|---|
| file | 待计算 Hash 的文件（10M以内） | 是 | .pdf 文件 |
| alg | Hash 算法 | 否 | 支持的hash算法sm3/sha256, 默认sha256；该值需要与摘要保全的 signAlgIdentifier参数保持对应关系。sm3 -> SM3withSM2 sha256 -> SHA256withRSA |
输出:
成功时返回结果对象，例如： {“State”:”200”,”Message”:”success”,”Data”:”Dt-JBoelPJRFk5gbyU_SOsutUXvncxx0a0QHLVeZ3Nh2v20wCG_hvw”}；
失败时返回错误码和错误信息。