ComponentSelectionRules

API Documentation:ComponentSelectionRules

Represents a container for component selection rules. Rules can be applied as part of the resolutionStrategy of a configuration and individual components can be explicitly accepted or rejected by rule. Components that are neither accepted or rejected will be subject to the default version matching strategies.

configurations {
    conf {
        resolutionStrategy {
            componentSelection {
                all { ComponentSelection selection ->
                    if (selection.candidate.module == 'someModule' && selection.candidate.version == '1.1') {
                        selection.reject("bad version '1.1' for 'someModule'")
                    }
                }
                all { ComponentSelection selection ->
                    if (selection.candidate.module == 'someModule' && selection.getDescriptor(IvyModuleDescriptor)?.branch == 'testing') {
                        if (selection.metadata == null || selection.metadata.status != 'milestone') {
                            selection.reject("only use milestones for someModule:testing")
                        }
                    }
                }
                withModule("org.sample:api") { ComponentSelection selection ->
                    if (selection.candidate.version == "1.1") {
                        selection.reject("known bad version")
                    }
                }
            }
        }
    }
}

Properties

No properties

Methods

MethodDescription
all(closure)

Adds a component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument. Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

all(ruleSource)

Adds a rule-source backed component selection rule that will apply to all resolved components. The ruleSource provides the rule as exactly one rule method annotated with Mutate. This rule method:

all(selectionAction)

Adds a simple component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument.

withModule(id, closure)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument. Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

withModule(id, ruleSource)

Adds a rule-source backed component selection rule that will apply to the specified module. The ruleSource provides the rule as exactly one rule method annotated with Mutate. This rule method:

withModule(id, selectionAction)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument.

Script blocks

No script blocks

Method details

Adds a component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument. Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

Adds a rule-source backed component selection rule that will apply to all resolved components. The ruleSource provides the rule as exactly one rule method annotated with Mutate. This rule method:

Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

ComponentSelectionRules all(Action<? super ComponentSelection> selectionAction)

Adds a simple component selection rule that will apply to all resolved components. Each rule will receive a ComponentSelection object as an argument.

ComponentSelectionRules withModule(Object id, Closure<?> closure)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument. Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

ComponentSelectionRules withModule(Object id, Object ruleSource)

Adds a rule-source backed component selection rule that will apply to the specified module. The ruleSource provides the rule as exactly one rule method annotated with Mutate. This rule method:

Injection of other arguments has been deprecated in favor of the added methods on ComponentSelection, namely ComponentSelection.getMetadata() and ComponentSelection.getDescriptor(java.lang.Class).

ComponentSelectionRules withModule(Object id, Action<? super ComponentSelection> selectionAction)

Adds a component selection rule that will apply to the specified module. Each rule will receive a ComponentSelection object as an argument.