grails.util
[Groovy] Class BuildSettings

java.lang.Object
  grails.util.AbstractBuildSettings
      grails.util.BuildSettings

class BuildSettings
extends AbstractBuildSettings

Represents the project paths and other build settings that the user can change when running the Grails commands. Defaults are provided for all settings, but the user can override those by setting the appropriate system property or specifying a value for it in the BuildConfig.groovy file.

Warning The behaviour is poorly defined if you explicitly set some of the project paths (such as projectWorkDir), but not others. If you set one of them explicitly, set all of them to ensure consistent behaviour.

APP_BASE_DIR

public static final java.lang.String APP_BASE_DIR

The base directory of the application

BUILD_LISTENERS

public static final java.lang.String BUILD_LISTENERS

The name of the system property for multiple buildListeners.

FUNCTIONAL_BASE_URL_PROPERTY

public static final java.lang.String FUNCTIONAL_BASE_URL_PROPERTY

A system property with this name is populated in the preparation phase of functional testing with the base URL that tests should be run against.

GLOBAL_PLUGINS_DIR

public static final java.lang.String GLOBAL_PLUGINS_DIR

The name of the system property for globalPluginsDir.

PLUGINS_DIR

public static final java.lang.String PLUGINS_DIR

The name of the system property for projectPluginsDir.

PROJECT_CLASSES_DIR

public static final java.lang.String PROJECT_CLASSES_DIR

The name of the system property for classesDir.

PROJECT_DOCS_OUTPUT_DIR

public static final java.lang.String PROJECT_DOCS_OUTPUT_DIR

The name of the system property for testReportsDir.

PROJECT_PLUGIN_CLASSES_DIR

public static final java.lang.String PROJECT_PLUGIN_CLASSES_DIR

The name of the system property for pluginClassesDir.

PROJECT_RESOURCES_DIR

public static final java.lang.String PROJECT_RESOURCES_DIR

The name of the system property for .

PROJECT_SOURCE_DIR

public static final java.lang.String PROJECT_SOURCE_DIR

The name of the system property for sourceDir.

PROJECT_TARGET_DIR

public static final java.lang.String PROJECT_TARGET_DIR

The name of the system property for projectTargetDir.

PROJECT_TEST_CLASSES_DIR

public static final java.lang.String PROJECT_TEST_CLASSES_DIR

The name of the system property for testClassesDir.

PROJECT_TEST_REPORTS_DIR

public static final java.lang.String PROJECT_TEST_REPORTS_DIR

The name of the system property for testReportsDir.

PROJECT_TEST_SOURCE_DIR

public static final java.lang.String PROJECT_TEST_SOURCE_DIR

The name of the system property for testSourceDir.

PROJECT_WAR_EXPLODED_DIR

public static final java.lang.String PROJECT_WAR_EXPLODED_DIR

The name of the system property for projectWarExplodedDir.

PROJECT_WAR_FILE

public static final java.lang.String PROJECT_WAR_FILE

The name of the WAR file of the project

PROJECT_WAR_OSGI_HEADERS

public static final java.lang.String PROJECT_WAR_OSGI_HEADERS

The name of the system property for enabling osgi headers in the WAR Manifest

PROJECT_WEB_XML_FILE

public static final java.lang.String PROJECT_WEB_XML_FILE

The name of the system property for webXmlFile.

PROJECT_WORK_DIR

public static final java.lang.String PROJECT_WORK_DIR

The name of the system property for projectWorkDir.

VERBOSE_COMPILE

public static final java.lang.String VERBOSE_COMPILE

The name of the system property for enabling verbose compilation verboseCompile.

WORK_DIR

public static final java.lang.String WORK_DIR

The name of the system property for grailsWorkDir.

settingsFileLoaded

protected boolean settingsFileLoaded

JAR_PATTERN

static final java.util.regex.Pattern JAR_PATTERN

applicationJars

java.util.List applicationJars

List of jars provided in the applications 'lib' directory

baseDir

java.io.File baseDir

The base directory for the build, which is normally the root directory of the current project. If a command is run outside of a project, then this will be the current working directory that the command was launched from.

buildDependencies

@Lazy
java.util.List buildDependencies

List containing the dependencies required for the build system only

buildListeners

