MongoHandlerContext.java

/*
 * Copyright 2022-present the original author or authors.
 *
 * 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
 *
 *      https://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 org.springframework.data.mongodb.observability;

import io.micrometer.observation.Observation;
import io.micrometer.observation.transport.Kind;
import io.micrometer.observation.transport.SenderContext;

import java.util.Arrays;
import java.util.LinkedHashSet;
import java.util.Set;

import org.bson.BsonDocument;
import org.bson.BsonValue;
import org.jspecify.annotations.Nullable;

import com.mongodb.ConnectionString;
import com.mongodb.RequestContext;
import com.mongodb.event.CommandFailedEvent;
import com.mongodb.event.CommandStartedEvent;
import com.mongodb.event.CommandSucceededEvent;

/**
 * A {@link Observation.Context} that contains MongoDB events.
 * <p>
 * <strong>NOTE:</strong> MongoDB Java Driver 5.7+ comes with observability directly built in which can be configured
 * via {@code MongoClientSettings.Builder#observabilitySettings(ObservabilitySettings)}.
 * We recommend switching to the driver native observability.
 *
 * @author Marcin Grzejszczak
 * @author Greg Turnquist
 * @author Mark Paluch
 * @since 4.0
 * @deprecated since 5.1 in favor of native MongoDB Java Driver observability support.
 */
@Deprecated(since = "5.1",  forRemoval = true)
public class MongoHandlerContext extends SenderContext<Object> {

	/**
	 * @see <a href=
	 *      "https://docs.mongodb.com/manual/reference/command">https://docs.mongodb.com/manual/reference/command</a> for
	 *      the command reference
	 */
	private static final Set<String> COMMANDS_WITH_COLLECTION_NAME = new LinkedHashSet<>(
			Arrays.asList("aggregate", "count", "distinct", "mapReduce", "geoSearch", "delete", "find", "findAndModify",
					"insert", "update", "collMod", "compact", "convertToCapped", "create", "createIndexes", "drop", "dropIndexes",
					"killCursors", "listIndexes", "reIndex"));

	private final @Nullable ConnectionString connectionString;
	private final @Nullable CommandStartedEvent commandStartedEvent;
	private final @Nullable RequestContext requestContext;
	private final @Nullable String collectionName;

	private @Nullable CommandSucceededEvent commandSucceededEvent;
	private @Nullable CommandFailedEvent commandFailedEvent;

	public MongoHandlerContext(@Nullable ConnectionString connectionString, CommandStartedEvent commandStartedEvent,
			RequestContext requestContext) {

		super((carrier, key, value) -> {}, Kind.CLIENT);
		this.connectionString = connectionString;
		this.commandStartedEvent = commandStartedEvent;
		this.requestContext = requestContext;
		this.collectionName = getCollectionName(commandStartedEvent);
	}

	public @Nullable CommandStartedEvent getCommandStartedEvent() {
		return this.commandStartedEvent;
	}

	public @Nullable RequestContext getRequestContext() {
		return this.requestContext;
	}

	public String getDatabaseName() {
		return commandStartedEvent != null ? commandStartedEvent.getDatabaseName() : "n/a";
	}

	public @Nullable String getCollectionName() {
		return this.collectionName;
	}

	public String getCommandName() {
		return commandStartedEvent != null ? commandStartedEvent.getCommandName() : "n/a";
	}

	public @Nullable ConnectionString getConnectionString() {
		return connectionString;
	}

	void setCommandSucceededEvent(CommandSucceededEvent commandSucceededEvent) {
		this.commandSucceededEvent = commandSucceededEvent;
	}

	void setCommandFailedEvent(CommandFailedEvent commandFailedEvent) {
		this.commandFailedEvent = commandFailedEvent;
	}

	/**
	 * Transform the command name into a collection name;
	 *
	 * @param event the {@link CommandStartedEvent}
	 * @return the name of the collection based on the command
	 */
	@Nullable
	private static String getCollectionName(CommandStartedEvent event) {

		String commandName = event.getCommandName();
		BsonDocument command = event.getCommand();

		if (COMMANDS_WITH_COLLECTION_NAME.contains(commandName)) {

			String collectionName = getNonEmptyBsonString(command.get(commandName));

			if (collectionName != null) {
				return collectionName;
			}
		}

		// Some other commands, like getMore, have a field like {"collection": collectionName}.
		return command == null ? "" : getNonEmptyBsonString(command.get("collection"));
	}

	/**
	 * Utility method to convert {@link BsonValue} into a plain string.
	 *
	 * @return trimmed string from {@code bsonValue} or null if the trimmed string was empty or the value wasn't a string
	 */
	private static @Nullable String getNonEmptyBsonString(@Nullable BsonValue bsonValue) {

		if (bsonValue == null || !bsonValue.isString()) {
			return null;
		}

		String stringValue = bsonValue.asString().getValue().trim();

		return stringValue.isEmpty() ? null : stringValue;
	}

}