java.lang.ObjectA factory for creating KeyInfo objects from scratch or for unmarshalling ajavax.xml.crypto.dsig.keyinfo.KeyInfoFactory
KeyInfo
object from a corresponding XML
representation.
Each instance of KeyInfoFactory
supports a specific
XML mechanism type. To create a KeyInfoFactory
, call one of the
static getInstance methods, passing in the XML
mechanism type desired, for example:
KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
The objects that this factory produces will be based on DOM and abide by the DOM interoperability requirements as defined in the DOM Mechanism Requirements section of the API overview. See the Service Providers section of the API overview for a list of standard mechanism types.
KeyInfoFactory
implementations are registered and loaded
using the java.security.Provider mechanism.
For example, a service provider that supports the
DOM mechanism would be specified in the Provider
subclass as:
put("KeyInfoFactory.DOM", "org.example.DOMKeyInfoFactory");
Also, the XMLStructure
s that are created by this factory
may contain state specific to the KeyInfo
and are not
intended to be reusable.
An implementation MUST minimally support the default mechanism type: DOM.
Note that a caller must use the same KeyInfoFactory
instance to create the XMLStructure
s of a particular
KeyInfo
object. The behavior is undefined if
XMLStructure
s from different providers or different mechanism
types are used together.
Concurrent Access
The static methods of this class are guaranteed to be thread-safe. Multiple threads may concurrently invoke the static methods defined in this class with no ill effects.
However, this is not true for the non-static methods defined by this
class. Unless otherwise documented by a specific provider, threads that
need to access a single KeyInfoFactory
instance concurrently
should synchronize amongst themselves and provide the necessary locking.
Multiple threads each manipulating a different KeyInfoFactory
instance need not synchronize.
Sean
- MullanJSR
- 105 Expert Group1.6
- Constructor: |
---|
|
Method from javax.xml.crypto.dsig.keyinfo.KeyInfoFactory Summary: |
---|
getInstance, getInstance, getInstance, getInstance, getMechanismType, getProvider, getURIDereferencer, isFeatureSupported, newKeyInfo, newKeyInfo, newKeyName, newKeyValue, newPGPData, newPGPData, newPGPData, newRetrievalMethod, newRetrievalMethod, newX509Data, newX509IssuerSerial, unmarshalKeyInfo |
Methods from java.lang.Object: |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Method from javax.xml.crypto.dsig.keyinfo.KeyInfoFactory Detail: |
---|
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 Note that the list of registered providers may be retrieved via the Security.getProviders() method. |
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 Note that the list of registered providers may be retrieved via the Security.getProviders() method. |
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. |
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. |
KeyInfoFactory (ex: "DOM") |
KeyInfoFactory . |
URIDereferencer that is used by
default to dereference URIs in RetrievalMethod objects. |
|
KeyInfo containing the specified list of
key information types. |
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. |
KeyName from the specified name. |
KeyValue from the specified public key. |
PGPData from the specified PGP public key
identifier. |
PGPData from the specified PGP key material
packet and optional list of external elements. |
PGPData from the specified PGP public key
identifier, and optional key material packet and list of external
elements. |
RetrievalMethod from the specified URI. |
RetrievalMethod from the specified parameters. |
X509Data containing the specified list of
X.509 content. |
X509IssuerSerial from the specified X.500 issuer
distinguished name and serial number. |
KeyInfo instance from a
mechanism-specific XMLStructure (ex: DOMStructure )
instance. |