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