/* * 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; /** *
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 static final String getDefaultAlgorithm() {
String type;
type = AccessController.doPrivileged(new PrivilegedAction<>() {
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 KeyManagerFactory
object.
*
*
This is the same name that was specified in one of the
* getInstance
calls that created this
* KeyManagerFactory
object.
*
* @return the algorithm name of this KeyManagerFactory
object.
*/
public final String getAlgorithm() {
return this.algorithm;
}
/**
* Generates a KeyManagerFactory
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
* KeyManagerFactory
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 KeyManagerFactory
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 KeyManagerFactory
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 KeyManagerFactory
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 KeyManagerFactory
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 KeyManagerFactory
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 KeyManagerFactory
object.
*
* @return the provider of this KeyManagerFactory
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();
}
}