com.mongodb.connection.RequestMessage Maven / Gradle / Ivy
/*
* Copyright (c) 2008-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 org.bson.BsonBinaryWriter;
import org.bson.BsonBinaryWriterSettings;
import org.bson.BsonDocument;
import org.bson.BsonWriterSettings;
import org.bson.FieldNameValidator;
import org.bson.codecs.BsonValueCodecProvider;
import org.bson.codecs.Codec;
import org.bson.codecs.Encoder;
import org.bson.codecs.EncoderContext;
import org.bson.codecs.configuration.CodecRegistry;
import org.bson.io.BsonOutput;
import java.util.concurrent.atomic.AtomicInteger;
import static org.bson.codecs.configuration.CodecRegistries.fromProviders;
/**
* Abstract base class for all MongoDB Wire Protocol request messages.
*/
abstract class RequestMessage {
static final AtomicInteger REQUEST_ID = new AtomicInteger(1);
// Allow an extra 16K to the maximum allowed size of a query or command document, so that, for example,
// a 16M document can be upserted via findAndModify
private static final int QUERY_DOCUMENT_HEADROOM = 16 * 1024;
private static final CodecRegistry REGISTRY = fromProviders(new BsonValueCodecProvider());
private final String collectionName;
private final MessageSettings settings;
private final int id;
private final OpCode opCode;
static class EncodingMetadata {
private final RequestMessage nextMessage;
private final int firstDocumentPosition;
EncodingMetadata(final RequestMessage nextMessage, final int firstDocumentPosition) {
this.nextMessage = nextMessage;
this.firstDocumentPosition = firstDocumentPosition;
}
public RequestMessage getNextMessage() {
return nextMessage;
}
public int getFirstDocumentPosition() {
return firstDocumentPosition;
}
}
/**
* Gets the next available unique message identifier.
*
* @return the message identifier
*/
public static int getCurrentGlobalId() {
return REQUEST_ID.get();
}
/**
* Construct an instance without a collection name
*
* @param opCode the op code of the message
* @param settings the message settings
*/
public RequestMessage(final OpCode opCode, final MessageSettings settings) {
this(null, opCode, settings);
}
/**
* Construct an instance.
*
* @param collectionName the collection name
* @param opCode the op code of the message
* @param settings the message settings
*/
public RequestMessage(final String collectionName, final OpCode opCode, final MessageSettings settings) {
this.collectionName = collectionName;
this.settings = settings;
id = REQUEST_ID.getAndIncrement();
this.opCode = opCode;
}
/**
* Gets the message id.
*
* @return the message id
*/
public int getId() {
return id;
}
/**
* Gets the op code of the message.
*
* @return the op code
*/
public OpCode getOpCode() {
return opCode;
}
/**
* Gets the collection namespace to send the message to.
*
* @return the namespace, which may be null for some message types
*/
public String getNamespace() {
return getCollectionName() != null ? getCollectionName() : null;
}
/**
* Gets the message settings.
*
* @return the message settings
*/
public MessageSettings getSettings() {
return settings;
}
/**
* Encoded the message to the given output.
*
* @param bsonOutput the output
* @return the next message to encode, if the current message is unable to fit all of its contents in a single message due to limits
* being exceeded
*/
public RequestMessage encode(final BsonOutput bsonOutput) {
return encodeWithMetadata(bsonOutput).getNextMessage();
}
/**
* Encoded the message to the given output.
*
* @param bsonOutput the output
* @return the next message to encode, if the current message is unable to fit all of its contents in a single message due to limits
* being exceeded
*/
public EncodingMetadata encodeWithMetadata(final BsonOutput bsonOutput) {
int messageStartPosition = bsonOutput.getPosition();
writeMessagePrologue(bsonOutput);
EncodingMetadata encodingMetadata = encodeMessageBodyWithMetadata(bsonOutput, messageStartPosition);
backpatchMessageLength(messageStartPosition, bsonOutput);
return encodingMetadata;
}
/**
* Writes the message prologue to the given output.
*
* @param bsonOutput the output
*/
protected void writeMessagePrologue(final BsonOutput bsonOutput) {
bsonOutput.writeInt32(0); // length: will set this later
bsonOutput.writeInt32(id);
bsonOutput.writeInt32(0); // response to
bsonOutput.writeInt32(opCode.getValue());
}
/**
* Encode the message body to the given output.
*
* @param bsonOutput the output
* @param messageStartPosition the start position of the message
* @return the next message to encode, if the contents of this message need to overflow into the next
*/
protected abstract RequestMessage encodeMessageBody(final BsonOutput bsonOutput, final int messageStartPosition);
/**
* Encode the message body to the given output.
*
* @param bsonOutput the output
* @param messageStartPosition the start position of the message
* @return the encoding metadata
*/
protected abstract EncodingMetadata encodeMessageBodyWithMetadata(final BsonOutput bsonOutput, final int messageStartPosition);
/**
* Appends a document to the message.
*
* @param document the document
* @param bsonOutput the output
* @param validator the field name validator
* @param the document type
*/
protected void addDocument(final BsonDocument document, final BsonOutput bsonOutput,
final FieldNameValidator validator) {
addDocument(document, getCodec(document), EncoderContext.builder().build(), bsonOutput, validator,
settings.getMaxDocumentSize() + QUERY_DOCUMENT_HEADROOM);
}
/**
* Appends a document to the message that is intended for storage in a collection.
*
* @param document the document
* @param bsonOutput the output
* @param validator the field name validator
*/
protected void addCollectibleDocument(final BsonDocument document, final BsonOutput bsonOutput,
final FieldNameValidator validator) {
addDocument(document, getCodec(document), EncoderContext.builder().isEncodingCollectibleDocument(true).build(), bsonOutput,
validator, settings.getMaxDocumentSize());
}
/**
* Backpatches the message length into the beginning of the message.
*
* @param startPosition the start position of the message
* @param bsonOutput the output
*/
protected void backpatchMessageLength(final int startPosition, final BsonOutput bsonOutput) {
int messageLength = bsonOutput.getPosition() - startPosition;
bsonOutput.writeInt32(bsonOutput.getPosition() - messageLength, messageLength);
}
/**
* Gets the collection name, which may be null for some message types
*
* @return the collection name
*/
protected String getCollectionName() {
return collectionName;
}
@SuppressWarnings("unchecked")
Codec getCodec(final BsonDocument document) {
return (Codec) REGISTRY.get(document.getClass());
}
private void addDocument(final T obj, final Encoder encoder, final EncoderContext encoderContext,
final BsonOutput bsonOutput, final FieldNameValidator validator, final int maxDocumentSize) {
BsonBinaryWriter writer = new BsonBinaryWriter(new BsonWriterSettings(),
new BsonBinaryWriterSettings(maxDocumentSize), bsonOutput, validator);
try {
encoder.encode(writer, obj, encoderContext);
} finally {
writer.close();
}
}
enum OpCode {
OP_REPLY(1),
OP_MSG(1000),
OP_UPDATE(2001),
OP_INSERT(2002),
OP_QUERY(2004),
OP_GETMORE(2005),
OP_DELETE(2006),
OP_KILL_CURSORS(2007);
OpCode(final int value) {
this.value = value;
}
private final int value;
public int getValue() {
return value;
}
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy