CKTIS / Java
MessageDigest — изчисляване и сравняване на хешове
MessageDigest изчислява еднопосочни хешове на данни. Научете как да изберете SHA-256, да обработвате байтове, да разбирате нулирането след digest и да сравнявате резултати с isEqual.
Версия: Java SE 21; repository runtime, production runtime not attested
Синтаксис
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest от java.security изчислява еднопосочен хеш на байтове, вместо да криптира данни. SHA-256 връща 256 бита, или 32 байта. Шестнадесетичният текст е само представяне на резултата; при преобразуване на текст в байтове изрично изберете кодиране като StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") получава реализация от доставчик на криптографски услуги. Ако заявеният алгоритъм не се поддържа, възниква NoSuchAlgorithmException; Java SE 21 изисква поддръжка на SHA-256.
Извикването на md.digest(input) върху обект от клас MessageDigest добавя input към вече натрупаните данни и завършва изчислението. При обработка на части извикайте update(...), а след това digest(). След завършване на изчислението обектът се връща в началното си състояние: следващото извикване не продължава предишното съобщение.
MessageDigest.isEqual(a, b) сравнява дължината и съдържанието на хешовете. Не я заменяйте с ==, който сравнява препратките към масивите. Не приемайте този метод за безусловна гаранция за постоянно време при всякакви аргументи и среди. Сам по себе си хешът не удостоверява подателя и не е криптиране.
Тази документация се отнася за Java SE 21, средата за изпълнение на хранилището. Производствената среда за изпълнение не е удостоверена.
Примери
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HexFormat;
public class DigestExample {
public static void main(String[] args) throws NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] actual = md.digest("abc".getBytes(StandardCharsets.UTF_8));
byte[] expected = HexFormat.of().parseHex(
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad");
System.out.println(HexFormat.of().formatHex(actual));
System.out.println(MessageDigest.isEqual(actual, expected));
}
}Резултат
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.