/*
 * 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.operation;

import com.mongodb.MongoCommandException;
import com.mongodb.MongoCredential;
import com.mongodb.WriteConcern;
import com.mongodb.async.SingleResultCallback;
import com.mongodb.binding.AsyncWriteBinding;
import com.mongodb.binding.WriteBinding;
import com.mongodb.connection.AsyncConnection;
import com.mongodb.connection.Connection;
import com.mongodb.connection.ConnectionDescription;
import org.bson.BsonDocument;

import static com.mongodb.assertions.Assertions.notNull;
import static com.mongodb.internal.async.ErrorHandlingResultCallback.errorHandlingCallback;
import static com.mongodb.operation.CommandOperationHelper.executeCommand;
import static com.mongodb.operation.CommandOperationHelper.executeCommandAsync;
import static com.mongodb.operation.CommandOperationHelper.writeConcernErrorWriteTransformer;
import static com.mongodb.operation.OperationHelper.AsyncCallableWithConnection;
import static com.mongodb.operation.OperationHelper.CallableWithConnection;
import static com.mongodb.operation.OperationHelper.LOGGER;
import static com.mongodb.operation.OperationHelper.releasingCallback;
import static com.mongodb.operation.OperationHelper.withConnection;
import static com.mongodb.operation.UserOperationHelper.asCommandDocument;
import static com.mongodb.operation.UserOperationHelper.translateUserCommandException;
import static com.mongodb.operation.UserOperationHelper.userCommandCallback;
import static com.mongodb.internal.operation.WriteConcernHelper.appendWriteConcernToCommand;
import static com.mongodb.operation.CommandOperationHelper.writeConcernErrorTransformer;
import static com.mongodb.operation.OperationHelper.withAsyncConnection;

An operation that updates a user.
Since:3.0
Deprecated:use CommandWriteOperation directly or the mongod shell helpers.
/** * An operation that updates a user. * * @since 3.0 * @deprecated use {@link CommandWriteOperation} directly or the mongod shell helpers. */
@Deprecated public class UpdateUserOperation implements AsyncWriteOperation<Void>, WriteOperation<Void> { private final MongoCredential credential; private final boolean readOnly; private final WriteConcern writeConcern;
Construct a new instance.
Params:
  • credential – the users credentials.
  • readOnly – true if the user is a readOnly user.
/** * Construct a new instance. * * @param credential the users credentials. * @param readOnly true if the user is a readOnly user. */
public UpdateUserOperation(final MongoCredential credential, final boolean readOnly) { this(credential, readOnly, null); }
Construct a new instance.
Params:
  • credential – the users credentials.
  • readOnly – true if the user is a readOnly user.
  • writeConcern – the write concern
Since:3.4
/** * Construct a new instance. * * @param credential the users credentials. * @param readOnly true if the user is a readOnly user. * @param writeConcern the write concern * * @since 3.4 */
public UpdateUserOperation(final MongoCredential credential, final boolean readOnly, final WriteConcern writeConcern) { this.credential = notNull("credential", credential); this.readOnly = readOnly; this.writeConcern = writeConcern; }
Gets the users credentials.
Returns:the users credentials.
/** * Gets the users credentials. * * @return the users credentials. */
public MongoCredential getCredential() { return credential; }
Returns true if the user is a readOnly user.
Returns:true if the user is a readOnly user.
/** * Returns true if the user is a readOnly user. * * @return true if the user is a readOnly user. */
public boolean isReadOnly() { return readOnly; } @Override public Void execute(final WriteBinding binding) { return withConnection(binding, new CallableWithConnection<Void>() { @Override public Void call(final Connection connection) { try { executeCommand(binding, getCredential().getSource(), getCommand(connection.getDescription()), connection, writeConcernErrorTransformer()); } catch (MongoCommandException e) { translateUserCommandException(e); } return null; } }); } @Override public void executeAsync(final AsyncWriteBinding binding, final SingleResultCallback<Void> callback) { withAsyncConnection(binding, new AsyncCallableWithConnection() { @Override public void call(final AsyncConnection connection, final Throwable t) { SingleResultCallback<Void> errHandlingCallback = errorHandlingCallback(callback, LOGGER); if (t != null) { errHandlingCallback.onResult(null, t); } else { final SingleResultCallback<Void> wrappedCallback = releasingCallback(errHandlingCallback, connection); executeCommandAsync(binding, credential.getSource(), getCommand(connection.getDescription()), connection, writeConcernErrorWriteTransformer(), userCommandCallback(wrappedCallback)); } } }); } private BsonDocument getCommand(final ConnectionDescription description) { BsonDocument commandDocument = asCommandDocument(credential, description, readOnly, "updateUser"); appendWriteConcernToCommand(writeConcern, commandDocument, description); return commandDocument; } }