Limite el tiempo de ejecución del servidor

Valores de tiempo de espera aceptados

La siguiente tabla describe el comportamiento de espera correspondiente a los valores aceptados para timeoutMS:

Si se especifica la opción timeoutMS, el driver aplica automáticamente el timeout especificado a cada operación del servidor. El siguiente ejemplo de código especifica un tiempo de espera de 200 milisegundos a nivel de cliente y luego llama al método MongoCollection.insertOne():

MongoClientSettings settings = MongoClientSettings.builder()
        .applyConnectionString(new ConnectionString("<connection string>"))
        .timeout(200L, MILLISECONDS)
        .build();
try (MongoClient mongoClient = MongoClients.create(settings)) {
    MongoDatabase database = mongoClient.getDatabase("db");
    MongoCollection<Document> collection = database.getCollection("people");
    collection.insertOne(new Document("name", "Francine Loews"));
}

Herencia de tiempo de espera

Cuando se especifica la opción timeoutMS, el controlador aplica el tiempo de espera de acuerdo con los mismos comportamientos de herencia que las demás opciones del controlador Java Reactive Streams. La siguiente tabla describe cómo se hereda el valor del tiempo de espera en cada nivel:

Para obtener más información sobre las anulaciones y las opciones específicas, consulta la siguiente sección de Anulaciones.

Transacciones

Al crear una nueva instancia de ClientSession para implementar una transacción, utiliza el método defaultTimeout() al construir una instancia de ClientSessionOptions. Puedes usar esta opción para especificar el tiempo de espera para los siguientes métodos:

• commitTransaction()

• abortTransaction()

• withTransaction()

• close()

El siguiente código muestra cómo configurar el defaultTimeout al crear una instancia de un ClientSession:

ClientSessionOptions opts = ClientSessionOptions.builder()
        .defaultTimeout(200L, MILLISECONDS)
        .build();
Publisher<ClientSession> session = mongoClient.startSession(opts);
// ... perform operations on ClientSession

Si no se especifica el defaultTimeout, el controlador utiliza el valor de tiempo de espera establecido en el MongoClient principal.

También puedes establecer un tiempo de espera a nivel de transacción llamando al método timeout() al crear una instancia de TransactionOptions. La configuración de esta opción aplica un tiempo de espera a todas las operaciones realizadas en el ámbito de la transacción:

TransactionOptions transactionOptions = TransactionOptions.builder()
        .timeout(200L, MILLISECONDS)
        .build();

Para obtener más información sobre las transacciones, consulte Transactions guide.

Cifrado del cliente

Cuando usas la Encriptación de Campo a Nivel de Cliente (CSFLE), el driver utiliza la opción timeoutMS para limitar el tiempo permitido para las operaciones de encriptación y desencriptación. Puedes configurar una opción de tiempo de espera para tu instancia de ClientEncryption llamando al método timeout() al crear una instancia de ClientEncryptionSettings.

Si especificas el tiempo de espera cuando construyes una instancia de ClientEncryption, el tiempo de espera controla la duración de todas las operaciones realizadas en esa instancia. Si no se proporciona un tiempo de espera al instanciar ClientEncryption, la instancia hereda la configuración de tiempo de espera de MongoClient utilizado en el constructor ClientEncryption.

Si se establece timeoutMS tanto en el cliente como directamente en ClientEncryption, se le da prioridad al valor que se proporciona a ClientEncryption.

Modo de tiempo de vida del cursor

El modo de tiempo de vida del cursor utiliza la configuración de tiempo de espera para limitar toda la vida útil de un cursor. En este modo, tu aplicación debe inicializar el cursor, completar todas las llamadas a los métodos del cursor y devolver todos los documentos dentro del límite de tiempo especificado. De lo contrario, el tiempo de vida del cursor expira y el driver genera un error de tiempo de espera.

Cuando cierras un cursor llamando al método close(), el tiempo de espera se restablece para el comando killCursors para asegurar que los recursos del servidor se limpien.

El siguiente ejemplo muestra cómo configurar un tiempo de espera del cursor para asegurar que el cursor esté inicializado y que todos los documentos se recuperen dentro del tiempo de espera heredado:

FindPublisher<Document> findPublisherWithLifetimeTimeout = collection
        .find(gte("age", 40))
        .timeoutMode(TimeoutMode.CURSOR_LIFETIME);