©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.xml.crypto.dsig.XMLSignatureFactory
public abstract class XMLSignatureFactory
用于从头创建 XMLSignature
对象或从相应的 XML 表示形式解组 XMLSignature
对象的工厂。
每个 XMLSignatureFactory
实例都支持一个特定的 XML 机制类型。要创建 XMLSignatureFactory
,则需要调用一个静态 getInstance
方法,以传入所需的 XML 机制类型,例如:
XMLSignatureFactory factory = XMLSignatureFactory.getInstance("DOM");
此工厂生成的对象将基于 DOM 并遵守 DOM 互操作性要求,正如 API 概述的 DOM Mechanism Requirements 部分中所定义的。标准机制类型列表,请参阅 API 概述的 Service Providers 部分。
使用 Provider
机制来注册和加载 XMLSignatureFactory
实现。例如,支持 DOM 机制的服务提供者将在 Provider
子类中指定,如下所示:
put("XMLSignatureFactory.DOM", "org.example.DOMXMLSignatureFactory");
实现至少必须支持默认的机制类型:DOM。
注意,调用者必须使用相同的 XMLSignatureFactory
实例来创建要生成的特定 XMLStructure
的 XMLSignature
。如果同时使用取自不同提供者或不同机制类型的 XMLStructure
,则行为是不明确的。
同时,由此工厂创建的 XMLStructure
可能包含特定于 XMLSignature
的状态,并且该状态是不可重用的。
创建了 XMLSignatureFactory
后,就可以通过调用适当的方法来实例化这些对象。例如,可以通过调用一个 newReference
方法来创建 Reference
实例。
此外,通过调用 unmarshalXMLSignature
方法,并向其传递包含 XML 内容的特定于机制的 XMLValidateContext
实例,可以从现有 XML 表示形式创建 XMLSignature
:
DOMValidateContext context = new DOMValidateContext(key, signatureElement); XMLSignature signature = factory.unmarshalXMLSignature(context);每个
XMLSignatureFactory
都必须支持该工厂类型所需的 XMLValidateContext
类型,但也可以支持其他类型。DOM XMLSignatureFactory
必须支持 DOMValidateContext
对象。
XMLSignature
对象的 sign
方法,并向其传递包含签名密钥和编组参数(参见 DOMSignContext
)的特定于机制的 XMLSignContext
对象,可以将工厂创建的每个 XMLSignature
编组为 XML 表示形式并对其进行签名。例如:
DOMSignContext context = new DOMSignContext(privateKey, document); signature.sign(context);并发访问
可保证此类的静态方法是线程安全的。多个线程可以并发调用此类中所定义的静态方法,而不会产生不良效果。
但是,对于此类所定义的非静态方法并非如此。除非具体的提供者另行指定,否则需要并发访问单个 XMLSignatureFactory
实例的多个线程应该在它们之间实现同步并提供所需的锁定。对于每个线程都操作一个不同 XMLSignatureFactory
实例的多个线程而言,无需实现同步。
构造方法摘要 | |
---|---|
protected |
XMLSignatureFactory()
默认的构造方法,由子类调用。 |
方法摘要 | |
---|---|
static XMLSignatureFactory |
getInstance()
返回支持默认的 XML 处理机制和表示形式类型(“DOM”) 的 XMLSignatureFactory 。 |
static XMLSignatureFactory |
getInstance(String mechanismType)
返回 XMLSignatureFactory ,它支持指定的 XML 处理机制和表示形式类型(比如:“DOM”)。 |
static XMLSignatureFactory |
getInstance(String mechanismType,
Provider provider)
返回支持请求的 XML 处理机制和表示形式类型(比如:“DOM”)的 XMLSignatureFactory ,由指定提供者提供。 |
static XMLSignatureFactory |
getInstance(String mechanismType,
String provider)
返回支持所需的 XML 处理机制和表示形式类型(比如:“DOM”)的 XMLSignatureFactory ,由指定提供者提供。 |
KeyInfoFactory |
getKeyInfoFactory()
返回创建 KeyInfo 对象的 KeyInfoFactory 。 |
String |
getMechanismType()
返回此 XMLSignatureFactory 支持的 XML 处理机制类型和表示形式类型(比如:“DOM”)。 |
Provider |
getProvider()
返回此 XMLSignatureFactory 的提供者。 |
abstract URIDereferencer |
getURIDereferencer()
返回对 URIDereferencer 的引用,默认情况下该引用用于取消 Reference 对象中对 URI 的引用。 |
abstract boolean |
isFeatureSupported(String feature)
指示是否支持指定的功能。 |
abstract CanonicalizationMethod |
newCanonicalizationMethod(String algorithm,
C14NMethodParameterSpec params)
针对指定的算法 URI 和参数创建 CanonicalizationMethod 。 |
abstract CanonicalizationMethod |
newCanonicalizationMethod(String algorithm,
XMLStructure params)
针对指定的算法 URI 和参数创建 CanonicalizationMethod 。 |
abstract DigestMethod |
newDigestMethod(String algorithm,
DigestMethodParameterSpec params)
针对指定的算法 URI 和参数创建 DigestMethod 。 |
abstract Manifest |
newManifest(List references)
创建包含指定的 Reference 列表的 Manifest 。 |
abstract Manifest |
newManifest(List references,
String id)
创建包含指定的 Reference 列表和可选 id 的 Manifest 。 |
abstract Reference |
newReference(String uri,
DigestMethod dm)
创建带指定 URI 和摘要方法的 Reference 。 |
abstract Reference |
newReference(String uri,
DigestMethod dm,
List appliedTransforms,
Data result,
List transforms,
String type,
String id)
创建带指定参数的 Reference 。 |
abstract Reference |
newReference(String uri,
DigestMethod dm,
List transforms,
String type,
String id)
创建带指定参数的 Reference 。 |
abstract Reference |
newReference(String uri,
DigestMethod dm,
List transforms,
String type,
String id,
byte[] digestValue)
创建带指定参数和预计算的摘要值的 Reference 。 |
abstract SignatureMethod |
newSignatureMethod(String algorithm,
SignatureMethodParameterSpec params)
针对指定的算法 URI 和参数创建 SignatureMethod 。 |
abstract SignatureProperties |
newSignatureProperties(List properties,
String id)
创建包含指定的 SignatureProperty 列表和可选 id 的 SignatureProperties 。 |
abstract SignatureProperty |
newSignatureProperty(List content,
String target,
String id)
创建包含指定的 XMLStructure 列表、目标 URI 和可选 id 的SignatureProperty 。 |
abstract SignedInfo |
newSignedInfo(CanonicalizationMethod cm,
SignatureMethod sm,
List references)
创建带指定的规范化方法和签名方法、以及一个或多个引用的列表的 SignedInfo 。 |
abstract SignedInfo |
newSignedInfo(CanonicalizationMethod cm,
SignatureMethod sm,
List references,
String id)
创建带指定参数的 SignedInfo 。 |
abstract Transform |
newTransform(String algorithm,
TransformParameterSpec params)
针对指定的算法 URI 和参数创建 Transform 。 |
abstract Transform |
newTransform(String algorithm,
XMLStructure params)
针对指定的算法 URI 和参数创建 Transform 。 |
abstract XMLObject |
newXMLObject(List content,
String id,
String mimeType,
String encoding)
根据指定参数创建 XMLObject 。 |
abstract XMLSignature |
newXMLSignature(SignedInfo si,
KeyInfo ki)
创建一个 XMLSignature ,并使用指定的 SignedInfo 和 KeyInfo 对象的内容对其进行初始化。 |
abstract XMLSignature |
newXMLSignature(SignedInfo si,
KeyInfo ki,
List objects,
String id,
String signatureValueId)
创建一个 XMLSignature ,并使用指定的参数对其进行初始化。 |
abstract XMLSignature |
unmarshalXMLSignature(XMLStructure xmlStructure)
从特定于机制的 XMLStructure 实例解组新的 XMLSignature 实例。 |
abstract XMLSignature |
unmarshalXMLSignature(XMLValidateContext context)
从特定于机制的 XMLValidateContext 实例解组新的 XMLSignature 实例。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
构造方法详细信息 |
---|
protected XMLSignatureFactory()
方法详细信息 |
---|
public static XMLSignatureFactory getInstance(String mechanismType)
XMLSignatureFactory
,它支持指定的 XML 处理机制和表示形式类型(比如:“DOM”)。
此方法使用标准的 JCA 提供者查找机制来查找并实例化所需机制类型的 XMLSignatureFactory
实现。它将从首选的 Provider
开始,遍历已注册的安全 Provider
的列表。返回取自第一个支持指定机制的 Provider
中的新 XMLSignatureFactory
对象。
注意,已注册提供者的列表可以通过 Security.getProviders()
方法获得。
mechanismType
- XML 处理机制和表示形式的类型。有关标准机制类型列表,请参阅 API 概述的 Service Providers 部分。
XMLSignatureFactory
NullPointerException
- 如果 mechanismType
为 null
NoSuchMechanismException
- 如果没有任何 Provider
支持指定机制的 XMLSignatureFactory
实现Provider
public static XMLSignatureFactory getInstance(String mechanismType, Provider provider)
XMLSignatureFactory
,由指定提供者提供。注意,指定的 Provider
对象不必已经在提供者列表中注册。
mechanismType
- XML 处理机制和表示形式的类型。有关标准机制类型列表,请参阅 API 概述的 Service Providers 部分。provider
- Provider
对象
XMLSignatureFactory
NullPointerException
- 如果 provider
或 mechanismType
为 null
NoSuchMechanismException
- 如果不能从指定的 Provider
对象得到指定机制的 XMLSignatureFactory
实现Provider
public static XMLSignatureFactory getInstance(String mechanismType, String provider) throws NoSuchProviderException
XMLSignatureFactory
,由指定提供者提供。指定的提供者必须已在安全提供者列表中注册。
注意,已注册提供者的列表可以通过 Security.getProviders()
方法获得。
mechanismType
- XML 处理机制和表示形式的类型。有关标准机制类型列表,请参阅 API 概述的 Service Providers 部分。provider
- 提供者的字符串名称
XMLSignatureFactory
NoSuchProviderException
- 如果指定的提供者没有在安全提供者列表中进行注册
NullPointerException
- 如果 provider
或 mechanismType
为 null
NoSuchMechanismException
- 如果从指定的提供者不能得到指定机制的 XMLSignatureFactory
实现Provider
public static XMLSignatureFactory getInstance()
XMLSignatureFactory
。
此方法使用标准的 JCA 提供者查找机制来查找并实例化默认机制类型的 XMLSignatureFactory
实现。它将从首选的 Provider
开始,遍历已注册的安全 Provider
的列表。返回取自第一个支持 DOM 机制的Provider
中的新 XMLSignatureFactory
对象。
注意,已注册提供者的列表可以通过 Security.getProviders()
方法获得。
XMLSignatureFactory
NoSuchMechanismException
- 如果没有任何 Provider
支持 DOM 机制的 XMLSignatureFactory
实现Provider
public final String getMechanismType()
XMLSignatureFactory
支持的 XML 处理机制类型和表示形式类型(比如:“DOM”)。
XMLSignatureFactory
支持的 XML 处理机制类型public final Provider getProvider()
XMLSignatureFactory
的提供者。
XMLSignatureFactory
的提供者public abstract XMLSignature newXMLSignature(SignedInfo si, KeyInfo ki)
XMLSignature
,并使用指定的 SignedInfo
和 KeyInfo
对象的内容对其进行初始化。
si
- 签名信息ki
- 密钥信息(可能为 null
)
XMLSignature
NullPointerException
- 如果 si
为 null
public abstract XMLSignature newXMLSignature(SignedInfo si, KeyInfo ki, List objects, String id, String signatureValueId)
XMLSignature
,并使用指定的参数对其进行初始化。
si
- 签名信息ki
- 密钥信息(可以为 null
)objects
- XMLObject
列表(可以为空或 null
)id
- Id(可以为 null
)signatureValueId
- SignatureValue Id(可以为 null
)
XMLSignature
NullPointerException
- 如果 si
为 null
ClassCastException
- 如果有些 objects
的类型不是 XMLObject
public abstract Reference newReference(String uri, DigestMethod dm)
Reference
。
uri
- 引用 URI(可以为 null
)dm
- 摘要方法
Reference
IllegalArgumentException
- 如果 uri
与 RFC 2396 不兼容
NullPointerException
- 如果 dm
为 null
public abstract Reference newReference(String uri, DigestMethod dm, List transforms, String type, String id)
Reference
。
uri
- 引用 URI(可以为 null
)dm
- 摘要方法transforms
- Transform
列表。需要复制该列表,以防止随后被修改。可以为 null
或空。type
- URI 形式的引用类型(可以为 null
)id
- 引用 ID(可以为 null
)
Reference
ClassCastException
- 如果有些 transforms
的类型不是 Transform
IllegalArgumentException
- 如果 uri
与 RFC 2396 不兼容
NullPointerException
- 如果 dm
为 null
public abstract Reference newReference(String uri, DigestMethod dm, List transforms, String type, String id, byte[] digestValue)
Reference
。
如果先前已经计算了 Reference
的摘要值,则此方法很有用。有关示例,请参阅 OASIS-DSS(数字签名服务)规范。
uri
- 引用 URI(可以为 null
)dm
- 摘要方法transforms
- Transform
列表。需要复制该列表,以防止随后被修改。可以为 null
或空。type
- URI 形式的引用类型(可以为 null
)id
- 引用 ID(可以为 null
)digestValue
- 摘要值。复制该数组,以防止随后被修改。
Reference
ClassCastException
- 如果任何 transforms
的类型不是 Transform
IllegalArgumentException
- 如果 uri
与 RFC 2396 不兼容
NullPointerException
- 如果 dm
或 digestValue
为 null
public abstract Reference newReference(String uri, DigestMethod dm, List appliedTransforms, Data result, List transforms, String type, String id)
Reference
。
在已将转换列表应用于 Reference
时,此方法很有用。例如,请参阅 OASIS-DSS(数字签名服务)规范。
生成了包含此引用的 XMLSignature
之后,将指定的 transforms
(如果为非空)应用于指定的 result
。所得 Reference
元素的 Transforms
元素被设置为 appliedTransforms
和 transforms
的串联。
uri
- 引用 URI(可以为 null
)dm
- 摘要方法appliedTransforms
- 已应用的 Transform
的列表。需要复制该列表,以防止随后被修改。列表至少必须包含一个条目。result
- 处理 appliedTransforms
的序列的结果transforms
- 生成签名时将应用的 Transform
的列表。需要复制该列表,以防止随后被修改。可以为 null
或空。type
- URI 形式的引用类型(可以为 null
)id
- 引用 ID(可以为 null
)
Reference
ClassCastException
- 如果任何转换(任一列表中)的类型不是 Transform
IllegalArgumentException
- 如果 uri
与 RFC 2396 不兼容或 appliedTransforms
为空
NullPointerException
- 如果 dm
、appliedTransforms
或 result
为 null
public abstract SignedInfo newSignedInfo(CanonicalizationMethod cm, SignatureMethod sm, List references)
SignedInfo
。
cm
- 规范化方法sm
- 签名方法references
- 一个列表,由一个或多个 Reference
组成。需要复制该列表,以防止随后被修改。
SignedInfo
ClassCastException
- 如果任何引用的类型不是 Reference
IllegalArgumentException
- 如果 references
为空
NullPointerException
- 如果任何参数为 null
public abstract SignedInfo newSignedInfo(CanonicalizationMethod cm, SignatureMethod sm, List references, String id)
SignedInfo
。
cm
- 规范化方法sm
- 签名方法references
- 一个列表,由一个或多个 Reference
组成。需要复制该列表,以防止随后被修改。id
- id(可以为 null
)
SignedInfo
ClassCastException
- 如果任何引用的类型不是 Reference
IllegalArgumentException
- 如果 references
为空
NullPointerException
- 如果 cm
、sm
或 references
为 null
public abstract XMLObject newXMLObject(List content, String id, String mimeType, String encoding)
XMLObject
。
content
- XMLStructure
的列表。需要复制该列表,以防止随后被修改。可以为 null
或空。id
- Id(可以为 null
)mimeType
- MIME 类型(可以为 null
)encoding
- 编码(可以为 null
)
XMLObject
ClassCastException
- 如果 content
包含任何类型不是 XMLStructure
的条目public abstract Manifest newManifest(List references)
Reference
列表的 Manifest
。
references
- 一个列表,由一个或多个 Reference
组成。需要复制该列表,以防止随后被修改。
Manifest
NullPointerException
- 如果 references
为 null
IllegalArgumentException
- 如果 references
为空
ClassCastException
- 如果 references
包含任何类型不是 Reference
的条目public abstract Manifest newManifest(List references, String id)
Reference
列表和可选 id 的 Manifest
。
references
- 一个列表,由一个或多个 Reference
组成。需要复制该列表,以防止随后被修改。id
- id(可以为 null
)
Manifest
NullPointerException
- 如果 references
为 null
IllegalArgumentException
- 如果 references
为空
ClassCastException
- 如果 references
包含任何类型不是 Reference
的条目public abstract SignatureProperty newSignatureProperty(List content, String target, String id)
XMLStructure
列表、目标 URI 和可选 id 的SignatureProperty
。
content
- 一个列表,由一个或多个 XMLStructure
组成。需要复制该列表,以防止随后被修改。target
- 使用此属性的 Signature 的目标 URIid
- id(可以为 null
)
SignatureProperty
NullPointerException
- 如果 content
或 target
为 null
IllegalArgumentException
- 如果 content
为空
ClassCastException
- 如果 content
包含任何类型不是 XMLStructure
的条目public abstract SignatureProperties newSignatureProperties(List properties, String id)
SignatureProperty
列表和可选 id 的 SignatureProperties
。
properties
- 一个列表,由一个或多个 SignatureProperty
组成。需要复制该列表,以防止随后被修改。id
- id(可以为 null
)
SignatureProperties
NullPointerException
- 如果 properties
为 null
IllegalArgumentException
- 如果 properties
为空
ClassCastException
- 如果 properties
包含任何类型不是 SignatureProperty
的条目public abstract DigestMethod newDigestMethod(String algorithm, DigestMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
DigestMethod
。
algorithm
- 标识摘要算法的 URIparams
- 特定于算法的摘要参数(可以为 null
)
DigestMethod
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public abstract SignatureMethod newSignatureMethod(String algorithm, SignatureMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
SignatureMethod
。
algorithm
- 标识签名算法的 URIparams
- 特定于算法的签名参数(可以为 null
)
SignatureMethod
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public abstract Transform newTransform(String algorithm, TransformParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
Transform
。
algorithm
- 标识转换算法的 URIparams
- 特定于算法的转换参数(可以为 null
)
Transform
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public abstract Transform newTransform(String algorithm, XMLStructure params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
Transform
。该参数被指定为特定于机制的 XMLStructure
(比如:DOMStructure
)。当参数是 XML 形式或没有任何用于指定参数的标准类时,此方法很有用。
algorithm
- 标识转换算法的 URIparams
- 从中解组参数的特定于机制的 XML 结构(如果该结构不是必需的或是可选的,则此参数为 null
)
Transform
ClassCastException
- 如果 params
类型不适合此 XMLSignatureFactory
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public abstract CanonicalizationMethod newCanonicalizationMethod(String algorithm, C14NMethodParameterSpec params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
CanonicalizationMethod
。
algorithm
- 标识规范化算法的 URIparams
- 特定于算法的规范化参数(可以为 null
)
CanonicalizationMethod
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public abstract CanonicalizationMethod newCanonicalizationMethod(String algorithm, XMLStructure params) throws NoSuchAlgorithmException, InvalidAlgorithmParameterException
CanonicalizationMethod
。该参数被指定为特定于机制的 XMLStructure
(比如:DOMStructure
)。当参数是 XML 形式或没有任何用于指定参数的标准类时,此方法很有用。
algorithm
- 标识规范化算法的 URIparams
- 从中解组参数的特定于机制的 XML 结构(如果该结构不是必需的或是可选的,则此参数为 null
)
CanonicalizationMethod
ClassCastException
- 如果 params
类型不适合此 XMLSignatureFactory
InvalidAlgorithmParameterException
- 如果指定的参数不适合请求的算法
NoSuchAlgorithmException
- 如果无法找到指定算法的实现
NullPointerException
- 如果 algorithm
为 null
public final KeyInfoFactory getKeyInfoFactory()
KeyInfo
对象的 KeyInfoFactory
。返回的 KeyInfoFactory
具有与此 XMLSignatureFactory
相同的机制类型和提供者。
KeyInfoFactory
NoSuchMechanismException
- 如果具有相同机制类型和提供者的 KeyFactory
实现不可用public abstract XMLSignature unmarshalXMLSignature(XMLValidateContext context) throws MarshalException
XMLValidateContext
实例解组新的 XMLSignature
实例。
context
- 从中解组签名的特定于机制的上下文
XMLSignature
NullPointerException
- 如果 context
为 null
ClassCastException
- 如果 context
类型不适合此工厂
MarshalException
- 如果解组过程中发生不可恢复的异常public abstract XMLSignature unmarshalXMLSignature(XMLStructure xmlStructure) throws MarshalException
XMLStructure
实例解组新的 XMLSignature
实例。如果只想解组(且不验证) XMLSignature
时,此方法很有用。
xmlStructure
- 从中解组签名的特定于机制的 XML 结构
XMLSignature
NullPointerException
- 如果 xmlStructure
为 null
ClassCastException
- 如果 xmlStructure
类型不适合此工厂
MarshalException
- 如果解组过程中发生不可恢复的异常。public abstract boolean isFeatureSupported(String feature)
feature
- 功能名称(作为抽象 URI)
true
,否则返回 false
NullPointerException
- 如果 feature
为 null
public abstract URIDereferencer getURIDereferencer()
URIDereferencer
的引用,默认情况下该引用用于取消 Reference
对象中对 URI 的引用。
URIDereferencer
的引用(不能为 null
)
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。