javax.xml.crypto.dsig
介面 Transform

所有父級介面：

AlgorithmMethod, XMLStructure

所有已知子介面：

CanonicalizationMethod

所有已知實作類別：

TransformService

public interface Transform
extends XMLStructure, AlgorithmMethod

W3C Recommendation for XML-Signature Syntax and Processing 中定義的 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.XMLStructure 繼承的方法

isFeatureSupported

從介面 javax.xml.crypto.AlgorithmMethod 繼承的方法

getAlgorithm

欄位詳細資訊

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 物件。

指定者：

介面 AlgorithmMethod 中的 getParameterSpec

返回：

特定於演算法的輸入參數（如果未指定，則返回 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 - 如果執行轉換時出現錯誤