org.codehaus.groovy.grails.commons

Class DefaultGrailsApplication

java.lang.Object

groovy.lang.GroovyObjectSupport

org.codehaus.groovy.grails.commons.DefaultGrailsApplication

All Implemented Interfaces:

groovy.lang.GroovyObject, GrailsApplication, org.springframework.beans.factory.Aware, org.springframework.beans.factory.BeanClassLoaderAware, org.springframework.context.ApplicationContextAware

public class DefaultGrailsApplication
extends groovy.lang.GroovyObjectSupport
implements GrailsApplication, org.springframework.beans.factory.BeanClassLoaderAware

Default implementation of the GrailsApplication interface that manages application loading, state, and artefact instances.

Upon loading this GrailsApplication will inspect each class using its registered ArtefactHandler instances. Each ArtefactHandler provides knowledge about the conventions used to establish its artefact type. For example controllers use the ControllerArtefactHandler to establish this knowledge.

New ArtefactHandler instances can be registered with the GrailsApplication thus allowing application extensibility.

Since:

0.1

See Also:

GrailsPluginManager, DefaultGrailsPluginManager, ArtefactHandler, ArtefactInfo

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.List<java.lang.Class<?>>	allArtefactClasses
protected java.lang.Class<?>[]	allArtefactClassesArray
protected java.lang.Class<?>[]	allClasses
protected grails.util.Metadata	applicationMeta
protected ArtefactHandler[]	artefactHandlers
protected java.util.Map<java.lang.String,ArtefactHandler>	artefactHandlersByName
protected java.util.Map<java.lang.String,ArtefactInfo>	artefactInfo
protected java.lang.ClassLoader	classLoader
protected groovy.util.ConfigObject	config
protected java.util.Map	flatConfig
protected static java.util.regex.Pattern	GETCLASS_PATTERN
protected static java.util.regex.Pattern	GETCLASSESMETH_PATTERN
protected static java.util.regex.Pattern	GETCLASSESPROP_PATTERN
protected boolean	initialised
protected static java.util.regex.Pattern	ISCLASS_PATTERN
protected java.util.Set<java.lang.Class<?>>	loadedClasses
protected static org.apache.commons.logging.Log	log
protected org.springframework.context.ApplicationContext	mainContext
protected org.springframework.context.ApplicationContext	parentContext
protected org.springframework.core.io.Resource[]	resources

Fields inherited from interface org.codehaus.groovy.grails.commons.GrailsApplication

APPLICATION_ID, CLASS_EDITOR_BEAN, CLASS_LOADER_BEAN, CONFIG_CLASS, CUSTOM_EDITORS_BEAN, DATA_SOURCE_BEAN, DATA_SOURCE_CLASS, DIALECT_DETECTOR_BEAN, ENV_APPLICATION, ENV_DEVELOPMENT, ENV_PRODUCTION, ENV_TEST, ENVIRONMENT, ENVIRONMENT_DEFAULT, EXCEPTION_HANDLER_BEAN, GLOBAL_PLUGINS_DIR, HIBERNATE_PROPERTIES_BEAN, MESSAGE_SOURCE_BEAN, MULTIPART_RESOLVER_BEAN, OPEN_SESSION_IN_VIEW_INTERCEPTOR_BEAN, PLUGINS_DIR, PROJECT_CLASSES_DIR, PROJECT_META_FILE, PROJECT_RESOURCES_DIR, PROJECT_TEST_CLASSES_DIR, PROJECT_WORK_DIR, SESSION_FACTORY_BEAN, TRANSACTION_MANAGER_BEAN, WORK_DIR

Constructor Summary

Constructors

Constructor and Description
DefaultGrailsApplication() Creates a new empty Grails application.
DefaultGrailsApplication(java.lang.Class<?>[] classes, java.lang.ClassLoader classLoader) Creates a new GrailsApplication instance using the given classes and GroovyClassLoader.
DefaultGrailsApplication(java.lang.ClassLoader classLoader)
DefaultGrailsApplication(org.springframework.core.io.Resource[] resources) Loads a GrailsApplication using the given ResourceLocator instance which will search for appropriate class names
DefaultGrailsApplication(org.codehaus.groovy.grails.io.support.Resource[] resources) Loads a GrailsApplication using the given ResourceLocator instance which will search for appropriate class names

