Menu Docs
Página inicial do Docs
/ / /
Kotlin Coroutine

NOVIDADES

Nesta página

  • Novidades no 5.2
  • Novidades em 5.1.3
  • Novidades em 5.1.2
  • Novidades em 5.1.1
  • Novidades no 5.1
  • Novidades no 5.0
  • Novidades no 4.11
  • Novidades no 4.10

Descubra as novidades de cada versão:

  • Versão 5.2

  • Versão 5.1.3

  • Versão 5.1.2

  • Versão 5.1.1

  • Versão 5.1

  • Versão 5.0

  • Versão 4.11

  • Versão 4.10

A versão do driver 5.2 inclui os seguintes novos recursos, melhorias e correções:

  • Adiciona a classe SearchIndexType , que você pode passar ao construir uma instância do SearchIndexModel . Esta alteração permite a você especificar o tipo de índice ao criar um índice de Atlas Search ou Vector Search . Para saber mais, consulte Índices doAtlas Search e Vector Search no guia Índices.

  • Delega a implementação dos algoritmos que implementam os mecanismos de autenticação SCRAM-SHA-1 e SCRAM-SHA-256 ao provedor JCA configurado. Essa alteração significa que seu aplicação pode usar um provedor JCA configurado compatível com FIPS para fornecer um nível mais alto de segurança.

  • Revisa o mongodb-crypt versão de dependência para corresponder à versão para os drivers JVM . Futuras versões do mongodb-crypt serão lançadas junto com o driver e compartilharão o mesmo número de versão. Você deve atualizar sua dependência mongodb-crypt para v5.2.0 ao atualizar seu driver para esta versão. Para saber mais, consulte o guia criptografia em execução em execução.

  • Melhorias de desempenho devido à implementação de criptografia nativa em todas as plataformas suportadas. A lista a seguir descreve as ações necessárias para implementar essa melhoria dependendo do seu sistema operacional:

    • Windows: atualize sua versão do mongodb-crypt para v5.2.0.

    • Mac: atualize sua versão do mongodb-crypt para v5.2.0.

    • Linux: instale libmongocrypt.so diretamente no sistema de arquivos, em vez de usar o arquivo fornecido com o arquivo JAR mongodb-crypt . Você pode encontrar instruções do Linux para instalar o libmongocrypt no manual do Servidor. Se você usar um gerenciador de pacote para instalar o libmongocrypt, o Java Native Access (JNA) o encontrará lá sem configurações adicionais. Como alternativa, você pode especificar o caminho da pesquisa definindo a variável de ambiente LD_LIBRARY_PATH para o caminho do arquivo do pacote libmongocrypt .

      Recomendamos a instalação direta porque a biblioteca compartilhada agrupada não está vinculada ao OpenSSL devido ao potencial de incompatibilidades binárias do OpenSSL.

      O carregamento da biblioteca compartilhada é tratado pelo JNA. Você pode visualizar as regras para a ordem do caminho da pesquisa de carregamento da biblioteca na documentação da classe NativeLibrary.

  • Corrige um problema que fazia com que os métodos InsertOneResult.getInsertedId() e InsertManyResult.getInsertedIds() retornassem IDs de documento incorretos em algumas situações. Essa alteração é portada para o driver Kotlin v5.1.4 e v4.11.4.

  • Quando uma operação de cluster fragmentado não obtém êxito, o driver evita selecionar o mesmo servidor mongos para tentativas de repetição de operação se outros servidores mongos estiverem disponíveis.

  • Adiciona metadados de acessibilidade necessários quando seu aplicação usa Imagem nativa do GraalVM. Esses metadados substituem a necessidade de coletar metadados de acessibilidade ao usar as bibliotecas de drivers. Para saber mais, consulte Metadados de Acessibilidade na documentação do GraalVM.

    Essa alteração não adiciona as entradas de recursos libjnidispatch e libmongocrypt , porque a adição de entradas para todas as plataformas suportadas (destinos) afeta significativamente o tamanho dos executáveis nativos criados usando a GraalVM Native Imagem. Veja esta amostra resource-config.json no repositório do driver Github para ver como especificar essas entradas explicitamente se seu aplicação depender da org.mongodb:mongodb-crypt biblioteca.

  • Ativa a pesquisa vetorial exata estendendo a API VectorSearchOptions para introduzir os seguintes subtipos de opção específicas:

    • ExactVectorSearchOptions: use esse tipo de opções para habilitar a correspondência precisa, garantindo que os resultados sejam os vetores mais próximos de um determinado vetor de consulta.

    • ApproximateVectorSearchOptions: use este tipo de opções para habilitar pesquisas que podem não retornar os vetores exatos mais próximos. Você pode passar um parâmetro numCandidates ao instanciar esse tipo para especificar o número de vizinhos mais próximos a serem considerados.

    Para saber mais sobre como usar o recurso Atlas Vector Search , consulte Atlas Vector Search no guia Aggregates Builders.

  • Adiciona suporte para serializadores da biblioteca kotlinx-datetime que permitem mapear tipos de data e hora de Kotlin para BSON como os tipos esperados em vez de strings. Para saber mais, consulte a seção Serialize Dates and Times do guia Kotlin Serialization.

  • Suporta serialização de JsonElement valores. Para trabalhar com o tipo JsonElement , você deve adicionar a biblioteca kotlinx-serialization-json como uma dependência em seu aplicação.

