Package org.apache.maven.impl

Class RequestTraceHelper

java.lang.Object

org.apache.maven.impl.RequestTraceHelper

public final class RequestTraceHelper
extends Object

Helper class to manage request tracing for improved error logging in Maven's dependency resolution. This class provides utilities to: - Track request traces through Maven's dependency resolution process - Convert between Maven and Resolver trace formats - Generate human-readable interpretations of trace data

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final record	RequestTraceHelper.ResolverTrace	Represents a resolver trace containing both Maven and Resolver-specific trace information

Constructor Summary

Constructors

Constructor	Description
RequestTraceHelper()

Method Summary

Modifier and Type	Method	Description
static RequestTraceHelper.ResolverTrace	enter(Session session, Object data)	Creates a new trace entry and updates the session's current trace
static void	exit(RequestTraceHelper.ResolverTrace trace)	Restores the parent trace as the current trace in the session
static String	interpretTrace(boolean detailed, org.eclipse.aether.RequestTrace requestTrace)	Creates a human-readable interpretation of a request trace
static RequestTrace	toMaven(String context, org.eclipse.aether.RequestTrace trace)	Converts a Resolver trace to a Maven trace
static org.eclipse.aether.RequestTrace	toResolver(RequestTrace trace)	Converts a Maven trace to a Resolver trace

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

RequestTraceHelper

public RequestTraceHelper()

Method Details

enter

public static RequestTraceHelper.ResolverTrace enter(Session session,
 Object data)

Creates a new trace entry and updates the session's current trace

Parameters:

session - The current Maven session

data - The data object to associate with the trace

Returns:

A new ResolverTrace containing both Maven and Resolver trace information

exit

public static void exit(RequestTraceHelper.ResolverTrace trace)

Restores the parent trace as the current trace in the session

Parameters:

trace - The current resolver trace to exit from

toMaven

public static RequestTrace toMaven(String context,
 org.eclipse.aether.RequestTrace trace)

Converts a Resolver trace to a Maven trace

Parameters:

context - The context string for the new Maven trace

trace - The Resolver trace to convert

Returns:

A new Maven trace, or null if the input trace was null

toResolver

public static org.eclipse.aether.RequestTrace toResolver(RequestTrace trace)

Converts a Maven trace to a Resolver trace

Parameters:

trace - The Maven trace to convert

Returns:

A new Resolver trace, or null if the input trace was null

interpretTrace

public static String interpretTrace(boolean detailed,
 org.eclipse.aether.RequestTrace requestTrace)

Creates a human-readable interpretation of a request trace

Parameters:

detailed - If true, includes additional details such as dependency paths

requestTrace - The trace to interpret

Returns:

A string describing the trace context and relevant details