Method Summary

Modifier and Type	Method and Description
void	addArtefact(java.lang.Class artefact) Adds the given artefact, attempting to determine type from
GrailsClass	addArtefact(java.lang.String artefactType, java.lang.Class artefactClass) Adds an artefact of the given type for the given Class.
protected GrailsClass	addArtefact(java.lang.String artefactType, java.lang.Class<?> artefactClass, boolean overrideable)
GrailsClass	addArtefact(java.lang.String artefactType, GrailsClass artefactGrailsClass) Adds an artefact of the given type for the given GrailsClass.
void	addOverridableArtefact(java.lang.Class artefact) Adds an artefact that can be overriden by user defined classes
GrailsClass	addOverridableArtefact(java.lang.String artefactType, java.lang.Class artefactClass) Adds an artefact of the given type for the given Class.
protected void	addToLoaded(java.lang.Class<?> clazz)
void	clear() Clears the application returning it to an empty state.
void	configChanged() Fired to inform the application when the Config.groovy file changes.
protected void	configureLoadedClasses(java.lang.Class<?>[] classes) Configures the loaded classes within the GrailsApplication instance using the registered ArtefactHandler instances.
java.lang.Class<?>[]	getAllArtefacts() Returns all the classes identified as artefacts by ArtefactHandler instances.
java.lang.Class<?>[]	getAllClasses() Retrieves all classes loaded by the GrailsApplication.
GrailsClass	getArtefact(java.lang.String artefactType, java.lang.String name) Retrieves an artefact for the given type and name.
GrailsClass	getArtefactByLogicalPropertyName(java.lang.String type, java.lang.String logicalName) Retrieves an artefact by its logical property name.
protected int	getArtefactCount(java.lang.String artefactType) Retrieves the number of artefacts registered for the given artefactType as defined by the ArtefactHandler.
GrailsClass	getArtefactForFeature(java.lang.String artefactType, java.lang.Object featureID) Get an artefact GrailsClass by a "feature" which depending on the artefact may be a URI or tag name for example
ArtefactHandler	getArtefactHandler(java.lang.String type) Returns the ArtefactHandler for the given type
ArtefactHandler[]	getArtefactHandlers() Obtain a list of all the artefact handlers
ArtefactInfo	getArtefactInfo(java.lang.String artefactType) Get the cache of classes for the specified artefact type.
protected DefaultArtefactInfo	getArtefactInfo(java.lang.String artefactType, boolean create) Get or create the cache of classes for the specified artefact type.
GrailsClass[]	getArtefacts(java.lang.String artefactType) Returns all of the GrailsClass instances for the given artefactType as defined by the ArtefactHandler
ArtefactHandler	getArtefactType(java.lang.Class theClass) Returns the ArtefactHandler for the given class or null
java.lang.Class<?>	getClassForName(java.lang.String className) Retrieves a class from the GrailsApplication for the given name.
java.lang.ClassLoader	getClassLoader() Returns the class loader instance for the Grails application.
groovy.util.ConfigObject	getConfig() Returns the ConfigObject instance.
protected GrailsClass	getFirstArtefact(java.lang.String artefactType)
java.util.Map<java.lang.String,java.lang.Object>	getFlatConfig() Returns the flatten ConfigObject for use from Java classes.
org.springframework.context.ApplicationContext	getMainContext() Returns the Spring context for this application.
grails.util.Metadata	getMetadata() Get access to the project's metadata, specified in application.properties
org.springframework.context.ApplicationContext	getParentContext() Returns the Spring application context that contains this application instance.
java.lang.Object	getProperty(java.lang.String propertyName) Override property access and hit on xxxxClasses to return class arrays of artefacts.
org.springframework.core.io.Resource	getResourceForClass(java.lang.Class theClazz) Retrieves the Spring Resource that was used to load the given Class.
boolean	hasArtefactHandler(java.lang.String type) Test whether an artefact handler exists for a given type
protected void	initArtefactHandlers() Initialises the default set of ArtefactHandler instances.
void	initialise() Initialise this GrailsApplication.
protected static void	initialiseGroovyExtensionModules()
protected void	initializeArtefacts(ArtefactHandler handler) Re-initialize the artefacts of the specified type.
protected void	initializeArtefacts(java.lang.String artefactType) Re-initialize the artefacts of the specified type.
java.lang.Object	invokeMethod(java.lang.String methodName, java.lang.Object args) Overrides method invocation to return dynamic artefact methods.
boolean	isArtefact(java.lang.Class theClazz) Returns true if the given class is an artefact identified by one of the registered ArtefactHandler instances.
boolean	isArtefactOfType(java.lang.String artefactType, java.lang.Class theClazz) Returns true if the specified class is of the given artefact type as defined by the ArtefactHandler.
boolean	isArtefactOfType(java.lang.String artefactType, java.lang.String className) Returns true if the specified class name is of the given artefact type as defined by the ArtefactHandler.
boolean	isInitialised() Returns whether this GrailsApplication has been initialised or not.
boolean	isWarDeployed() Returns true if this application has been deployed as a WAR file
protected java.lang.Class<?>[]	populateAllClasses()
void	rebuild() Rebuilds this Application throwing away the class loader and re-constructing it from the loaded resources again.
void	refresh() Refreshes this GrailsApplication, rebuilding all of the artefact definitions as defined by the registered ArtefactHandler instances.
protected void	refreshArtefactGrailsClassCaches() Tell all our artefact info objects to update their internal state after we've added a bunch of classes.
void	refreshConstraints() Refreshes constraints defined by the DomainClassArtefactHandler.
void	registerArtefactHandler(ArtefactHandler handler) Registers a new ArtefactHandler that is responsible for identifying and managing a particular artefact type that is defined by some convention.
void	setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
void	setBeanClassLoader(java.lang.ClassLoader classLoader)
void	setConfig(groovy.util.ConfigObject config)
void	setMainContext(org.springframework.context.ApplicationContext context) Sets the main Spring context for this application.
void	updateFlatConfig()

