8298966: Deprecate JMX Subject Delegation and the method JMXConnector.getMBeanServerConnection(Subject) for removal.

Reviewed-by: mchung, dfuchs

Author: kevinjwalls

src/java.management.rmi/share/classes/javax/management/remote/rmi/RMIConnector.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2002, 2022, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2002, 2023, 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
@@ -390,6 +390,7 @@ public synchronized MBeanServerConnection getMBeanServerConnection()
         return getMBeanServerConnection(null);
     }
 
+    @SuppressWarnings("removal")
     public synchronized MBeanServerConnection
             getMBeanServerConnection(Subject delegationSubject)
             throws IOException {

src/java.management/share/classes/javax/management/remote/JMXConnector.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2002, 2013, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2002, 2023, 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
@@ -168,7 +168,13 @@ public MBeanServerConnection getMBeanServerConnection()
      * cannot be created, for instance because the connection to the remote
      * MBean server has not yet been established (with the {@link #connect(Map)
      * connect} method), or it has been closed, or it has broken.
+     *
+     * @deprecated This method supported the legacy Subject Delegation feature,
+     * and is only useful in conjunction with other APIs which are deprecated and
+     * subject to removal in a future release. Consequently, this method is also
+     * deprecated and subject to removal. There is no replacement.
      */
+    @Deprecated(since="21", forRemoval=true)
     public MBeanServerConnection getMBeanServerConnection(
                                                Subject delegationSubject)
             throws IOException;