Deprecated API (Grails 3.0.10.BUILD-SNAPSHOT)
Date: 2015-12-03

# Deprecated API

## Contents

- Deprecated Interface
- Deprecated Trait
- Deprecated Class
- Deprecated Annotation Type
- Deprecated Method
- Deprecated Constructor
- Deprecated Field

- Deprecated Fields
  Field and Description
  BuildSettings#BUILD_LISTENERS | The name of the system property for multiple build listeners
  BuildSettings#DEPENDENCY_RESOLVER | The dependency resolver to use
  BuildSettings#GLOBAL_PLUGINS_DIR | The name of the system property for global plugins directory
  BuildSettings#PLUGINS_DIR | The name of the system property for the project plugins directory
  BuildSettings#PLUGIN_INCLUDE_SOURCE | The name of the system property for plugin include source
  BuildSettings#PLUGIN_STAGING_DIR | The name of the system property for plugin staging directory
  BuildSettings#PROJECT_PLUGIN_BUILD_CLASSES_DIR | The name of the system property for project build classes directory.
  BuildSettings#PROJECT_PLUGIN_CLASSES_DIR | The name of the system property for the plugin classes directory
  BuildSettings#PROJECT_PLUGIN_PROVIDED_CLASSES_DIR | The name of the system property for plugin provided classes diretory
  BuildSettings#PROJECT_WAR_EXPLODED_DIR | The name of the system property for WAR exploded directory
  BuildSettings#PROJECT_WEB_XML_FILE | The name of the system property for for the web.xml location
  BuildSettings#VERBOSE_COMPILE | The name of the system property for enabling verbose compilation verbose compile
  GrailsASTUtils#THIS_EXPR | @deprecated Sharing copies of VariableExpression which refer to "this" is unsafe

- Deprecated Interfaces
  Interface and Description
  ASTErrorsHelper Enhances a class to contain an Errors property of type org.springframework.validation.Errors.
  ApplicationAttributes @author Graeme Rocher
  ArtefactHandler @author Graeme Rocher
  ArtefactInfo @author Graeme Rocher
  CascadingValidator Extends the default Spring Validator interface and provides an additional method that specifies whether validation should cascade into associations.
  Constraint Defines a validatable constraint.
  ConstraintFactory A factory for creating constraint instances.
  ConstraintsEvaluator Evaluates and returns constraints.
  FlashScope @author Graeme Rocher
  GrailsApplication @author Graeme Rocher
  GrailsApplicationAttributes @deprecated Use GrailsApplicationAttributes instead
  GrailsApplicationAware @author Graeme Rocher
  GrailsArtefactClassInjector Interface specific to Grails artefacts that returns the artefact type.
  GrailsClass @author Graeme Rocher
  GrailsControllerClass Represents a controller class in Grails.
  GrailsDomainClass Represents a persistable Grails domain class.
  GrailsDomainClassInjector Mainly just a marker interface for implementations that perform injection on domain classes.
  GrailsDomainClassProperty A property of a GrailsDomainClass instance.
  GrailsPlugin @author Graeme Rocher
  GrailsPluginInfo @author Graeme Rocher
  GrailsPluginManager @author Graeme Rocher
  GroovyPagesUriService @deprecated Use GroovyPagesUriService instead
  LinkGenerator @deprecated Use LinkGenerator instead
  MimeTypeProvider @deprecated Use MimeTypeProvider instead
  MimeTypeResolver @deprecated Use MimeTypeResolver instead
  PluginManagerAware @author Graeme Rocher
  PromiseDecorator @author Graeme Rocher
  PromiseDecoratorLookupStrategy @author Graeme Rocher
  PromiseDecoratorProvider @author Graeme Rocher
  RedirectEventListener @deprecated Use RedirectEventListener instead
  Resource @deprecated Use Resource instead
  UrlMappings @deprecated Use UrlMappings instead
  UrlMappingsHolder @deprecated Use UrlMappingsHolder instead

