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 mongodb-driver, mongodb-driver-core, and bson
The newest version!
/*
* Copyright 2013-2015 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.WriteConcern;
import com.mongodb.WriteConcernResult;
import com.mongodb.annotations.ThreadSafe;
import com.mongodb.async.SingleResultCallback;
import com.mongodb.binding.ReferenceCounted;
import com.mongodb.bulk.BulkWriteResult;
import com.mongodb.bulk.DeleteRequest;
import com.mongodb.bulk.InsertRequest;
import com.mongodb.bulk.UpdateRequest;
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 writeConcern the write concern
* @param inserts the inserts
* @param callback the callback to be passed the write result
*/
void insertAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern,
List inserts, 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 writeConcern the write concern
* @param updates the updates
* @param callback the callback to be passed the write result
*/
void updateAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern, List updates,
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 writeConcern the write concern
* @param deletes the deletes
* @param callback the callback to be passed the write result
*/
void deleteAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern, List deletes,
SingleResultCallback callback);
/**
* Insert the documents using the insert command asynchronously.
*
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param writeConcern the write concern
* @param inserts the inserts
* @param callback the callback to be passed the bulk write result
*/
void insertCommandAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern, List inserts,
SingleResultCallback callback);
/**
* Update the documents using the update command asynchronously.
*
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param writeConcern the write concern
* @param updates the updates
* @param callback the callback to be passed the BulkWriteResult
*/
void updateCommandAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern, List updates,
SingleResultCallback callback);
/**
* Delete the documents using the delete command asynchronously.
*
* @param namespace the namespace
* @param ordered whether the writes are ordered
* @param writeConcern the write concern
* @param deletes the deletes
* @param callback the callback to be passed the BulkWriteResult
*/
void deleteCommandAsync(MongoNamespace namespace, boolean ordered, WriteConcern writeConcern, List deletes,
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
*/
void commandAsync(String database, BsonDocument command, boolean slaveOk, FieldNameValidator fieldNameValidator,
Decoder commandResultDecoder, 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);
}