Returns an XMLSignatureFactory that supports the default XML processing mechanism and representation type ("DOM").

  Returns an XMLSignatureFactory that supports the default XML processing mechanism and representation type ("DOM").

This method uses the standard JCA provider lookup mechanism to locate and instantiate an XMLSignatureFactory implementation of the default mechanism type. It traverses the list of registered security Providers, starting with the most preferred Provider. A new XMLSignatureFactory object from the first Provider that supports the DOM mechanism is returned.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.
Returns: a new XMLSignatureFactory
Throws:
- NoSuchMechanismException - if no Provider supports an XMLSignatureFactory implementation for the DOM mechanism
See Also: Provider,

  Returns an XMLSignatureFactory that supports the specified XML processing mechanism and representation type (ex: "DOM").

  Returns an XMLSignatureFactory that supports the specified XML processing mechanism and representation type (ex: "DOM").

This method uses the standard JCA provider lookup mechanism to locate and instantiate an XMLSignatureFactory implementation of the desired mechanism type. It traverses the list of registered security Providers, starting with the most preferred Provider. A new XMLSignatureFactory object from the first Provider that supports the specified mechanism is returned.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.
Returns: a new XMLSignatureFactory
Parameters:
- mechanismType - the type of the XML processing mechanism and representation. See the Service Providers section of the API overview for a list of standard mechanism types.
Throws:
- NullPointerException - if mechanismType is null
- NoSuchMechanismException - if no Provider supports an XMLSignatureFactory implementation for the specified mechanism
See Also: Provider,

  Returns an XMLSignatureFactory that supports the requested XML processing mechanism and representation type (ex: "DOM"), as supplied by the specified provider.

  Returns an XMLSignatureFactory that supports the
requested XML processing mechanism and representation type (ex: "DOM"),
as supplied by the specified provider. Note that the specified
Provider object does not have to be registered in the
provider list.
Returns: a new XMLSignatureFactory
Parameters:
- mechanismType - the type of the XML processing mechanism and representation. See the Service Providers section of the API overview for a list of standard mechanism types.
- provider - the Provider object
Throws:
- NullPointerException - if provider or mechanismType is null
- NoSuchMechanismException - if an XMLSignatureFactory implementation for the specified mechanism is not available from the specified Provider object
See Also: Provider,

  Returns an XMLSignatureFactory that supports the requested XML processing mechanism and representation type (ex: "DOM"), as supplied by the specified provider.

  Returns an XMLSignatureFactory that supports the requested XML processing mechanism and representation type (ex: "DOM"), as supplied by the specified provider. The specified provider must be registered in the security provider list.

Note that the list of registered providers may be retrieved via the Security.getProviders() method.
Returns: a new XMLSignatureFactory
Parameters:
- mechanismType - the type of the XML processing mechanism and representation. See the Service Providers section of the API overview for a list of standard mechanism types.
- provider - the string name of the provider
Throws:
- NoSuchProviderException - if the specified provider is not registered in the security provider list
- NullPointerException - if provider or mechanismType is null
- NoSuchMechanismException - if an XMLSignatureFactory implementation for the specified mechanism is not available from the specified provider
See Also: Provider,

  Returns a KeyInfoFactory that creates KeyInfo objects.

  Returns a KeyInfoFactory that creates KeyInfo
objects. The returned KeyInfoFactory has the same
mechanism type and provider as this XMLSignatureFactory.
Returns: a KeyInfoFactory
Throws:
- NoSuchMechanismException - if a KeyFactory implementation with the same mechanism type and provider is not available

  Returns the type of the XML processing mechanism and representation supported by this XMLSignatureFactory (ex: "DOM").

  Returns the type of the XML processing mechanism and representation
supported by this XMLSignatureFactory (ex: "DOM").
Returns: the XML processing mechanism type supported by this XMLSignatureFactory

  Returns the provider of this XMLSignatureFactory.

  Returns the provider of this XMLSignatureFactory.
Returns: the provider of this XMLSignatureFactory

  Returns a reference to the URIDereferencer that is used by default to dereference URIs in Reference objects.

  Returns a reference to the URIDereferencer that is used by
default to dereference URIs in Reference objects.
Returns: a reference to the default URIDereferencer (never null)

  Indicates whether a specified feature is supported.

  Indicates whether a specified feature is supported.
Returns: true if the specified feature is supported, false otherwise
Parameters:
- feature - the feature name (as an absolute URI)
Throws:
- NullPointerException - if feature is null

  Creates a CanonicalizationMethod for the specified algorithm URI and parameters.

  Creates a CanonicalizationMethod for the specified
algorithm URI and parameters.
Returns: the CanonicalizationMethod
Parameters:
- algorithm - the URI identifying the canonicalization algorithm
- params - algorithm-specific canonicalization parameters (may be null)
Throws:
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates a CanonicalizationMethod for the specified algorithm URI and parameters.

  Creates a CanonicalizationMethod for the specified
