META-INF.modules.java.base.classes.com.sun.net.ssl.SSLContext Maven / Gradle / Ivy
Show all versions of java.base Show documentation
/*
* Copyright (c) 2000, 2017, 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.SSLContext
*/
package com.sun.net.ssl;
import java.security.*;
import java.util.*;
import javax.net.ssl.*;
import sun.security.ssl.SSLSocketFactoryImpl;
import sun.security.ssl.SSLServerSocketFactoryImpl;
/**
* Instances of this class represent a secure socket protocol
* implementation which acts as a factory for secure socket
* factories. This class is initialized with an optional set of
* key and trust managers and source of secure random bytes.
*
* @deprecated As of JDK 1.4, this implementation-specific class was
* replaced by {@link javax.net.ssl.SSLContext}.
*/
@Deprecated(since="1.4")
public class SSLContext {
private Provider provider;
private SSLContextSpi contextSpi;
private String protocol;
/**
* Creates an SSLContext object.
*
* @param contextSpi the delegate
* @param provider the provider
* @param protocol the protocol
*/
protected SSLContext(SSLContextSpi contextSpi, Provider provider,
String protocol) {
this.contextSpi = contextSpi;
this.provider = provider;
this.protocol = protocol;
}
/**
* Generates a SSLContext object that implements the
* specified secure socket protocol.
*
* @param protocol the standard name of the requested protocol.
*
* @return the new SSLContext object
*
* @exception NoSuchAlgorithmException if the specified protocol is not
* available in the default provider package or any of the other provider
* packages that were searched.
*/
public static SSLContext getInstance(String protocol)
throws NoSuchAlgorithmException
{
try {
Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",
(String) null);
return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],
protocol);
} catch (NoSuchProviderException e) {
throw new NoSuchAlgorithmException(protocol + " not found");
}
}
/**
* Generates a SSLContext object that implements the
* specified secure socket protocol.
*
* @param protocol the standard name of the requested protocol.
* @param provider the name of the provider
*
* @return the new SSLContext object
*
* @exception NoSuchAlgorithmException if the specified protocol is not
* available from the specified provider.
* @exception NoSuchProviderException if the specified provider has not
* been configured.
*/
public static SSLContext getInstance(String protocol, String provider)
throws NoSuchAlgorithmException, NoSuchProviderException
{
if (provider == null || provider.length() == 0)
throw new IllegalArgumentException("missing provider");
Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",
provider);
return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],
protocol);
}
/**
* Generates a SSLContext object that implements the
* specified secure socket protocol.
*
* @param protocol the standard name of the requested protocol.
* @param provider an instance of the provider
*
* @return the new SSLContext object
*
* @exception NoSuchAlgorithmException if the specified protocol is not
* available from the specified provider.
*/
public static SSLContext getInstance(String protocol, Provider provider)
throws NoSuchAlgorithmException
{
if (provider == null)
throw new IllegalArgumentException("missing provider");
Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",
provider);
return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],
protocol);
}
/**
* Returns the protocol name of this SSLContext object.
*
* This is the same name that was specified in one of the
* getInstance calls that created this
* SSLContext object.
*
* @return the protocol name of this SSLContext object.
*/
public final String getProtocol() {
return this.protocol;
}
/**
* Returns the provider of this SSLContext object.
*
* @return the provider of this SSLContext object
*/
public final Provider getProvider() {
return this.provider;
}
/**
* Initializes this context. Either of the first two parameters
* may be null in which case the installed security providers will
* be searched for the highest priority implementation of the
* appropriate factory. Likewise, the secure random parameter may
* be null in which case the default implementation will be used.
*
* @param km the sources of authentication keys or null
* @param tm the sources of peer authentication trust decisions or null
* @param random the source of randomness for this generator or null
*/
public final void init(KeyManager[] km, TrustManager[] tm,
SecureRandom random)
throws KeyManagementException {
contextSpi.engineInit(km, tm, random);
}
/**
* Returns a SocketFactory object for this
* context.
*
* @return the factory
*/
public final SSLSocketFactory getSocketFactory() {
return contextSpi.engineGetSocketFactory();
}
/**
* Returns a ServerSocketFactory object for
* this context.
*
* @return the factory
*/
public final SSLServerSocketFactory getServerSocketFactory() {
return contextSpi.engineGetServerSocketFactory();
}
}