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

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

This method uses the standard JCA provider lookup mechanism to locate and instantiate a KeyInfoFactory implementation of the default mechanism type. It traverses the list of registered security Providers, starting with the most preferred Provider. A new KeyInfoFactory 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 KeyInfoFactory
Throws:
- NoSuchMechanismException - if no Provider supports a KeyInfoFactory implementation for the DOM mechanism
See Also: Provider,

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

  Returns a KeyInfoFactory 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 a KeyInfoFactory implementation of the desired mechanism type. It traverses the list of registered security Providers, starting with the most preferred Provider. A new KeyInfoFactory 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 KeyInfoFactory
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 a KeyInfoFactory implementation for the specified mechanism
See Also: Provider,

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

  Returns a KeyInfoFactory 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 KeyInfoFactory
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 mechanismType or provider are null
- NoSuchMechanismException - if a KeyInfoFactory implementation for the specified mechanism is not available from the specified Provider object
See Also: Provider,

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

  Returns a KeyInfoFactory 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 KeyInfoFactory
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 mechanismType or provider are null
- NoSuchMechanismException - if a KeyInfoFactory implementation for the specified mechanism is not available from the specified provider
See Also: Provider,

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

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

  Returns the provider of this KeyInfoFactory.

  Returns the provider of this KeyInfoFactory.
Returns: the provider of this KeyInfoFactory

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

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

  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 KeyInfo containing the specified list of key information types.

  Creates a KeyInfo containing the specified list of
key information types.
Returns: a KeyInfo
Parameters:
- content - a list of one or more {@link XMLStructure}s representing key information types. The list is defensively copied to protect against subsequent modification.
Throws:
- NullPointerException - if content is null
- IllegalArgumentException - if content is empty
- ClassCastException - if content contains any entries that are not of type {@link XMLStructure}

  Creates a KeyInfo containing the specified list of key information types and optional id.

  Creates a KeyInfo containing the specified list of key
information types and optional id. The
id parameter represents the value of an XML
ID attribute and is useful for referencing
the KeyInfo from other XML structures.
Returns: a KeyInfo
Parameters:
- content - a list of one or more {@link XMLStructure}s representing key information types. The list is defensively copied to protect against subsequent modification.
- id - the value of an XML ID (may be null)
Throws:
- NullPointerException - if content is null
- IllegalArgumentException - if content is empty
- ClassCastException - if content contains any entries that are not of type {@link XMLStructure}

  Creates a KeyName from the specified name.

  Creates a KeyName from the specified name.
Returns: a KeyName
Parameters:
- name - the name that identifies the key
Throws:
- NullPointerException - if name is null

  Creates a KeyValue from the specified public key.

  Creates a KeyValue from the specified public key.
Returns: a KeyValue
Parameters:
- key - the public key
Throws:
- KeyException - if the key's algorithm is not recognized or supported by this KeyInfoFactory
- NullPointerException - if key is null

  Creates a PGPData from the specified PGP public key identifier.

  Creates a PGPData from the specified PGP public key
identifier.
Returns: a PGPData
Parameters:
- keyId - a PGP public key identifier as defined in RFC 2440, section 11.2. The array is cloned to protect against subsequent modification.
Throws:
- NullPointerException - if keyId is null
- IllegalArgumentException - if the key id is not in the correct format

  Creates a PGPData from the specified PGP public key identifier, and optional key material packet and list of external elements.

  Creates a PGPData from the specified PGP public key
identifier, and optional key material packet and list of external
elements.
Returns: a PGPData
Parameters:
- keyId - a PGP public key identifier as defined in RFC 2440, section 11.2. The array is cloned to protect against subsequent modification.
- keyPacket - a PGP key material packet as defined in RFC 2440, section 5.5. The array is cloned to protect against subsequent modification. May be null.
- other - a list of {@link XMLStructure}s representing elements from an external namespace. The list is defensively copied to protect against subsequent modification. May be null or empty.
Throws:
- NullPointerException - if keyId is null
- IllegalArgumentException - if the keyId or keyPacket is not in the correct format. For keyPacket, the format of the packet header is checked and the tag is verified that it is of type key material. The contents and format of the packet body are not checked.
- ClassCastException - if other contains any entries that are not of type {@link XMLStructure}

  Creates a PGPData from the specified PGP key material packet and optional list of external elements.

  Creates a PGPData from the specified PGP key material
