8273045: Fix misc javadoc bugs in the java.security and javax.net.ssl code

Reviewed-by: xuelei

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

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2021, 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
@@ -96,7 +96,7 @@ public abstract class AuthProvider extends Provider {
      *          from the caller, which may be {@code null}
      *
      * @throws IllegalStateException if the provider requires configuration
-     * and {@link configure} has not been called
+     * and {@link #configure} has not been called
      * @throws LoginException if the login operation fails
      * @throws SecurityException if the caller does not pass a
      *  security check for
@@ -111,7 +111,7 @@ public abstract class AuthProvider extends Provider {
      * Log out from this provider.
      *
      * @throws IllegalStateException if the provider requires configuration
-     * and {@link configure} has not been called
+     * and {@link #configure} has not been called
      * @throws LoginException if the logout operation fails
      * @throws SecurityException if the caller does not pass a
      *  security check for
@@ -139,7 +139,7 @@ public abstract class AuthProvider extends Provider {
      *          authentication information, which may be {@code null}
      *
      * @throws IllegalStateException if the provider requires configuration
-     * and {@link configure} has not been called
+     * and {@link #configure} has not been called
      * @throws SecurityException if the caller does not pass a
      *  security check for
      *  {@code SecurityPermission("authProvider.name")},

src/java.base/share/classes/javax/net/ssl/SNIHostName.java

@@ -34,6 +34,7 @@ import java.nio.charset.CharacterCodingException;
 import java.util.Locale;
 import java.util.Objects;
 import java.util.regex.Pattern;
+import java.util.regex.PatternSyntaxException;
 
 /**
  * Instances of this class represent a server name of type
@@ -297,7 +298,7 @@ public final class SNIHostName extends SNIServerName {
      * @return a {@code SNIMatcher} object for {@code SNIHostName}s
      * @throws NullPointerException if {@code regex} is
      *         {@code null}
-     * @throws java.util.regex.PatternSyntaxException if the regular expression's
+     * @throws PatternSyntaxException if the regular expression's
      *         syntax is invalid
      */
     public static SNIMatcher createSNIMatcher(String regex) {

src/java.base/share/classes/javax/net/ssl/SNIMatcher.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2021, 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
@@ -25,6 +25,8 @@
 
 package javax.net.ssl;
 
+import java.util.Collection;
+
 /**
  * Instances of this class represent a matcher that performs match
  * operations on an {@link SNIServerName} instance.

src/java.base/share/classes/javax/net/ssl/SNIServerName.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2012, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2012, 2021, 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
@@ -27,6 +27,7 @@ package javax.net.ssl;
 
 import java.util.Arrays;
 import java.util.HexFormat;
+import java.util.List;
 
 /**
  * Instances of this class represent a server name in a Server Name

src/java.base/share/classes/javax/net/ssl/SSLEngine.java

@@ -983,7 +983,7 @@ public abstract class SSLEngine {
      * @see     #getSupportedCipherSuites()
      * @see     #getEnabledCipherSuites()
      */
-    public abstract void setEnabledCipherSuites(String suites []);
+    public abstract void setEnabledCipherSuites(String[] suites);
 
 
     /**
@@ -1024,7 +1024,7 @@ public abstract class SSLEngine {
      *          when the protocols parameter is null.
      * @see     #getEnabledProtocols()
      */
-    public abstract void setEnabledProtocols(String protocols[]);
+    public abstract void setEnabledProtocols(String[] protocols);
 
 
     /**
@@ -1161,7 +1161,7 @@ public abstract class SSLEngine {
      *
      * @implNote
      * The JDK SunJSSE provider implementation returns false unless
-     * {@link setUseClientMode(boolean)} is used to change the mode to true.
+     * {@link #setUseClientMode(boolean)} is used to change the mode to true.
      *
      * @return  true if the engine should do handshaking
      *          in "client" mode

src/java.base/share/classes/javax/net/ssl/SSLEngineResult.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2017, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2021, 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
@@ -25,6 +25,8 @@
 
 package javax.net.ssl;
 
+import java.nio.ByteBuffer;
+
 /**
  * An encapsulation of the result state produced by
  * {@code SSLEngine} I/O calls.

src/java.base/share/classes/javax/net/ssl/SSLServerSocket.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 1997, 2018, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 1997, 2021, 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
@@ -23,13 +23,11 @@
  * questions.
  */
 
-
 package javax.net.ssl;
 
 import java.io.*;
 import java.net.*;
 
-
 /**
  * This class extends <code>ServerSocket</code> and
  * provides secure server sockets using protocols such as the Secure

src/java.base/share/classes/javax/net/ssl/SSLSession.java

@@ -26,6 +26,7 @@
 package javax.net.ssl;
 
 import java.security.Principal;
+import java.nio.ByteBuffer;
 
 /**
  * In SSL, sessions are used to describe an ongoing relationship between

src/java.base/share/classes/javax/net/ssl/X509ExtendedTrustManager.java

@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2010, 2020, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2010, 2021, 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
@@ -26,8 +26,8 @@
 package javax.net.ssl;
 
 import java.net.Socket;
-import javax.net.ssl.X509TrustManager;
 
+import java.security.AlgorithmConstraints;
 import java.security.cert.X509Certificate;
 import java.security.cert.CertificateException;