Class DependencySet

java.lang.Object
org.apache.maven.plugins.assembly.model.DependencySet
All Implemented Interfaces:
Serializable

public class DependencySet extends Object implements Serializable
A dependencySet allows inclusion and exclusion of project dependencies in the assembly.
Version:
$Revision$ $Date$
See Also:
  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    private String
    Similar to a UNIX permission, sets the directory mode of the directories included.
    private List<String>
    Field excludes.
    private String
    Similar to a UNIX permission, sets the file mode of the files included.
    private List<String>
    Field includes.
    private String
    Sets the output directory relative to the root of the root directory of the assembly.
    private String
    Sets the mapping pattern for all dependencies included in this assembly.
    private String
    Sets the dependency scope for this dependencySet.
    private boolean
    If set to true, this property will unpack all dependencies into the specified output directory.
    Allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact.
    private boolean
    Determines whether the artifact produced during the current project's build should be included in this dependency set.
    private boolean
    Determines whether the attached artifacts produced during the current project's build should be included in this dependency set.
    private boolean
    When specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error.
    private boolean
    Determines whether transitive dependencies will be included in the processing of the current dependency set.
    private boolean
    Determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact.
  • Constructor Summary

    Constructors
    Constructor
    Description
     
  • Method Summary

    Modifier and Type
    Method
    Description
    void
    Method addExclude.
    void
    Method addInclude.
    Get similar to a UNIX permission, sets the directory mode of the directories included.
    Method getExcludes.
    Get similar to a UNIX permission, sets the file mode of the files included.
    Method getIncludes.
    Get sets the output directory relative to the root of the root directory of the assembly.
    Get sets the mapping pattern for all dependencies included in this assembly.
    Get sets the dependency scope for this dependencySet.
    Get allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact.
    boolean
    Get if set to true, this property will unpack all dependencies into the specified output directory.
    boolean
    Get determines whether the artifact produced during the current project's build should be included in this dependency set.
    boolean
    Get determines whether the attached artifacts produced during the current project's build should be included in this dependency set.
    boolean
    Get when specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error.
    boolean
    Get determines whether transitive dependencies will be included in the processing of the current dependency set.
    boolean
    Get determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact.
    void
    Method removeExclude.
    void
    Method removeInclude.
    void
    setDirectoryMode(String directoryMode)
    Set similar to a UNIX permission, sets the directory mode of the directories included.
    void
    setExcludes(List<String> excludes)
    Set when <exclude> subelements are present, they define a set of dependency artifact coordinates to exclude.
    void
    setFileMode(String fileMode)
    Set similar to a UNIX permission, sets the file mode of the files included.
    void
    setIncludes(List<String> includes)
    Set when <include> subelements are present, they define a set of artifact coordinates to include.
    void
    setOutputDirectory(String outputDirectory)
    Set sets the output directory relative to the root of the root directory of the assembly.
    void
    setOutputFileNameMapping(String outputFileNameMapping)
    Set sets the mapping pattern for all dependencies included in this assembly.
    void
    Set sets the dependency scope for this dependencySet.
    void
    setUnpack(boolean unpack)
    Set if set to true, this property will unpack all dependencies into the specified output directory.
    void
    Set allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact.
    void
    setUseProjectArtifact(boolean useProjectArtifact)
    Set determines whether the artifact produced during the current project's build should be included in this dependency set.
    void
    setUseProjectAttachments(boolean useProjectAttachments)
    Set determines whether the attached artifacts produced during the current project's build should be included in this dependency set.
    void
    setUseStrictFiltering(boolean useStrictFiltering)
    Set when specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error.
    void
    setUseTransitiveDependencies(boolean useTransitiveDependencies)
    Set determines whether transitive dependencies will be included in the processing of the current dependency set.
    void
    setUseTransitiveFiltering(boolean useTransitiveFiltering)
    Set determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
  • Field Details

    • outputDirectory

      private String outputDirectory
      Sets the output directory relative to the root of the root directory of the assembly. For example, "log" will put the specified files in the log directory, directly beneath the root of the archive.
    • includes

      private List<String> includes
      Field includes.
    • excludes

      private List<String> excludes
      Field excludes.
    • fileMode

      private String fileMode
      Similar to a UNIX permission, sets the file mode of the files included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0644 translates to User read-write, Group and Other read-only. The default value is 0644. (more on unix-style permissions)
    • directoryMode

      private String directoryMode
      Similar to a UNIX permission, sets the directory mode of the directories included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0755 translates to User read-write, Group and Other read-only. The default value is 0755. (more on unix-style permissions)
    • useStrictFiltering

      private boolean useStrictFiltering
      When specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error. This is meant to highlight obsolete inclusions or exclusions, or else signal that the assembly descriptor is incorrectly configured. (Since 2.2) .
    • outputFileNameMapping

      private String outputFileNameMapping
      Sets the mapping pattern for all dependencies included in this assembly. Default is ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}. (Since 2.2-beta-2; 2.2-beta-1 uses ${artifactId}-${version}${dashClassifier?}.${extension}). NOTE: If the dependencySet specifies unpack == true, outputFileNameMapping WILL NOT BE USED; in these cases, use outputDirectory. See the plugin FAQ for more details about entries usable in the outputFileNameMapping parameter.
    • unpack

      private boolean unpack
      If set to true, this property will unpack all dependencies into the specified output directory. When set to false, dependencies will be included as archives (jars). Can only unpack jar, zip, tar.gz, and tar.bz archives. Default value is false.
    • unpackOptions

      private UnpackOptions unpackOptions
      Allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact. (Since 2.2) .
    • scope

      private String scope
      Sets the dependency scope for this dependencySet. Default scope value is "runtime".
    • useProjectArtifact

      private boolean useProjectArtifact
      Determines whether the artifact produced during the current project's build should be included in this dependency set. Default value is true, for backward compatibility. (Since 2.2) .
    • useProjectAttachments

      private boolean useProjectAttachments
      Determines whether the attached artifacts produced during the current project's build should be included in this dependency set. Default value is false. (Since 2.2) .
    • useTransitiveDependencies

      private boolean useTransitiveDependencies
      Determines whether transitive dependencies will be included in the processing of the current dependency set. If true, includes/excludes/useTransitiveFiltering will apply to transitive dependency artifacts in addition to the main project dependency artifacts. If false, useTransitiveFiltering is meaningless, and includes/excludes only affect the immediate dependencies of the project. By default, this value is true. (Since 2.2) .
    • useTransitiveFiltering

      private boolean useTransitiveFiltering
      Determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact. If true, and the current artifact is a transitive dependency brought in by another artifact which matches an inclusion or exclusion pattern, then the current artifact has the same inclusion/exclusion logic applied to it as well. By default, this value is false, in order to preserve backward compatibility with version 2.1. This means that includes/excludes only apply directly to the current artifact, and not to the transitive set of artifacts which brought it in. (Since 2.2) .
  • Constructor Details

    • DependencySet

      public DependencySet()
  • Method Details

    • addExclude

      public void addExclude(String string)
      Method addExclude.
      Parameters:
      string - a string object.
    • addInclude

      public void addInclude(String string)
      Method addInclude.
      Parameters:
      string - a string object.
    • getDirectoryMode

      public String getDirectoryMode()
      Get similar to a UNIX permission, sets the directory mode of the directories included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0755 translates to User read-write, Group and Other read-only. The default value is 0755. (more on unix-style permissions)
      Returns:
      String
    • getExcludes

      public List<String> getExcludes()
      Method getExcludes.
      Returns:
      List
    • getFileMode

      public String getFileMode()
      Get similar to a UNIX permission, sets the file mode of the files included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0644 translates to User read-write, Group and Other read-only. The default value is 0644. (more on unix-style permissions)
      Returns:
      String
    • getIncludes

      public List<String> getIncludes()
      Method getIncludes.
      Returns:
      List
    • getOutputDirectory

      public String getOutputDirectory()
      Get sets the output directory relative to the root of the root directory of the assembly. For example, "log" will put the specified files in the log directory, directly beneath the root of the archive.
      Returns:
      String
    • getOutputFileNameMapping

      public String getOutputFileNameMapping()
      Get sets the mapping pattern for all dependencies included in this assembly. Default is ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}. (Since 2.2-beta-2; 2.2-beta-1 uses ${artifactId}-${version}${dashClassifier?}.${extension}). NOTE: If the dependencySet specifies unpack == true, outputFileNameMapping WILL NOT BE USED; in these cases, use outputDirectory. See the plugin FAQ for more details about entries usable in the outputFileNameMapping parameter.
      Returns:
      String
    • getScope

      public String getScope()
      Get sets the dependency scope for this dependencySet. Default scope value is "runtime".
      Returns:
      String
    • getUnpackOptions

      public UnpackOptions getUnpackOptions()
      Get allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact. (Since 2.2).
      Returns:
      UnpackOptions
    • isUnpack

      public boolean isUnpack()
      Get if set to true, this property will unpack all dependencies into the specified output directory. When set to false, dependencies will be included as archives (jars). Can only unpack jar, zip, tar.gz, and tar.bz archives. Default value is false.
      Returns:
      boolean
    • isUseProjectArtifact

      public boolean isUseProjectArtifact()
      Get determines whether the artifact produced during the current project's build should be included in this dependency set. Default value is true, for backward compatibility. (Since 2.2).
      Returns:
      boolean
    • isUseProjectAttachments

      public boolean isUseProjectAttachments()
      Get determines whether the attached artifacts produced during the current project's build should be included in this dependency set. Default value is false. (Since 2.2).
      Returns:
      boolean
    • isUseStrictFiltering

      public boolean isUseStrictFiltering()
      Get when specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error. This is meant to highlight obsolete inclusions or exclusions, or else signal that the assembly descriptor is incorrectly configured. (Since 2.2).
      Returns:
      boolean
    • isUseTransitiveDependencies

      public boolean isUseTransitiveDependencies()
      Get determines whether transitive dependencies will be included in the processing of the current dependency set. If true, includes/excludes/useTransitiveFiltering will apply to transitive dependency artifacts in addition to the main project dependency artifacts. If false, useTransitiveFiltering is meaningless, and includes/excludes only affect the immediate dependencies of the project. By default, this value is true. (Since 2.2).
      Returns:
      boolean
    • isUseTransitiveFiltering

      public boolean isUseTransitiveFiltering()
      Get determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact. If true, and the current artifact is a transitive dependency brought in by another artifact which matches an inclusion or exclusion pattern, then the current artifact has the same inclusion/exclusion logic applied to it as well. By default, this value is false, in order to preserve backward compatibility with version 2.1. This means that includes/excludes only apply directly to the current artifact, and not to the transitive set of artifacts which brought it in. (Since 2.2).
      Returns:
      boolean
    • removeExclude

      public void removeExclude(String string)
      Method removeExclude.
      Parameters:
      string - a string object.
    • removeInclude

      public void removeInclude(String string)
      Method removeInclude.
      Parameters:
      string - a string object.
    • setDirectoryMode

      public void setDirectoryMode(String directoryMode)
      Set similar to a UNIX permission, sets the directory mode of the directories included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0755 translates to User read-write, Group and Other read-only. The default value is 0755. (more on unix-style permissions)
      Parameters:
      directoryMode - a directoryMode object.
    • setExcludes

      public void setExcludes(List<String> excludes)
      Set when <exclude> subelements are present, they define a set of dependency artifact coordinates to exclude. If none is present, then <excludes> represents no exclusions. Artifact coordinates may be given in simple groupId:artifactId form, or they may be fully qualified in the form groupId:artifactId:type[:classifier]:version. Additionally, wildcards can be used, as in *:maven-*.
      Parameters:
      excludes - a excludes object.
    • setFileMode

      public void setFileMode(String fileMode)
      Set similar to a UNIX permission, sets the file mode of the files included. THIS IS AN OCTAL VALUE. Format: (User)(Group)(Other) where each component is a sum of Read = 4, Write = 2, and Execute = 1. For example, the value 0644 translates to User read-write, Group and Other read-only. The default value is 0644. (more on unix-style permissions)
      Parameters:
      fileMode - a fileMode object.
    • setIncludes

      public void setIncludes(List<String> includes)
      Set when <include> subelements are present, they define a set of artifact coordinates to include. If none is present, then <includes> represents all valid values. Artifact coordinates may be given in simple groupId:artifactId form, or they may be fully qualified in the form groupId:artifactId:type[:classifier]:version. Additionally, wildcards can be used, as in *:maven-*.
      Parameters:
      includes - a includes object.
    • setOutputDirectory

      public void setOutputDirectory(String outputDirectory)
      Set sets the output directory relative to the root of the root directory of the assembly. For example, "log" will put the specified files in the log directory, directly beneath the root of the archive.
      Parameters:
      outputDirectory - a outputDirectory object.
    • setOutputFileNameMapping

      public void setOutputFileNameMapping(String outputFileNameMapping)
      Set sets the mapping pattern for all dependencies included in this assembly. Default is ${artifact.artifactId}-${artifact.version}${dashClassifier?}.${artifact.extension}. (Since 2.2-beta-2; 2.2-beta-1 uses ${artifactId}-${version}${dashClassifier?}.${extension}). NOTE: If the dependencySet specifies unpack == true, outputFileNameMapping WILL NOT BE USED; in these cases, use outputDirectory. See the plugin FAQ for more details about entries usable in the outputFileNameMapping parameter.
      Parameters:
      outputFileNameMapping - a outputFileNameMapping object.
    • setScope

      public void setScope(String scope)
      Set sets the dependency scope for this dependencySet. Default scope value is "runtime".
      Parameters:
      scope - a scope object.
    • setUnpack

      public void setUnpack(boolean unpack)
      Set if set to true, this property will unpack all dependencies into the specified output directory. When set to false, dependencies will be included as archives (jars). Can only unpack jar, zip, tar.gz, and tar.bz archives. Default value is false.
      Parameters:
      unpack - a unpack object.
    • setUnpackOptions

      public void setUnpackOptions(UnpackOptions unpackOptions)
      Set allows the specification of includes and excludes, along with filtering options, for items unpacked from a dependency artifact. (Since 2.2).
      Parameters:
      unpackOptions - a unpackOptions object.
    • setUseProjectArtifact

      public void setUseProjectArtifact(boolean useProjectArtifact)
      Set determines whether the artifact produced during the current project's build should be included in this dependency set. Default value is true, for backward compatibility. (Since 2.2).
      Parameters:
      useProjectArtifact - a useProjectArtifact object.
    • setUseProjectAttachments

      public void setUseProjectAttachments(boolean useProjectAttachments)
      Set determines whether the attached artifacts produced during the current project's build should be included in this dependency set. Default value is false. (Since 2.2).
      Parameters:
      useProjectAttachments - a useProjectAttachments object.
    • setUseStrictFiltering

      public void setUseStrictFiltering(boolean useStrictFiltering)
      Set when specified as true, any include/exclude patterns which aren't used to filter an actual artifact during assembly creation will cause the build to fail with an error. This is meant to highlight obsolete inclusions or exclusions, or else signal that the assembly descriptor is incorrectly configured. (Since 2.2).
      Parameters:
      useStrictFiltering - a useStrictFiltering object.
    • setUseTransitiveDependencies

      public void setUseTransitiveDependencies(boolean useTransitiveDependencies)
      Set determines whether transitive dependencies will be included in the processing of the current dependency set. If true, includes/excludes/useTransitiveFiltering will apply to transitive dependency artifacts in addition to the main project dependency artifacts. If false, useTransitiveFiltering is meaningless, and includes/excludes only affect the immediate dependencies of the project. By default, this value is true. (Since 2.2).
      Parameters:
      useTransitiveDependencies - a useTransitiveDependencies object.
    • setUseTransitiveFiltering

      public void setUseTransitiveFiltering(boolean useTransitiveFiltering)
      Set determines whether the include/exclude patterns in this dependency set will be applied to the transitive path of a given artifact. If true, and the current artifact is a transitive dependency brought in by another artifact which matches an inclusion or exclusion pattern, then the current artifact has the same inclusion/exclusion logic applied to it as well. By default, this value is false, in order to preserve backward compatibility with version 2.1. This means that includes/excludes only apply directly to the current artifact, and not to the transitive set of artifacts which brought it in. (Since 2.2).
      Parameters:
      useTransitiveFiltering - a useTransitiveFiltering object