Methods inherited from class groovy.lang.GroovyObjectSupport

getMetaClass, setMetaClass, setProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.codehaus.groovy.grails.commons.GrailsApplication

configChanged, getClassLoader, getFlatConfig, getMainContext, getMetadata, getParentContext, isWarDeployed, setMainContext

Methods inherited from interface org.springframework.context.ApplicationContextAware

setApplicationContext

Field Detail

GETCLASSESPROP_PATTERN

protected static final java.util.regex.Pattern GETCLASSESPROP_PATTERN

GETCLASSESMETH_PATTERN

protected static final java.util.regex.Pattern GETCLASSESMETH_PATTERN

ISCLASS_PATTERN

protected static final java.util.regex.Pattern ISCLASS_PATTERN

GETCLASS_PATTERN

protected static final java.util.regex.Pattern GETCLASS_PATTERN

allClasses

protected java.lang.Class<?>[] allClasses

log

protected static org.apache.commons.logging.Log log

loadedClasses

protected java.util.Set<java.lang.Class<?>> loadedClasses

artefactHandlers

protected ArtefactHandler[] artefactHandlers

artefactHandlersByName

protected java.util.Map<java.lang.String,ArtefactHandler> artefactHandlersByName

allArtefactClasses

protected java.util.List<java.lang.Class<?>> allArtefactClasses

artefactInfo

protected java.util.Map<java.lang.String,ArtefactInfo> artefactInfo

allArtefactClassesArray

protected java.lang.Class<?>[] allArtefactClassesArray

resources

protected org.springframework.core.io.Resource[] resources

initialised

protected boolean initialised

classLoader

protected java.lang.ClassLoader classLoader

config

protected groovy.util.ConfigObject config

flatConfig

protected java.util.Map flatConfig

parentContext

protected org.springframework.context.ApplicationContext parentContext

mainContext

protected org.springframework.context.ApplicationContext mainContext

applicationMeta

