compact3
javax.xml.crypto.dsig
Interface Transform
-
- All Superinterfaces:
- AlgorithmMethod, XMLStructure
- All Known Subinterfaces:
- CanonicalizationMethod
- All Known Implementing Classes:
- TransformService
public interface Transform extends XMLStructure, AlgorithmMethod
A representation of the XMLTransform
element as defined in the W3C Recommendation for XML-Signature Syntax and Processing. The XML Schema Definition is defined as:<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>
ATransform
instance may be created by invoking thenewTransform
method of theXMLSignatureFactory
class.- Since:
- 1.6
- See Also:
-
XMLSignatureFactory.newTransform(String, TransformParameterSpec)
-
-
Field Summary
Fields Modifier and Type Field and Description static String
BASE64
The Base64 transform algorithm URI.static String
ENVELOPED
The Enveloped Signature transform algorithm URI.static String
XPATH
The XPath transform algorithm URI.static String
XPATH2
The XPath Filter 2 transform algorithm URI.static String
XSLT
The XSLT transform algorithm URI.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method and Description AlgorithmParameterSpec
getParameterSpec()
Returns the algorithm-specific input parameters associated with thisTransform
.Data
transform(Data data, XMLCryptoContext context)
Transforms the specified data using the underlying transform algorithm.Data
transform(Data data, XMLCryptoContext context, OutputStream os)
Transforms the specified data using the underlying transform algorithm.-
Methods inherited from interface javax.xml.crypto.XMLStructure
isFeatureSupported
-
Methods inherited from interface javax.xml.crypto.AlgorithmMethod
getAlgorithm
-
-
-
-
Field Detail
BASE64
static final String BASE64
The Base64 transform algorithm URI.- See Also:
- Constant Field Values
ENVELOPED
static final String ENVELOPED
The Enveloped Signature transform algorithm URI.- See Also:
- Constant Field Values
XPATH
static final String XPATH
The XPath transform algorithm URI.- See Also:
- Constant Field Values
XPATH2
static final String XPATH2
The XPath Filter 2 transform algorithm URI.- See Also:
- Constant Field Values
XSLT
static final String XSLT
The XSLT transform algorithm URI.- See Also:
- Constant Field Values
-
Method Detail
getParameterSpec
AlgorithmParameterSpec getParameterSpec()
Returns the algorithm-specific input parameters associated with thisTransform
.The returned parameters can be typecast to a
TransformParameterSpec
object.- Specified by:
-
getParameterSpec
in interfaceAlgorithmMethod
- Returns:
-
the algorithm-specific input parameters (may be
null
if not specified)
transform
Data transform(Data data, XMLCryptoContext context) throws TransformException
Transforms the specified data using the underlying transform algorithm.- Parameters:
-
data
- the data to be transformed -
context
- theXMLCryptoContext
containing additional context (may benull
if not applicable) - Returns:
- the transformed data
- Throws:
-
NullPointerException
- ifdata
isnull
-
TransformException
- if an error occurs while executing the transform
transform
Data transform(Data data, XMLCryptoContext context, OutputStream os) throws TransformException
Transforms the specified data using the underlying transform algorithm. If the output of this transform is anOctetStreamData
, then this method returnsnull
and the bytes are written to the specifiedOutputStream
. Otherwise, theOutputStream
is ignored and the method behaves as iftransform(Data, XMLCryptoContext)
were invoked.- Parameters:
-
data
- the data to be transformed -
context
- theXMLCryptoContext
containing additional context (may benull
if not applicable) -
os
- theOutputStream
that should be used to write the transformed data to - Returns:
-
the transformed data (or
null
if the data was written to theOutputStream
parameter) - Throws:
-
NullPointerException
- ifdata
oros
isnull
-
TransformException
- if an error occurs while executing the transform
-
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2022, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.