8297878: KEM: Implementation

8322971: KEM.getInstance() should check if a 3rd-party security provider is signed

Reviewed-by: mullan, andrew
Backport-of: e9d2641a14407380264b50fa2fe299980fe5f214

src/java.base/share/classes/java/security/Provider.java

@@ -1568,6 +1568,7 @@ private static void addEngine(String name, boolean sp, Class<?> constructorParam
         addEngine("KeyAgreement",                       true,  null);
         addEngine("KeyGenerator",                       false, null);
         addEngine("SecretKeyFactory",                   false, null);
+        addEngine("KEM",                                true,  null);
         // JSSE
         addEngine("KeyManagerFactory",                  false, null);
         addEngine("SSLContext",                         false, null);

src/java.base/share/classes/javax/crypto/DecapsulateException.java

@@ -0,0 +1,66 @@
+/*
+ * Copyright (c) 2023, 2024, 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 javax.crypto;
+
+import java.security.GeneralSecurityException;
+
+/**
+ * An exception that is thrown by the
+ * {@link javax.crypto.KEM.Decapsulator#decapsulate} method to denote an
+ * error during decapsulation.
+ *
+ * @apiNote This class is defined in Java SE 17 Maintenance Release 1.
+ * @since 17
+ */
+public class DecapsulateException extends GeneralSecurityException {
+
+    @java.io.Serial
+    private static final long serialVersionUID = 21L;
+
+    /**
+     * Creates a {@code DecapsulateException} with the specified
+     * detail message.
+     *
+     * @param message the detail message (which is saved for later retrieval
+     *        by the {@link #getMessage()} method).
+     */
+    public DecapsulateException(String message) {
+        super(message);
+    }
+
+    /**
+     * Creates a {@code DecapsulateException} with the specified
+     * detail message and cause.
+     *
+     * @param message the detail message (which is saved for later retrieval
+     *        by the {@link #getMessage()} method).
+     * @param cause the cause (which is saved for later retrieval by the
+     *        {@link #getCause()} method).  (A {@code null} value is permitted,
+     *        and indicates that the cause is nonexistent or unknown.)
+     */
+    public DecapsulateException(String message, Throwable cause) {
+        super(message, cause);
+    }
+}