1 /*

     2  * Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.

     3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

     4  *

     5  * This code is free software; you can redistribute it and/or modify it

     6  * under the terms of the GNU General Public License version 2 only, as

     7  * published by the Free Software Foundation.  Oracle designates this

     8  * particular file as subject to the "Classpath" exception as provided

     9  * by Oracle in the LICENSE file that accompanied this code.

    10  *

    11  * This code is distributed in the hope that it will be useful, but WITHOUT

    12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

    13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

    14  * version 2 for more details (a copy is included in the LICENSE file that

    15  * accompanied this code).

    16  *

    17  * You should have received a copy of the GNU General Public License version

    18  * 2 along with this work; if not, write to the Free Software Foundation,

    19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

    20  *

    21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

    22  * or visit www.oracle.com if you need additional information or have any

    23  * questions.

    24  */

    25 

    26 /*

    27  * NOTE:  this file was copied from javax.net.ssl.SSLContext

    28  */

    29 

    30 package com.sun.net.ssl;

    31 

    32 import java.security.*;

    33 import java.util.*;

    34 import javax.net.ssl.*;

    35 

    36 import sun.security.ssl.SSLSocketFactoryImpl;

    37 import sun.security.ssl.SSLServerSocketFactoryImpl;

    38 

    39 /**

    40  * Instances of this class represent a secure socket protocol

    41  * implementation which acts as a factory for secure socket

    42  * factories. This class is initialized with an optional set of

    43  * key and trust managers and source of secure random bytes.

    44  *

    45  * @deprecated As of JDK 1.4, this implementation-specific class was

    46  *      replaced by {@link javax.net.ssl.SSLContext}.

    47  */

    48 @Deprecated(since="1.4")

    49 public class SSLContext {

    50     private Provider provider;

    51 

    52     private SSLContextSpi contextSpi;

    53 

    54     private String protocol;

    55 

    56     /**

    57      * Creates an SSLContext object.

    58      *

    59      * @param contextSpi the delegate

    60      * @param provider the provider

    61      * @param protocol the protocol

    62      */

    63     protected SSLContext(SSLContextSpi contextSpi, Provider provider,

    64         String protocol) {

    65         this.contextSpi = contextSpi;

    66         this.provider = provider;

    67         this.protocol = protocol;

    68     }

    69 

    70     /**

    71      * Generates a <code>SSLContext</code> object that implements the

    72      * specified secure socket protocol.

    73      *

    74      * @param protocol the standard name of the requested protocol.

    75      *

    76      * @return the new <code>SSLContext</code> object

    77      *

    78      * @exception NoSuchAlgorithmException if the specified protocol is not

    79      * available in the default provider package or any of the other provider

    80      * packages that were searched.

    81      */

    82     public static SSLContext getInstance(String protocol)

    83         throws NoSuchAlgorithmException

    84     {

    85         try {

    86             Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",

    87                                                 (String) null);

    88             return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],

    89                 protocol);

    90         } catch (NoSuchProviderException e) {

    91             throw new NoSuchAlgorithmException(protocol + " not found");

    92         }

    93     }

    94 

    95     /**

    96      * Generates a <code>SSLContext</code> object that implements the

    97      * specified secure socket protocol.

    98      *

    99      * @param protocol the standard name of the requested protocol.

   100      * @param provider the name of the provider

   101      *

   102      * @return the new <code>SSLContext</code> object

   103      *

   104      * @exception NoSuchAlgorithmException if the specified protocol is not

   105      * available from the specified provider.

   106      * @exception NoSuchProviderException if the specified provider has not

   107      * been configured.

   108      */

   109     public static SSLContext getInstance(String protocol, String provider)

   110         throws NoSuchAlgorithmException, NoSuchProviderException

   111     {

   112         if (provider == null || provider.isEmpty())

   113             throw new IllegalArgumentException("missing provider");

   114         Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",

   115                                             provider);

   116         return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],

   117             protocol);

   118     }

   119 

   120     /**

   121      * Generates a <code>SSLContext</code> object that implements the

   122      * specified secure socket protocol.

   123      *

   124      * @param protocol the standard name of the requested protocol.

   125      * @param provider an instance of the provider

   126      *

   127      * @return the new <code>SSLContext</code> object

   128      *

   129      * @exception NoSuchAlgorithmException if the specified protocol is not

   130      * available from the specified provider.

   131      */

   132     public static SSLContext getInstance(String protocol, Provider provider)

   133         throws NoSuchAlgorithmException

   134     {

   135         if (provider == null)

   136             throw new IllegalArgumentException("missing provider");

   137         Object[] objs = SSLSecurity.getImpl(protocol, "SSLContext",

   138                                             provider);

   139         return new SSLContext((SSLContextSpi)objs[0], (Provider)objs[1],

   140             protocol);

   141     }

   142 

   143     /**

   144      * Returns the protocol name of this <code>SSLContext</code> object.

   145      *

   146      * <p>This is the same name that was specified in one of the

   147      * <code>getInstance</code> calls that created this

   148      * <code>SSLContext</code> object.

   149      *

   150      * @return the protocol name of this <code>SSLContext</code> object.

   151      */

   152     public final String getProtocol() {

   153         return this.protocol;

   154     }

   155 

   156     /**

   157      * Returns the provider of this <code>SSLContext</code> object.

   158      *

   159      * @return the provider of this <code>SSLContext</code> object

   160      */

   161     public final Provider getProvider() {

   162         return this.provider;

   163     }

   164 

   165     /**

   166      * Initializes this context. Either of the first two parameters

   167      * may be null in which case the installed security providers will

   168      * be searched for the highest priority implementation of the

   169      * appropriate factory. Likewise, the secure random parameter may

   170      * be null in which case the default implementation will be used.

   171      *

   172      * @param km the sources of authentication keys or null

   173      * @param tm the sources of peer authentication trust decisions or null

   174      * @param random the source of randomness for this generator or null

   175      */

   176     public final void init(KeyManager[] km, TrustManager[] tm,

   177                                 SecureRandom random)

   178         throws KeyManagementException {

   179         contextSpi.engineInit(km, tm, random);

   180     }

   181 

   182     /**

   183      * Returns a <code>SocketFactory</code> object for this

   184      * context.

   185      *

   186      * @return the factory

   187      */

   188     public final SSLSocketFactory getSocketFactory() {

   189         return contextSpi.engineGetSocketFactory();

   190     }

   191 

   192     /**

   193      * Returns a <code>ServerSocketFactory</code> object for

   194      * this context.

   195      *

   196      * @return the factory

   197      */

   198     public final SSLServerSocketFactory getServerSocketFactory() {

   199         return contextSpi.engineGetServerSocketFactory();

   200     }

   201 }