@@ -36,161 +36,6 @@ Upcoming Breaking Changes
36
36
are deprecated in MongoDB v4.2 and later. They will be replaced by the
37
37
aggregation framework and removed in a future release.
38
38
39
- .. _version-4.11:
40
-
41
- What's New in 4.11
42
- ------------------
43
-
44
- This section includes the following information:
45
-
46
- - :ref:`java-deprecations-4.11`
47
- - :ref:`java-new-features-4.11`
48
-
49
- .. _java-deprecations-4.11:
50
-
51
- Deprecations in 4.11
52
- ~~~~~~~~~~~~~~~~~~~~
53
-
54
- .. warning:: Deprecations in this release
55
-
56
- To avoid breaking changes in future major releases of the driver,
57
- replace any application code that depends on deprecated methods and types.
58
-
59
- The 4.11 driver release deprecates the following items:
60
-
61
- - The ``getStats()`` and ``isCapped()`` instance methods of the
62
- ``DBCollection`` class are deprecated. The corresponding server
63
- commands are deprecated in MongoDB v6.2 and later. Use the ``$collStats``
64
- aggregation pipeline stage to retrieve the information provided by these
65
- methods instead. You can run the aggregation as shown in the following code
66
- example:
67
-
68
- .. code-block:: java
69
-
70
- Cursor cursor = collection.aggregate(Arrays.asList(
71
- new BasicDBObject("$collStats",
72
- new BasicDBObject("storageStats", new BasicDBObject()))),
73
- AggregationOptions.builder().build()
74
- );
75
-
76
- To determine whether a collection is a capped collection, access the value
77
- of the ``storageStats.capped`` field returned by ``Cursor`` instance in the
78
- preceding example aggregation.
79
-
80
- To learn more about the ``$collStats`` aggregation operator, see the
81
- :manual:`$collStats (aggregation) </reference/operator/aggregation/collStats/>`
82
- Server manual entry.
83
-
84
- - The following network address-related methods are deprecated and will be removed
85
- in v5.0:
86
-
87
- - The `ServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/ServerAddress.html>`__
88
- methods ``getSocketAddress()`` and ``getSocketAddresses()``.
89
-
90
- Instead of ``getSocketAddress()``, use the ``getByName()`` instance
91
- method of ``java.net.InetAddress``.
92
-
93
- Instead of ``getSocketAddresses()``, use the ``getAllByName()`` instance
94
- method of ``java.net.InetAddress``.
95
-
96
- - The `UnixServerAddress <{+api+}/apidocs/mongodb-driver-core/com/mongodb/UnixServerAddress.html>`__
97
- method ``getUnixSocketAddress()``.
98
-
99
- Instead of ``getUnixSocketAddress()``, construct an instance of
100
- ``jnr.unixsocket.UnixSocketAddress``. Pass the full path of the UNIX
101
- socket file to the constructor. By default, MongoDB creates a UNIX
102
- socket file located at ``"/tmp/mongodb-27017.sock"``. To learn more
103
- about the ``UnixSocketAddress``, see the `UnixSocketAddress <https://www.javadoc.io/doc/com.github.jnr/jnr-unixsocket/latest/jnr/unixsocket/UnixSocketAddress.html>`__ API documentation.
104
-
105
- - The following methods and types related to the
106
- `StreamFactory <https://mongodb.github.io/mongo-java-driver/4.10/apidocs/mongodb-driver-core/com/mongodb/connection/StreamFactory.html>`__
107
- interface are deprecated and scheduled for removal in v5.0:
108
-
109
- - ``streamFactoryFactory()`` method from ``MongoClientSettings.Builder``
110
- - ``getStreamFactoryFactory()`` method from ``MongoClientSettings``
111
- - ``NettyStreamFactoryFactory`` class
112
- - ``NettyStreamFactory`` class
113
- - ``AsynchronousSocketChannelStreamFactory`` class
114
- - ``AsynchronousSocketChannelStreamFactoryFactory`` class
115
- - ``BufferProvider`` class
116
- - ``SocketStreamFactory`` class
117
- - ``Stream`` class
118
- - ``StreamFactory`` class
119
- - ``StreamFactoryFactory`` class
120
- - ``TlsChannelStreamFactoryFactory`` class
121
-
122
- If you configure Netty by using
123
- ``MongoClientSettings.Builder.streamFactoryFactory()``, your code might resemble
124
- the following:
125
-
126
- .. code-block:: java
127
- :emphasize-lines: 6
128
- :copyable: false
129
-
130
- import com.mongodb.connection.netty.NettyStreamFactoryFactory;
131
-
132
- // ...
133
-
134
- MongoClientSettings settings = MongoClientSettings.builder()
135
- .streamFactoryFactory(NettyStreamFactoryFactory.builder().build())
136
- .build();
137
-
138
- Replace this code with the `TransportSettings.nettyBuilder() <{+api+}/apidocs/mongodb-driver-core/com/mongodb/connection/TransportSettings.html>`__
139
- as shown in the following example:
140
-
141
- .. code-block:: java
142
- :emphasize-lines: 6
143
-
144
- import com.mongodb.connection.TransportSettings;
145
-
146
- // ...
147
-
148
- MongoClientSettings settings = MongoClientSettings.builder()
149
- .transportSettings(TransportSettings.nettyBuilder().build())
150
- .build();
151
-
152
-
153
- .. _java-new-features-4.11:
154
-
155
- New Features in 4.11
156
- ~~~~~~~~~~~~~~~~~~~~
157
-
158
- New features of the 4.11 driver release include:
159
-
160
- - Support for connecting to MongoDB by using a SOCKS5 proxy. To learn more
161
- see :ref:`java-connect-socks`.
162
- - Added the ``getSplitEvent()`` method to the ``ChangeStreamDocument`` class
163
- to identify fragments of a change stream event that exceeds 16MB. You must
164
- use the aggregation stage ``$changeStreamSplitLargeEvent`` in your change
165
- stream to handle events that exceed 16MB. To learn more, see :ref:`java-split-change-stream-events`.
166
- - Added an aggregation stage builder for ``$vectorSearch``. To learn more, see :ref:`Atlas Vector Search <java-atlas-vector-search>`.
167
- - Added Atlas Search index management helpers. To learn more, see :ref:`Atlas Search Indexes <search-indexes>`.
168
- - Updated Snappy and Zstd compression library dependency versions. To learn
169
- more about the current dependency versions, see :ref:`network-compression`.
170
- - Added ``getElapsedTime()`` methods to the following classes to monitor the
171
- duration of connection pool events:
172
-
173
- - `ConnectionCheckOutFailedEvent <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ConnectionCheckOutFailedEvent.html>`__
174
- - `ConnectionCheckedOutEvent <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ConnectionCheckedOutEvent.html>`__
175
- - `ConnectionReadyEvent <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ConnectionReadyEvent.html>`__
176
-
177
- - Support for Java 21 virtual threads and structured concurrency. The driver
178
- internals were updated to avoid unnecessary pinning of virtual threads
179
- and to preserve interrupted status of a thread, as the latter matters for
180
- structured concurrency where it is used for cancellation.
181
-
182
- To learn more about virtual threads, see the `Virtual Threads <https://openjdk.org/jeps/444>`__
183
- JDK enhancement proposal. To learn more about structured concurrency, see the
184
- `Structured Concurrency <https://openjdk.org/jeps/453>`__
185
- JDK enhancement proposal.
186
-
187
- - Updated API documentation for the following types:
188
-
189
- - `ClusterListener <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ClusterListener.html>`__
190
- - `ServerListener <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ServerListener.html>`__
191
- - `ServerMonitorListener <{+api+}/apidocs/mongodb-driver-core/com/mongodb/event/ServerMonitorListener.html>`__
192
-
193
-
194
39
.. _version-4.10:
195
40
196
41
What's New in 4.10
0 commit comments