Javadoc, scalatest and checkstyle fixes

Suppress OutputBuffer deprecation warning
Fix javadoc
Move tracing tests to the appropriate package
Add SpanTree to scala test exclusions list

Author: rozza

bson/src/main/org/bson/io/BasicOutputBuffer.java

@@ -88,6 +88,7 @@ public void writeInt32(final int value) {
     }
 
     @Override
+    @SuppressWarnings("deprecation")
     public void writeInt32(final int position, final int value) {
         ensureOpen();
         checkPosition(position, 4);

driver-core/src/main/com/mongodb/internal/connection/ByteBufferBsonOutput.java

@@ -100,6 +100,7 @@ public void writeInt32(final int value) {
 
 
     @Override
+    @SuppressWarnings("deprecation")
     public void writeInt32(final int absolutePosition, final int value) {
         ensureOpen();
 

driver-core/src/main/com/mongodb/observability/MicrometerObservabilitySettings.java

@@ -44,11 +44,20 @@
 @Immutable
 public final class MicrometerObservabilitySettings extends ObservabilitySettings {
 
+    /**
+     * If set, this will enable/disable tracing even when an observationRegistry has been passed
+     * <p>
+     * For internal use only
+     */
     @Internal
-    // If set, this will enable/disable tracing even when an observationRegistry has been passed.
     public static final String ENV_OBSERVABILITY_ENABLED = "OBSERVABILITY_MONGODB_ENABLED";
+
+    /**
+     * If set, this will truncate the command payload captured in the tracing span to the specified length.
+     * <p>
+     * For internal use only
+     */
     @Internal
-    // If set, this will truncate the command payload captured in the tracing span to the specified length.
     public static final String ENV_OBSERVABILITY_QUERY_TEXT_MAX_LENGTH = "OBSERVABILITY_MONGODB_QUERY_TEXT_MAX_LENGTH";
     @Nullable
     private final ObservationRegistry observationRegistry;

driver-scala/src/test/scala/org/mongodb/scala/ApiAliasAndCompanionSpec.scala

@@ -74,6 +74,7 @@ class ApiAliasAndCompanionSpec extends BaseSpec {
       "SessionContext",
       "SingleResultCallback",
       "Slow",
+      "SpanTree",
       "SubjectProvider",
       "TransactionExample",
       "UnixServerAddress",

driver-sync/src/test/functional/com/mongodb/client/unified/UnifiedTest.java

@@ -28,7 +28,7 @@
 import com.mongodb.client.gridfs.GridFSBucket;
 import com.mongodb.client.model.Filters;
 import com.mongodb.client.test.CollectionHelper;
-import com.mongodb.client.tracing.SpanTree;
+import com.mongodb.observability.SpanTree;
 import com.mongodb.client.unified.UnifiedTestModifications.TestDef;
 import com.mongodb.client.vault.ClientEncryption;
 import com.mongodb.connection.ClusterDescription;

driver-sync/src/test/functional/com/mongodb/client/unified/UnifiedTestModifications.java

@@ -27,8 +27,6 @@
 
 import static com.mongodb.ClusterFixture.isDiscoverableReplicaSet;
 import static com.mongodb.ClusterFixture.isSharded;
-import static com.mongodb.ClusterFixture.isStandalone;
-import static com.mongodb.ClusterFixture.isUnixSocket;
 import static com.mongodb.ClusterFixture.serverVersionLessThan;
 import static com.mongodb.assertions.Assertions.assertNotNull;
 import static com.mongodb.assertions.Assertions.assertTrue;

driver-sync/src/test/functional/com/mongodb/client/tracing/MicrometerProseTest.java renamed to driver-sync/src/test/functional/com/mongodb/observability/MicrometerProseTest.java

@@ -14,16 +14,14 @@
  * limitations under the License.
  */
 
-package com.mongodb.client.tracing;
+package com.mongodb.observability;
 
 import com.mongodb.MongoClientSettings;
 import com.mongodb.client.Fixture;
 import com.mongodb.client.MongoClient;
 import com.mongodb.client.MongoClients;
 import com.mongodb.client.MongoCollection;
 import com.mongodb.client.MongoDatabase;
-import com.mongodb.observability.MicrometerObservabilitySettings;
-import com.mongodb.observability.ObservabilitySettings;
 import io.micrometer.observation.ObservationRegistry;
 import io.micrometer.tracing.test.reporter.inmemory.InMemoryOtelSetup;
 import org.bson.Document;

driver-sync/src/test/functional/com/mongodb/client/tracing/SpanTree.java renamed to driver-sync/src/test/functional/com/mongodb/observability/SpanTree.java

@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 
-package com.mongodb.client.tracing;
+package com.mongodb.observability;
 
 import com.mongodb.lang.Nullable;
 import io.micrometer.tracing.exporter.FinishedSpan;