-
- 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
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 transformedcontext
- 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 transformedcontext
- 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
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/xml/crypto/dsig/Transform.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.