algorithm URI and parameters. The parameters are specified as a
mechanism-specific XMLStructure (ex: DOMStructure).
This method is useful when the parameters are in XML form or there is
no standard class for specifying the parameters.
Returns: the CanonicalizationMethod
Parameters:
- algorithm - the URI identifying the canonicalization algorithm
- params - a mechanism-specific XML structure from which to unmarshal the parameters from (may be null if not required or optional)
Throws:
- ClassCastException - if the type of params is inappropriate for this XMLSignatureFactory
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates a DigestMethod for the specified algorithm URI and parameters.

  Creates a DigestMethod for the specified algorithm URI
and parameters.
Returns: the DigestMethod
Parameters:
- algorithm - the URI identifying the digest algorithm
- params - algorithm-specific digest parameters (may be null)
Throws:
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates a Manifest containing the specified list of References.

  Creates a Manifest containing the specified
list of References.
Returns: a Manifest
Parameters:
- references - a list of one or more References. The list is defensively copied to protect against subsequent modification.
Throws:
- NullPointerException - if references is null
- IllegalArgumentException - if references is empty
- ClassCastException - if references contains any entries that are not of type {@link Reference}

  Creates a Manifest containing the specified list of References and optional id.

  Creates a Manifest containing the specified
list of References and optional id.
Returns: a Manifest
Parameters:
- references - a list of one or more References. The list is defensively copied to protect against subsequent modification.
- id - the id (may be null)
Throws:
- NullPointerException - if references is null
- IllegalArgumentException - if references is empty
- ClassCastException - if references contains any entries that are not of type {@link Reference}

  Creates a Reference with the specified URI and digest method.

  Creates a Reference with the specified URI and digest
method.
Returns: a Reference
Parameters:
- uri - the reference URI (may be null)
- dm - the digest method
Throws:
- IllegalArgumentException - if uri is not RFC 2396 compliant
- NullPointerException - if dm is null

  Creates a Reference with the specified parameters.

  Creates a Reference with the specified parameters.

This method is useful when a list of transforms have already been applied to the Reference. See for example, the OASIS-DSS (Digital Signature Services) specification.

When an XMLSignature containing this reference is generated, the specified transforms (if non-null) are applied to the specified result. The Transforms element of the resulting Reference element is set to the concatenation of the appliedTransforms and transforms.
Returns: a Reference
Parameters:
- uri - the reference URI (may be null)
- dm - the digest method
- appliedTransforms - a list of {@link Transform}s that have already been applied. The list is defensively copied to protect against subsequent modification. The list must contain at least one entry.
- result - the result of processing the sequence of appliedTransforms
- transforms - a list of {@link Transform}s that are to be applied when generating the signature. The list is defensively copied to protect against subsequent modification. May be null or empty.
- type - the reference type, as a URI (may be null)
- id - the reference ID (may be null)
Throws:
- ClassCastException - if any of the transforms (in either list) are not of type Transform
- IllegalArgumentException - if uri is not RFC 2396 compliant or appliedTransforms is empty
- NullPointerException - if dm, appliedTransforms or result is null

  Creates a Reference with the specified parameters.

  Creates a Reference with the specified parameters.
Returns: a Reference
Parameters:
- uri - the reference URI (may be null)
- dm - the digest method
- transforms - a list of {@link Transform}s. The list is defensively copied to protect against subsequent modification. May be null or empty.
- type - the reference type, as a URI (may be null)
- id - the reference ID (may be null)
Throws:
- ClassCastException - if any of the transforms are not of type Transform
- IllegalArgumentException - if uri is not RFC 2396 compliant
- NullPointerException - if dm is null

  Creates a Reference with the specified parameters and pre-calculated digest value.

  Creates a Reference with the specified parameters and pre-calculated digest value.

This method is useful when the digest value of a Reference has been previously computed. See for example, the OASIS-DSS (Digital Signature Services) specification.
Returns: a Reference
Parameters:
- uri - the reference URI (may be null)
- dm - the digest method
- transforms - a list of {@link Transform}s. The list is defensively copied to protect against subsequent modification. May be null or empty.
- type - the reference type, as a URI (may be null)
- id - the reference ID (may be null)
- digestValue - the digest value. The array is cloned to protect against subsequent modification.
Throws:
- ClassCastException - if any of the transforms are not of type Transform
- IllegalArgumentException - if uri is not RFC 2396 compliant
- NullPointerException - if dm or digestValue is null

  Creates a SignatureMethod for the specified algorithm URI and parameters.

  Creates a SignatureMethod for the specified algorithm URI
and parameters.
Returns: the SignatureMethod
Parameters:
- algorithm - the URI identifying the signature algorithm
- params - algorithm-specific signature parameters (may be null)
Throws:
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates a SignatureProperties containing the specified list of SignaturePropertys and optional id.

  Creates a SignatureProperties containing the specified
list of SignaturePropertys and optional id.
Returns: a SignatureProperties
Parameters:
- properties - a list of one or more SignaturePropertys. The list is defensively copied to protect against subsequent modification.
- id - the id (may be null)
Throws:
- NullPointerException - if properties is null
- IllegalArgumentException - if properties is empty
- ClassCastException - if properties contains any entries that are not of type {@link SignatureProperty}

  Creates a SignatureProperty containing the specified list of XMLStructures, target URI and optional id.

  Creates a SignatureProperty containing the specified
