/*
 * Copyright (c) 2014, 2018, 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.
 */

package com.oracle.security.ucrypto;

import java.util.*;
import java.security.ProviderException;

The exception class used by SunUcrypto provider. An exception
object of this class indicates that a function call to the underlying
native calls returned a value not equal to CRYPTO_SUCCESS.
Since:
9/**
 * The exception class used by SunUcrypto provider. An exception
 * object of this class indicates that a function call to the underlying
 * native calls returned a value not equal to CRYPTO_SUCCESS.
 *
 * @since 9
 */
public final class UcryptoException extends ProviderException {

    private static final long serialVersionUID = -933864511110035746L;

    // NOTE: check /usr/include/sys/crypto/common.h for updates
    public enum Error {
        CRYPTO_SUCCESS,
        CRYPTO_CANCEL,
        CRYPTO_HOST_MEMORY,
        CRYPTO_GENERAL_ERROR,
        CRYPTO_FAILED,
        CRYPTO_ARGUMENTS_BAD,
        CRYPTO_ATTRIBUTE_READ_ONLY,
        CRYPTO_ATTRIBUTE_SENSITIVE,
        CRYPTO_ATTRIBUTE_TYPE_INVALID,
        CRYPTO_ATTRIBUTE_VALUE_INVALID,
        CRYPTO_CANCELED,
        CRYPTO_DATA_INVALID,
        CRYPTO_DATA_LEN_RANGE,
        CRYPTO_DEVICE_ERROR,
        CRYPTO_DEVICE_MEMORY,
        CRYPTO_DEVICE_REMOVED,
        CRYPTO_ENCRYPTED_DATA_INVALID,
        CRYPTO_ENCRYPTED_DATA_LEN_RANGE,
        CRYPTO_KEY_HANDLE_INVALID,
        CRYPTO_KEY_SIZE_RANGE,
        CRYPTO_KEY_TYPE_INCONSISTENT,
        CRYPTO_KEY_NOT_NEEDED,
        CRYPTO_KEY_CHANGED,
        CRYPTO_KEY_NEEDED,
        CRYPTO_KEY_INDIGESTIBLE,
        CRYPTO_KEY_FUNCTION_NOT_PERMITTED,
        CRYPTO_KEY_NOT_WRAPPABLE,
        CRYPTO_KEY_UNEXTRACTABLE,
        CRYPTO_MECHANISM_INVALID,
        CRYPTO_MECHANISM_PARAM_INVALID,
        CRYPTO_OBJECT_HANDLE_INVALID,
        CRYPTO_OPERATION_IS_ACTIVE,
        CRYPTO_OPERATION_NOT_INITIALIZED,
        CRYPTO_PIN_INCORRECT,
        CRYPTO_PIN_INVALID,
        CRYPTO_PIN_LEN_RANGE,
        CRYPTO_PIN_EXPIRED,
        CRYPTO_PIN_LOCKED,
        CRYPTO_SESSION_CLOSED,
        CRYPTO_SESSION_COUNT,
        CRYPTO_SESSION_HANDLE_INVALID,
        CRYPTO_SESSION_READ_ONLY,
        CRYPTO_SESSION_EXISTS,
        CRYPTO_SESSION_READ_ONLY_EXISTS,
        CRYPTO_SESSION_READ_WRITE_SO_EXISTS,
        CRYPTO_SIGNATURE_INVALID,
        CRYPTO_SIGNATURE_LEN_RANGE,
        CRYPTO_TEMPLATE_INCOMPLETE,
        CRYPTO_TEMPLATE_INCONSISTENT,
        CRYPTO_UNWRAPPING_KEY_HANDLE_INVALID,
        CRYPTO_UNWRAPPING_KEY_SIZE_RANGE,
        CRYPTO_UNWRAPPING_KEY_TYPE_INCONSISTENT,
        CRYPTO_USER_ALREADY_LOGGED_IN,
        CRYPTO_USER_NOT_LOGGED_IN,
        CRYPTO_USER_PIN_NOT_INITIALIZED,
        CRYPTO_USER_TYPE_INVALID,
        CRYPTO_USER_ANOTHER_ALREADY_LOGGED_IN,
        CRYPTO_USER_TOO_MANY_TYPES,
        CRYPTO_WRAPPED_KEY_INVALID,
        CRYPTO_WRAPPED_KEY_LEN_RANGE,
        CRYPTO_WRAPPING_KEY_HANDLE_INVALID,
        CRYPTO_WRAPPING_KEY_SIZE_RANGE,
        CRYPTO_WRAPPING_KEY_TYPE_INCONSISTENT,
        CRYPTO_RANDOM_SEED_NOT_SUPPORTED,
        CRYPTO_RANDOM_NO_RNG,
        CRYPTO_DOMAIN_PARAMS_INVALID,
        CRYPTO_BUFFER_TOO_SMALL,
        CRYPTO_INFORMATION_SENSITIVE,
        CRYPTO_NOT_SUPPORTED,
        CRYPTO_QUEUED,
        CRYPTO_BUFFER_TOO_BIG,
        CRYPTO_INVALID_CONTEXT,
        CRYPTO_INVALID_MAC,
        CRYPTO_MECH_NOT_SUPPORTED,
        CRYPTO_INCONSISTENT_ATTRIBUTE,
        CRYPTO_NO_PERMISSION,
        CRYPTO_INVALID_PROVIDER_ID,
        CRYPTO_VERSION_MISMATCH,
        CRYPTO_BUSY,
        CRYPTO_UNKNOWN_PROVIDER,
        CRYPTO_MODVERIFICATION_FAILED,
        CRYPTO_OLD_CTX_TEMPLATE,
        CRYPTO_WEAK_KEY,
        CRYPTO_FIPS140_ERROR;
    };