java.util.List buildListeners

classesDir

java.io.File classesDir

The location to which Grails compiles a project's classes.

defaultCompileDependencies

@Lazy
java.util.List defaultCompileDependencies

List containing the default (resolved via the dependencyManager) compile-time dependencies of the app as File instances.

defaultEnv

boolean defaultEnv

true if the default environment for a script should be used.

defaultPluginMap

java.util.Map defaultPluginMap

A Set of plugin names and versions that represent the default set of plugins installed when creating Grails applications

defaultPluginSet

java.util.Set defaultPluginSet

A Set of plugin names that represent the default set of plugins installed when creating Grails applications

defaultRuntimeDependencies

@Lazy
java.util.List defaultRuntimeDependencies

List containing the default runtime-time dependencies of the app as File instances.

defaultTestDependencies

@Lazy
java.util.List defaultTestDependencies

List containing the default test-time dependencies of the app as File instances.

dependenciesExternallyConfigured

boolean dependenciesExternallyConfigured

Whether the project required build dependencies are externally configured (by Maven for example) or not

dependencyManager

IvyDependencyManager dependencyManager

Manages dependencies and dependency resolution in a Grails application

docsOutputDir

java.io.File docsOutputDir

The location of the documentation output.

grailsEnv

java.lang.String grailsEnv

The environment for the current script.

grailsHome

java.io.File grailsHome

Location of the Grails distribution as usually identified by the GRAILS_HOME environment variable. This value may be null if GRAILS_HOME is not set, for example if a project uses the Grails JAR files directly.

grailsScriptClosure

groovy.lang.Closure grailsScriptClosure

Implementation of the "grailsScript()" method used in Grails scripts.

grailsVersion

java.lang.String grailsVersion

The version of Grails being used for the current script.

grailsWorkDir

java.io.File grailsWorkDir

The location of the Grails working directory where non-project-specific temporary files are stored.

pluginClassesDir

java.io.File pluginClassesDir

The location to which Grails compiles a project's plugin classes.

projectTargetDir

java.io.File projectTargetDir

The location of the project target directory where reports, artifacts and so on are output.

projectWarExplodedDir

java.io.File projectWarExplodedDir

The location of the Grails WAR directory where exploded WAR is built.

projectWarFile

java.io.File projectWarFile

The WAR file of the project

projectWarOsgiHeaders

boolean projectWarOsgiHeaders

Setting for whether or not to enable OSGI headers in the WAR Manifest, can be overridden via -verboseCompile(=[true|false])?

projectWorkDir

java.io.File projectWorkDir

The location of the project working directory for project-specific temporary files.

providedDependencies

@Lazy
java.util.List providedDependencies

List containing the dependencies needed at development time, but provided by the container at runtime *

proxySettings

groovy.util.ConfigObject proxySettings

The settings used to establish the HTTP proxy to use for dependency resolution etc.

proxySettingsFile

java.io.File proxySettingsFile

The file containing the proxy settings

resourcesDir

java.io.File resourcesDir

The location where Grails keeps temporary copies of a project's resources.

rootLoader

java.net.URLClassLoader rootLoader

The root loader for the build. This has the required libraries on the classpath.

sourceDir

java.io.File sourceDir

The location of the plain source.

testClassesDir

java.io.File testClassesDir

The location to which Grails compiles a project's test classes.

testReportsDir

java.io.File testReportsDir

The location of the test reports.

testSourceDir

java.io.File testSourceDir

The location of the test source.

userHome

java.io.File userHome

Location of the current user's home directory - equivalent to "user.home" system property.

verboseCompile

boolean verboseCompile

Setting for whether or not to enable verbose compilation, can be overridden via -verboseCompile(=[true|false])?

webXmlLocation

java.io.File webXmlLocation

Location of the generated web.xml file

BuildSettings

BuildSettings()

BuildSettings

BuildSettings(java.io.File grailsHome)

BuildSettings

BuildSettings(java.io.File grailsHome, java.io.File baseDir)

configureDependencyManager

java.lang.Object configureDependencyManager(groovy.util.ConfigObject config)

createConfigSlurper

groovy.util.ConfigSlurper createConfigSlurper()

getBaseDir

java.io.File getBaseDir()

