Configurações do soquete

Visão geral

Neste guia, você aprenderá como o driver Java gerencia as configurações de soquete.

Você pode especificar configurações para seus soquetes usando umastring de conexão ou passando um objeto MongoClientSettings para o construtor MongoClients. Selecione a aba Connection String ou MongoClientSettings para visualizar as opções disponíveis:

Nome da opção	Tipo	Descrição
`connectTimeoutMS`	inteiro	Especifica o tempo máximo, em milésimos de segundo, que o driver Java aguarda a abertura de uma conexão antes de atingir o tempo-limite. Um valor de `0` instrui o driver a nunca atingir o tempo-limite enquanto espera a abertura de uma conexão. Padrão: `10000` (10 segundos)
`socketTimeoutMS`	inteiro	Especifica a quantidade máxima de tempo, em milissegundos, que o driver Java aguardará para enviar ou receber uma solicitação antes de atingir o tempo limite. Um valor de `0` instrui o driver a nunca expirar enquanto aguarda para enviar ou receber uma solicitação. Padrão: `0`

Este exemplo especifica que o driver atingirá o tempo limite após 15 segundos de espera pela abertura de uma conexão:

ConnectionString connectionString = "mongodb://<host>:<port>/?connectTimeoutMS=15000"
MongoClient mongoClient = MongoClients.create(connectionString)

Para obter mais informações sobre esses parâmetros, consulte a documentação da APIConnectionString .

Encadeie o método applyToSocketSettings() para modificar o comportamento do driver ao se conectar e se comunicar com sua implantação do MongoDB.

A tabela a seguir descreve os métodos que você pode conectar às suas configurações para modificar o comportamento do driver:

Método	Descrição
`applyConnectionString()`	Usa as configurações de um objeto `ConnectionString`.
`applySettings()`	Utiliza as definições de terminais especificadas num objeto `SocketSettings`.
`connectTimeout()`	Define o tempo máximo para se conectar a um soquete disponível antes de lançar uma exceção de tempo limite. Padrão: `10 seconds`
`readTimeout()`	Define o tempo máximo para ler a partir de um soquete disponível antes de lançar uma exceção de tempo limite. Padrão: `0`, que indica que não há tempo limite
`receiveBufferSize()`	Define o tamanho do buffer do soquete ao receber. Padrão: O padrão do sistema operacional
`sendBufferSize()`	Define o tamanho do buffer do soquete ao enviar. Padrão: O padrão do sistema operacional

Observação

Conecte-se ao MongoDB usando um proxy SOCKS5

Você pode encadear o método applyToProxySettings() às suas configurações de soquete para se conectar ao MongoDB usando um proxy SOCKS5. Para saber como usar um proxy SOCKS5 e definir as configurações de proxy, consulte o guia Como conectar ao MongoDB usando um proxy SOCKS5 .

Este exemplo especifica o seguinte comportamento do driver em um soquete do MongoDB:

Para se conectar a um soquete disponível em 10 SECONDS
Para ler um soquete disponível dentro 15 SECONDS

MongoClient mongoClient = MongoClients.create(
    MongoClientSettings.builder()
    .applyConnectionString(new ConnectionString("<your connection string>"))
    .applyToSocketSettings(builder ->
        builder.connectTimeout(10, SECONDS)
        .readTimeout(15, SECONDS))
    .build());

Para obter mais informações sobre os métodos encadeados, consulte a documentação da API do MongoClientSettings.Builder.

Voltar

Configurações do Servidor

Definir configurações de CRUD no nível do cliente