CSHARP-5317: Mark API as obsolete: Connection + Cluster (#1488)

Author: papafe

src/MongoDB.Driver.Core/Core/Bindings/ICoreServerSessionPool.cs

@@ -13,6 +13,8 @@
 * limitations under the License.
 */
 
+using System;
+
 namespace MongoDB.Driver
 {
     /// <summary>

src/MongoDB.Driver.Core/Core/Clusters/ICluster.cs

@@ -33,6 +33,7 @@ public interface ICluster : IDisposable
         /// <summary>
         /// Occurs when the cluster description has changed.
         /// </summary>
+        [Obsolete("This event will be removed in a later release.")]
         event EventHandler<ClusterDescriptionChangedEventArgs> DescriptionChanged;
 
         // properties
@@ -65,19 +66,22 @@ public interface ICluster : IDisposable
         /// Acquires a core server session.
         /// </summary>
         /// <returns>A core server session.</returns>
+        [Obsolete("This method will be removed in a later release.")]
         ICoreServerSession AcquireServerSession();
 
         /// <summary>
         /// Gets the crypt client.
         /// </summary>
         /// <returns>A crypt client.</returns>
 #pragma warning disable CS3003
+        [Obsolete("This property will be removed in a later release.")]
         CryptClient CryptClient { get; }
 #pragma warning restore
 
         /// <summary>
         /// Initializes the cluster.
         /// </summary>
+        [Obsolete("This method will be removed in a later release.")]
         void Initialize();
 
         /// <summary>
@@ -86,6 +90,7 @@ public interface ICluster : IDisposable
         /// <param name="selector">The server selector.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>The selected server.</returns>
+        [Obsolete("This method will be removed in a later release.")]
         IServer SelectServer(IServerSelector selector, CancellationToken cancellationToken);
 
         /// <summary>
@@ -94,6 +99,7 @@ public interface ICluster : IDisposable
         /// <param name="selector">The server selector.</param>
         /// <param name="cancellationToken">The cancellation token.</param>
         /// <returns>A Task representing the operation. The result of the Task is the selected server.</returns>
+        [Obsolete("This method will be removed in a later release.")]
         Task<IServer> SelectServerAsync(IServerSelector selector, CancellationToken cancellationToken);
 
         /// <summary>
@@ -103,6 +109,7 @@ public interface ICluster : IDisposable
         /// <returns>
         /// A session.
         /// </returns>
+        [Obsolete("This method will be removed in a later release.")]
         ICoreSessionHandle StartSession(CoreSessionOptions options = null);
     }
 }

src/MongoDB.Driver.Core/Core/Clusters/IClusterClock.cs

@@ -13,13 +13,15 @@
 * limitations under the License.
 */
 
+using System;
 using MongoDB.Bson;
 
 namespace MongoDB.Driver.Core.Clusters
 {
     /// <summary>
     /// A cluster clock.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IClusterClock
     {
         // properties

src/MongoDB.Driver.Core/Core/Compression/ICompressor.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.IO;
 
 namespace MongoDB.Driver.Core.Compression

src/MongoDB.Driver.Core/Core/Configuration/ClusterBuilder.cs

@@ -196,6 +196,7 @@ public ClusterBuilder ConfigureTcp(Func<TcpStreamSettings, TcpStreamSettings> co
         /// </summary>
         /// <param name="wrapper">The stream factory wrapper.</param>
         /// <returns>A reconfigured cluster builder.</returns>
+        [Obsolete("This method will be made internal in a later release.")]
         public ClusterBuilder RegisterStreamFactory(Func<IStreamFactory, IStreamFactory> wrapper)
         {
             Ensure.IsNotNull(wrapper, nameof(wrapper));

src/MongoDB.Driver.Core/Core/ConnectionPools/IConnectionPool.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.ConnectionPools
     /// <summary>
     /// Represents a connection pool.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IConnectionPool : IDisposable
     {
         // properties

src/MongoDB.Driver.Core/Core/ConnectionPools/IConnectionPoolFactory.cs

@@ -22,6 +22,7 @@ namespace MongoDB.Driver.Core.ConnectionPools
     /// <summary>
     /// Handler for connections related exceptions raised in <see cref="IConnectionPool"/>.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IConnectionExceptionHandler
     {
         /// <summary>
@@ -34,6 +35,7 @@ public interface IConnectionExceptionHandler
     /// <summary>
     /// Represents a connection pool factory.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IConnectionPoolFactory
     {
         // methods

src/MongoDB.Driver.Core/Core/Connections/IConnection.cs

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Connections
     /// <summary>
     /// Represents a connection.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IConnection : IDisposable
     {
         // properties
@@ -156,6 +157,7 @@ public interface IConnection : IDisposable
     /// <summary>
     /// Represents a handle to a connection.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IConnectionHandle : IConnection
     {
         // methods

src/MongoDB.Driver.Core/Core/Connections/IConnectionFactory.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.Net;
 using MongoDB.Driver.Core.Configuration;
 using MongoDB.Driver.Core.Servers;
@@ -22,6 +23,7 @@ namespace MongoDB.Driver.Core.Connections
     /// <summary>
     /// Represents a connection factory.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public interface IConnectionFactory
     {
         // properties

src/MongoDB.Driver.Core/Core/Operations/AsyncCursor.cs

@@ -35,6 +35,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents an async cursor.
     /// </summary>
     /// <typeparam name="TDocument">The type of the documents.</typeparam>
+    [Obsolete("This class will be made internal in a later release.")]
     public class AsyncCursor<TDocument> : IAsyncCursor<TDocument>, ICursorBatchInfo
     {
         #region static