Package org.eclipse.aether.resolution

Class DependencyRequest

java.lang.Object
org.eclipse.aether.resolution.DependencyRequest
public final class DependencyRequest extends Object
A request to resolve transitive dependencies. This request can either be supplied with a CollectRequest to calculate the transitive dependencies or with an already resolved dependency graph.
See Also:

  • Constructor Details

    • DependencyRequest

      public DependencyRequest()
      Creates an uninitialized request. Note that either setRoot(DependencyNode) or setCollectRequest(CollectRequest) must eventually be called to create a valid request.

    • DependencyRequest

      public DependencyRequest(DependencyNode node, DependencyFilter filter)
      Creates a request for the specified dependency graph and with the given resolution filter.
      Parameters:
      node - The root node of the dependency graph whose artifacts should be resolved, may be null.
      filter - The resolution filter to use, may be null.

    • DependencyRequest

      public DependencyRequest(CollectRequest request, DependencyFilter filter)
      Creates a request for the specified collect request and with the given resolution filter.
      Parameters:
      request - The collect request used to calculate the dependency graph whose artifacts should be resolved, may be null.
      filter - The resolution filter to use, may be null.

  • Method Details

    • getRoot

      public DependencyNode getRoot()
      Gets the root node of the dependency graph whose artifacts should be resolved.
      Returns:
      The root node of the dependency graph or null if none.

    • setRoot

      public DependencyRequest setRoot(DependencyNode root)
      Sets the root node of the dependency graph whose artifacts should be resolved. When this request is processed, the nodes of the given dependency graph will be updated to refer to the resolved artifacts. Eventually, either setRoot(DependencyNode) or setCollectRequest(CollectRequest) must be called to create a valid request.
      Parameters:
      root - The root node of the dependency graph, may be null.
      Returns:
      This request for chaining, never null.

    • getCollectRequest

      public CollectRequest getCollectRequest()
      Gets the collect request used to calculate the dependency graph whose artifacts should be resolved.
      Returns:
      The collect request or null if none.

    • setCollectRequest

      public DependencyRequest setCollectRequest(CollectRequest collectRequest)
      Sets the collect request used to calculate the dependency graph whose artifacts should be resolved. Eventually, either setRoot(DependencyNode) or setCollectRequest(CollectRequest) must be called to create a valid request. If this request is supplied with a dependency node via setRoot(DependencyNode), the collect request is ignored.
      Parameters:
      collectRequest - The collect request, may be null.
      Returns:
      This request for chaining, never null.

    • getFilter

      public DependencyFilter getFilter()
      Gets the resolution filter used to select which artifacts of the dependency graph should be resolved.
      Returns:
      The resolution filter or null to resolve all artifacts of the dependency graph.

    • setFilter

      public DependencyRequest setFilter(DependencyFilter filter)
      Sets the resolution filter used to select which artifacts of the dependency graph should be resolved. For example, use this filter to restrict resolution to dependencies of a certain scope.
      Parameters:
      filter - The resolution filter, may be null to resolve all artifacts of the dependency graph.
      Returns:
      This request for chaining, never null.

    • getTrace

      public RequestTrace getTrace()
      Gets the trace information that describes the higher level request/operation in which this request is issued.
      Returns:
      The trace information about the higher level operation or null if none.

    • setTrace

      public DependencyRequest setTrace(RequestTrace trace)
      Sets the trace information that describes the higher level request/operation in which this request is issued.
      Parameters:
      trace - The trace information about the higher level operation, may be null.
      Returns:
      This request for chaining, never null.

    • toString

      public String toString()
      Overrides:
      toString in class Object