Returns the current base directory of this project.

getBuildListeners

Object[] getBuildListeners()

getClassesDir

java.io.File getClassesDir()

getCompileDependencies

java.util.List getCompileDependencies()

List containing the compile-time dependencies of the app as File instances.

getFunctionalTestBaseUrl

java.lang.String getFunctionalTestBaseUrl()

getGrailsWorkDir

java.io.File getGrailsWorkDir()

getPluginClassesDir

java.io.File getPluginClassesDir()

getProjectTargetDir

java.io.File getProjectTargetDir()

getProjectWarExplodedDir

java.io.File getProjectWarExplodedDir()

getProjectWarFile

java.io.File getProjectWarFile()

getProjectWarOsgiHeaders

boolean getProjectWarOsgiHeaders()

getProjectWorkDir

java.io.File getProjectWorkDir()

getResourcesDir

java.io.File getResourcesDir()

getRuntimeDependencies

java.util.List getRuntimeDependencies()

List containing the runtime dependencies of the app as File instances.

getSourceDir

java.io.File getSourceDir()

getTestClassesDir

java.io.File getTestClassesDir()

getTestDependencies

java.util.List getTestDependencies()

List containing the test-time dependencies of the app as File instances.

getTestReportsDir

java.io.File getTestReportsDir()

getTestSourceDir

java.io.File getTestSourceDir()

getWebXmlLocation

java.io.File getWebXmlLocation()

loadConfig

groovy.util.ConfigObject loadConfig()

Loads the application's BuildSettings.groovy file if it exists and returns the corresponding config object. If the file does not exist, this returns an empty config.

loadConfig

groovy.util.ConfigObject loadConfig(java.io.File configFile)

Loads the given configuration file if it exists and returns the corresponding config object. If the file does not exist, this returns an empty config.

loadConfig

groovy.util.ConfigObject loadConfig(groovy.util.ConfigObject config)

loadSettingsFile

protected groovy.util.ConfigObject loadSettingsFile()

obtainGroovyClassLoader

groovy.lang.GroovyClassLoader obtainGroovyClassLoader()

parseGrailsBuildListeners

protected void parseGrailsBuildListeners()

pluginDependencyHandler

groovy.lang.Closure pluginDependencyHandler()

pluginDependencyHandler

groovy.lang.Closure pluginDependencyHandler(IvyDependencyManager dependencyManager)

postLoadConfig

protected void postLoadConfig()

setBaseDir

void setBaseDir(java.io.File newBaseDir)

Changes the base directory, making sure that everything that depends on it gets refreshed too. If you have have previously loaded a configuration file, you should load it again after calling this method.

Warning This method resets the project paths, so if they have been set manually by the caller, then that information will be lost!

setBuildListeners

void setBuildListeners(java.lang.Object buildListeners)

setClassesDir

void setClassesDir(java.io.File dir)

setCompileDependencies

void setCompileDependencies(java.util.List deps)

Sets the compile time dependencies for the project

setGrailsWorkDir

void setGrailsWorkDir(java.io.File dir)

setPluginClassesDir

void setPluginClassesDir(java.io.File dir)

setProjectTargetDir

void setProjectTargetDir(java.io.File dir)

setProjectWarExplodedDir

void setProjectWarExplodedDir(java.io.File dir)

setProjectWarFile

void setProjectWarFile(java.io.File file)

setProjectWarOsgiHeaders

void setProjectWarOsgiHeaders(boolean flag)

setProjectWorkDir

void setProjectWorkDir(java.io.File dir)

setResourcesDir

void setResourcesDir(java.io.File dir)

setRuntimeDependencies

void setRuntimeDependencies(java.util.List deps)

Sets the runtime dependencies for the project

setSourceDir

void setSourceDir(java.io.File dir)

setTestClassesDir

void setTestClassesDir(java.io.File dir)

setTestDependencies

void setTestDependencies(java.util.List deps)

Sets the test time dependencies for the project

setTestReportsDir

void setTestReportsDir(java.io.File dir)

setTestSourceDir

void setTestSourceDir(java.io.File dir)

setVerboseCompile

void setVerboseCompile(boolean flag)

setWebXmlLocation

void setWebXmlLocation(java.io.File location)

Groovy Documentation