模块 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 Schema Definition定义为：

  <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)

字段汇总

字段

变量和类型	字段	描述
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。

方法摘要

变量和类型	方法	描述
AlgorithmParameterSpec	getParameterSpec()	返回与此 Transform关联的特定于算法的输入参数。
Data	transform(Data data, XMLCryptoContext context)	使用基础变换算法转换指定的数据。
Data	transform(Data data, XMLCryptoContext context, OutputStream os)	使用基础变换算法转换指定的数据。

声明方法的接口 javax.xml.crypto.AlgorithmMethod

getAlgorithm

声明方法的接口 javax.xml.crypto.XMLStructure

isFeatureSupported

字段详细信息

BASE64

static final String BASE64

Base64转换算法URI。

另请参见：

常数字段值

ENVELOPED

static final String ENVELOPED

Enveloped Signature变换算法URI。

另请参见：

常数字段值

XPATH

static final String XPATH

XPath转换算法URI。

另请参见：

常数字段值

XPATH2

static final String XPATH2

XPath Filter 2变换算法URI。

另请参见：

常数字段值

XSLT

static final String XSLT

XSLT变换算法URI。

另请参见：

常数字段值

方法详细信息

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 - 如果在执行转换时发生错误