com.mongodb.connection.AsyncConnection Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of mongo-java-driver Show documentation
Show all versions of mongo-java-driver Show documentation
The MongoDB Java Driver uber-artifact, containing the legacy driver, the mongodb-driver, mongodb-driver-core, and bson
/*
* Copyright 2008-present MongoDB, Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package com.mongodb.connection;
import com.mongodb.MongoNamespace;
import com.mongodb.ReadPreference;
import com.mongodb.WriteConcernResult;
import com.mongodb.annotations.ThreadSafe;
import com.mongodb.async.SingleResultCallback;
import com.mongodb.binding.ReferenceCounted;
import com.mongodb.bulk.DeleteRequest;
import com.mongodb.bulk.InsertRequest;
import com.mongodb.bulk.UpdateRequest;
import com.mongodb.session.SessionContext;
import org.bson.BsonDocument;
import org.bson.FieldNameValidator;
import org.bson.codecs.Decoder;
import java.util.List;
/**
* An asynchronous connection to a MongoDB server with non-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
*/
@ThreadSafe
public interface AsyncConnection extends ReferenceCounted {
@Override
AsyncConnection retain();
/**
* Gets the description of the connection.
*
* @return the connection description
*/
ConnectionDescription getDescription();
/**
* Insert the documents using the insert wire protocol and apply the write concern asynchronously.
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param insertRequest the insert request
* @param callback the callback to be passed the write result
*/
void insertAsync(MongoNamespace namespace, boolean ordered, InsertRequest insertRequest,
SingleResultCallback callback);
/**
* Update the documents using the update wire protocol and apply the write concern asynchronously.
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param updateRequest the update request
* @param callback the callback to be passed the write result
*/
void updateAsync(MongoNamespace namespace, boolean ordered, UpdateRequest updateRequest,
SingleResultCallback callback);
/**
* Delete the documents using the delete wire protocol and apply the write concern asynchronously.
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param deleteRequest the delete request
* @param callback the callback to be passed the write result
*/
void deleteAsync(MongoNamespace namespace, boolean ordered, DeleteRequest deleteRequest,
SingleResultCallback callback);
/**
* Execute the command asynchronously.
*
* @param database the database to execute the command in
* @param command the command document
* @param slaveOk whether the command can run on a secondary
* @param fieldNameValidator the field name validator for the command document
* @param commandResultDecoder the decoder for the result
* @param callback the callback to be passed the command result
* @param the type of the result
* @deprecated Prefer {@link #commandAsync(String, BsonDocument, FieldNameValidator, ReadPreference, Decoder, SessionContext,
* SingleResultCallback)}
*/
@Deprecated
void commandAsync(String database, BsonDocument command, boolean slaveOk, FieldNameValidator fieldNameValidator,
Decoder commandResultDecoder, SingleResultCallback callback);
/**
* Execute the command.
*
* @param the type of the result
* @param database the database to execute the command in
* @param command the command document
* @param fieldNameValidator the field name validator for the command document
* @param readPreference the read preference that was applied to get this connection, or null if this is a write operation
* @param commandResultDecoder the decoder for the result
* @param sessionContext the session context
* @param callback the callback to be passed the write result
* @since 3.6
*/
void commandAsync(String database, BsonDocument command, FieldNameValidator fieldNameValidator, ReadPreference readPreference,
Decoder commandResultDecoder, SessionContext sessionContext, SingleResultCallback callback);
/**
* Executes the command, consuming as much of the {@code SplittablePayload} as possible.
*
* @param the type of the result
* @param database the database to execute the command in
* @param command the command document
* @param commandFieldNameValidator the field name validator for the command document
* @param readPreference the read preference that was applied to get this connection, or null if this is a write operation
* @param commandResultDecoder the decoder for the result
* @param sessionContext the session context
* @param responseExpected true if a response from the server is expected
* @param payload the splittable payload to incorporate with the command
* @param payloadFieldNameValidator the field name validator for the payload documents
* @param callback the callback to be passed the write result
* @since 3.6
*/
void commandAsync(String database, BsonDocument command, FieldNameValidator commandFieldNameValidator,
ReadPreference readPreference, Decoder commandResultDecoder, SessionContext sessionContext,
boolean responseExpected, SplittablePayload payload, FieldNameValidator payloadFieldNameValidator,
SingleResultCallback callback);
/**
* Execute the query asynchronously.
*
* @param namespace the namespace to query
* @param queryDocument the query document
* @param fields the field to include or exclude
* @param numberToReturn the number of documents to return
* @param skip the number of documents to skip
* @param slaveOk whether the query can run on a secondary
* @param tailableCursor whether to return a tailable cursor
* @param awaitData whether a tailable cursor should wait before returning if no documents are available
* @param noCursorTimeout whether the cursor should not timeout
* @param partial whether partial results from sharded clusters are acceptable
* @param oplogReplay whether to replay the oplog
* @param resultDecoder the decoder for the query result documents
* @param the query result document type
* @param callback the callback to be passed the write result
* @deprecated Replaced by {@link #queryAsync(MongoNamespace, BsonDocument, BsonDocument, int, int, int, boolean, boolean, boolean,
* boolean, boolean, boolean, Decoder, SingleResultCallback)}
*/
@Deprecated
void queryAsync(MongoNamespace namespace, BsonDocument queryDocument, BsonDocument fields,
int numberToReturn, int skip, boolean slaveOk, boolean tailableCursor, boolean awaitData, boolean noCursorTimeout,
boolean partial, boolean oplogReplay, Decoder resultDecoder, SingleResultCallback> callback);
/**
* Execute the query asynchronously.
*
* @param namespace the namespace to query
* @param queryDocument the query document
* @param fields the field to include or exclude
* @param skip the number of documents to skip
* @param limit the maximum number of documents to return in all batches
* @param batchSize the maximum number of documents to return in this batch
* @param slaveOk whether the query can run on a secondary
* @param tailableCursor whether to return a tailable cursor
* @param awaitData whether a tailable cursor should wait before returning if no documents are available
* @param noCursorTimeout whether the cursor should not timeout
* @param partial whether partial results from sharded clusters are acceptable
* @param oplogReplay whether to replay the oplog
* @param resultDecoder the decoder for the query result documents
* @param the query result document type
* @param callback the callback to be passed the write result
* @since 3.1
*/
void queryAsync(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 resultDecoder,
SingleResultCallback> callback);
/**
* Get more result documents from a cursor asynchronously.
*
* @param namespace the namespace to get more documents from
* @param cursorId the cursor id
* @param numberToReturn the number of documents to return
* @param resultDecoder the decoder for the query result documents
* @param callback the callback to be passed the query result
* @param the type of the query result documents
*/
void getMoreAsync(MongoNamespace namespace, long cursorId, int numberToReturn, Decoder resultDecoder,
SingleResultCallback> callback);
/**
* Asynchronously Kills the given list of cursors.
*
* @param cursors the cursors
* @param callback the callback that is called once the cursors have been killed
* @deprecated Replaced by {@link #killCursorAsync(MongoNamespace, List, SingleResultCallback)}
*/
@Deprecated
void killCursorAsync(List cursors, SingleResultCallback callback);
/**
* Asynchronously Kills the given list of cursors.
*
* @param namespace the namespace in which the cursors live
* @param cursors the cursors
* @param callback the callback that is called once the cursors have been killed
*/
void killCursorAsync(MongoNamespace namespace, List cursors, SingleResultCallback callback);
}