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

import com.mongodb.lang.Nullable;
import org.bson.BsonDocument;
import org.bson.BsonInt32;
import org.bson.BsonValue;

import static java.lang.String.format;

An exception representing an error reported due to a write failure.
/** * An exception representing an error reported due to a write failure. * */
public class WriteConcernException extends MongoServerException { private static final long serialVersionUID = -1100801000476719450L; private final WriteConcernResult writeConcernResult; private final BsonDocument response;
Construct a new instance.
Params:
  • response – the response to the write operation
  • address – the address of the server that executed the operation
  • writeConcernResult – the write concern result
/** * Construct a new instance. * * @param response the response to the write operation * @param address the address of the server that executed the operation * @param writeConcernResult the write concern result */
public WriteConcernException(final BsonDocument response, final ServerAddress address, final WriteConcernResult writeConcernResult) { super(extractErrorCode(response), format("Write failed with error code %d and error message '%s'", extractErrorCode(response), extractErrorMessage(response)), address); this.response = response; this.writeConcernResult = writeConcernResult; }
For internal use only: extract the error code from the response to a write command.
Params:
  • response – the response
Returns:the code, or -1 if there is none
/** * For internal use only: extract the error code from the response to a write command. * @param response the response * @return the code, or -1 if there is none */
public static int extractErrorCode(final BsonDocument response) { // mongos may set an err field containing duplicate key error information String errorMessage = extractErrorMessage(response); if (errorMessage != null) { if (response.containsKey("err")) { if (errorMessage.contains("E11000 duplicate key error")) { return 11000; } } // mongos may return a list of documents representing write command responses from each shard. Return the one with a matching // "err" field, so that it can be used to get the error code if (!response.containsKey("code") && response.containsKey("errObjects")) { for (BsonValue curErrorDocument : response.getArray("errObjects")) { if (errorMessage.equals(extractErrorMessage(curErrorDocument.asDocument()))) { return curErrorDocument.asDocument().getNumber("code").intValue(); } } } } return response.getNumber("code", new BsonInt32(-1)).intValue(); }
For internal use only: extract the error message from the response to a write command.
Params:
  • response – the response
Returns:the error message
/** * For internal use only: extract the error message from the response to a write command. * * @param response the response * @return the error message */
@Nullable public static String extractErrorMessage(final BsonDocument response) { if (response.isString("err")) { return response.getString("err").getValue(); } else if (response.isString("errmsg")) { return response.getString("errmsg").getValue(); } else { return null; } }
Gets the write result.
Returns:the write result
/** * Gets the write result. * * @return the write result */
public WriteConcernResult getWriteConcernResult() { return writeConcernResult; }
Gets the error code associated with the write concern failure.
Returns:the error code
/** * Gets the error code associated with the write concern failure. * * @return the error code */
public int getErrorCode() { return extractErrorCode(response); }
Gets the error message associated with the write concern failure.
Returns:the error message
/** * Gets the error message associated with the write concern failure. * * @return the error message */
@Nullable public String getErrorMessage() { return extractErrorMessage(response); }
Gets the response to the write operation.
Returns:the response to the write operation
/** * Gets the response to the write operation. * * @return the response to the write operation */
public BsonDocument getResponse() { return response; } }