Module java.xml.crypto

软件包 javax.xml.crypto.dsig

Interface Transform

All Superinterfaces:

AlgorithmMethod ， XMLStructure

All Known Subinterfaces:

CanonicalizationMethod

所有已知实现类：

TransformService

public interface Transform
extends XMLStructure, AlgorithmMethod

Transform中定义的XML Transform元素的表示 。 XML模式定义定义为：

  <element name="Transform" type="ds:TransformType"/>
   <complexType name="TransformType" mixed="true">
     <choice minOccurs="0" maxOccurs="unbounded">
       <any namespace="##other" processContents="lax"/>
       <!-- (1,1) elements from (0,unbounded) namespaces -->
       <element name="XPath" type="string"/>
     </choice>
     <attribute name="Algorithm" type="anyURI" use="required"/>
   </complexType> 

可以通过调用XMLSignatureFactory类的newTransform方法来创建一个Transform实例。

从以下版本开始：

1.6

另请参见：

XMLSignatureFactory.newTransform(String, TransformParameterSpec)

Field Summary

Fields

Modifier and Type	Field	描述
static String	BASE64	Base64转换算法的URI。
static String	ENVELOPED	Enveloped Signature转换算法URI。
static String	XPATH	XPath转换算法的URI。
static String	XPATH2	XPath Filter 2转换算法URI。
static String	XSLT	XSLT转换算法的URI。

方法摘要

Modifier and Type	方法	描述
AlgorithmParameterSpec	getParameterSpec()	返回与此 Transform相关联的特定于算法的输入参数。
Data	transform(Data data, XMLCryptoContext context)	使用底层变换算法转换指定的数据。
Data	transform(Data data, XMLCryptoContext context, OutputStream os)	使用底层变换算法转换指定的数据。

Methods inherited from interface javax.xml.crypto.AlgorithmMethod

getAlgorithm

Methods inherited from interface javax.xml.crypto.XMLStructure

isFeatureSupported

字段详细信息

BASE64

static final String BASE64

Base64转换算法URI。

另请参见：

Constant Field Values

ENVELOPED

static final String ENVELOPED

Enveloped Signature转换算法URI。

另请参见：

Constant Field Values

XPATH

static final String XPATH

XPath转换算法的URI。

另请参见：

Constant Field Values

XPATH2

static final String XPATH2

XPath Filter 2变换算法的URI。

另请参见：

Constant Field Values

XSLT

static final String XSLT

XSLT转换算法URI。

另请参见：

Constant Field Values

方法详细信息

getParameterSpec

AlgorithmParameterSpec getParameterSpec()

返回与该Transform相关联的特定于算法的输入参数。

返回的参数可以类型转换为TransformParameterSpec对象。

Specified by:

getParameterSpec在接口 AlgorithmMethod

结果

算法特定的输入参数（如果未指定，可以是 null ）

transform

Data transform(Data data,
               XMLCryptoContext context)
        throws TransformException

使用底层变换算法转换指定的数据。

参数

data - 要转换的数据

context - 包含附加上下文的 XMLCryptoContext （如果不适用，可能为 null ）

结果

转换后的数据

异常

NullPointerException - 如果 data是 null

TransformException - 执行变换时是否发生错误

transform

Data transform(Data data,
               XMLCryptoContext context,
               OutputStream os)
        throws TransformException

使用底层变换算法转换指定的数据。 如果此转换的输出为OctetStreamData ，则此方法返回null ，并将字节写入指定的OutputStream 。 否则， OutputStream被忽略，该方法的行为就像调用transform(Data, XMLCryptoContext)一样。

参数

data - 要转换的数据

context - 包含附加上下文的 XMLCryptoContext （如果不适用，可能为 null ）

os - 应该用于写入转换后的数据的 OutputStream

结果

转换的数据（或 null如果数据写入 OutputStream参数）

异常

NullPointerException - 如果 data或 os是 null

TransformException - 执行变换时是否发生错误