Module java.xml.crypto

Package javax.xml.crypto.dsig

Interface Transform

所有超级接口:

AlgorithmMethod, XMLStructure

所有已知子接口:

CanonicalizationMethod

所有已知实现类:

TransformService

       public interface Transform extends XMLStructure, AlgorithmMethod
      

XML Transform 元素的表示，如W3C XML签名语法和处理推荐标准中定义。 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	Description
static final String	BASE64	Base64 转换算法URI。
static final String	ENVELOPED	包裹签名 转换算法URI。
static final String	XPATH	XPath 转换算法URI。
static final String	XPATH2	XPath Filter 2 转换算法URI。
static final String	XSLT	XSLT 转换算法URI。

Method Summary

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

Methods declared in interface javax.xml.crypto.AlgorithmMethod

getAlgorithm

Methods declared in interface javax.xml.crypto.XMLStructure

isFeatureSupported

Field Details

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 Filter 2 转换算法URI。

另请参阅:

• 常量字段值

XSLT

             static final String XSLT
            

XSLT 转换算法URI。

另请参阅:

• 常量字段值

Method Details

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

返回:

转换后的数据（如果数据写入OutputStream参数，则为null）

抛出:

NullPointerException - 如果data或os为null

TransformException - 如果执行转换时发生错误