io.opentelemetry.javaagent.tooling.bootstrap.BootstrapPackagesConfigurer Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of opentelemetry-javaagent-tooling Show documentation

Instrumentation of Java libraries using OpenTelemetry.

There is a newer version: 2.12.0-alpha

Show newest version

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

package io.opentelemetry.javaagent.tooling.bootstrap;

import io.opentelemetry.sdk.autoconfigure.spi.ConfigProperties;

/**
 * This SPI can be used to define which packages/classes belong to the bootstrap class loader: all
 * packages configured here will always be loaded by the bootstrap class loader, even if class
 * loader that initiated loading of the class does not normally delegate to bootstrap class loader.
 *
 * IMPORTANT: This SPI cannot add new packages to the bootstrap CL, it only defines those
 * that are already there - the purpose is to make sure they're loaded by the correct class loader.
 *
 * 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 BootstrapPackagesConfigurer {

  /**
   * Configure the passed {@code builder} and define which classes should always be loaded by the
   * bootstrap class loader.
   */
  void configure(BootstrapPackagesBuilder builder, ConfigProperties config);
}