[JAVA] Remove deprecated Stream-related types (#513)

* SteamFactory deprecations

Author: rachel-mack

source/fundamentals/connection/mongoclientsettings.txt

@@ -142,8 +142,8 @@ connection behavior:
      - Sets the :ref:`server API <stable-api-java>` to use when sending
        commands to the server.
 
-   * - ``streamFactoryFactory()``
-     - Sets the factory to use to create a ``StreamFactory``.
+   * - ``transportSettings()``
+     - Sets `TransportSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/TransportSettings.html>`__.
 
    * - ``uuidRepresentation()``
      - Sets the UUID representation to use when encoding instances of UUID

source/fundamentals/connection/socks.txt

@@ -29,13 +29,17 @@ SOCKS5 Proxy Settings
 
 The proxy settings specify the SOCKS5 proxy server address and your
 authentication credentials. You can specify your settings in an instance of
-``MongoClientSettings`` or in your connection string.
+:ref:`MongoClientSettings <mongoclientsettings>` or in your :ref:`connection
+string <connection-uri>`.
 
 .. important::
-
-   The driver ignores the proxy settings if you specify a custom
-   ``StreamFactoryFactory``, which by default creates instances of
-   ``SocketStreamFactory``.
+   
+   The driver ignores the proxy settings if either of the following are true:
+   
+   - A Unix domain socket handles the communication.
+     For more information, see the `UnixServerAddress documentation <{+api+}/apidocs/mongodb-driver-core/com/mongodb/UnixServerAddress.html>`__.
+   - ``TransportSettings`` are configured.
+     For more information, see the `TransportSettings documentation <{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/TransportSettings.html>`__.
 
 The following table describes the SOCKS5 client options:
 

source/fundamentals/connection/tls.txt

@@ -270,7 +270,6 @@ provided by Netty.
    import com.mongodb.MongoClientSettings;
    import com.mongodb.client.MongoClients;
    import com.mongodb.client.MongoClient;
-   import com.mongodb.connection.netty.NettyStreamFactoryFactory;
    import io.netty.handler.ssl.SslContext;
    import io.netty.handler.ssl.SslContextBuilder;
    import io.netty.handler.ssl.SslProvider;
@@ -279,25 +278,35 @@ provided by Netty.
 
    The driver tests with Netty version ``{+nettyVersion+}``
 
-To instruct the driver to use `io.netty.handler.ssl.SslContext <https://netty.io/4.1/api/io/netty/handler/ssl/SslContext.html>`__,
-use the `NettyStreamFactoryFactory.Builder.sslContext <{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/netty/NettyStreamFactoryFactory.Builder.html#sslContext(io.netty.handler.ssl.SslContext)>`__
-method. See the method documentation for details about the different `io.netty.handler.ssl.SslProvider <https://netty.io/4.1/api/io/netty/handler/ssl/SslProvider.html>`__
-variants the driver supports and the implications of using them.
+To instruct the driver to use
+`io.netty.handler.ssl.SslContext <https://netty.io/4.1/api/io/netty/handler/ssl/SslContext.html>`__,
+configure
+`NettyTransportSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/NettyTransportSettings.html>`__
+when you define your `MongoClientSettings <{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.html>`__.
+Use `MongoClientSettings.Builder.transportSettings
+<{+api+}/apidocs/mongodb-driver-core/com/mongodb/MongoClientSettings.Builder.html#transportSettings(com.mongodb.connection.TransportSettings)>`__
+and `NettyTransportSettings.Builder.sslContext
+<{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/NettyTransportSettings.Builder.html#sslContext(io.netty.handler.ssl.SslContext)>`__
+to build your settings:
 
 .. code-block:: java
+   :emphasize-lines: 3-8
    :copyable: true
 
    SslContext sslContext = SslContextBuilder.forClient()
            .sslProvider(SslProvider.OPENSSL)
            .build();
    MongoClientSettings settings = MongoClientSettings.builder()
            .applyToSslSettings(builder -> builder.enabled(true))
-           .streamFactoryFactory(NettyStreamFactoryFactory.builder()
-                   .sslContext(sslContext)
-                   .build())
+           .transportSettings(TransportSettings.nettyBuilder()
+                              .sslContext(sslContext)
+                              .build())
            .build();
    MongoClient client = MongoClients.create(settings);
 
+For more details about the ``io.netty.handler.ssl.SslProvider``, see the `Netty
+documentation
+<https://netty.io/4.1/api/io/netty/handler/ssl/SslProvider.html>`__
 
 Online Certificate Status Protocol (OCSP)
 -----------------------------------------

source/upgrade.txt

@@ -80,8 +80,8 @@ This driver version introduces the following breaking changes:
     ``long`` instead of type ``int``. Because this change breaks both binary and source
     compatibility, update any source code that uses these methods and rebuild your binary.
 
-- The following record annotations from the
-  ``org.bson.codecs.record.annotations`` package are replaced with
+- Replaces the following record annotations from the
+  ``org.bson.codecs.record.annotations`` package with
   annotations of the same name from the ``org.bson.codecs.pojo.annotations`` package:
 
   - ``BsonId``
@@ -152,7 +152,7 @@ This driver version introduces the following breaking changes:
   ``BsonDecimal128.isNumber()`` now returns ``true``, and
   ``BsonDecimal128.asNumber()`` returns the equivalent ``BsonNumber``.
 
-- This driver version removes the `ServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ServerAddress.html>`__
+- Removes the `ServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ServerAddress.html>`__
   methods ``getSocketAddress()`` and ``getSocketAddresses()``.
 
   Instead of ``getSocketAddress()``, use the ``getByName()`` instance
@@ -161,7 +161,7 @@ This driver version introduces the following breaking changes:
   Instead of ``getSocketAddresses()``, use the ``getAllByName()`` instance
   method of ``java.net.InetAddress``.
 
-- This driver version removes the `UnixServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/UnixServerAddress.html>`__
+- Removes the `UnixServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/UnixServerAddress.html>`__
   methods ``getSocketAddress()`` and ``getUnixSocketAddress()``.
 
   Instead of ``getUnixSocketAddress()``, construct an instance of
@@ -283,11 +283,33 @@ This driver version introduces the following breaking changes:
 
 .. _java-breaking-changes-v5.0-list-collections:
 
-- This driver version adds support for a new ``authorizedCollection`` option of
+- Adds support for a new ``authorizedCollection`` option of
   the ``listCollections`` command. This introduces a breaking binary
   change in the ``MongoDatabase.listCollectionNames()`` methods, meaning any
   code using these methods must be recompiled. This change does not require any
   changes to source code.
+  
+- Removes the following methods and types related to the 
+  `StreamFactory
+  <https://mongodb.github.io/mongo-java-driver/4.11/apidocs/mongodb-driver-core/com/mongodb/connection/StreamFactory.html>`__
+
+- Removes the following methods and types related to the 
+  `Stream
+  <https://mongodb.github.io/mongo-java-driver/4.11/apidocs/mongodb-driver-core/com/mongodb/connection/Stream.html>`__
+  interface:
+
+  - ``streamFactoryFactory()`` method from ``MongoClientSettings.Builder``
+  - ``getStreamFactoryFactory()`` method from ``MongoClientSettings``
+  - ``NettyStreamFactoryFactory`` class
+  - ``NettyStreamFactory`` class
+  - ``AsynchronousSocketChannelStreamFactory`` class
+  - ``AsynchronousSocketChannelStreamFactoryFactory`` class
+  - ``BufferProvider`` interface
+  - ``SocketStreamFactory`` class
+  - ``Stream`` interface
+  - ``StreamFactory`` interface
+  - ``StreamFactoryFactory`` interface
+  - ``TlsChannelStreamFactoryFactory`` class
 
 .. _java-breaking-changes-v4.8: