Actualizar versiones de los controladores

Cambios importantes en la versión 5.5

• El controlador ya no es compatible con la versión 4.0 de MongoDB Server. Para obtener más información sobre este cambio, consulta la seccion Cambios en soporte de driver Version 5.5 servidor.

Cambios importantes en la versión 5.2

Esta versión del controlador introduce los siguientes cambios importantes:

• Se elimina la compatibilidad con MongoDB Server v.3.6 Para obtener más información sobre este cambio, consulte la sección "Cambios en la compatibilidad con el servidor de la versión del 5.2 controlador ".

• Se revisa el control de versiones de las dependencias de mongodb-crypt para que coincida con el control de versiones de los controladores de JVM. Futuras versiones de mongodb-crypt Se lanzan junto con el controlador y comparten el mismo número de versión. Debe actualizar su dependencia mongodb-crypt a v5.2.0 al actualizar el controlador para esta versión.

Cambios importantes en la versión 5.1

Esta versión del controlador introduce los siguientes cambios importantes:

• Al usar el mecanismo de autenticación MONGODB-OIDC, no se pueden incluir comas en el valor de la cadena de conexión authMechanismProperties. Si el valor authMechanismProperties incluye una coma, páselo como opción de conexión en una instancia MongoClientSettings.

Cambios importantes en la versión 5.0

Esta versión del controlador introduce los siguientes cambios importantes:

• Introduce los siguientes cambios en la clase ConnectionId:

  • El constructor ConnectionId ahora acepta un valor de tipo long como segundo parámetro en lugar de int. De igual forma, ahora acepta un valor de tipo Long como tercer parámetro en lugar de Integer. Dado que este cambio rompe la compatibilidad binaria, recompile cualquier código existente que llame al constructor ConnectionId.

  • El método withServerValue() ahora acepta un parámetro de tipo long en lugar de int. Dado que este cambio rompe la compatibilidad binaria, debe recompilar cualquier código que llame al método withServerValue().

  • El método getServerValue() ahora devuelve un valor de tipo Long en lugar de Integer. De forma similar, el método getLocalValue() devuelve un valor de tipo long en lugar de int. Dado que este cambio rompe la compatibilidad entre el binario y el código fuente, actualice cualquier código fuente que utilice estos métodos y reconstruya su binario.

• Reemplaza las siguientes anotaciones de registros del paquete org.bson.codecs.record.annotations con anotaciones del mismo nombre del paquete org.bson.codecs.pojo.annotations:

  • BsonId

  • BsonProperty

  • BsonRepresentation

• Se cambia el tipo de dato del parámetro de duración del tiempo de espera connectTimeout para los métodos SocketSettings.Builder.connectTimeout() y SocketSettings.Builder.readTimeout(). El tipo de dato de este parámetro ahora es long en lugar de int.

  En versiones anteriores, este parámetro era de tipo int para ambos métodos. Este cambio rompe la compatibilidad binaria y requiere una recompilación, pero no requiere cambios en el código.

• Se elimina el método Filters.eqFull(), disponible exclusivamente en Beta, que permitía construir un filtro de igualdad al realizar una búsqueda vectorial. En su lugar, se puede usar el método Filters.eq() al instanciar un tipo VectorSearchOptions, como se muestra en el siguiente código:

  val opts = vectorSearchOptions().filter(eq("x", 8))

• Cambia la forma en que ClusterSettings calcula la configuración ClusterConnectionMode, haciéndolo más consistente al usar el nombre del conjunto de réplicas especificado, independientemente de su configuración. Anteriormente, el controlador solo consideraba el nombre del conjunto de réplicas si estaba definido en la cadena de conexión.

  Por ejemplo, los dos ejemplos de código siguientes devuelven el valor ClusterConnectionMode.MULTIPLE. Anteriormente, el segundo ejemplo devolvía ClusterConnectionMode.SINGLE.

  ClusterSettings.builder()
      .applyConnectionString(ConnectionString("mongodb://127.0.0.1:27017/?replicaSet=replset"))
      .build()
      .mode

  ClusterSettings.builder()
      .hosts(listOf(ServerAddress("127.0.0.1", 27017)))
      .requiredReplicaSetName("replset")
      .build()
      .mode

• BsonDecimal128 Los valores responden a las llamadas de método de la misma manera que los valores Decimal128. BsonDecimal128.isNumber() ahora devuelve true y BsonDecimal128.asNumber() devuelve el equivalente BsonNumber.

• Elimina los métodos ServerAddress getSocketAddress() getSocketAddresses()y.

  En lugar de getSocketAddress(), utilice el método de instancia getByName() de java.net.InetAddress.

  En lugar de getSocketAddresses(), utilice el método de instancia getAllByName() de java.net.InetAddress.

• Elimina los métodos UnixServerAddress getSocketAddress() getUnixSocketAddress()y.

  En lugar de getSocketAddress(), utilice el método de instancia getByName() de java.net.InetAddress.

  En lugar getUnixSocketAddress() de, construya una instancia de.jnr.unixsocket.UnixSocketAddress Pase la ruta completa del archivo de socket UNIX al constructor. Por defecto, MongoDB crea un archivo de socket UNIX ubicado "/tmp/mongodb-27017.sock" en. Para obtener más información sobre la UnixSocketAddress clase, consulte la documentación de la API UnixSocketAddress.

• Elimina la interfaz Parameterizable. En lugar de implementar esta interfaz en un tipo Codec personalizado, anule el método CodecProvider.get() en el CodecProvider del códec si este está diseñado para un tipo parametrizado.

• Elimina el método isSlaveOk() de las clases ReadPreference y TaggableReadPreference. Para comprobar si una preferencia de lectura permite leer desde un miembro secundario de un conjunto de réplicas, utilice los métodos isSecondaryOk() de estas clases.

• Elimina los métodos auxiliares DBCollection.getStats() y DBCollection.isCapped() del comando collStats. En lugar de estos métodos, puede usar la etapa de canalización de agregación $collStats.

• Elimina las clases MapCodec y IterableCodec. En lugar de MapCodec, use MapCodecProvider. En lugar de IterableCodec, use CollectionCodecProvider o IterableCodecProvider para los tipos Iterable que no sean tipos Collection.

• Elimina los métodos sharded() y nonAtomic() de las clases MapReducePublisher y MapReduceIterable.

• Elimina los siguientes métodos para su uso con índices geoHaystack:

  • Indexes.geoHaystack()

  • IndexOptions.getBucketSize()

  • IndexOptions.bucketSize()

  En su lugar, puede usar la $geoNear etapa de canalización de agregación o un operador de consulta geoespacial en un 2índice d. Para obtener más información, consulte la página Consultas geoespaciales del manual de MongoDB Server.

• Elimina la opción oplogReplay de las operaciones de búsqueda. Los siguientes métodos oplogReplay ya no están disponibles:

  • DBCursor.oplogReplay()

  • DBCollectionFindOptions.isOplogReplay()

  • DBCollectionFindOptions.oplogReplay()

  • FindPublisher.oplogReplay()

  • FindIterable.oplogReplay()

• Elimina los siguientes constructores Exception:

  • MongoBulkWriteException(BulkWriteResult, List<BulkWriteError>, WriteConcernError, ServerAddress)

  • MongoCursorNotFoundException(long, ServerAddress)

  • MongoQueryException(ServerAddress, int, String)

  • MongoQueryException(ServerAddress, int, String, String)

  • MongoQueryException(MongoCommandException)

• Elimina las siguientes sobrecargas para el método BulkWriteResult.acknowledged():

  • acknowledged(Type, int, List<BulkWriteUpsert>)

  • acknowledged(Type, int, Integer, List<BulkWriteUpsert>)

  • acknowledged(int, int, int, Integer, List<BulkWriteUpsert>)

• Elimina los siguientes constructores ChangeStreamDocument:

  • ChangeStreamDocument(String, BsonDocument, BsonDocument, BsonDocument, TDocument, TDocument, BsonDocument, ...)

  • ChangeStreamDocument(String, BsonDocument, BsonDocument, BsonDocument, TDocument, BsonDocument, BsonTimestamp, ...)

  • ChangeStreamDocument(OperationType, BsonDocument, BsonDocument, BsonDocument, TDocument, BsonDocument, BsonTimestamp, ...)

