Package com.mongodb.client

Interface MongoCursor<TResult>

Type Parameters:
TResult - The type of documents the cursor contains
All Superinterfaces:
AutoCloseable, Closeable, Iterator<TResult>
All Known Subinterfaces:
MongoChangeStreamCursor<TResult>
@NotThreadSafe @Deprecated(since="2021-05-27") public interface MongoCursor<TResult> extends Iterator<TResult>, Closeable
Deprecated.
Usage of this API is not supported in AEM as a Cloud Service.
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
    Description
    void
    close()
    Deprecated.
     
    ServerAddress
    getServerAddress()
    Deprecated.
    Returns the server address
    ServerCursor
    getServerCursor()
    Deprecated.
    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()
    Deprecated.
     
    TResult
    next()
    Deprecated.
     
    TResult
    tryNext()
    Deprecated.
    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 Details

    • close

      void close()
      Deprecated.
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable

    • hasNext

      boolean hasNext()
      Deprecated.
      Specified by:
      hasNext in interface Iterator<TResult>

    • next

      TResult next()
      Deprecated.
      Specified by:
      next in interface Iterator<TResult>

    • tryNext

      @Nullable TResult tryNext()
      Deprecated.
      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()
      Deprecated.
      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()
      Deprecated.
      Returns the server address
      Returns:
      ServerAddress