O 5.1.3 a versão do patch do driver inclui as seguintes alterações:

  • Corrige um problema que pode causar erros de asserção ao usar Cursor tipos.

O 5.1.2 a versão do patch do driver inclui as seguintes alterações:

  • Suporte para codificação de classes de dados Kotlin com tipos de parâmetro genéricos anuláveis. Por exemplo, você pode codificar a classe Container no seguinte código:

    @Serializable
    data class Box<T>(
    val boxed: T
    )
    @Serializable
    data class Container(
    val box: Box<String?>
    )

O 5.1.1 a versão do patch do driver inclui as seguintes alterações:

  • Ao usar o mecanismo de autenticação MONGODB-OIDC , você não deve incluir vírgulas no valor da string de conexão authMechanismProperties . Para saber mais sobre esse comportamento, consulte a seção MONGODB-OIDC do guia Autenticação empresarial.

Aviso

Depreciações nesta versão

Para evitar alterações significativas em futuras versões principais do driver, substitua qualquer código de aplicativo que dependa de elementos de programa obsoletos.

Esta seção inclui as seguintes informações:

  • O suporte para o servidor MongoDB v3.6 está obsoleto e será removido na próxima versão do driver. Para saber como atualizar seu sistema do servidor MongoDB, consulte Notas de versão no manual do servidor MongoDB.

  • Testes internos da tecnologia de imagem nativa GraalVM. Esses testes envolvem a criação de aplicativos nativos usando a ferramenta de imagem nativa GraalVM.

  • Suporte aprimorado para o mecanismo de autenticação MONGODB-OIDC . Para saber mais sobre o OIDC, consulte a seção MONGODB-OIDC do guia Mecanismos de autenticação empresarial.

  • Corrige um problema no qual as operações usavam o codec incorreto ao usar uma instância polimórfica MongoCollection . Isso garante que as informações do discriminador não sejam perdidas ao usar bson-kotlinx.

  • Corrige um problema no qual o discriminador de classe era o primeiro campo ao decodificar, resultando em erros de tipo de campo ao usar uma instância polimórfica MongoCollection .

  • Suporte para serialização polimórfica . Para saber mais, consulte a seção Serialização polimórfica do guia Serialização Kotlin .

  • Introduz a opção serverMonitoringMode de conexão URI. Para saber mais, consulte o guia Opções de conexão .

Os novos recursos da versão do driver 5.0 incluem:

  • O construtor KotlinSerializerCodecProvider agora aceita objetos serializersModule e bsonConfiguration :

    KotlinSerializerCodec.create(clazz.kotlin, serializersModule=serializersModule, bsonConfiguration=bsonConfiguration)

    Isso torna mais fácil personalizar sua configuração.

  • Corrige um bug de reflexão do Kotlin que resultou no apagamento do tipo de container.

Esta seção inclui as seguintes informações:

Aviso

Depreciações nesta versão

Para evitar alterações significativas em futuras versões principais do driver, substitua qualquer código de aplicativo que dependa de métodos e tipos preteridos.

