Groovy Documentation

## grails.util
[Groovy] Class PluginBuildSettings

    java.lang.Object
      grails.util.PluginBuildSettings

    class PluginBuildSettings

Uses the project BuildSettings object to discover information about the installed plugin such as the jar files they provide, the plugin descriptors and so on.

Authors:
  Graeme Rocher

Since:
  1.2

Field Summary
`static java.lang.Object` | `EXCLUDED_RESOURCES` Resources to be excluded from the final packaged plugin.

Property Summary
`BuildSettings` | `buildSettings`
`GrailsPluginManager` | `pluginManager`
`groovy.lang.Closure` | `resourceResolver` A default resolver used if none is specified to the resource resolving methods in this class.

Constructor Summary
`PluginBuildSettings(BuildSettings buildSettings)`
`PluginBuildSettings(BuildSettings buildSettings, GrailsPluginManager pluginManager)`

Method Summary
`void` | `clearCache()` Clears any cached entries.
`Resource[]` | `getArtefactResources()` Obtains a reference to all artefact resources (all Groovy files contained within the grails-app directory of plugins or applications).
`Resource[]` | `getArtefactResourcesForOne(java.lang.String projectDir)` Returns an array of all artefacts in the given application or plugin directory as Spring resources.
`Resource[]` | `getAvailableScripts()` Obtains an array of all Gant scripts that are availabe for execution in a Grails application.
`Resource` | `getBasePluginDescriptor()` Obtains the 'base' plugin descriptor, which is the plugin descriptor of the current plugin project.
`Resource` | `getDescriptorForPlugin(Resource pluginDir)` Returns the descriptor location for the given plugin directory.
`java.lang.String` | `getGlobalPluginsPath()` Obtains the path to the global plugins directory.
`java.util.List` | `getImplicitPluginDirectories()` Returns a list of all plugin directories in both the given path and the global "plugins" directory together.
`Resource[]` | `getInlinePluginDirectories()` Returns an array of the inplace plugin locations.
`groovy.util.slurpersupport.GPathResult` | `getMetadataForPlugin(java.lang.String pluginName)` Returns XML about the plugin.
`groovy.util.slurpersupport.GPathResult` | `getMetadataForPlugin(Resource pluginDir)` Returns XML metadata for the plugin.
`java.util.List` | `getPluginBaseDirectories()` Gets a list of all the known plugin base directories (directories where plugins are installed to).
`Resource` | `getPluginDescriptor(Resource pluginDir)` Returns the plugin descriptor for the Given plugin directory.
`Resource[]` | `getPluginDescriptors()` /*.groovy") }
`Resource` | `getPluginDirForName(java.lang.String pluginName)` Obtains a plugin directory for the given name.
`Resource[]` | `getPluginDirectories()` Obtains a list of plugin directories for the application
`Resource[]` | `getPluginI18nDirectories()` Obtains an array of all plugin i18n directories.
`GrailsPluginInfo` | `getPluginInfo(java.lang.String pluginBaseDir)` Obtains a PluginInfo for the installed plugin directory.
`GrailsPluginInfo` | `getPluginInfoForName(java.lang.String pluginName)` Obtains a PluginInfo for the installed plugin directory.
`GrailsPluginInfo` | `getPluginInfoForSource(java.lang.String sourceFile)` Gets a PluginInfo for a particular source file if its contained within that plugin
`GrailsPluginInfo[]` | `getPluginInfos(java.lang.String pluginDirPath = this.pluginDirPath)` Returns an array of PluginInfo objects
`Resource[]` | `getPluginJarFiles()` Obtains an array of all plugin provided JAR files
`Resource[]` | `getPluginLibDirectories()` Obtains an array of all plugin lib directories.
`Resource[]` | `getPluginResourceBundles()` Obtains an array of all plugin provided resource bundles.
`Resource[]` | `getPluginScripts()` .groovy").each { if (!
`Resource[]` | `getPluginSourceFiles()` /*.properties") } }
`Resource[]` | `getPluginSourceFiles(java.io.File pluginDir)`
`Resource[]` | `getPluginXmlMetadata()` Obtains a Resource array of the Plugin metadata XML files used to describe the plugins provided resources
`GrailsPluginInfo[]` | `getSupportedPluginInfos()` Returns only the PluginInfo objects that support the current Environment and BuildScope.
`Resource[]` | `getUnmanagedPluginJarFiles()` Obtains an array of all plugin provided JAR files for plugins that don't define a dependencies.groovy.
`boolean` | `isGlobalPluginLocation(Resource pluginDir)` Returns true if the specified plugin directory is a global plugin.
`boolean` | `isInlinePluginLocation(Resource pluginLocation)` Returns true if the specified plugin location is an inline location.

Methods inherited from class java.lang.Object
java.lang.Object#wait(), java.lang.Object#wait(long), java.lang.Object#wait(long, int), java.lang.Object#equals(java.lang.Object), java.lang.Object#toString(), java.lang.Object#hashCode(), java.lang.Object#getClass(), java.lang.Object#notify(), java.lang.Object#notifyAll()

Field Detail

### EXCLUDED_RESOURCES

    public static final java.lang.Object EXCLUDED_RESOURCES

  Resources to be excluded from the final packaged plugin. Defined as Ant paths.

Property Detail

### buildSettings

    BuildSettings buildSettings

### pluginManager

    GrailsPluginManager pluginManager

### resourceResolver

    groovy.lang.Closure resourceResolver

  A default resolver used if none is specified to the resource resolving methods in this class.

Constructor Detail

### PluginBuildSettings

    PluginBuildSettings(BuildSettings buildSettings)

### PluginBuildSettings

    PluginBuildSettings(BuildSettings buildSettings, GrailsPluginManager pluginManager)

Method Detail

### clearCache

    void clearCache()

  Clears any cached entries.

### getArtefactResources

    Resource[] getArtefactResources()

  Obtains a reference to all artefact resources (all Groovy files contained within the grails-app directory of plugins or applications).

### getArtefactResourcesForOne

    Resource[] getArtefactResourcesForOne(java.lang.String projectDir)

  Returns an array of all artefacts in the given application or plugin directory as Spring resources.

### getAvailableScripts

    Resource[] getAvailableScripts()

  Obtains an array of all Gant scripts that are availabe for execution in a Grails application.

### getBasePluginDescriptor

    Resource getBasePluginDescriptor()

  Obtains the 'base' plugin descriptor, which is the plugin descriptor of the current plugin project.

### getDescriptorForPlugin

    Resource getDescriptorForPlugin(Resource pluginDir)

  Returns the descriptor location for the given plugin directory. The descriptor is the Groovy file that ends with *GrailsPlugin.groovy

### getGlobalPluginsPath

    java.lang.String getGlobalPluginsPath()

  Obtains the path to the global plugins directory.

### getImplicitPluginDirectories

    java.util.List getImplicitPluginDirectories()

  Returns a list of all plugin directories in both the given path and the global "plugins" directory together.

### getInlinePluginDirectories

    Resource[] getInlinePluginDirectories()

  Returns an array of the inplace plugin locations.

### getMetadataForPlugin

    groovy.util.slurpersupport.GPathResult getMetadataForPlugin(java.lang.String pluginName)

  Returns XML about the plugin.

### getMetadataForPlugin

    groovy.util.slurpersupport.GPathResult getMetadataForPlugin(Resource pluginDir)

  Returns XML metadata for the plugin.

### getPluginBaseDirectories

    java.util.List getPluginBaseDirectories()

  Gets a list of all the known plugin base directories (directories where plugins are installed to).

### getPluginDescriptor

    Resource getPluginDescriptor(Resource pluginDir)

  Returns the plugin descriptor for the Given plugin directory.
  Parameters:
    `pluginDir` - The plugin directory
  Returns:
    The plugin descriptor

### getPluginDescriptors

    Resource[] getPluginDescriptors()

  /*.groovy") } /** Obtains an array of all plugin descriptors (the root classes that end with *GrailsPlugin.groovy).

### getPluginDirForName

    Resource getPluginDirForName(java.lang.String pluginName)

  Obtains a plugin directory for the given name.

### getPluginDirectories

    Resource[] getPluginDirectories()

  Obtains a list of plugin directories for the application

### getPluginI18nDirectories

    Resource[] getPluginI18nDirectories()

  Obtains an array of all plugin i18n directories.

### getPluginInfo

    GrailsPluginInfo getPluginInfo(java.lang.String pluginBaseDir)

  Obtains a PluginInfo for the installed plugin directory.

### getPluginInfoForName

    GrailsPluginInfo getPluginInfoForName(java.lang.String pluginName)

  Obtains a PluginInfo for the installed plugin directory.

### getPluginInfoForSource

    GrailsPluginInfo getPluginInfoForSource(java.lang.String sourceFile)

  Gets a PluginInfo for a particular source file if its contained within that plugin

### getPluginInfos

    GrailsPluginInfo[] getPluginInfos(java.lang.String pluginDirPath = this.pluginDirPath)

  Returns an array of PluginInfo objects

### getPluginJarFiles

    Resource[] getPluginJarFiles()

  Obtains an array of all plugin provided JAR files

### getPluginLibDirectories

    Resource[] getPluginLibDirectories()

  Obtains an array of all plugin lib directories.

### getPluginResourceBundles

    Resource[] getPluginResourceBundles()

  Obtains an array of all plugin provided resource bundles.

### getPluginScripts

    Resource[] getPluginScripts()

  .groovy").each { if (!it.file.name.startsWith('_')) scripts << it } resourceResolver("file:${basedir}/scripts/*.groovy").each { if (!it.file.name.startsWith('_')) scripts << it } pluginScripts.each { if (!it.file.name.startsWith('_')) scripts << it } resourceResolver("file:${userHome}/.grails/scripts/*.groovy").each { if (!it.file.name.startsWith('_')) scripts << it } availableScripts = scripts as Resource[] cache.availableScripts = availableScripts } return availableScripts } /** Obtains an array of plugin provided Gant scripts available to a Grails application.

### getPluginSourceFiles

    Resource[] getPluginSourceFiles()

  /*.properties") } } /** Obtains an array of all plugin provided source files (Java and Groovy).

### getPluginSourceFiles

    Resource[] getPluginSourceFiles(java.io.File pluginDir)

### getPluginXmlMetadata

    Resource[] getPluginXmlMetadata()

  Obtains a Resource array of the Plugin metadata XML files used to describe the plugins provided resources

### getSupportedPluginInfos

    GrailsPluginInfo[] getSupportedPluginInfos()

  Returns only the PluginInfo objects that support the current Environment and BuildScope.
  See Also:
    Environment
    BuildScope

### getUnmanagedPluginJarFiles

    Resource[] getUnmanagedPluginJarFiles()

  Obtains an array of all plugin provided JAR files for plugins that don't define a dependencies.groovy.

### isGlobalPluginLocation

    boolean isGlobalPluginLocation(Resource pluginDir)

  Returns true if the specified plugin directory is a global plugin.

### isInlinePluginLocation

    boolean isInlinePluginLocation(Resource pluginLocation)

  Returns true if the specified plugin location is an inline location.

Groovy Documentation