protected grails.util.Metadata applicationMeta

Constructor Detail

DefaultGrailsApplication

public DefaultGrailsApplication()

Creates a new empty Grails application.

DefaultGrailsApplication

public DefaultGrailsApplication(java.lang.ClassLoader classLoader)

DefaultGrailsApplication

public DefaultGrailsApplication(java.lang.Class<?>[] classes,
                                java.lang.ClassLoader classLoader)

Creates a new GrailsApplication instance using the given classes and GroovyClassLoader.

Parameters:

classes - The classes that make up the GrailsApplication

classLoader - The GroovyClassLoader to use

DefaultGrailsApplication

public DefaultGrailsApplication(org.springframework.core.io.Resource[] resources)

Loads a GrailsApplication using the given ResourceLocator instance which will search for appropriate class names

DefaultGrailsApplication

public DefaultGrailsApplication(org.codehaus.groovy.grails.io.support.Resource[] resources)

Loads a GrailsApplication using the given ResourceLocator instance which will search for appropriate class names

Method Detail

initArtefactHandlers

protected void initArtefactHandlers()

Initialises the default set of ArtefactHandler instances.

See Also:

ArtefactHandler

getAllArtefacts

public java.lang.Class<?>[] getAllArtefacts()

Returns all the classes identified as artefacts by ArtefactHandler instances.

Specified by:

getAllArtefacts in interface GrailsApplication

Returns:

An array of classes

populateAllClasses

protected java.lang.Class<?>[] populateAllClasses()

configureLoadedClasses

protected void configureLoadedClasses(java.lang.Class<?>[] classes)

Configures the loaded classes within the GrailsApplication instance using the registered ArtefactHandler instances.

Parameters:

classes - The classes to configure

refreshArtefactGrailsClassCaches

protected void refreshArtefactGrailsClassCaches()

Tell all our artefact info objects to update their internal state after we've added a bunch of classes.

addToLoaded

protected void addToLoaded(java.lang.Class<?> clazz)

getConfig

public groovy.util.ConfigObject getConfig()

Description copied from interface: GrailsApplication

Returns the ConfigObject instance.

Specified by:

getConfig in interface GrailsApplication

Returns:

The ConfigObject instance

getArtefactCount

protected int getArtefactCount(java.lang.String artefactType)

Retrieves the number of artefacts registered for the given artefactType as defined by the ArtefactHandler.

Parameters:

artefactType - The type of the artefact as defined by the ArtefactHandler

Returns:

The number of registered artefacts

getAllClasses

public java.lang.Class<?>[] getAllClasses()

Retrieves all classes loaded by the GrailsApplication.

Specified by:

getAllClasses in interface GrailsApplication

Returns:

All classes loaded by the GrailsApplication

getClassForName

public java.lang.Class<?> getClassForName(java.lang.String className)

Retrieves a class from the GrailsApplication for the given name.

Specified by:

getClassForName in interface GrailsApplication

Parameters:

className - The class name

Returns:

Either the Class instance or null if it doesn't exist

refreshConstraints

public void refreshConstraints()

Refreshes constraints defined by the DomainClassArtefactHandler. TODO: Move this out of GrailsApplication

Specified by:

refreshConstraints in interface GrailsApplication

refresh

public void refresh()

Refreshes this GrailsApplication, rebuilding all of the artefact definitions as defined by the registered ArtefactHandler instances.

Specified by:

refresh in interface GrailsApplication

rebuild

public void rebuild()

Description copied from interface: GrailsApplication

Rebuilds this Application throwing away the class loader and re-constructing it from the loaded resources again. Can only be called in development mode and an error will be thrown if called in a different enivronment

Specified by:

rebuild in interface GrailsApplication

getResourceForClass

public org.springframework.core.io.Resource getResourceForClass(java.lang.Class theClazz)

Retrieves the Spring Resource that was used to load the given Class.

Specified by:

getResourceForClass in interface GrailsApplication

Parameters:

theClazz - The class

Returns:

Either a Spring Resource or null if no Resource was found for the given class

isArtefact

public boolean isArtefact(java.lang.Class theClazz)

