com.mongodb.client

Interface MongoCursor<TResult>

Type Parameters:

TResult - The type of documents the cursor contains

All Superinterfaces:

java.lang.AutoCloseable, java.io.Closeable, java.util.Iterator<TResult>

@NotThreadSafe
public interface MongoCursor<TResult>
extends java.util.Iterator<TResult>, java.io.Closeable

The Mongo Cursor interface implementing the iterator protocol.

An application should ensure that a cursor is closed in all circumstances, e.g. using a try-with-resources statement:

 try (MongoCursor<Document> cursor = collection.find().iterator()) {
     while (cursor.hasNext()) {
         System.out.println(cursor.next());
     }
 }
 

Since:

3.0

Method Summary

Modifier and Type	Method and Description
void	close()
ServerAddress	getServerAddress() Returns the server address
ServerCursor	getServerCursor() Returns the server cursor, which can be null if the no cursor was created or if the cursor has been exhausted or killed.
boolean	hasNext()
TResult	next()
TResult	tryNext() A special next() case that returns the next element in the iteration if available or null.

Methods inherited from interface java.util.Iterator

forEachRemaining, remove

Method Detail

close

void close()

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

hasNext

boolean hasNext()

Specified by:

hasNext in interface java.util.Iterator<TResult>

next

TResult next()

Specified by:

next in interface java.util.Iterator<TResult>

tryNext

@Nullable
TResult tryNext()

A special next() case that returns the next element in the iteration if available or null.

Tailable cursors are an example where this is useful. A call to tryNext() may return null, but in the future calling tryNext() would return a new element if a document had been added to the capped collection.

Returns:

the next element in the iteration if available or null.

getServerCursor

@Nullable
ServerCursor getServerCursor()

Returns the server cursor, which can be null if the no cursor was created or if the cursor has been exhausted or killed.

Returns:

the ServerCursor, which can be null.

getServerAddress

ServerAddress getServerAddress()

Returns the server address

Returns:

ServerAddress