A versão 4.11 do driver substitui os seguintes itens:

  • Os seguintes métodos relacionados ao endereço de rede são preteridos e serão removidos na v5.0:

    • O ServerAddress métodos getSocketAddress() e getSocketAddresses().

      Em vez de getSocketAddress(), utilize o método de instância getByName() de java.net.InetAddress.

      Em vez de getSocketAddresses(), utilize o método de instância getAllByName() de java.net.InetAddress.

    • O UnixServerAddress método getUnixSocketAddress().

      Em vez de getUnixSocketAddress(), construa uma instância de jnr.unixsocket.UnixSocketAddress. Passe o caminho completo do arquivo de soquete UNIX para o construtor. Por padrão, o MongoDB cria um arquivo de soquete UNIX localizado em "/tmp/mongodb-27017.sock". Para saber mais sobre o UnixSocketAddress, consulte a documentação da API UnixSocketAddress.

  • Os seguintes métodos e tipos relacionados à StreamFactory interface são preteridas e programadas para remoção na v5.0:

    • streamFactoryFactory() método de MongoClientSettings.Builder

    • getStreamFactoryFactory() método de MongoClientSettings

    • NettyStreamFactoryFactory classe

    • NettyStreamFactory classe

    • AsynchronousSocketChannelStreamFactory classe

    • AsynchronousSocketChannelStreamFactoryFactory classe

    • BufferProvider classe

    • SocketStreamFactory classe

    • Stream classe

    • StreamFactory classe

    • StreamFactoryFactory classe

    • TlsChannelStreamFactoryFactory classe

    Se você configurar o Netty utilizando MongoClientSettings.Builder.streamFactoryFactory(), seu código poderá se assemelhar ao seguinte:

    import com.mongodb.connection.netty.NettyStreamFactoryFactory;
    // ...
    MongoClientSettings settings = MongoClientSettings.builder()
    .streamFactoryFactory(NettyStreamFactoryFactory.builder().build())
    .build();

    Substitua este código pelo TransportSettings.nettyBuilder() como mostrado no exemplo a seguir:

    import com.mongodb.connection.TransportSettings;
    // ...
    MongoClientSettings settings = MongoClientSettings.builder()
    .transportSettings(TransportSettings.nettyBuilder().build())
    .build();

Os novos recursos da versão 4.11 do driver incluem:

  • Suporte para conexão ao MongoDB usando um proxy SOCKS5.

  • Foi adicionado o método getSplitEvent() à classe ChangeStreamDocument para identificar fragmentos de um evento de fluxo de alteração que excede 16 MB. Você deve usar o estágio de agregação $changeStreamSplitLargeEvent em seu fluxo de alterações para lidar com eventos que excedam 16 MB.

  • Foi adicionado um construtor de estágio de agregação para $vectorSearch.

  • Foram adicionados assistentes de gerenciamento de índices do Atlas Search.

  • Versões atualizadas da biblioteca de compressão Snappy e Zstd. Para saber mais sobre as versões de dependência atuais, consulte Compressão de rede.

  • Foram adicionados métodos getElapsedTime() às seguintes classes para monitorar a duração dos eventos do pool de conexões:

  • Suporte para threads virtuais Java 21 e simultaneidade estruturada. Os componentes internos do driver foram atualizados para evitar a fixação desnecessária de threads virtuais e para preservar o status de interrupção de um thread, já que esse último é importante para a simultaneidade estruturada, onde é usado para cancelamento.

    Para saber mais sobre os threads virtuais, consulte a seção Threads virtuais proposta de aprimoramento do JDK. Para saber mais sobre simultaneidade estruturada, consulte a seção SimultaneidadeEstruturada proposta de aprimoramento do JDK.

  • Documentação da API atualizada para os seguintes tipos:

Importante

A partir da versão 4.10.1 do driver Kotlin, você deve adicionar a biblioteca bson-kotlinx como uma dependência explícita para usar a biblioteca kotlinx-serialization .

  • Suporte para uso do lado do servidor Kotlin, tanto para corrotinas quanto para aplicativos síncronos.

  • Suporte de codec para classes de dados Kotlin.

  • Suporte para a biblioteca kotlinx.serialization

Voltar

Referência rápida