模块 java.xml.crypto

包 javax.xml.crypto.dsig

接口 Transform

所有父级接口：

AlgorithmMethod , XMLStructure

所有已知的子接口：

CanonicalizationMethod

所有已知的实现类：

TransformService

public interface Transform extends XMLStructure , AlgorithmMethod 
      

W3C 对 XML 签名语法和处理的推荐 中定义的 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	描述
static final String	BASE64	Base64 转换算法 URI。
static final String	ENVELOPED	信封签名 转换算法 URI。
static final String	XPATH	XPath 转换算法 URI。
static final String	XPATH2	XPath 过滤器 2 转换算法 URI。
static final 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
            

信封签名 转换算法 URI。

参见：

• 常量字段值

XPATH

static final String  XPATH
            

XPath 转换算法 URI。

参见：

• 常量字段值

XPATH2

static final String  XPATH2
            

XPath 过滤器 2 转换算法 URI。

参见：

• 常量字段值

XSLT

static final String  XSLT
            

XSLT 转换算法 URI。

参见：

• 常量字段值

方法详情

getParameterSpec

AlgorithmParameterSpec  getParameterSpec()
            

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

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

指定者：

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