Interface Connection

  • All Superinterfaces:
    ReferenceCounted

    @ThreadSafe
    @Deprecated
    public interface Connection
    extends ReferenceCounted
    Deprecated.
    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)
        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