Annotated all internal packages (#1818)

rozza · web-flow · commit 0d34dfa074ee · 2025-10-09T13:16:07.000+01:00
JAVA-5975
diff --git a/driver-core/src/main/com/mongodb/internal/async/function/package-info.java b/driver-core/src/main/com/mongodb/internal/async/function/package-info.java
@@ -14,7 +14,13 @@
  * limitations under the License.
  */
 
+/**
+ * This package contains internal functionality that may change at any time.
+ */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.async.function;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/async/package-info.java b/driver-core/src/main/com/mongodb/internal/async/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.async;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/authentication/package-info.java b/driver-core/src/main/com/mongodb/internal/authentication/package-info.java
@@ -15,9 +15,13 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.authentication;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/binding/package-info.java b/driver-core/src/main/com/mongodb/internal/binding/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.binding;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/bulk/package-info.java b/driver-core/src/main/com/mongodb/internal/bulk/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.bulk;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/capi/package-info.java b/driver-core/src/main/com/mongodb/internal/capi/package-info.java
@@ -15,10 +15,13 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.capi;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/bulk/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
- * Internal program elements related to {@link com.mongodb.client.model.bulk}.
+ * This package contains internal functionality that may change at any time.
  */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model.bulk;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/changestream/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model.changestream;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/model/package-info.java b/driver-core/src/main/com/mongodb/internal/client/model/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.model;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/package-info.java b/driver-core/src/main/com/mongodb/internal/client/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes for internal client functionality.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java b/driver-core/src/main/com/mongodb/internal/client/vault/package-info.java
@@ -15,10 +15,12 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal.client.vault;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/netty/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
- * Contains <a href="https://netty.io/">Netty</a>-specific program elements.
+ * This package contains internal functionality that may change at any time.
  */
+
+@Internal
 @NonNullApi
 package com.mongodb.internal.connection.netty;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.connection;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/async/package-info.java
@@ -20,5 +20,10 @@
 /**
  * This package enables the usage of TLS Channel as an {@link
  * java.nio.channels.AsynchronousByteChannel}.
+ *
+ * <p>This package contains internal functionality that may change at any time.
  */
+@Internal
 package com.mongodb.internal.connection.tlschannel.async;
+
+import com.mongodb.annotations.Internal;
diff --git a/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java b/driver-core/src/main/com/mongodb/internal/connection/tlschannel/package-info.java
@@ -26,5 +26,10 @@
  * <p>In other words, a simple library that allows the programmer to have TLS using the same
  * standard socket API used for plaintext, just like OpenSSL does for C, only for Java, filling a
  * specially painful missing feature of the standard Java library.
+ *
+ * <p>This package contains internal functionality that may change at any time.
  */
+@Internal
 package com.mongodb.internal.connection.tlschannel;
+
+import com.mongodb.annotations.Internal;
diff --git a/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java b/driver-core/src/main/com/mongodb/internal/diagnostics/logging/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.diagnostics.logging;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/dns/package-info.java b/driver-core/src/main/com/mongodb/internal/dns/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.dns;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/event/package-info.java b/driver-core/src/main/com/mongodb/internal/event/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.event;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/function/package-info.java b/driver-core/src/main/com/mongodb/internal/function/package-info.java
@@ -15,9 +15,11 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.function;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/inject/package-info.java b/driver-core/src/main/com/mongodb/internal/inject/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.inject;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/logging/package-info.java b/driver-core/src/main/com/mongodb/internal/logging/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.logging;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/operation/package-info.java b/driver-core/src/main/com/mongodb/internal/operation/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * The core of the MongoDB driver works via operations, using the command pattern. The main Operations supported by MongoDB are in this
- * package, as are helpers and infrastructure required for operation functionality.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.internal.operation;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java b/driver-core/src/main/com/mongodb/internal/operation/retry/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.operation.retry;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/package-info.java b/driver-core/src/main/com/mongodb/internal/package-info.java
@@ -15,9 +15,12 @@
  */
 
 /**
+ * This package contains internal functionality that may change at any time.
  */
 
+@Internal
 @NonNullApi
 package com.mongodb.internal;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/selector/package-info.java b/driver-core/src/main/com/mongodb/internal/selector/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.selector;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/session/package-info.java b/driver-core/src/main/com/mongodb/internal/session/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.session;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/thread/package-info.java b/driver-core/src/main/com/mongodb/internal/thread/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.thread;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/time/package-info.java b/driver-core/src/main/com/mongodb/internal/time/package-info.java
@@ -15,9 +15,11 @@
  */
 
 /**
- * This package contains program elements for working with time.
+ * This package contains internal functionality that may change at any time.
  */
+@Internal
 @NonNullApi
 package com.mongodb.internal.time;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-core/src/main/com/mongodb/internal/validator/package-info.java b/driver-core/src/main/com/mongodb/internal/validator/package-info.java
@@ -15,10 +15,11 @@
  */
 
 /**
- * This package contains classes that manage binding to MongoDB servers for various operations.
+ * This package contains internal functionality that may change at any time.
  */
-
+@Internal
 @NonNullApi
 package com.mongodb.internal.validator;
 
+import com.mongodb.annotations.Internal;
 import com.mongodb.lang.NonNullApi;
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/crypt/package-info.java
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/gridfs/package-info.java
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/package-info.java
diff --git a/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java b/driver-reactive-streams/src/main/com/mongodb/reactivestreams/client/internal/vault/package-info.java
diff --git a/driver-sync/src/main/com/mongodb/client/internal/package-info.java b/driver-sync/src/main/com/mongodb/client/internal/package-info.java