    // Array used to look up error by ordinal
    private static final Error[] ALL_ERRORS = Error.values();

    
Get the error enum value (if any) associated with this exception.
/**
     * Get the error enum value (if any) associated with this exception.
     */
    public Error getError() {
        return (errorCode >= 0 && errorCode < ALL_ERRORS.length) ?
            ALL_ERRORS[errorCode] :
            null;
    }

    
The error code if this exception is triggered by a Ucrypto error.
/**
     * The error code if this exception is triggered by a Ucrypto error.
     */
    private final int errorCode;

    
This method gets the corresponding text error message from a
predefined mapping. If mapping is not found, then it returns the error
code as a hex-string.
Returns:
The message or the error code; e.g. "CRYPTO_DATA_INVALID" or
        "0x88"./**
     * This method gets the corresponding text error message from a
     * predefined mapping. If mapping is not found, then it returns the error
     * code as a hex-string.
     *
     * @return The message or the error code; e.g. "CRYPTO_DATA_INVALID" or
     *         "0x88".
     */
    static String getErrorMessage(int errorCode) {
        String message;
        if (errorCode >= 0 && errorCode < ALL_ERRORS.length) {
            message = ALL_ERRORS[errorCode].name();
        } else {
            message = "0x" + Integer.toHexString(errorCode);
        }
        return message;
    }

    
Constructor taking the error code as defined for the CRYPTO_* constants
/**
     * Constructor taking the error code as defined for the CRYPTO_* constants
     */
    public UcryptoException(int rv) {
        super(getErrorMessage(rv));
        this.errorCode = rv;
    }

    public UcryptoException(String message) {
        super(message);
        errorCode = -1;
    }

    public UcryptoException(String message, Throwable cause) {
        super(message, cause);
        errorCode = -1;
    }

    
Returns the Ucrypto error code.
Returns:
The error code./**
     * Returns the Ucrypto error code.
     *
     * @return The error code.
     */
    public int getErrorCode() {
        return errorCode;
    }
}