• Home
• io.opentelemetry.javaagent
• opentelemetry-javaagent-extension-api
• 2.10.0-alpha
• source code
• HttpServerResponseCustomizer.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

io.opentelemetry.javaagent.bootstrap.http.HttpServerResponseCustomizer Maven / Gradle / Ivy

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

package io.opentelemetry.javaagent.bootstrap.http;

import io.opentelemetry.context.Context;

/**
 * {@link HttpServerResponseCustomizer} can be used to execute code after an HTTP server response is
 * created for the purpose of mutating the response in some way, such as appending headers, that may
 * depend on the context of the SERVER span.
 *
 * 
This is a service provider interface that requires implementations to be registered in a
 * provider-configuration file stored in the {@code META-INF/services} resource directory.
 */
public interface HttpServerResponseCustomizer {
  /**
   * Called for each HTTP server response with its SERVER span context provided. This is called at a
   * time when response headers can already be set, but the response is not yet committed, which is
   * typically at the start of request handling.
   *
   * @param serverContext Context of a SERVER span {@link io.opentelemetry.api.trace.SpanContext}
   * @param response Response object specific to the library being instrumented
   * @param responseMutator Mutator through which the provided response object can be mutated
   */
   void customize(
      Context serverContext,
      RESPONSE response,
      HttpServerResponseMutator responseMutator);
}