list of XMLStructures, target URI and optional id.
Returns: a SignatureProperty
Parameters:
- content - a list of one or more XMLStructures. The list is defensively copied to protect against subsequent modification.
- target - the target URI of the Signature that this property applies to
- id - the id (may be null)
Throws:
- NullPointerException - if content or target is null
- IllegalArgumentException - if content is empty
- ClassCastException - if content contains any entries that are not of type {@link XMLStructure}

  Creates a SignedInfo with the specified canonicalization and signature methods, and list of one or more references.

  Creates a SignedInfo with the specified canonicalization
and signature methods, and list of one or more references.
Returns: a SignedInfo
Parameters:
- cm - the canonicalization method
- sm - the signature method
- references - a list of one or more {@link Reference}s. The list is defensively copied to protect against subsequent modification.
Throws:
- ClassCastException - if any of the references are not of type Reference
- IllegalArgumentException - if references is empty
- NullPointerException - if any of the parameters are null

  Creates a SignedInfo with the specified parameters.

  Creates a SignedInfo with the specified parameters.
Returns: a SignedInfo
Parameters:
- cm - the canonicalization method
- sm - the signature method
- references - a list of one or more {@link Reference}s. The list is defensively copied to protect against subsequent modification.
- id - the id (may be null)
Throws:
- ClassCastException - if any of the references are not of type Reference
- IllegalArgumentException - if references is empty
- NullPointerException - if cm, sm, or references are null

  Creates a Transform for the specified algorithm URI and parameters.

  Creates a Transform for the specified algorithm URI
and parameters.
Returns: the Transform
Parameters:
- algorithm - the URI identifying the transform algorithm
- params - algorithm-specific transform parameters (may be null)
Throws:
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates a Transform for the specified algorithm URI and parameters.

  Creates a Transform for the specified algorithm URI
and parameters. The parameters are specified as a mechanism-specific
XMLStructure (ex: DOMStructure). This method is
useful when the parameters are in XML form or there is no standard
class for specifying the parameters.
Returns: the Transform
Parameters:
- algorithm - the URI identifying the transform algorithm
- params - a mechanism-specific XML structure from which to unmarshal the parameters from (may be null if not required or optional)
Throws:
- ClassCastException - if the type of params is inappropriate for this XMLSignatureFactory
- InvalidAlgorithmParameterException - if the specified parameters are inappropriate for the requested algorithm
- NoSuchAlgorithmException - if an implementation of the specified algorithm cannot be found
- NullPointerException - if algorithm is null

  Creates an XMLObject from the specified parameters.

  Creates an XMLObject from the specified parameters.
Returns: an XMLObject
Parameters:
- content - a list of {@link XMLStructure}s. The list is defensively copied to protect against subsequent modification. May be null or empty.
- id - the Id (may be null)
- mimeType - the mime type (may be null)
- encoding - the encoding (may be null)
Throws:
- ClassCastException - if content contains any entries that are not of type {@link XMLStructure}

  Creates an XMLSignature and initializes it with the contents of the specified SignedInfo and KeyInfo objects.

  Creates an XMLSignature and initializes it with the contents
of the specified SignedInfo and KeyInfo
objects.
Returns: an XMLSignature
Parameters:
- si - the signed info
- ki - the key info (may be null)
Throws:
- NullPointerException - if si is null

  Creates an XMLSignature and initializes it with the specified parameters.

  Creates an XMLSignature and initializes it with the
specified parameters.
Returns: an XMLSignature
Parameters:
- si - the signed info
- ki - the key info (may be null)
- objects - a list of {@link XMLObject}s (may be empty or null)
- id - the Id (may be null)
- signatureValueId - the SignatureValue Id (may be null)
Throws:
- NullPointerException - if si is null
- ClassCastException - if any of the objects are not of type XMLObject

  Unmarshals a new XMLSignature instance from a mechanism-specific XMLStructure instance.

  Unmarshals a new XMLSignature instance from a
mechanism-specific XMLStructure instance.
This method is useful if you only want to unmarshal (and not
validate) an XMLSignature.
Returns: the XMLSignature
Parameters:
- xmlStructure - a mechanism-specific XML structure from which to unmarshal the signature from
Throws:
- NullPointerException - if xmlStructure is null
- ClassCastException - if the type of xmlStructure is inappropriate for this factory
- MarshalException - if an unrecoverable exception occurs during unmarshalling

  Unmarshals a new XMLSignature instance from a mechanism-specific XMLValidateContext instance.

  Unmarshals a new XMLSignature instance from a
mechanism-specific XMLValidateContext instance.
Returns: the XMLSignature
Parameters:
- context - a mechanism-specific context from which to unmarshal the signature from
Throws:
- NullPointerException - if context is null
- ClassCastException - if the type of context is inappropriate for this factory
- MarshalException - if an unrecoverable exception occurs during unmarshalling