|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
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
对象。如果默认提供程序包提供请求工厂的实现,则返回包含该实现的一个 SecretKeyFactory
实例。如果默认的提供程序包中不存在请求的工厂,则将搜索其他提供程序包。
algorithm
- 请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅《Java Cryptography Extension Reference Guide》中的附录 A。
SecretKeyFactory
对象。
NullPointerException
- 如果指定的算法为 null。
NoSuchAlgorithmException
- 如果默认提供程序包中或搜索到的任何其他提供程序包中不存在指定算法的秘密密钥工厂。public static final SecretKeyFactory getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException
SecretKeyFactory
。
algorithm
- 请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅《Java Cryptography Extension Reference Guide》中的附录 A。provider
- 提供程序的名称。
SecretKeyFactory
对象。
NoSuchAlgorithmException
- 如果指定算法的秘密密钥工厂在指定的提供程序中不可用。
NullPointerException
- 如果指定的算法为 null。
NoSuchProviderException
- 如果指定的提供程序未配置。
IllegalArgumentException
- 如果 provider
为 null。public static final SecretKeyFactory getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException
SecretKeyFactory
。注:provider
不一定都需要注册。
algorithm
- 请求的秘密密钥算法的标准名称。有关标准算法名称的信息,请参阅《Java Cryptography Extension Reference Guide》中的附录 A。provider
- 提供程序。
SecretKeyFactory
对象。
NullPointerException
- 如果指定的算法为 null。
NoSuchAlgorithmException
- 如果指定算法的秘密密钥工厂在指定的提供程序中不可用。
IllegalArgumentException
- 如果 provider
为 null。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
- 如果此秘密密钥工厂无法处理给定的密钥。
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。