org.apache.rocketmq.shaded.io.opentelemetry.context.propagation.TextMapSetter Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of rocketmq-client-java

There is a newer version: 5.0.7

/*
 * Copyright The OpenTelemetry Authors
 * SPDX-License-Identifier: Apache-2.0
 */

package org.apache.rocketmq.shaded.io.opentelemetry.context.propagation;

import javax.annotation.Nullable;

/**
 * Class that allows a {@code TextMapPropagator} to set propagated fields into a carrier.
 *
 * {@code Setter} is stateless and allows to be saved as a constant to avoid runtime allocations.
 *
 * @param  carrier of propagation fields, such as an http request
 */
public interface TextMapSetter {

  /**
   * Replaces a propagated field with the given value.
   *
   * For example, a setter for an {@link java.net.HttpURLConnection} would be the method
   * reference {@link java.net.HttpURLConnection#addRequestProperty(String, String)}
   *
   * @param carrier holds propagation fields. For example, an outgoing message or http request. To
   *     facilitate implementations as java lambdas, this parameter may be null.
   * @param key the key of the field.
   * @param value the value of the field.
   */
  void set(@Nullable C carrier, String key, String value);
}