/*
 * Copyright (C) 2018 The Android Open Source Project
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */


package android.net.ssl;

import javax.net.ssl.SSLSocket;
import javax.net.ssl.SSLException;

/**
 * Static utility methods for accessing additional functionality of supported instances of
 * {@link javax.net.ssl.SSLSocket SSLSocket}.  Sockets from the platform TLS provider will be compatible with all
 * methods in this class.
 */

@SuppressWarnings({"unchecked", "deprecation", "all"})
public class SSLSockets {

private SSLSockets() { throw new RuntimeException("Stub!"); }

/**
 * Returns whether the given socket can be used with the methods in this class.  In general,
 * only sockets from the platform TLS provider are supported.
 */

public static boolean isSupportedSocket(@android.annotation.NonNull javax.net.ssl.SSLSocket socket) { throw new RuntimeException("Stub!"); }

/**
 * Enables or disables the use of session tickets.
 *
 * <p>This function must be called before the handshake is started or it will have no effect.
 *
 * @param socket the socket
 * @param useSessionTickets whether to enable or disable the use of session tickets
 * @throws java.lang.IllegalArgumentException if the given socket is not a platform socket
 */

public static void setUseSessionTickets(@android.annotation.NonNull javax.net.ssl.SSLSocket socket, boolean useSessionTickets) { throw new RuntimeException("Stub!"); }

/**
 * Exports a value derived from the TLS master secret as described in RFC 5705.
 *
 * A number of protocols leverage Transport Layer Security (TLS) to perform key
 * establishment but then use some of the keying material for their own purposes.
 *
 * This method allows an application to export keying material from a TLS connection.
 * The exported material will be the same on the client and server if they pass in
 * the same values for {@code label} and {@code context}.  See RFC 5705 for further
 * details.
 *
 * @param socket the socket to use for exporting keying material
 * @param label the label to use in calculating the exported value.  This must be
 * an ASCII-only string.
 * @param context the application-specific context value to use in calculating the
 * exported value.  This may be {@code null} to use no application context, which is
 * treated differently than an empty byte array.
 * @param length the number of bytes of keying material to return.
 * @return a value of the specified length, or {@code null} if the handshake has not yet
 * completed or the connection has been closed.
 * @throws javax.net.ssl.SSLException if the value could not be exported.
 */

@android.annotation.Nullable
public static byte[] exportKeyingMaterial(@android.annotation.NonNull javax.net.ssl.SSLSocket socket, @android.annotation.NonNull java.lang.String label, @android.annotation.Nullable byte[] context, int length) throws javax.net.ssl.SSLException { throw new RuntimeException("Stub!"); }
}