Interface ComponentSelectionRules

public interface 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")
                        }
                    }
                }
            }
        }
    }

Since:

2.2

Method Summary

Modifier and Type	Method	Description
ComponentSelectionRules	all(Closure<?> closure)	Adds a component selection rule that will apply to all resolved components.
ComponentSelectionRules	all(Object ruleSource)	Deprecated. use all(Action) instead.
ComponentSelectionRules	all(Action<? super ComponentSelection> selectionAction)	Adds a simple component selection rule that will apply to all resolved components.
ComponentSelectionRules	withModule(Object id, Closure<?> closure)	Adds a component selection rule that will apply to the specified module.
ComponentSelectionRules	withModule(Object id, Object ruleSource)	Deprecated. use withModule(Object,Action) instead.
ComponentSelectionRules	withModule(Object id, Action<? super ComponentSelection> selectionAction)	Adds a component selection rule that will apply to the specified module.

Method Details

all

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.

Parameters:

selectionAction - the Action that implements a rule to be applied

Returns:

this

Since:

2.2

all

ComponentSelectionRules all(@DelegatesTo(ComponentSelection.class)
 Closure<?> closure)

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

Parameters:

closure - the Closure that implements a rule to be applied

Returns:

this

Since:

2.2

all

@Deprecated
ComponentSelectionRules all(Object ruleSource)

Deprecated.

use all(Action) instead.

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:

• must return void.
• must have ComponentSelection as its parameter.

Parameters:

ruleSource - an instance providing a rule implementation

Returns:

this

Since:

2.2

withModule

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.

Parameters:

id - the module to apply this rule to in "group:module" format or as a ModuleIdentifier

selectionAction - the Action that implements a rule to be applied

Returns:

this

Since:

2.2

withModule

ComponentSelectionRules withModule(Object id,
 @DelegatesTo(ComponentSelection.class)
 Closure<?> closure)

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

Parameters:

id - the module to apply this rule to in "group:module" format or as a ModuleIdentifier

closure - the Closure that implements a rule to be applied

Returns:

this

Since:

2.2

withModule

@Deprecated
ComponentSelectionRules withModule(Object id,
 Object ruleSource)

Deprecated.

use withModule(Object,Action) instead.

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:

• must return void.
• must have ComponentSelection as its parameter.

Parameters:

id - the module to apply this rule to in "group:module" format or as a ModuleIdentifier

ruleSource - an instance providing a rule implementation

Returns:

this

Since:

2.2