Class Sm3Hash

java.lang.Object
cloud.opencode.base.crypto.hash.Sm3Hash
All Implemented Interfaces:
HashFunction
public final class Sm3Hash extends Object implements HashFunction
SM3 hash function implementation - Chinese national cryptographic standard hash algorithm SM3 哈希函数实现 - 中国国密标准哈希算法

Requires Bouncy Castle provider to be available in the classpath. 需要 Bouncy Castle 提供者在类路径中可用。

Features | 主要功能:

  • Chinese national standard hash (GB/T 32905-2016) - 中国国密标准哈希（GB/T 32905-2016）
  • 256-bit digest output - 256 位摘要输出
  • Requires Bouncy Castle provider - 需要 Bouncy Castle 提供者

Usage Examples | 使用示例:

Sm3Hash sm3 = Sm3Hash.create();
String hex = sm3.hashHex("data");

Security | 安全性:

  • Thread-safe: Yes - 线程安全: 是
  • Null-safe: Yes - 空值安全: 是

Performance | 性能特性:

  • Time complexity: O(n) - 时间复杂度: O(n)，n为数据长度
  • Space complexity: O(1) - 空间复杂度: O(1)
Since:
JDK 25, opencode-base-crypto V1.0.0
Author:
Leon Soo www.LeonSoo.com
See Also:

  • Method Summary

    Modifier and Type
    Method
    Description
    static Sm3Hash
    create()
    Create SM3 hash function (256-bit digest) 创建 SM3 哈希函数（256 位摘要）
    String
    getAlgorithm()
    Get the hash algorithm name 获取哈希算法名称
    int
    getDigestLength()
    Get the digest length in bytes 获取摘要长度（字节数）
    byte[]
    hash(byte[] data)
    Compute hash of byte array 计算字节数组的哈希值
    byte[]
    hash(String data)
    Compute hash of string (UTF-8 encoded) 计算字符串的哈希值（使用 UTF-8 编码）
    String
    hashBase64(byte[] data)
    Compute hash and return as Base64 string 计算哈希值并返回 Base64 字符串
    String
    hashHex(byte[] data)
    Compute hash and return as hexadecimal string 计算哈希值并返回十六进制字符串
    String
    hashHex(String data)
    Compute hash of string and return as hexadecimal string 计算字符串哈希值并返回十六进制字符串

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Method Details

    • create

      public static Sm3Hash create()
      Create SM3 hash function (256-bit digest) 创建 SM3 哈希函数（256 位摘要）
      Returns:
      SM3 hash function instance
      Throws:
      OpenCryptoException - if Bouncy Castle provider is not available

    • hash

      public byte[] hash(byte[] data)
      Description copied from interface: HashFunction
      Compute hash of byte array 计算字节数组的哈希值
      Specified by:
      hash in interface HashFunction
      Parameters:
      data - input data to hash
      Returns:
      hash digest as byte array

    • hash

      public byte[] hash(String data)
      Description copied from interface: HashFunction
      Compute hash of string (UTF-8 encoded) 计算字符串的哈希值（使用 UTF-8 编码）
      Specified by:
      hash in interface HashFunction
      Parameters:
      data - input string to hash
      Returns:
      hash digest as byte array

    • hashHex

      public String hashHex(byte[] data)
      Description copied from interface: HashFunction
      Compute hash and return as hexadecimal string 计算哈希值并返回十六进制字符串
      Specified by:
      hashHex in interface HashFunction
      Parameters:
      data - input data to hash
      Returns:
      hash digest as lowercase hex string

    • hashHex

      public String hashHex(String data)
      Description copied from interface: HashFunction
      Compute hash of string and return as hexadecimal string 计算字符串哈希值并返回十六进制字符串
      Specified by:
      hashHex in interface HashFunction
      Parameters:
      data - input string to hash
      Returns:
      hash digest as lowercase hex string

    • hashBase64

      public String hashBase64(byte[] data)
      Description copied from interface: HashFunction
      Compute hash and return as Base64 string 计算哈希值并返回 Base64 字符串
      Specified by:
      hashBase64 in interface HashFunction
      Parameters:
      data - input data to hash
      Returns:
      hash digest as Base64 string

    • getDigestLength

      public int getDigestLength()
      Description copied from interface: HashFunction
      Get the digest length in bytes 获取摘要长度（字节数）
      Specified by:
      getDigestLength in interface HashFunction
      Returns:
      digest length in bytes

    • getAlgorithm

      public String getAlgorithm()
      Description copied from interface: HashFunction
      Get the hash algorithm name 获取哈希算法名称
      Specified by:
      getAlgorithm in interface HashFunction
      Returns:
      algorithm name