Localizar vários documentos

Você pode executar uma query de vários documentos em uma coleção chamando o método find() em um objeto MongoCollection. Passe um filtro de query para o método find() para consultar e retornar documentos que correspondam ao filtro na collection. Se você não incluir um filtro, o MongoDB retornará todos os documentos na collection.

Para obter mais informações sobre como fazer query no MongoDB com o driver Java, veja nossoguia sobre como fazer query de documentos.

Você também pode encadear métodos para o método find(), como sort(), que organiza os documentos correspondentes em uma ordem especificada e projection(), que configura os campos incluídos nos documentos retornados.

Para obter mais informações sobre o método de sort(), veja nosso guia de classificação. Para obter mais informações sobre o método de projection(), veja nosso guia de projeções

O método find() retorna uma instância do FindIterable, uma classe que oferece vários métodos para acessar, organizar e percorrer os resultados. O FindIterable também herda métodos de sua classe pai, MongoIterable que implementa o núcleo da interface Java Iterable.

Você pode chamar o método iterator() no MongoIterable para gerar uma instância do MongoCursor que você pode usar para cruzar os resultados. Você pode chamar métodos no MongoCursor, como hasNext(), para conferir se existem resultados adicionais, ou next(), para gerar o próximo documento da collection. Se nenhum documento corresponder à query, a chamada hasNext() gerará false e, portanto, chamar next() lançará uma exceção.

Se você chamar next() no iterador depois dele ter gerado o resultado final ou quando não houver resultados, ele lançará uma exceção do tipo java.util.NoSuchElementException. Sempre use hasNext() para conferir se existem resultados adicionais antes de chamar next().

package usage.examples;
import static com.mongodb.client.model.Filters.lt;
import org.bson.Document;
import org.bson.conversions.Bson;
import com.mongodb.client.MongoClient;
import com.mongodb.client.MongoClients;
import com.mongodb.client.MongoCollection;
import com.mongodb.client.MongoCursor;
import com.mongodb.client.MongoDatabase;
import com.mongodb.client.model.Projections;
import com.mongodb.client.model.Sorts;
public class Find {
    public static void main( String[] args ) {
        // Replace the uri string with your MongoDB deployment's connection string
        String uri = "<connection string uri>";
        try (MongoClient mongoClient = MongoClients.create(uri)) {
            MongoDatabase database = mongoClient.getDatabase("sample_mflix");
            MongoCollection<Document> collection = database.getCollection("movies");
            Bson projectionFields = Projections.fields(
                    Projections.include("title", "imdb"),
                    Projections.excludeId());
            MongoCursor<Document> cursor = collection.find(lt("runtime", 15))
                    .projection(projectionFields)
                    .sort(Sorts.descending("title")).iterator();
            try {
                while(cursor.hasNext()) {
                    System.out.println(cursor.next().toJson());
                }
            } finally {
                cursor.close();
            }
        }
    }
}