org.sonatype.aether.util.filter
Class PatternInclusionsDependencyFilter

java.lang.Object
  extended by org.sonatype.aether.util.filter.PatternInclusionsDependencyFilter
All Implemented Interfaces:
DependencyFilter
Direct Known Subclasses:
PatternExclusionsDependencyFilter

public class PatternInclusionsDependencyFilter
extends java.lang.Object
implements DependencyFilter

A simple filter to include artifacts from a list of patterns. The artifact pattern syntax is of the form:

 [groupId]:[artifactId]:[extension]:[version]
 

Where each pattern segment is optional and supports full and partial * wildcards. An empty pattern segment is treated as an implicit wildcard. Version can be a range in case a VersionScheme is specified.

For example, org.apache.* would match all artifacts whose group id started with org.apache. , and :::*-SNAPSHOT would match all snapshot artifacts.

Author:
Alin Dreghiciu

Constructor Summary
PatternInclusionsDependencyFilter(java.util.Collection<java.lang.String> patterns)
          Creates a new filter using the specified patterns.
PatternInclusionsDependencyFilter(java.lang.String... patterns)
          Creates a new filter using the specified patterns.
PatternInclusionsDependencyFilter(VersionScheme versionScheme, java.util.Collection<java.lang.String> patterns)
          Creates a new filter using the specified patterns and VersionScheme .
PatternInclusionsDependencyFilter(VersionScheme versionScheme, java.lang.String... patterns)
          Creates a new filter using the specified patterns.
 
Method Summary
 boolean accept(DependencyNode node, java.util.List<DependencyNode> parents)
          Indicates whether the specified dependency node shall be included or excluded.
 boolean equals(java.lang.Object obj)
           
 int hashCode()
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

PatternInclusionsDependencyFilter

public PatternInclusionsDependencyFilter(java.lang.String... patterns)
Creates a new filter using the specified patterns.

Parameters:
patterns - The include patterns, may be null or empty to include no artifacts.

PatternInclusionsDependencyFilter

public PatternInclusionsDependencyFilter(VersionScheme versionScheme,
                                         java.lang.String... patterns)
Creates a new filter using the specified patterns.

Parameters:
versionScheme - To be used for parsing versions/version ranges. If null and pattern specifies a range no artifact will be included.
patterns - The include patterns, may be null or empty to include no artifacts.

PatternInclusionsDependencyFilter

public PatternInclusionsDependencyFilter(java.util.Collection<java.lang.String> patterns)
Creates a new filter using the specified patterns.

Parameters:
patterns - The include patterns, may be null or empty to include no artifacts.

PatternInclusionsDependencyFilter

public PatternInclusionsDependencyFilter(VersionScheme versionScheme,
                                         java.util.Collection<java.lang.String> patterns)
Creates a new filter using the specified patterns and VersionScheme .

Parameters:
versionScheme - To be used for parsing versions/version ranges. If null and pattern specifies a range no artifact will be included.
patterns - The include patterns, may be null or empty to include no artifacts.
Method Detail

accept

public boolean accept(DependencyNode node,
                      java.util.List<DependencyNode> parents)
Description copied from interface: DependencyFilter
Indicates whether the specified dependency node shall be included or excluded.

Specified by:
accept in interface DependencyFilter
Parameters:
node - The dependency node to filter, must not be null.
parents - The (read-only) chain of parent nodes that leads to the node to be filtered, must not be null. Iterating this (possibly empty) list walks up the dependency graph towards the root node, i.e. the immediate parent node (if any) is the first node in the list. The size of the list also denotes the zero-based depth of the filtered node.
Returns:
true to include the dependency node, false to exclude it.

equals

public boolean equals(java.lang.Object obj)
Overrides:
equals in class java.lang.Object

hashCode

public int hashCode()
Overrides:
hashCode in class java.lang.Object


Copyright © 2010-2011 Sonatype, Inc.. All Rights Reserved.