• Elimina los siguientes constructores para eventos:

  • CommandEvent(RequestContext, int, ConnectionDescription, String)

  • CommandEvent(int, ConnectionDescription, String)

  • CommandEvent(RequestContext, long, int, ConnectionDescription, String)

  • CommandFailedEvent(RequestContext, int, ConnectionDescription, String, long, Throwable)

  • CommandFailedEvent(int, ConnectionDescription, String, long, Throwable)

  • CommandStartedEvent(RequestContext, int, ConnectionDescription, String, String, BsonDocument)

  • CommandStartedEvent(int, ConnectionDescription, String, String, BsonDocument)

  • CommandSucceededEvent(RequestContext, int, ConnectionDescription, String, BsonDocument, long)

  • CommandSucceededEvent(int, ConnectionDescription, String, BsonDocument, long)

  • ConnectionCheckedInEvent(ConnectionId)

  • ConnectionCheckedOutEvent(ConnectionId, long)

  • ConnectionCheckedOutEvent(ConnectionId)

  • ConnectionCheckOutFailedEvent(ServerId, long, Reason)

  • ConnectionCheckOutFailedEvent(ServerId, Reason)

  • ConnectionCheckOutStartedEvent(ServerId)

  • ConnectionReadyEvent(ConnectionId)

  • ServerHeartbeatFailedEvent(ConnectionId, long, Throwable)

  • ServerHeartbeatSucceededEvent(ConnectionId, BsonDocument, long)

• Elimina la opción errorLabels de la clase WriteConcernError. Esto incluye los métodos addLabel() y getErrorLabels(), así como el constructor que incluye un parámetro errorLabels. En su lugar, puede usar las etiquetas de error incluidas en el objeto MongoException que contiene el WriteConcernError.

• Elimina las siguientes clases del paquete com.mongodb.event:

  • ConnectionAddedEvent

  • ConnectionPoolOpenedEvent

  • ConnectionRemovedEvent

  • ClusterListenerAdapter

  • ConnectionPoolListenerAdapter

  • ServerListenerAdapter

  • ServerMonitorListenerAdapter

  El controlador también elimina los siguientes métodos relacionados de la interfaz ConnectionPoolListener:

  • connectionAdded()

  • connectionPoolOpened()

  • connectionRemoved()

  Para obtener más información sobre el paquete com.mongodb.event, consulte la documentación de la API.

• Añade la opción authorizedCollection al comando listCollections. Esto introduce un cambio binario importante en el método MongoDatabase.listCollectionNames(). Este cambio no requiere modificaciones en el código fuente, pero es necesario recompilar cualquier código que utilice este método.

• Elimina los siguientes métodos y tipos relacionados con la interfaz Stream:

  • MongoClientSettings.Builder.streamFactoryFactory() método. Utilice el método MongoClientSettings.Builder.transportSettings() en su lugar.

  • MongoClientSettings.getStreamFactoryFactory() método. Utilice el método MongoClientSettings.getTransportSettings() en su lugar.

  • NettyStreamFactoryFactory Clase. En su lugar, llame al método TransportSettings.nettyBuilder() para crear un objeto NettyTransportSettings. Luego, llame al método MongoClientSettings.Builder.transportSettings() para aplicar la configuración.

  • NettyStreamFactory clase.

  • AsynchronousSocketChannelStreamFactory clase.

  • AsynchronousSocketChannelStreamFactoryFactory clase.

  • BufferProvider interfaz.

  • SocketStreamFactory clase.

  • Stream interfaz.

  • StreamFactory interfaz.

  • StreamFactoryFactory interfaz.

  • TlsChannelStreamFactoryFactory clase.

Versión del servidor 8.1 Cambios de soporte

No se puede usar una versión 3.x del controlador de sincronización de Kotlin para conectarse a una implementación de MongoDB con MongoDB Server v8.1 o posterior. A partir de MongoDB Server v8.1, el comando buildinfo requiere autenticación, lo que provoca una incompatibilidad con el controlador v3.x.

Cambios en la compatibilidad del servidor con la versión del controlador 5.5

El5.5 controlador v deja de ser compatible con MongoDB Server.4.0 Para usar el5.5 controlador v, debe conectarse a MongoDB Server 4.2 o posterior. Para saber cómo actualizar su implementación de MongoDB Server, consulte las Notas de la versión en el manual de MongoDB Server.

Cambios en la compatibilidad del servidor con la versión del controlador 5.2

El5.2 controlador v deja de ser compatible con MongoDB Server.3.6 Para usar el5.2 controlador v, debe conectarse a MongoDB Server 4.0 o posterior. Para saber cómo actualizar su implementación de MongoDB Server, consulte las Notas de la versión en el manual de MongoDB Server.

Cambios en la compatibilidad del servidor con la versión del controlador 4.8

El4.8 controlador v ya no es compatible con MongoDB Server 3.4 y versiones anteriores. Para usar el4.8 controlador v, debe conectarse a MongoDB Server 3.6 o versiones posteriores. Para saber cómo actualizar su implementación de MongoDB Server, consulte las Notas de la versión en el manual de MongoDB Server.