Package com.mongodb.connection

Interface Connection

  • All Superinterfaces:
    ReferenceCounted
    Deprecated.

    @ThreadSafe
@Deprecated
public interface Connection
extends ReferenceCounted
    A synchronous connection to a MongoDB server with blocking operations.

    Implementations of this class are thread safe.

    This interface is not stable. While methods will not be removed, new ones may be added.

    Since:
    3.0

    • Method Detail

      • retain

        Connection retain​()
        Deprecated. 
        Description copied from interface: ReferenceCounted
        Retain an additional reference to this object. All retained references must be released, or there will be a leak.
        Specified by:
        retain in interface ReferenceCounted
        Returns:
        this

      • getDescription

        ConnectionDescription getDescription​()
        Deprecated. 
        Gets the description of the connection.
        Returns:
        the connection description

      • insert

        WriteConcernResult insert​(MongoNamespace namespace,
                          boolean ordered,
                          InsertRequest insertRequest)
        Deprecated. 
        Insert the documents using the insert wire protocol and apply the write concern.
        Parameters:
        namespace - the namespace
        ordered - whether the writes are ordered
        insertRequest - the insert request
        Returns:
        the write concern result

      • update

        WriteConcernResult update​(MongoNamespace namespace,
                          boolean ordered,
                          UpdateRequest updateRequest)
        Deprecated. 
        Update the documents using the update wire protocol and apply the write concern.
        Parameters:
        namespace - the namespace
        ordered - whether the writes are ordered
        updateRequest - the update request
        Returns:
        the write concern result

      • delete

        WriteConcernResult delete​(MongoNamespace namespace,
                          boolean ordered,
                          DeleteRequest deleteRequest)
        Deprecated. 
        Delete the documents using the delete wire protocol and apply the write concern.
        Parameters:
        namespace - the namespace
        ordered - whether the writes are ordered
        deleteRequest - the delete request
        Returns:
        the write concern result

      • command

        <T> T command​(String database,
              BsonDocument command,
              FieldNameValidator fieldNameValidator,
              ReadPreference readPreference,
              Decoder<T> commandResultDecoder,
              SessionContext sessionContext)
        Deprecated. 
        Execute the command.
        Type Parameters:
        T - the type of the result
        Parameters:
        database - the database to execute the command in
        command - the command document
        fieldNameValidator - the field name validator for the command document
        readPreference - the read preference that was applied to get this connection, or null if this is a write operation
        commandResultDecoder - the decoder for the result
        sessionContext - the session context
        Returns:
        the command result
        Since:
        3.6

      • command

        <T> T command​(String database,
              BsonDocument command,
              FieldNameValidator commandFieldNameValidator,
              ReadPreference readPreference,
              Decoder<T> commandResultDecoder,
              SessionContext sessionContext,
              boolean responseExpected,
              SplittablePayload payload,
              FieldNameValidator payloadFieldNameValidator)
        Deprecated. 
        Executes the command, consuming as much of the SplittablePayload as possible.
        Type Parameters:
        T - the type of the result
        Parameters:
        database - the database to execute the command in
        command - the command document
        commandFieldNameValidator - the field name validator for the command document
        readPreference - the read preference that was applied to get this connection, or null if this is a write operation
        commandResultDecoder - the decoder for the result
        sessionContext - the session context
        responseExpected - true if a response from the server is expected
        payload - the splittable payload to incorporate with the command
        payloadFieldNameValidator - the field name validator for the payload documents
        Returns:
        the command result
        Since:
        3.6

      • query

        @Deprecated
<T> QueryResult<T> query​(MongoNamespace namespace,
                         BsonDocument queryDocument,
                         BsonDocument fields,
                         int numberToReturn,
                         int skip,
                         boolean slaveOk,
                         boolean tailableCursor,
                         boolean awaitData,
                         boolean noCursorTimeout,
                         boolean partial,
                         boolean oplogReplay,
                         Decoder<T> resultDecoder)
        Deprecated. Replaced by query(MongoNamespace, BsonDocument, BsonDocument, int, int, int, boolean, boolean, boolean, boolean, boolean, boolean, Decoder)
        Execute the query.
        Type Parameters:
        T - the query result document type
        Parameters:
        namespace - the namespace to query
        queryDocument - the query document
        fields - the field to include or exclude
        numberToReturn - the number of documents to return
        skip - the number of documents to skip
        slaveOk - whether the query can run on a secondary
        tailableCursor - whether to return a tailable cursor
        awaitData - whether a tailable cursor should wait before returning if no documents are available
        noCursorTimeout - whether the cursor should not timeout
        partial - whether partial results from sharded clusters are acceptable
        oplogReplay - whether to replay the oplog
        resultDecoder - the decoder for the query result documents
        Returns:
        the query results

      • query

        <T> QueryResult<T> query​(MongoNamespace namespace,
                         BsonDocument queryDocument,
                         BsonDocument fields,
                         int skip,
                         int limit,
                         int batchSize,
                         boolean slaveOk,
                         boolean tailableCursor,
                         boolean awaitData,
                         boolean noCursorTimeout,
                         boolean partial,
                         boolean oplogReplay,
                         Decoder<T> resultDecoder)
        Deprecated. 
        Execute the query.
        Type Parameters:
        T - the query result document type
        Parameters:
        namespace - the namespace to query
        queryDocument - the query document
        fields - the field to include or exclude
        skip - the number of documents to skip
        limit - the maximum number of documents to return in all batches
        batchSize - the maximum number of documents to return in this batch
        slaveOk - whether the query can run on a secondary
        tailableCursor - whether to return a tailable cursor
        awaitData - whether a tailable cursor should wait before returning if no documents are available
        noCursorTimeout - whether the cursor should not timeout
        partial - whether partial results from sharded clusters are acceptable
        oplogReplay - whether to replay the oplog
        resultDecoder - the decoder for the query result documents
        Returns:
        the query results
        Since:
        3.1

      • getMore

        <T> QueryResult<T> getMore​(MongoNamespace namespace,
                           long cursorId,
                           int numberToReturn,
                           Decoder<T> resultDecoder)
        Deprecated. 
        Get more result documents from a cursor.
        Type Parameters:
        T - the type of the query result documents
        Parameters:
        namespace - the namespace to get more documents from
        cursorId - the cursor id
        numberToReturn - the number of documents to return
        resultDecoder - the decoder for the query results
        Returns:
        the query results

      • killCursor

        void killCursor​(MongoNamespace namespace,
                List<Long> cursors)
        Deprecated. 
        Kills the given list of cursors.
        Parameters:
        namespace - the namespace to in which the cursors live
        cursors - the cursors