- Deprecated Traits
  Trait and Description
  ModelBuilder Used to build a Model for the purposes of codegen

- Deprecated Classes
  Class and Description
  ASTValidationErrorsHelper @author Jeff Brown
  AbstractConstraint Abstract class for constraints to extend.
  AbstractGrailsArtefactTransformer Abstract transformer that takes an implementation class and creates methods in a target ClassNode that delegate to that implementation class.
  AbstractPromiseFactory @author Graeme Rocher
  CacheEntry Wrapper for a value inside a cache that adds timestamp information for expiration and prevents "cache storms" with a Lock.
  ConstrainedProperty Provides the ability to set contraints against a properties of a class.
  DeprecatedGrailsConfig Type safe abstraction over Grails configuration
  DomainClassArtefactHandler @author Graeme Rocher
  FlatConfig @author Graeme Rocher
  ForwardMethod Implements performing a forward.
  GrailsASTUtils Helper methods for working with Groovy AST trees.
  GrailsClassUtils @author Graeme Rocher
  GrailsDomainConfigurationUtil @author Graeme Rocher
  GrailsMetaClassUtils @author Graeme Rocher
  GrailsResourceUtils @author Graeme Rocher
  GrailsRuntimeConfigurator Handles the runtime configuration of the Grails ApplicationContext.
  GrailsTransactionTemplate @author Graeme Rocher
  GroovyPageUtils Methods to establish template names, paths and so on.
  JSONObject.Null This class has been deprecated, should no longer be referenced and has been removed from Grails 3.1.
  MimeType @deprecated Use MimeType instead
  MimeTypeUtils @deprecated Use MimeTypeUtils instead
  MockApplicationContext deprecated: Will be removed in a future version of Grails.
  ResponseRedirector @deprecated Use ResponseRedirector instead
  SoftThreadLocalMap Creates a InheritableThreadLocal with an intial value of a Map.

- Deprecated Annotation Types
  Annotation Type and Description
  AstTransformer Marker annotation that for classes that transform Grails classes at the AST level.
  BindUsing This annotation may be applied to a class or to a field to customize the data binding process.
  BindingFormat Apply BindingFormat to a field to provide a format to be used when binding a String to this field.