Returns true if the given class is an artefact identified by one of the registered ArtefactHandler instances. Uses class name equality to handle class reloading

Specified by:

isArtefact in interface GrailsApplication

Parameters:

theClazz - The class to check

Returns:

true if it is an artefact

isArtefactOfType

public boolean isArtefactOfType(java.lang.String artefactType,
                                java.lang.Class theClazz)

Returns true if the specified class is of the given artefact type as defined by the ArtefactHandler.

Specified by:

isArtefactOfType in interface GrailsApplication

Parameters:

artefactType - The type of the artefact

theClazz - The class

Returns:

true if it is of the specified artefactType

See Also:

ArtefactHandler

isArtefactOfType

public boolean isArtefactOfType(java.lang.String artefactType,
                                java.lang.String className)

Returns true if the specified class name is of the given artefact type as defined by the ArtefactHandler.

Specified by:

isArtefactOfType in interface GrailsApplication

Parameters:

artefactType - The type of the artefact

className - The class name

Returns:

true if it is of the specified artefactType

See Also:

ArtefactHandler

getArtefact

public GrailsClass getArtefact(java.lang.String artefactType,
                               java.lang.String name)

Retrieves an artefact for the given type and name.

Specified by:

getArtefact in interface GrailsApplication

Parameters:

artefactType - The artefact type as defined by a registered ArtefactHandler

name - The name of the class

Returns:

A GrailsClass instance or null if none could be found for the given artefactType and name

getArtefactType

public ArtefactHandler getArtefactType(java.lang.Class theClass)

Description copied from interface: GrailsApplication

Returns the ArtefactHandler for the given class or null

Specified by:

getArtefactType in interface GrailsApplication

Parameters:

theClass - The class

Returns:

The ArtefactHandler

getFirstArtefact

protected GrailsClass getFirstArtefact(java.lang.String artefactType)

getArtefacts

public GrailsClass[] getArtefacts(java.lang.String artefactType)

Returns all of the GrailsClass instances for the given artefactType as defined by the ArtefactHandler

Specified by:

getArtefacts in interface GrailsApplication

Parameters:

artefactType - The type of the artefact defined by the ArtefactHandler

Returns:

An array of classes for the given artefact

getArtefactForFeature

public GrailsClass getArtefactForFeature(java.lang.String artefactType,
                                         java.lang.Object featureID)

Description copied from interface: GrailsApplication

Get an artefact GrailsClass by a "feature" which depending on the artefact may be a URI or tag name for example

Specified by:

getArtefactForFeature in interface GrailsApplication

Parameters:

artefactType - The type ID of the artefact, i.e. "TagLib"

featureID - The "feature" ID, say a URL or tag name

Returns:

The grails class or null if none is found

addArtefact

public GrailsClass addArtefact(java.lang.String artefactType,
                               java.lang.Class artefactClass)

Adds an artefact of the given type for the given Class.

Specified by:

addArtefact in interface GrailsApplication

Parameters:

artefactType - The type of the artefact as defined by a ArtefactHandler instance

artefactClass - A Class instance that matches the type defined by the ArtefactHandler

Returns:

The GrailsClass if successful or null if it couldn't be added

Throws:

GrailsConfigurationException - If the specified Class is not the same as the type defined by the ArtefactHandler

See Also:

ArtefactHandler

addArtefact

public GrailsClass addArtefact(java.lang.String artefactType,
                               GrailsClass artefactGrailsClass)

Adds an artefact of the given type for the given GrailsClass.

Specified by:

addArtefact in interface GrailsApplication

Parameters:

artefactType - The type of the artefact as defined by a ArtefactHandler instance

artefactGrailsClass - A GrailsClass instance that matches the type defined by the ArtefactHandler

Returns:

The GrailsClass if successful or null if it couldn't be added

Throws:

GrailsConfigurationException - If the specified GrailsClass is not the same as the type defined by the ArtefactHandler

See Also:

ArtefactHandler

registerArtefactHandler

public void registerArtefactHandler(ArtefactHandler handler)

