Update netty to 4.1.115.Final

Also clean up a number of javadoc warnings from Java 21

Author: gmfeinberg

driver/pom.xml

@@ -46,7 +46,7 @@
     <copyright>Copyright (c) 2011, 2024 Oracle and/or its affiliates. All rights reserved.</copyright>
     <java.apidoc>http://docs.oracle.com/javase/8/docs/api</java.apidoc>
     <maven.deploy.skip>false</maven.deploy.skip>
-    <netty.version>4.1.108.Final</netty.version>
+    <netty.version>4.1.115.Final</netty.version>
     <jackson.version>2.15.2</jackson.version>
    <!-- by default, skip tests; tests require a profile -->
    <maven.test.skip>true</maven.test.skip>
@@ -379,7 +379,7 @@
         <version>3.5.0</version>
         <configuration>
           <quiet>true</quiet>
-          <!-- consider this: <doclint>-missing</doclint> -->
+          <doclint>-missing</doclint>
           <source>8</source>
           <doctitle>${project.name} ${project.version}</doctitle>
           <windowtitle>${project.name} ${project.version}</windowtitle>

driver/src/main/java/oracle/nosql/driver/BatchOperationNumberLimitException.java

@@ -19,8 +19,9 @@ public class BatchOperationNumberLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the message
+     * @hidden
      */
     public BatchOperationNumberLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/DeploymentException.java

@@ -20,8 +20,9 @@ public class DeploymentException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public DeploymentException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/DriverMain.java

