Deprecated API (Grails 3.1.10)
Date: 2016-07-28

# 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.
  GitProfileRepository An implementation of the ProfileRepository instance that uses git
  GrailsASTUtils Helper methods for working with Groovy AST trees.
  GrailsClassUtils @author Graeme Rocher
  GrailsDomainConfigurationUtil @author Graeme Rocher
  GrailsMetaClassUtils @author Graeme Rocher
  GrailsPluginManagerFactoryBean A factory bean for loading the GrailsPluginManager instance.
  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.
  JSONBuilder Builds JSON data.
  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