|
Groovy Documentation | |||||||
FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | PROPERTY | CONSTR | METHOD | DETAIL: FIELD | PROPERTY | CONSTR | METHOD |
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 BuildSettings.projectWorkDir), but not others. If you set one of them explicitly, set all of them to ensure consistent behaviour.
Field Summary | |
---|---|
static java.lang.String |
APP_BASE_DIR
The base directory of the application |
static java.lang.String |
BUILD_LISTENERS
The name of the system property for multiple buildListeners. |
static java.lang.String |
COMPILER_SOURCE_LEVEL
The compiler source level to use |
static java.lang.String |
COMPILER_TARGET_LEVEL
The compiler source level to use |
static java.lang.String |
CONVERT_CLOSURES_KEY
A property name to enable/disable AST conversion of closures actions&tags to methods |
static java.lang.String |
CORE_WORKING_DIR_NAME
The name of the working directory for commands that don't belong to a project (like create-app) |
static 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. |
static java.lang.String |
GLOBAL_PLUGINS_DIR
The name of the system property for globalPluginsDir. |
static java.lang.String |
OFFLINE_MODE
|
static java.lang.String |
PLUGINS_DIR
The name of the system property for projectPluginsDir. |
static java.lang.String |
PROJECT_CLASSES_DIR
The name of the system property for classesDir. |
static java.lang.String |
PROJECT_DOCS_OUTPUT_DIR
The name of the system property for docsOutputDir. |
static java.lang.String |
PROJECT_PLUGIN_BUILD_CLASSES_DIR
The name of the system property for pluginBuildClassesDir. |
static java.lang.String |
PROJECT_PLUGIN_CLASSES_DIR
The name of the system property for pluginClassesDir. |
static java.lang.String |
PROJECT_PLUGIN_PROVIDED_CLASSES_DIR
The name of the system property for pluginProvidedClassesDir. |
static java.lang.String |
PROJECT_RESOURCES_DIR
|
static java.lang.String |
PROJECT_SOURCE_DIR
The name of the system property for sourceDir. |
static java.lang.String |
PROJECT_TARGET_DIR
The name of the system property for projectTargetDir. |
static java.lang.String |
PROJECT_TEST_CLASSES_DIR
The name of the system property for testClassesDir. |
static java.lang.String |
PROJECT_TEST_REPORTS_DIR
The name of the system property for testReportsDir. |
static java.lang.String |
PROJECT_TEST_SOURCE_DIR
The name of the system property for testSourceDir. |
static java.lang.String |
PROJECT_WAR_EXPLODED_DIR
The name of the system property for projectWarExplodedDir. |
static java.lang.String |
PROJECT_WAR_FILE
The name of the WAR file of the project |
static java.lang.String |
PROJECT_WAR_OSGI_HEADERS
The name of the system property for enabling osgi headers in the WAR Manifest |
static java.lang.String |
PROJECT_WEB_XML_FILE
The name of the system property for BuildSettings.webXmlLocation. |
static java.lang.String |
PROJECT_WORK_DIR
The name of the system property for projectWorkDir. |
static java.lang.String |
SERVLET_VERSION
The version of the servlet API |
static java.lang.String |
VERBOSE_COMPILE
The name of the system property for enabling verbose compilation verboseCompile. |
static java.lang.String |
WORK_DIR
The name of the system property for grailsWorkDir. |
protected boolean |
settingsFileLoaded
|
Fields inherited from class AbstractBuildSettings | |
---|---|
cache, config, flatConfig, globalPluginsDir, globalPluginsDirSet, projectPluginsDir, projectPluginsDirSet |
Property Summary | |
---|---|
static java.util.regex.Pattern |
JAR_PATTERN
|
org.apache.ivy.core.report.ResolveReport |
allDependenciesReport
The dependency report for all configurations |
java.util.List |
applicationJars
List of jars provided in the applications 'lib' directory |
java.io.File |
baseDir
The base directory for the build, which is normally the root directory of the current project. |
java.util.List |
buildListeners
|
org.apache.ivy.core.report.ResolveReport |
buildResolveReport
|
java.io.File |
classesDir
The location to which Grails compiles a project's classes. |
org.apache.ivy.core.report.ResolveReport |
compileResolveReport
|
java.lang.String |
compilerSourceLevel
The compiler source level to use |
java.lang.String |
compilerTargetLevel
The compiler target level to use |
boolean |
convertClosuresArtefacts
|
GrailsCoreDependencies |
coreDependencies
|
java.util.List |
defaultBuildDependencies
|
java.util.List |
defaultCompileDependencies
|
boolean |
defaultEnv
|
java.util.Map |
defaultPluginMap
A Set of plugin names and versions that represent the default set of plugins installed when creating Grails applications |
java.util.Set |
defaultPluginSet
A Set of plugin names that represent the default set of plugins installed when creating Grails applications |
java.util.List |
defaultProvidedDependencies
|
java.util.List |
defaultRuntimeDependencies
|
java.util.List |
defaultTestDependencies
|
boolean |
dependenciesExternallyConfigured
Whether the project required build dependencies are externally configured (by Maven for example) or not |
IvyDependencyManager |
dependencyManager
Manages dependencies and dependency resolution in a Grails application |
java.io.File |
docsOutputDir
The location of the documentation output. |
boolean |
enableResolve
Whether to enable resolving dependencies |
java.lang.String |
grailsEnv
The environment for the current script. |
java.io.File |
grailsHome
Location of the Grails distribution as usually identified by the GRAILS_HOME environment variable. |
java.lang.String |
grailsVersion
The version of Grails being used for the current script. |
java.io.File |
grailsWorkDir
The location of the Grails working directory where non-project-specific temporary files are stored. |
boolean |
includeJavadoc
whether to include javadoc attachments in a resolve |
boolean |
includeSource
whether to include source attachments in a resolve |
boolean |
modified
Return whether the BuildConfig has been modified |
boolean |
offline
Whether the build is allowed to connect to remote servers to resolve dependencies |
java.io.File |
pluginBuildClassesDir
The location to which Grails compiles build scoped plugins classes. |
java.io.File |
pluginClassesDir
The location to which Grails compiles a project's plugin classes. |
java.util.List |
pluginDependencies
|
java.io.File |
pluginProvidedClassesDir
The location to which Grails compiles provided scoped plugins classes. |
java.io.File |
projectTargetDir
The location of the project target directory where reports, artifacts and so on are output. |
java.io.File |
projectWarExplodedDir
The location of the Grails WAR directory where exploded WAR is built. |
java.io.File |
projectWarFile
The WAR file of the project |
boolean |
projectWarOsgiHeaders
Setting for whether or not to enable OSGI headers in the WAR Manifest, can be overridden via -verboseCompile(=[true|false])? |
java.io.File |
projectWorkDir
The location of the project working directory for project-specific temporary files. |
org.apache.ivy.core.report.ResolveReport |
providedResolveReport
|
groovy.util.ConfigObject |
proxySettings
The settings used to establish the HTTP proxy to use for dependency resolution etc. |
java.io.File |
proxySettingsFile
The file containing the proxy settings |
java.io.File |
resourcesDir
The location where Grails keeps temporary copies of a project's resources. |
java.net.URLClassLoader |
rootLoader
The root loader for the build. |
org.apache.ivy.core.report.ResolveReport |
runtimeResolveReport
|
java.lang.String |
servletVersion
The version of the servlet API used |
java.io.File |
sourceDir
The location of the plain source. |
java.io.File |
testClassesDir
The location to which Grails compiles a project's test classes and any test scoped plugin classes. |
java.io.File |
testReportsDir
The location of the test reports. |
org.apache.ivy.core.report.ResolveReport |
testResolveReport
|
java.io.File |
testSourceDir
The location of the test source. |
java.io.File |
userHome
Location of the current user's home directory - equivalent to "user.home" system property. |
boolean |
verboseCompile
Setting for whether or not to enable verbose compilation, can be overridden via -verboseCompile(=[true|false])? |
java.io.File |
webXmlLocation
Location of the generated web.xml file |
Constructor Summary | |
BuildSettings()
|
|
BuildSettings(java.io.File grailsHome)
|
|
BuildSettings(java.io.File grailsHome, java.io.File baseDir)
|
Method Summary | |
---|---|
java.lang.Object
|
configureDependencyManager(groovy.util.ConfigObject config)
|
groovy.util.ConfigSlurper
|
createConfigSlurper()
|
java.io.File
|
getBaseDir()
Returns the current base directory of this project. |
java.io.File
|
getBasePluginDescriptor()
|
java.util.List
|
getBuildDependencies()
List containing the runtime dependencies of the app as File instances. |
java.lang.Object[]
|
getBuildListeners()
|
java.io.File
|
getClassesDir()
|
java.util.List
|
getCompileDependencies()
List containing the compile-time dependencies of the app as File instances. |
boolean
|
getConvertClosuresArtefacts()
|
java.lang.String
|
getFunctionalTestBaseUrl()
|
groovy.lang.Closure
|
getGrailsScriptClosure()
Implementation of the "grailsScript()" method used in Grails scripts. |
java.io.File
|
getGrailsWorkDir()
|
java.io.File
|
getPluginBuildClassesDir()
|
java.util.List
|
getPluginBuildDependencies()
Obtains a list of source plugins that are build time dependencies |
java.io.File
|
getPluginClassesDir()
|
java.util.List
|
getPluginCompileDependencies()
Obtains a list of source plugins that are provided time dependencies |
java.io.File
|
getPluginProvidedClassesDir()
|
java.util.List
|
getPluginProvidedDependencies()
Obtains a list of source plugins that are provided time dependencies |
java.util.List
|
getPluginRuntimeDependencies()
Obtains a list of source plugins that are runtime time dependencies |
java.util.List
|
getPluginTestDependencies()
Obtains a list of source plugins that are test time dependencies |
java.io.File
|
getProjectTargetDir()
|
java.io.File
|
getProjectWarExplodedDir()
|
java.io.File
|
getProjectWarFile()
|
boolean
|
getProjectWarOsgiHeaders()
|
java.io.File
|
getProjectWorkDir()
|
java.util.List
|
getProvidedDependencies()
List containing the runtime dependencies of the app as File instances. |
java.io.File
|
getResourcesDir()
|
java.util.List
|
getRuntimeDependencies()
List containing the runtime dependencies of the app as File instances. |
java.io.File
|
getSourceDir()
|
java.io.File
|
getTestClassesDir()
|
java.util.List
|
getTestDependencies()
List containing the test-time dependencies of the app as File instances. |
java.io.File
|
getTestReportsDir()
|
java.io.File
|
getTestSourceDir()
|
java.io.File
|
getWebXmlLocation()
|
boolean
|
isPluginProject()
|
boolean
|
isRegisteredInMetadata(java.lang.String pluginName)
|
protected java.lang.Object
|
loadBuildPropertiesFromClasspath(java.util.Properties buildProps)
|
groovy.util.ConfigObject
|
loadConfig()
Loads the application's BuildSettings.groovy file if it exists and returns the corresponding config object. |
groovy.util.ConfigObject
|
loadConfig(java.io.File configFile)
Loads the given configuration file if it exists and returns the corresponding config object. |
groovy.util.ConfigObject
|
loadConfig(groovy.util.ConfigObject config)
|
protected groovy.util.ConfigObject
|
loadSettingsFile()
|
boolean
|
notDefinedInBuildConfig(java.lang.String pluginName)
|
groovy.lang.GroovyClassLoader
|
obtainGroovyClassLoader()
|
protected void
|
parseGrailsBuildListeners()
|
groovy.lang.Closure
|
pluginDependencyHandler()
|
groovy.lang.Closure
|
pluginDependencyHandler(IvyDependencyManager dependencyManager)
|
protected void
|
postLoadConfig()
|
void
|
setBaseDir(java.io.File newBaseDir)
|
void
|
setBuildDependencies(java.util.List deps)
Sets the runtime dependencies for the project |
void
|
setBuildListeners(java.lang.Object buildListeners)
|
void
|
setClassesDir(java.io.File dir)
|
void
|
setCompileDependencies(java.util.List deps)
Sets the compile time dependencies for the project |
void
|
setConvertClosuresArtefacts(boolean convert)
|
void
|
setGrailsWorkDir(java.io.File dir)
|
void
|
setPluginBuildClassesDir(java.io.File dir)
|
void
|
setPluginClassesDir(java.io.File dir)
|
void
|
setPluginProvidedClassesDir(java.io.File dir)
|
void
|
setProjectTargetDir(java.io.File dir)
|
void
|
setProjectWarExplodedDir(java.io.File dir)
|
void
|
setProjectWarFile(java.io.File file)
|
void
|
setProjectWarOsgiHeaders(boolean flag)
|
void
|
setProjectWorkDir(java.io.File dir)
|
void
|
setProvidedDependencies(java.util.List deps)
Sets the runtime dependencies for the project |
void
|
setResourcesDir(java.io.File dir)
|
void
|
setRuntimeDependencies(java.util.List deps)
Sets the runtime dependencies for the project |
void
|
setSourceDir(java.io.File dir)
|
void
|
setTestClassesDir(java.io.File dir)
|
void
|
setTestDependencies(java.util.List deps)
Sets the test time dependencies for the project |
void
|
setTestReportsDir(java.io.File dir)
|
void
|
setTestSourceDir(java.io.File dir)
|
void
|
setVerboseCompile(boolean flag)
|
void
|
setWebXmlLocation(java.io.File location)
|
protected boolean
|
shouldResolve()
|
void
|
storeDependencyCache()
|
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 |
---|
public static final java.lang.String APP_BASE_DIR
public static final java.lang.String BUILD_LISTENERS
public static final java.lang.String COMPILER_SOURCE_LEVEL
public static final java.lang.String COMPILER_TARGET_LEVEL
public static final java.lang.String CONVERT_CLOSURES_KEY
public static final java.lang.String CORE_WORKING_DIR_NAME
public static final java.lang.String FUNCTIONAL_BASE_URL_PROPERTY
public static final java.lang.String GLOBAL_PLUGINS_DIR
public static final java.lang.String OFFLINE_MODE
public static final java.lang.String PLUGINS_DIR
public static final java.lang.String PROJECT_CLASSES_DIR
public static final java.lang.String PROJECT_DOCS_OUTPUT_DIR
public static final java.lang.String PROJECT_PLUGIN_BUILD_CLASSES_DIR
public static final java.lang.String PROJECT_PLUGIN_CLASSES_DIR
public static final java.lang.String PROJECT_PLUGIN_PROVIDED_CLASSES_DIR
public static final java.lang.String PROJECT_RESOURCES_DIR
public static final java.lang.String PROJECT_SOURCE_DIR
public static final java.lang.String PROJECT_TARGET_DIR
public static final java.lang.String PROJECT_TEST_CLASSES_DIR
public static final java.lang.String PROJECT_TEST_REPORTS_DIR
public static final java.lang.String PROJECT_TEST_SOURCE_DIR
public static final java.lang.String PROJECT_WAR_EXPLODED_DIR
public static final java.lang.String PROJECT_WAR_FILE
public static final java.lang.String PROJECT_WAR_OSGI_HEADERS
public static final java.lang.String PROJECT_WEB_XML_FILE
public static final java.lang.String PROJECT_WORK_DIR
public static final java.lang.String SERVLET_VERSION
public static final java.lang.String VERBOSE_COMPILE
public static final java.lang.String WORK_DIR
protected boolean settingsFileLoaded
Property Detail |
---|
static final java.util.regex.Pattern JAR_PATTERN
@Lazy org.apache.ivy.core.report.ResolveReport allDependenciesReport
java.util.List applicationJars
java.io.File baseDir
java.util.List buildListeners
org.apache.ivy.core.report.ResolveReport buildResolveReport
java.io.File classesDir
org.apache.ivy.core.report.ResolveReport compileResolveReport
java.lang.String compilerSourceLevel
java.lang.String compilerTargetLevel
boolean convertClosuresArtefacts
GrailsCoreDependencies coreDependencies
@Lazy java.util.List defaultBuildDependencies
@Lazy java.util.List defaultCompileDependencies
boolean defaultEnv
true
if the default environment for a script should be used.
java.util.Map defaultPluginMap
java.util.Set defaultPluginSet
@Lazy java.util.List defaultProvidedDependencies
@Lazy java.util.List defaultRuntimeDependencies
@Lazy java.util.List defaultTestDependencies
boolean dependenciesExternallyConfigured
IvyDependencyManager dependencyManager
java.io.File docsOutputDir
boolean enableResolve
java.lang.String grailsEnv
java.io.File grailsHome
null
if GRAILS_HOME is not set, for example if a
project uses the Grails JAR files directly.
java.lang.String grailsVersion
java.io.File grailsWorkDir
boolean includeJavadoc
boolean includeSource
boolean modified
boolean offline
java.io.File pluginBuildClassesDir
java.io.File pluginClassesDir
java.util.List pluginDependencies
java.io.File pluginProvidedClassesDir
java.io.File projectTargetDir
java.io.File projectWarExplodedDir
java.io.File projectWarFile
boolean projectWarOsgiHeaders
java.io.File projectWorkDir
org.apache.ivy.core.report.ResolveReport providedResolveReport
groovy.util.ConfigObject proxySettings
java.io.File proxySettingsFile
java.io.File resourcesDir
java.net.URLClassLoader rootLoader
org.apache.ivy.core.report.ResolveReport runtimeResolveReport
java.lang.String servletVersion
java.io.File sourceDir
java.io.File testClassesDir
java.io.File testReportsDir
org.apache.ivy.core.report.ResolveReport testResolveReport
java.io.File testSourceDir
java.io.File userHome
boolean verboseCompile
java.io.File webXmlLocation
Constructor Detail |
---|
BuildSettings()
BuildSettings(java.io.File grailsHome)
BuildSettings(java.io.File grailsHome, java.io.File baseDir)
Method Detail |
---|
java.lang.Object configureDependencyManager(groovy.util.ConfigObject config)
groovy.util.ConfigSlurper createConfigSlurper()
java.io.File getBaseDir()
java.io.File getBasePluginDescriptor()
java.util.List getBuildDependencies()
java.lang.Object[] getBuildListeners()
java.io.File getClassesDir()
java.util.List getCompileDependencies()
boolean getConvertClosuresArtefacts()
java.lang.String getFunctionalTestBaseUrl()
groovy.lang.Closure getGrailsScriptClosure()
java.io.File getGrailsWorkDir()
java.io.File getPluginBuildClassesDir()
java.util.List getPluginBuildDependencies()
java.io.File getPluginClassesDir()
java.util.List getPluginCompileDependencies()
java.io.File getPluginProvidedClassesDir()
java.util.List getPluginProvidedDependencies()
java.util.List getPluginRuntimeDependencies()
java.util.List getPluginTestDependencies()
java.io.File getProjectTargetDir()
java.io.File getProjectWarExplodedDir()
java.io.File getProjectWarFile()
boolean getProjectWarOsgiHeaders()
java.io.File getProjectWorkDir()
java.util.List getProvidedDependencies()
java.io.File getResourcesDir()
java.util.List getRuntimeDependencies()
java.io.File getSourceDir()
java.io.File getTestClassesDir()
java.util.List getTestDependencies()
java.io.File getTestReportsDir()
java.io.File getTestSourceDir()
java.io.File getWebXmlLocation()
boolean isPluginProject()
boolean isRegisteredInMetadata(java.lang.String pluginName)
protected java.lang.Object loadBuildPropertiesFromClasspath(java.util.Properties buildProps)
groovy.util.ConfigObject loadConfig()
groovy.util.ConfigObject loadConfig(java.io.File configFile)
groovy.util.ConfigObject loadConfig(groovy.util.ConfigObject config)
protected groovy.util.ConfigObject loadSettingsFile()
boolean notDefinedInBuildConfig(java.lang.String pluginName)
groovy.lang.GroovyClassLoader obtainGroovyClassLoader()
protected void parseGrailsBuildListeners()
groovy.lang.Closure pluginDependencyHandler()
groovy.lang.Closure pluginDependencyHandler(IvyDependencyManager dependencyManager)
protected void postLoadConfig()
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!
void setBuildDependencies(java.util.List deps)
void setBuildListeners(java.lang.Object buildListeners)
void setClassesDir(java.io.File dir)
void setCompileDependencies(java.util.List deps)
void setConvertClosuresArtefacts(boolean convert)
void setGrailsWorkDir(java.io.File dir)
void setPluginBuildClassesDir(java.io.File dir)
void setPluginClassesDir(java.io.File dir)
void setPluginProvidedClassesDir(java.io.File dir)
void setProjectTargetDir(java.io.File dir)
void setProjectWarExplodedDir(java.io.File dir)
void setProjectWarFile(java.io.File file)
void setProjectWarOsgiHeaders(boolean flag)
void setProjectWorkDir(java.io.File dir)
void setProvidedDependencies(java.util.List deps)
void setResourcesDir(java.io.File dir)
void setRuntimeDependencies(java.util.List deps)
void setSourceDir(java.io.File dir)
void setTestClassesDir(java.io.File dir)
void setTestDependencies(java.util.List deps)
void setTestReportsDir(java.io.File dir)
void setTestSourceDir(java.io.File dir)
void setVerboseCompile(boolean flag)
void setWebXmlLocation(java.io.File location)
protected boolean shouldResolve()
void storeDependencyCache()
Groovy Documentation