Module brave

Package brave.propagation

Interface ExtraFieldCustomizer

public interface ExtraFieldCustomizer

This allows configuration plugins to collaborate on building an instance of ExtraFieldPropagation.Factory.

For example, a customizer can add an extra field field without affecting the trace propagation format.

This also allows one object to customize both Tracing, via TracingCustomizer, and extra fields ExtraFieldPropagation, by implementing both customizer interfaces.

Integration examples

In practice, a dependency injection tool applies a collection of these instances prior to building the tracing instance. For example, an injected List<ExtraFieldPropagationCustomizer> parameter to a provider of Propagation.Factory.

Here are some examples, in alphabetical order:

   
Dagger Set Multibindings
   
Guice Set Multibinder
   
Spring Autowired Collections
 

Since:

5.7

See Also:

CurrentTraceContextCustomizer, TracingCustomizer

Field Summary

Fields

Modifier and Type	Field	Description
static ExtraFieldCustomizer	NOOP	Use to avoid comparing against null references

Method Summary

Modifier and Type	Method	Description
void	customize(ExtraFieldPropagation.FactoryBuilder builder)

Field Detail

NOOP

static final ExtraFieldCustomizer NOOP

Use to avoid comparing against null references

Method Detail

customize

void customize(ExtraFieldPropagation.FactoryBuilder builder)