- Deprecated Methods
  Method and Description
  BuildScope#getCurrent() Returns the current Scope object based on the currently set "grails.scope" System property
  DefaultGrailsApplicationAttributes#getApplicationUri(javax.servlet.ServletRequest request) @deprecated Use instead
  DefaultGrailsPlugin#doc(java.lang.String text) @deprecated Dynamic document generation no longer supported
  DefaultGrailsPlugin#restartContainer() Restarts the container
  DefaultGrailsPluginManager#checkForChanges() @deprecated Replaced by agent-based reloading, will be removed in a future version of Grails
  DefaultGrailsPluginManager#startPluginChangeScanner() @deprecated Will be removed in a future version of Grails
  DefaultGrailsPluginManager#stopPluginChangeScanner() @deprecated Will be removed in a future version of Grails
  GrailsApplication#getFlatConfig() Returns the flatten ConfigObject for use from Java classes.
  GrailsClass#getGrailsApplication() The GrailsApplication that this class belongs to
  GrailsClass#getReference() @deprecated
  GrailsClassUtils#getClassName(java.lang.String logicalName, java.lang.String trailingName) Returns the class name for the given logical name and trailing name.
  GrailsClassUtils#getClassNameForLowerCaseHyphenSeparatedName(java.lang.String name) Converts foo-bar into FooBar
  GrailsClassUtils#getClassNameRepresentation(java.lang.String name) Returns the class name representation of the given name
  GrailsClassUtils#getLogicalName(java.lang.Class clazz, java.lang.String trailingName) Retrieves the logical class name of a Grails artifact given the Grails class and a specified trailing name
  GrailsClassUtils#getLogicalName(java.lang.String name, java.lang.String trailingName) Retrieves the logical name of the class without the trailing name
  GrailsClassUtils#getLogicalPropertyName(java.lang.String className, java.lang.String trailingName) @deprecated Use GrailsNameUtils.getLogicalPropertyName instead.
  GrailsClassUtils#getNameFromScript(java.lang.String scriptName) Calculates the class name from a script name in the form my-funk-grails-script
  GrailsClassUtils#getNaturalName(java.lang.String name) Converts a property name into its natural language equivalent eg ('firstName' becomes 'First Name')
  GrailsClassUtils#getPropertyName(java.lang.String name) Shorter version of getPropertyNameRepresentation
  GrailsClassUtils#getPropertyName(java.lang.Class clazz) Shorter version of getPropertyNameRepresentation
  GrailsClassUtils#getPropertyNameForLowerCaseHyphenSeparatedName(java.lang.String name) Converts foo-bar into fooBar
  GrailsClassUtils#getPropertyNameRepresentation(java.lang.Class targetClass) Returns the property name equivalent for the specified class
  GrailsClassUtils#getPropertyNameRepresentation(java.lang.String name) Returns the property name representation of the given name
  GrailsClassUtils#getScriptName(java.lang.Class clazz) Retrieves the script name representation of the supplied class.
  GrailsClassUtils#getScriptName(java.lang.String name) @deprecated Use GrailsNameUtils.getScriptName instead.
  GrailsClassUtils#getShortName(java.lang.Class targetClass) Returns the class name without the package prefix
  GrailsClassUtils#getShortName(java.lang.String className) Returns the class name without the package prefix
  GrailsDomainClass#getPersistantProperties() Returns all of the persistant properties of the domain class
  GrailsDomainClass#getPersistantProperties() Returns all of the persistant properties of the domain class
  GrailsDomainConfigurationUtil#evaluateConstraints(java.lang.Object instance, GrailsDomainClassProperty properties, Map defaultConstraints) Evaluates the constraints closure to build the list of constraints
  GrailsDomainConfigurationUtil#evaluateConstraints(Class theClass, GrailsDomainClassProperty properties, Map defaultConstraints) Evaluates the constraints closure to build the list of constraints
  GrailsDomainConfigurationUtil#evaluateConstraints(java.lang.Object instance, GrailsDomainClassProperty properties) Evaluates the constraints closure to build the list of constraints.
  GrailsDomainConfigurationUtil#evaluateConstraints(java.lang.Object instance) Evaluates the constraints closure to build the list of constraints.
  GrailsDomainConfigurationUtil#evaluateConstraints(Class theClass) Evaluates the constraints closure to build the list of constraints
  GrailsDomainConfigurationUtil#evaluateConstraints(Class theClass, GrailsDomainClassProperty properties) Evaluates the constraints closure to build the list of constraints.
  GrailsPlugin#checkForChanges() When called this method checks for any changes to the plug-ins watched resources and reloads appropriately
  GrailsUtil#getEnvironment() Retrieves the current execution environment.
  GrailsUtil#sanitize(java.lang.Throwable t)
  GrailsUtil#writeSlurperResult(groovy.util.slurpersupport.GPathResult result, java.io.Writer output) Writes out a GPathResult (i.e. the result of parsing XML using XmlSlurper) to the given writer.
  GrailsWebRequest#lookupApplication() Looks up the GrailsApplication from the current request.
  GrailsWebUtil#currentFlatConfiguration() @return The currently bound GrailsApplication instance
  StreamCharBuffer#readAsCharArray() Reads the buffer to a char[].
  StreamCharBuffer#readAsString() Reads the buffer to a String.