Registers a new ArtefactHandler that is responsible for identifying and managing a particular artefact type that is defined by some convention.

Specified by:

registerArtefactHandler in interface GrailsApplication

Parameters:

handler - The ArtefactHandler to regster

hasArtefactHandler

public boolean hasArtefactHandler(java.lang.String type)

Description copied from interface: GrailsApplication

Test whether an artefact handler exists for a given type

Specified by:

hasArtefactHandler in interface GrailsApplication

Parameters:

type - The type of the handler

Returns:

true if it does

getArtefactHandlers

public ArtefactHandler[] getArtefactHandlers()

Description copied from interface: GrailsApplication

Obtain a list of all the artefact handlers

Specified by:

getArtefactHandlers in interface GrailsApplication

Returns:

The list, possible empty but not null, of all currently registered handlers

getArtefactHandler

public ArtefactHandler getArtefactHandler(java.lang.String type)

Description copied from interface: GrailsApplication

Returns the ArtefactHandler for the given type

Specified by:

getArtefactHandler in interface GrailsApplication

Parameters:

type - The artefact handler type

Returns:

The artefact handler

initializeArtefacts

protected void initializeArtefacts(java.lang.String artefactType)

Re-initialize the artefacts of the specified type. This gives handlers a chance to update caches etc.

Parameters:

artefactType - The type of artefact to init

clear

public void clear()

Clears the application returning it to an empty state. Very dangerous method, use with caution.

initializeArtefacts

protected void initializeArtefacts(ArtefactHandler handler)

Re-initialize the artefacts of the specified type. This gives handlers a chance to update caches etc.

Parameters:

handler - The handler to register

getArtefactInfo

protected DefaultArtefactInfo getArtefactInfo(java.lang.String artefactType,
                                              boolean create)

Get or create the cache of classes for the specified artefact type.

Parameters:

artefactType - The name of an artefact type

create - Set to true if you want non-existent caches to be created

Returns:

The cache of classes for the type, or null if no cache exists and create is false

getArtefactInfo

public ArtefactInfo getArtefactInfo(java.lang.String artefactType)

Get the cache of classes for the specified artefact type.

Specified by:

getArtefactInfo in interface GrailsApplication

Parameters:

artefactType - The name of an artefact type

Returns:

The cache of classes for the type, or null if no cache exists

invokeMethod

public java.lang.Object invokeMethod(java.lang.String methodName,
                                     java.lang.Object args)

Overrides method invocation to return dynamic artefact methods.

We will support getXXXXClasses() and isXXXXClass(class)

Specified by:

invokeMethod in interface groovy.lang.GroovyObject

Overrides:

invokeMethod in class groovy.lang.GroovyObjectSupport

Parameters:

methodName - The name of the method

args - The arguments to the method

Returns:

The return value of the method TODO Need to add matches for addClass(java.lang.Class) and addClass(GrailsClass)

getProperty

public java.lang.Object getProperty(java.lang.String propertyName)

Override property access and hit on xxxxClasses to return class arrays of artefacts.

Specified by:

getProperty in interface groovy.lang.GroovyObject

Overrides:

getProperty in class groovy.lang.GroovyObjectSupport

Parameters:

propertyName - The name of the property, if it ends in *Classes then match and invoke internal ArtefactHandler

Returns:

All the artifacts or delegate to super.getProperty

initialise

public void initialise()

Description copied from interface: GrailsApplication

Initialise this GrailsApplication.

Specified by:

initialise in interface GrailsApplication

initialiseGroovyExtensionModules

protected static void initialiseGroovyExtensionModules()

isInitialised

public boolean isInitialised()

Description copied from interface: GrailsApplication

Returns whether this GrailsApplication has been initialised or not.

Specified by:

isInitialised in interface GrailsApplication

Returns:

true if it has been initialised

getArtefactByLogicalPropertyName

public GrailsClass getArtefactByLogicalPropertyName(java.lang.String type,
                                                    java.lang.String logicalName)

Description copied from interface: GrailsApplication

Retrieves an artefact by its logical property name. For example the logical property name of BookController would be book.

Specified by:

getArtefactByLogicalPropertyName in interface GrailsApplication

Parameters:

type - The artefact type

logicalName - The logical name

Returns:

The GrailsClass or null if it doesn't exist

addArtefact

public void addArtefact(java.lang.Class artefact)

Description copied from interface: GrailsApplication

Adds the given artefact, attempting to determine type from

Specified by:

addArtefact in interface GrailsApplication

Parameters:

artefact - The artefact to add

setBeanClassLoader

public void setBeanClassLoader(java.lang.ClassLoader classLoader)

Specified by:

setBeanClassLoader in interface org.springframework.beans.factory.BeanClassLoaderAware

addOverridableArtefact

public void addOverridableArtefact(java.lang.Class artefact)

Description copied from interface: GrailsApplication

Adds an artefact that can be overriden by user defined classes

Specified by:

addOverridableArtefact in interface GrailsApplication

Parameters:

artefact - An overridable artefact

addOverridableArtefact

public GrailsClass addOverridableArtefact(java.lang.String artefactType,
                                          java.lang.Class artefactClass)

Adds an artefact of the given type for the given Class.

Parameters:

artefactType - The type of the artefact as defined by a ArtefactHandler instance

artefactClass - A Class instance that matches the type defined by the ArtefactHandler

Returns:

The GrailsClass if successful or null if it couldn't be added

Throws:

GrailsConfigurationException - If the specified Class is not the same as the type defined by the ArtefactHandler

See Also:

ArtefactHandler

addArtefact

protected GrailsClass addArtefact(java.lang.String artefactType,
                                  java.lang.Class<?> artefactClass,
                                  boolean overrideable)

setApplicationContext

public void setApplicationContext(org.springframework.context.ApplicationContext applicationContext)
                           throws org.springframework.beans.BeansException

Specified by:

setApplicationContext in interface org.springframework.context.ApplicationContextAware

Throws:

org.springframework.beans.BeansException

getMetadata

public grails.util.Metadata getMetadata()

Description copied from interface: GrailsApplication

Get access to the project's metadata, specified in application.properties

This provides access to information like required grails version, application name, version etc but NOT general application settings.

Specified by:

getMetadata in interface GrailsApplication

Returns:

A read-only Map of data about the application, not environment specific

isWarDeployed

public boolean isWarDeployed()

Description copied from interface: GrailsApplication

Returns true if this application has been deployed as a WAR file

Specified by:

isWarDeployed in interface GrailsApplication

Returns:

true if the application is WAR deployed

setConfig

public void setConfig(groovy.util.ConfigObject config)

updateFlatConfig

public void updateFlatConfig()

getFlatConfig

public java.util.Map<java.lang.String,java.lang.Object> getFlatConfig()

Description copied from interface: GrailsApplication

Returns the flatten ConfigObject for use from Java classes.

Specified by:

getFlatConfig in interface GrailsApplication

Returns:

The flattened config

configChanged

public void configChanged()

Description copied from interface: GrailsApplication

Fired to inform the application when the Config.groovy file changes.

Specified by:

configChanged in interface GrailsApplication

getClassLoader

public java.lang.ClassLoader getClassLoader()

Description copied from interface: GrailsApplication

Returns the class loader instance for the Grails application.

Specified by:

getClassLoader in interface GrailsApplication

Returns:

The ClassLoader instance

getMainContext

public org.springframework.context.ApplicationContext getMainContext()

Description copied from interface: GrailsApplication

Returns the Spring context for this application. Note that this will return null until the application is fully initialised. This context contains all the application artifacts, plugin beans, the works.

Specified by:

getMainContext in interface GrailsApplication

setMainContext

public void setMainContext(org.springframework.context.ApplicationContext context)

Description copied from interface: GrailsApplication

Sets the main Spring context for this application.

Specified by:

setMainContext in interface GrailsApplication

getParentContext

public org.springframework.context.ApplicationContext getParentContext()

Description copied from interface: GrailsApplication

Returns the Spring application context that contains this application instance. It is the parent of the context returned by GrailsApplication.getMainContext().

Specified by:

getParentContext in interface GrailsApplication