@@ -14,11 +14,11 @@
 import java.util.jar.Manifest;
 
 /**
- * @hidden
- *
  * A simple main for the driver jar file. At this time it only handles a
  * "version" command. If it ever is extended for other arguments it should
  * be better abstracted for multiple commands
+ *
+ * @hidden
  */
 public class DriverMain {
 

driver/src/main/java/oracle/nosql/driver/EvolutionLimitException.java

@@ -18,9 +18,10 @@ public class EvolutionLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      *
      * @param msg the exception message
+     * @hidden
      */
     public EvolutionLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexExistsException.java

@@ -16,8 +16,9 @@ public class IndexExistsException extends ResourceExistsException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexExistsException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexLimitException.java

@@ -18,8 +18,9 @@ public class IndexLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/IndexNotFoundException.java

@@ -16,8 +16,9 @@ public class IndexNotFoundException extends ResourceNotFoundException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public IndexNotFoundException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/InvalidAuthorizationException.java

@@ -16,8 +16,9 @@ public class InvalidAuthorizationException extends NoSQLException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public InvalidAuthorizationException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/JsonParseException.java

@@ -26,17 +26,19 @@ public class JsonParseException extends NoSQLException {
     private JsonLocation location;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public JsonParseException(String msg) {
         super(msg);
     }
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
      * @param location the exception location in the input
+     * @hidden
      */
     public JsonParseException(String msg, JsonLocation location) {
         super(msg);
@@ -79,8 +81,9 @@ public String toString() {
     }
 
     /**
-     * @hidden
+     * Internal use only
      * @return the location of the exception in the input
+     * @hidden
      */
     public JsonLocation getLocation() {
         return location;

driver/src/main/java/oracle/nosql/driver/KeySizeLimitException.java

@@ -18,8 +18,9 @@ public class KeySizeLimitException extends ResourceLimitException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the exception message
+     * @hidden
      */
     public KeySizeLimitException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/NoSQLException.java

@@ -17,18 +17,19 @@ public class NoSQLException extends RuntimeException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * internal use only
      * @param msg the message
+     * @hidden
      */
     public /*protected*/ NoSQLException(String msg) {
         super(msg + " (" + SDKVersion.VERSION + ")");
     }
 
     /**
-     * @hidden
-     *
+     * internal use only
      * @param msg the message
      * @param cause the cause
+     * @hidden
      */
     public /*protected*/ NoSQLException(String msg, Throwable cause) {
         super(msg + " (" + SDKVersion.VERSION + ")", cause);

driver/src/main/java/oracle/nosql/driver/NoSQLHandleConfig.java

@@ -427,12 +427,12 @@ public NoSQLHandleConfig(AuthorizationProvider provider) {
     }
 
     /**
-     * @hidden
-     *
+     * internal use only
      * @param endpoint the endpoint to use
      * @param path the path to use
      * @return the constructed URL
      * Return a URL from an endpoint string
+     * @hidden
      */
     public static URL createURL(String endpoint, String path) {
         requireNonNull(endpoint,
@@ -767,8 +767,6 @@ public NoSQLHandleConfig setConnectionPoolMinSize(int poolMinSize) {
     }
 
     /**
-     * @hidden
-     *
      * Sets an inactivity period, in seconds, used to time out idle connections
      * in the connection pool. This setting allows unused connections to be
      * reclaimed when the system goes idle, reducing resource use. If 0 for
@@ -780,6 +778,7 @@ public NoSQLHandleConfig setConnectionPoolMinSize(int poolMinSize) {
      * @return this
      *
      * @since 5.3.2
+     * @hidden
      */
     public NoSQLHandleConfig setConnectionPoolInactivityPeriod(
         int poolInactivityPeriod) {
@@ -834,14 +833,14 @@ public int getMaxContentLength() {
     }
 
     /**
-     * @hidden
      * Sets the maximum size in bytes of http chunks.
      * If not set, or set to zero, the default value of 64KB is used.
      *
      * @param maxChunkSize the maximum bytes allowed in
      * http chunks. Pass zero to use the default.
      *
      * @return this
+     * @hidden
      */
     public NoSQLHandleConfig setMaxChunkSize(int maxChunkSize) {
         if (maxChunkSize < 0) {
@@ -854,10 +853,10 @@ public NoSQLHandleConfig setMaxChunkSize(int maxChunkSize) {
     }
 
     /**
-     * @hidden
      * Returns the maximum size, in bytes, of any http chunk
      *
      * @return the size
+     * @hidden
      */
     public int getMaxChunkSize() {
         return maxChunkSize;
@@ -892,14 +891,14 @@ public int getConnectionPoolMinSize() {
     }
 
     /**
-     * @hidden
      * Returns the inactivity period, in seconds, to use to time out idle
      * connections. This allows the connection pool to shrink after a period
      * of inactivity, reducing resource use.
      *
      * @return the inactivity period, or 0 if not set
      *
      * @since 5.3.2
+     * @hidden
      */
     public int getConnectionPoolInactivityPeriod() {
         return connectionPoolInactivityPeriod;
@@ -976,9 +975,9 @@ public NoSQLHandleConfig setRateLimitingEnabled(boolean enable) {
     }
 
     /**
-     * @hidden
      * Internal use only
      * @return true if rate limiting is enabled
+     * @hidden
      */
     public boolean getRateLimitingEnabled() {
         return rateLimitingEnabled;
@@ -1007,9 +1006,9 @@ public void setDefaultRateLimitingPercentage(double percent) {
     }
 
     /**
-     * @hidden
      * Internal use only
      * @return the default percentage
+     * @hidden
      */
     public double getDefaultRateLimitingPercentage() {
         if (defaultRateLimiterPercentage == 0.0) {
@@ -1354,58 +1353,60 @@ public NoSQLHandleConfig setProxyPort(int proxyPort) {
     }
 
     /**
-     * @hidden
      * Returns a proxy host, or null if not configured
      *
      * @return the host, or null
+     * @hidden
      */
     public String getProxyHost() {
         return proxyHost;
     }
 
     /**
-     * @hidden
      * Returns a proxy user name, or null if not configured
      *
      * @return the user name, or null
+     * @hidden
      */
     public String getProxyUsername() {
         return proxyUsername;
     }
 
     /**
-     * @hidden
      * Returns a proxy password, or null if not configured
      *
      * @return the password, or null
+     * @hidden
      */
     public String getProxyPassword() {
         return proxyPassword;
     }
 
     /**
-     * @hidden
      * Returns a proxy port, or 0 if not configured
      *
      * @return the proxy port
+     * @hidden
      */
     public int getProxyPort() {
         return proxyPort;
     }
 
     /**
-     * @hidden
+     * internal use only
      * @param sslCtx the SSL context to set
      * @return this
+     * @hidden
      */
     public NoSQLHandleConfig setSslContext(SslContext sslCtx) {
         this.sslCtx = sslCtx;
         return this;
     }
 
     /**
-     * @hidden
+     * internal use only
      * @return the SSL context
+     * @hidden
      */
     public SslContext getSslContext() {
         return sslCtx;
@@ -1549,8 +1550,6 @@ public StatsControl.StatsHandler getStatsHandler() {
     }
 
     /**
-     * @hidden
-     *
      * Cloud service only.
      * Turns on, or off internal, automatic refresh of auth information based on
      * tracked requests. This is present in case the refresh really isn't
@@ -1561,21 +1560,21 @@ public StatsControl.StatsHandler getStatsHandler() {
      * @return this
      *
      * @since 5.3.2
+     * @hidden
      */
     public NoSQLHandleConfig setAuthRefresh(boolean value) {
         this.authRefresh = value;
         return this;
     }
 
     /**
-     * @hidden
-     *
      * Cloud service only.
      * Returns the state of the authRefresh flag
      *
      * @return true if auth refresh is enabled
      *
      * @since 5.3.2
+     * @hidden
      */
     public boolean getAuthRefresh() {
         return authRefresh;

driver/src/main/java/oracle/nosql/driver/OperationNotSupportedException.java

@@ -16,8 +16,9 @@ public class OperationNotSupportedException extends NoSQLException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * Internal use only
      * @param msg the exception message
+     * @hidden
      */
     public OperationNotSupportedException(String msg) {
         super(msg);

driver/src/main/java/oracle/nosql/driver/OperationThrottlingException.java

@@ -25,8 +25,9 @@ public class OperationThrottlingException extends ThrottlingException {
     private static final long serialVersionUID = 1L;
 
     /**
-     * @hidden
+     * Internal use only
      * @param msg the exception message
+     * @hidden
      */
     public OperationThrottlingException(String msg) {
         super(msg);