packet and optional list of external elements.
Returns: a PGPData
Parameters:
- keyPacket - a PGP key material packet as defined in RFC 2440, section 5.5. The array is cloned to protect against subsequent modification.
- other - a list of {@link XMLStructure}s representing elements from an external namespace. The list is defensively copied to protect against subsequent modification. May be null or empty.
Throws:
- NullPointerException - if keyPacket is null
- IllegalArgumentException - if keyPacket is not in the correct format. For keyPacket, the format of the packet header is checked and the tag is verified that it is of type key material. The contents and format of the packet body are not checked.
- ClassCastException - if other contains any entries that are not of type {@link XMLStructure}

  Creates a RetrievalMethod from the specified URI.

  Creates a RetrievalMethod from the specified URI.
Returns: a RetrievalMethod
Parameters:
- uri - the URI that identifies the KeyInfo information to be retrieved
Throws:
- NullPointerException - if uri is null
- IllegalArgumentException - if uri is not RFC 2396 compliant

  Creates a RetrievalMethod from the specified parameters.

  Creates a RetrievalMethod from the specified parameters.
Returns: a RetrievalMethod
Parameters:
- uri - the URI that identifies the KeyInfo information to be retrieved
- type - a URI that identifies the type of KeyInfo information to be retrieved (may be null)
- transforms - a list of {@link Transform}s. The list is defensively copied to protect against subsequent modification. May be null or empty.
Throws:
- NullPointerException - if uri is null
- IllegalArgumentException - if uri is not RFC 2396 compliant
- ClassCastException - if transforms contains any entries that are not of type {@link Transform}

  Creates a X509Data containing the specified list of X.509 content.

  Creates a X509Data containing the specified list of
X.509 content.
Returns: a X509Data
Parameters:
- content - a list of one or more X.509 content types. Valid types are {@link String} (subject names), byte[] (subject key ids), {@link java.security.cert.X509Certificate}, {@link X509CRL}, or {@link XMLStructure} ({@link X509IssuerSerial} objects or elements from an external namespace). Subject names are distinguished names in RFC 2253 String format. Implementations MUST support the attribute type keywords defined in RFC 2253 (CN, L, ST, O, OU, C, STREET, DC and UID). Implementations MAY support additional keywords. The list is defensively copied to protect against subsequent modification.
Throws:
- NullPointerException - if content is null
- IllegalArgumentException - if content is empty, or if a subject name is not RFC 2253 compliant or one of the attribute type keywords is not recognized.
- ClassCastException - if content contains any entries that are not of one of the valid types mentioned above

  Creates an X509IssuerSerial from the specified X.500 issuer distinguished name and serial number.

  Creates an X509IssuerSerial from the specified X.500 issuer
distinguished name and serial number.
Returns: an X509IssuerSerial
Parameters:
- issuerName - the issuer's distinguished name in RFC 2253 String format. Implementations MUST support the attribute type keywords defined in RFC 2253 (CN, L, ST, O, OU, C, STREET, DC and UID). Implementations MAY support additional keywords.
- serialNumber - the serial number
Throws:
- NullPointerException - if issuerName or serialNumber are null
- IllegalArgumentException - if the issuer name is not RFC 2253 compliant or one of the attribute type keywords is not recognized.

  Unmarshals a new KeyInfo instance from a mechanism-specific XMLStructure (ex: DOMStructure) instance.

  Unmarshals a new KeyInfo instance from a
mechanism-specific XMLStructure (ex: DOMStructure)
instance.
Returns: the KeyInfo
Parameters:
- xmlStructure - a mechanism-specific XML structure from which to unmarshal the keyinfo 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