jdk/src/java.base/share/classes/com/sun/net/ssl/KeyManagerFactory.java
changeset 25859 3317bb8137f4
parent 14775 2ed01c760aea
child 30033 b9c86c17164a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/jdk/src/java.base/share/classes/com/sun/net/ssl/KeyManagerFactory.java	Sun Aug 17 15:54:13 2014 +0100
@@ -0,0 +1,220 @@
+/*
+ * Copyright (c) 2000, 2012, Oracle and/or its affiliates. All rights reserved.
+ * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
+ *
+ * This code is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License version 2 only, as
+ * published by the Free Software Foundation.  Oracle designates this
+ * particular file as subject to the "Classpath" exception as provided
+ * by Oracle in the LICENSE file that accompanied this code.
+ *
+ * This code is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+ * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
+ * version 2 for more details (a copy is included in the LICENSE file that
+ * accompanied this code).
+ *
+ * You should have received a copy of the GNU General Public License version
+ * 2 along with this work; if not, write to the Free Software Foundation,
+ * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
+ *
+ * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
+ * or visit www.oracle.com if you need additional information or have any
+ * questions.
+ */
+
+/*
+ * NOTE:  this file was copied from javax.net.ssl.KeyManagerFactory
+ */
+
+package com.sun.net.ssl;
+
+import java.security.*;
+
+/**
+ * This class acts as a factory for key managers based on a
+ * source of key material. Each key manager manages a specific
+ * type of key material for use by secure sockets. The key
+ * material is based on a KeyStore and/or provider specific sources.
+ *
+ * @deprecated As of JDK 1.4, this implementation-specific class was
+ *      replaced by {@link javax.net.ssl.KeyManagerFactory}.
+ */
+@Deprecated
+public class KeyManagerFactory {
+    // The provider
+    private Provider provider;
+
+    // The provider implementation (delegate)
+    private KeyManagerFactorySpi factorySpi;
+
+    // The name of the key management algorithm.
+    private String algorithm;
+
+    /**
+     * <p>The default KeyManager can be changed by setting the value of the
+     * {@code sun.ssl.keymanager.type} security property to the desired name.
+     *
+     * @return the default type as specified by the
+     * {@code sun.ssl.keymanager.type} security property, or an
+     * implementation-specific default if no such property exists.
+     *
+     * @see java.security.Security security properties
+     */
+    public final static String getDefaultAlgorithm() {
+        String type;
+        type = AccessController.doPrivileged(new PrivilegedAction<String>() {
+            public String run() {
+                return Security.getProperty("sun.ssl.keymanager.type");
+            }
+        });
+        if (type == null) {
+            type = "SunX509";
+        }
+        return type;
+
+    }
+
+    /**
+     * Creates a KeyManagerFactory object.
+     *
+     * @param factorySpi the delegate
+     * @param provider the provider
+     * @param algorithm the algorithm
+     */
+    protected KeyManagerFactory(KeyManagerFactorySpi factorySpi,
+                                Provider provider, String algorithm) {
+        this.factorySpi = factorySpi;
+        this.provider = provider;
+        this.algorithm = algorithm;
+    }
+
+    /**
+     * Returns the algorithm name of this <code>KeyManagerFactory</code> object.
+     *
+     * <p>This is the same name that was specified in one of the
+     * <code>getInstance</code> calls that created this
+     * <code>KeyManagerFactory</code> object.
+     *
+     * @return the algorithm name of this <code>KeyManagerFactory</code> object.
+     */
+    public final String getAlgorithm() {
+        return this.algorithm;
+    }
+
+    /**
+     * Generates a <code>KeyManagerFactory</code> object that implements the
+     * specified key management algorithm.
+     * If the default provider package provides an implementation of the
+     * requested key management algorithm, an instance of
+     * <code>KeyManagerFactory</code> containing that implementation is
+     * returned.  If the algorithm is not available in the default provider
+     * package, other provider packages are searched.
+     *
+     * @param algorithm the standard name of the requested
+     * algorithm.
+     *
+     * @return the new <code>KeyManagerFactory</code> object
+     *
+     * @exception NoSuchAlgorithmException if the specified algorithm is not
+     * available in the default provider package or any of the other provider
+     * packages that were searched.
+     */
+    public static final KeyManagerFactory getInstance(String algorithm)
+        throws NoSuchAlgorithmException
+    {
+        try {
+            Object[] objs = SSLSecurity.getImpl(algorithm, "KeyManagerFactory",
+                                                (String) null);
+            return new KeyManagerFactory((KeyManagerFactorySpi)objs[0],
+                                    (Provider)objs[1],
+                                    algorithm);
+        } catch (NoSuchProviderException e) {
+            throw new NoSuchAlgorithmException(algorithm + " not found");
+        }
+    }
+
+    /**
+     * Generates a <code>KeyManagerFactory</code> object for the specified
+     * key management algorithm from the specified provider.
+     *
+     * @param algorithm the standard name of the requested
+     * algorithm.
+     * @param provider the name of the provider
+     *
+     * @return the new <code>KeyManagerFactory</code> object
+     *
+     * @exception NoSuchAlgorithmException if the specified algorithm is not
+     * available from the specified provider.
+     * @exception NoSuchProviderException if the specified provider has not
+     * been configured.
+     */
+    public static final KeyManagerFactory getInstance(String algorithm,
+                                                 String provider)
+        throws NoSuchAlgorithmException, NoSuchProviderException
+    {
+        if (provider == null || provider.length() == 0)
+            throw new IllegalArgumentException("missing provider");
+        Object[] objs = SSLSecurity.getImpl(algorithm, "KeyManagerFactory",
+                                            provider);
+        return new KeyManagerFactory((KeyManagerFactorySpi)objs[0],
+                                        (Provider)objs[1], algorithm);
+    }
+
+    /**
+     * Generates a <code>KeyManagerFactory</code> object for the specified
+     * key management algorithm from the specified provider.
+     *
+     * @param algorithm the standard name of the requested
+     * algorithm.
+     * @param provider an instance of the provider
+     *
+     * @return the new <code>KeyManagerFactory</code> object
+     *
+     * @exception NoSuchAlgorithmException if the specified algorithm is not
+     * available from the specified provider.
+     */
+    public static final KeyManagerFactory getInstance(String algorithm,
+                                                 Provider provider)
+        throws NoSuchAlgorithmException
+    {
+        if (provider == null)
+            throw new IllegalArgumentException("missing provider");
+        Object[] objs = SSLSecurity.getImpl(algorithm, "KeyManagerFactory",
+                                            provider);
+        return new KeyManagerFactory((KeyManagerFactorySpi)objs[0],
+                                        (Provider)objs[1], algorithm);
+    }
+
+    /**
+     * Returns the provider of this <code>KeyManagerFactory</code> object.
+     *
+     * @return the provider of this <code>KeyManagerFactory</code> object
+     */
+    public final Provider getProvider() {
+        return this.provider;
+    }
+
+
+    /**
+     * Initializes this factory with a source of key material. The
+     * provider may also include a provider-specific source
+     * of key material.
+     *
+     * @param ks the key store or null
+     * @param password the password for recovering keys
+     */
+    public void init(KeyStore ks, char[] password)
+        throws KeyStoreException, NoSuchAlgorithmException,
+            UnrecoverableKeyException {
+        factorySpi.engineInit(ks, password);
+    }
+
+    /**
+     * Returns one key manager for each type of key material.
+     * @return the key managers
+     */
+    public KeyManager[] getKeyManagers() {
+        return factorySpi.engineGetKeyManagers();
+    }
+}