- Deprecated Constructors
  Constructor and Description
  DefaultUrlMappingEvaluator#DefaultUrlMappingEvaluator(javax.servlet.ServletContext servletContext) @param servletContext The servlet context
  DefaultUrlMappingInfo#DefaultUrlMappingInfo(java.lang.Object viewName, java.util.Map params, UrlMappingData urlData, javax.servlet.ServletContext servletContext) @deprecated Use DefaultUrlMappingInfo(Object, java.util.Map, grails.web.mapping.UrlMappingData, grails.core.GrailsApplication) instead
  DefaultUrlMappingInfo#DefaultUrlMappingInfo(java.lang.Object uri, java.lang.String httpMethod, UrlMappingData data, javax.servlet.ServletContext servletContext) @deprecated Use DefaultUrlMappingInfo(Object, String, grails.web.mapping.UrlMappingData, grails.core.GrailsApplication) instead
  DefaultUrlMappingInfo#DefaultUrlMappingInfo(java.lang.Object uri, UrlMappingData data, javax.servlet.ServletContext servletContext) @deprecated Use DefaultUrlMappingInfo(Object, grails.web.mapping.UrlMappingData, grails.core.GrailsApplication) instead
  DefaultUrlMappingInfo#DefaultUrlMappingInfo(java.lang.Object redirectInfo, java.lang.Object controllerName, java.lang.Object actionName, java.lang.Object namespace, java.lang.Object pluginName, java.lang.Object viewName, java.util.Map params, UrlMappingData urlData, javax.servlet.ServletContext servletContext) @deprecated Use DefaultUrlMappingInfo(Object, Object, Object, Object, Object, Object, java.util.Map, grails.web.mapping.UrlMappingData, grails.core.GrailsApplication) instead
  DefaultUrlMappingInfo#DefaultUrlMappingInfo(java.lang.Object redirectInfo, java.lang.Object controllerName, java.lang.Object actionName, java.lang.Object namespace, java.lang.Object pluginName, java.lang.Object viewName, java.lang.String httpMethod, java.lang.String version, Map params, UrlMappingData urlData, javax.servlet.ServletContext servletContext) @deprecated Use DefaultUrlMappingInfo(Object, Object, Object, Object, Object, Object, String, String, java.util.Map, grails.web.mapping.UrlMappingData, grails.core.GrailsApplication) instead
  GrailsAwareInjectionOperation#GrailsAwareInjectionOperation(groovy.lang.GroovyResourceLoader resourceLoader, ClassInjector classInjectors) @deprecated Custom resource loader no longer supported
  RegexUrlMapping#RegexUrlMapping(UrlMappingData data, java.net.URI uri, ConstrainedProperty constraints, javax.servlet.ServletContext servletContext) @deprecated Use RegexUrlMapping(grails.web.mapping.UrlMappingData, java.net.URI, grails.validation.ConstrainedProperty[], grails.core.GrailsApplication) instead
  RegexUrlMapping#RegexUrlMapping(UrlMappingData data, java.lang.Object controllerName, java.lang.Object actionName, java.lang.Object namespace, java.lang.Object pluginName, java.lang.Object viewName, java.lang.String httpMethod, java.lang.String version, ConstrainedProperty constraints, javax.servlet.ServletContext servletContext) @deprecated Use RegexUrlMapping(grails.web.mapping.UrlMappingData, Object, Object, Object, Object, Object, String, String, grails.validation.ConstrainedProperty[], grails.core.GrailsApplication) instead
  RegexUrlMapping#RegexUrlMapping(java.lang.Object redirectInfo, UrlMappingData data, java.lang.Object controllerName, java.lang.Object actionName, java.lang.Object namespace, java.lang.Object pluginName, java.lang.Object viewName, java.lang.String httpMethod, java.lang.String version, ConstrainedProperty constraints, javax.servlet.ServletContext servletContext) @deprecated Use RegexUrlMapping(Object, grails.web.mapping.UrlMappingData, Object, Object, Object, Object, Object, String, String, grails.validation.ConstrainedProperty[], grails.core.GrailsApplication) instead