java.lang.Object javax.crypto.SecretKeyFactory
public class SecretKeyFactory
此类表示秘密密钥的工厂。
密钥工厂用来将密钥(类型 Key
的不透明加密密钥)转换为密钥规范(底层密钥材料的透明表示形式),反之亦然。秘密密钥工厂只对秘密(对称)密钥进行操作。
密钥工厂为双工模式,即其允许根据给定密钥规范(密钥材料)构建不透明密钥对象,或以适当格式获取密钥对象的底层密钥材料。
应用程序开发人员应参阅其提供者文档,找出 generateSecret
和 getKeySpec
方法所支持的密钥规范。例如,"SunJCE" 提供者提供的 DES 秘密密钥工厂支持 DESKeySpec
作为 DES 密钥的透明表示形式,并且该提供者的 Triple DES 密钥的秘密密钥工厂支持 DESedeKeySpec
作为 Triple DES 密钥的透明表示形式。
SecretKey
,
DESKeySpec
,
DESedeKeySpec
,
PBEKeySpec
构造方法摘要 | |
---|---|
protected |
SecretKeyFactory(SecretKeyFactorySpi keyFacSpi, Provider provider, String algorithm) 创建一个 SecretKeyFactory 对象。 |
方法摘要 | |
---|---|
SecretKey |
generateSecret(KeySpec keySpec) 根据提供的密钥规范(密钥材料)生成 SecretKey 对象。 |
String |
getAlgorithm() 返回此 SecretKeyFactory 对象的算法名称。 |
static SecretKeyFactory |
getInstance(String algorithm) 返回转换指定算法的秘密密钥的 SecretKeyFactory 对象。 |
static SecretKeyFactory |
getInstance(String algorithm, Provider provider) 返回转换指定算法的秘密密钥的 SecretKeyFactory 对象。 |
static SecretKeyFactory |
getInstance(String algorithm, String provider) 返回转换指定算法的秘密密钥的 SecretKeyFactory 对象。 |
KeySpec |
getKeySpec(SecretKey key, Class keySpec) 以请求的格式返回给定密钥对象的规范(密钥材料)。 |
Provider |
getProvider() 返回此 SecretKeyFactory 对象的提供者。 |
SecretKey |
translateKey(SecretKey key) 将一个密钥对象(其提供者未知或可能不受信任)转换为此秘密密钥工厂的相应密钥对象。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
protected SecretKeyFactory(SecretKeyFactorySpi keyFacSpi, Provider provider, String algorithm)
keyFacSpi
- 委托
provider
- 提供者
algorithm
- 秘密密钥算法
方法详细信息 |
---|
public static final SecretKeyFactory getInstance(String algorithm) throws NoSuchAlgorithmException
SecretKeyFactory
对象。
此方法从首选 Provider 开始遍历已注册安全提供者列表。返回一个封装 SecretKeyFactorySpi 实现的新 SecretKeyFactory 对象,该实现取自支持指定算法的第一个 Provider。
注意,可以通过 Security.getProviders()
方法获取已注册提供者列表。
algorithm
- 所请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅
Java Cryptography Architecture Reference Guide 中的附录 A。
SecretKeyFactory
对象。
NullPointerException
- 如果指定的算法为 null。
NoSuchAlgorithmException
- 如果没有任何 Provider 支持指定算法的 SecretKeyFactorySpi 实现。
Provider
public static final SecretKeyFactory getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
SecretKeyFactory
对象。
返回一个封装 SecretKeyFactorySpi 实现的新 SecretKeyFactory 对象,该实现取自指定的提供者。指定提供者必须在安全提供者列表中注册。
注意,可以通过 Security.getProviders()
方法获取已注册提供者列表。
algorithm
- 所请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅
Java Cryptography Architecture Reference Guide 中的附录 A。
provider
- 提供者的名称。
SecretKeyFactory
对象。
NoSuchAlgorithmException
- 如果不能从指定提供者获得指定算法的 SecretKeyFactorySpi 实现。
NullPointerException
- 如果指定的算法为 null。
NoSuchProviderException
- 如果指定提供者未在安全提供者列表中注册。
IllegalArgumentException
- 如果
provider
为 null 或空。
Provider
public static final SecretKeyFactory getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
SecretKeyFactory
对象。
返回一个封装 SecretKeyFactorySpi 实现的新 SecretKeyFactory 对象,该实现取自指定的 Provider 对象。注意,指定 Provider 对象无需在提供者列表中注册。
algorithm
- 所请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅
Java Cryptography Architecture Reference Guide 中的附录 A。
provider
- 提供者。
SecretKeyFactory
对象。
NullPointerException
- 如果指定的算法为 null。
NoSuchAlgorithmException
- 如果不能从指定的 Provider 对象获得指定算法的 SecretKeyFactorySpi 实现。
IllegalArgumentException
- 如果
provider
为 null。
Provider
public final Provider getProvider()
SecretKeyFactory
对象的提供者。
SecretKeyFactory
对象的提供者
public final String getAlgorithm()
SecretKeyFactory
对象的算法名称。
此名称与在某个创建此 SecretKeyFactory
对象的 getInstance
调用中指定的名称相同。
SecretKeyFactory
对象的算法名称。
public final SecretKey generateSecret(KeySpec keySpec) throws InvalidKeySpecException
SecretKey
对象。
keySpec
- 秘密密钥的规范(密钥材料)
InvalidKeySpecException
- 如果给定密钥规范不适合生成秘密密钥的秘密密钥工厂。
public final KeySpec getKeySpec(SecretKey key, Class keySpec) throws InvalidKeySpecException
key
- 密钥
keySpec
- 所请求的格式,密钥材料将以此格式返回
InvalidKeySpecException
- 如果所请求的密钥规范不适合给定的密钥(例如,与
key
和
keySpec
关联的算法不匹配,或者
key
在加密硬件设备上引用一个密钥而
keySpec
是基于软件的密钥规范),或者无法处理给定的密钥(例如,给定的密钥具有此秘密密钥工厂不支持的算法或格式)。
public final SecretKey translateKey(SecretKey key) throws InvalidKeyException
key
- 其提供者未知或不受信任的密钥
InvalidKeyException
- 如果此秘密密钥工厂无法处理给定的密钥。