dsig/keyinfo/KeyInfoFactory.java

26  * $Id: KeyInfoFactory.java,v 1.12 2005/05/10 16:35:35 mullan Exp $
53  * <p>Each instance of <code>KeyInfoFactory</code> supports a specific
54  * XML mechanism type. To create a <code>KeyInfoFactory</code>, call one of the
59  *   KeyInfoFactory factory = KeyInfoFactory.getInstance("DOM");
70  * <p><code>KeyInfoFactory</code> implementations are registered and loaded
75  *     put("KeyInfoFactory.DOM", "org.example.DOMKeyInfoFactory");
84  * <p>Note that a caller must use the same <code>KeyInfoFactory</code>
97  * need to access a single <code>KeyInfoFactory</code> instance concurrently
99  * Multiple threads each manipulating a different <code>KeyInfoFactory</code>
106 public abstract class KeyInfoFactory {
114     protected KeyInfoFactory() {}
117      * Returns a <code>KeyInfoFactory</code> that supports the
121      * locate and instantiate a <code>KeyInfoFactory</code> implementation of
124      * <code>Provider</code>. A new <code>KeyInfoFactory</code> object
144      * @return a new <code>KeyInfoFactory</code>
148      *    <code>KeyInfoFactory</code> implementation for the specified mechanism
151     public static KeyInfoFactory getInstance(String mechanismType) {
157             Service s = p.getService("KeyInfoFactory", mechanismType);
165                 if (obj instanceof KeyInfoFactory) {
166                     KeyInfoFactory factory = (KeyInfoFactory) obj;
178      * Returns a <code>KeyInfoFactory</code> that supports the
190      * @return a new <code>KeyInfoFactory</code>
193      * @throws NoSuchMechanismException if a <code>KeyInfoFactory</code>
198     public static KeyInfoFactory getInstance(String mechanismType,
206         Service s = provider.getService("KeyInfoFactory", mechanismType);
215             if (obj instanceof KeyInfoFactory) {
216                 KeyInfoFactory factory = (KeyInfoFactory) obj;
227      * Returns a <code>KeyInfoFactory</code> that supports the
241      * @return a new <code>KeyInfoFactory</code>
246      * @throws NoSuchMechanismException if a <code>KeyInfoFactory</code>
251     public static KeyInfoFactory getInstance(String mechanismType,
265         Service s = p.getService("KeyInfoFactory", mechanismType);
273             if (obj instanceof KeyInfoFactory) {
274                 KeyInfoFactory factory = (KeyInfoFactory) obj;
285      * Returns a <code>KeyInfoFactory</code> that supports the
289      * locate and instantiate a <code>KeyInfoFactory</code> implementation of
292      * <code>Provider</code>.  A new <code>KeyInfoFactory</code> object
307      * @return a new <code>KeyInfoFactory</code>
309      *    <code>KeyInfoFactory</code> implementation for the DOM mechanism
312     public static KeyInfoFactory getInstance() {
318      * supported by this <code>KeyInfoFactory</code> (ex: "DOM")
321      *    <code>KeyInfoFactory</code>
328      * Returns the provider of this <code>KeyInfoFactory</code>.
330      * @return the provider of this <code>KeyInfoFactory</code>
386      *    recognized or supported by this <code>KeyInfoFactory</code>