Deprecated API (Grails 2.4.4)
Date: 2014-10-28

# Deprecated API

## Contents

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

- Deprecated Fields
  Field and Description
  GrailsASTUtils#THIS_EXPR | @deprecated Sharing copies of VariableExpression which refer to "this" is unsafe
  GrailsApplication#ENVIRONMENT | Constant used to resolve the environment via System.getProperty(ENVIRONMENT)
  GrailsApplication#ENVIRONMENT_DEFAULT | Constants that indicates whether this GrailsApplication is running in the default environment
  GrailsApplication#ENV_APPLICATION | Constant for the application data source, primarly for backward compatability for those applications that use ApplicationDataSource.groovy
  GrailsApplication#ENV_DEVELOPMENT | Constant for the development environment
  GrailsApplication#ENV_PRODUCTION | Constant for the production environment.
  GrailsApplication#ENV_TEST | Constant for the test environment.
  GrailsApplication#GLOBAL_PLUGINS_DIR | The path to the global plug-ins directory for the application
  GrailsApplication#PLUGINS_DIR | The path to the plug-ins directory for the application
  GrailsApplication#PROJECT_CLASSES_DIR | The name of the system property whose value contains the location, during development, of the current Grails projects resources directory
  GrailsApplication#PROJECT_RESOURCES_DIR | The name of the system property whose value contains the location, during development, of the current Grails projects resources directory
  GrailsApplication#PROJECT_TEST_CLASSES_DIR | The name of the system property whose value contains the location, during development, of the current Grails projects resources directory
  GrailsApplication#PROJECT_WORK_DIR | The directory where temporary project resources and plug-ins are kept
  GrailsApplication#WORK_DIR | The name of the system property whose value contains the location, during development, of the Grails working directory where temporary files are generated to

- Deprecated Classes
  Class and Description
  BindDynamicMethod A dynamic method present in controllers allowing data binding from a map to a target instance.
  CacheEntry Wrapper for a value inside a cache that adds timestamp information for expiration and prevents "cache storms" with a Lock.
  GrailsAwareGroovyTestSuite Adds support for running Grails JUnit Tests from Eclipse JUnit runner or even from the command line.
  GrailsProjectCompiler Encapsulates the compilation logic required for a Grails application.
  GrailsProjectWatcher Watches a Grails project and re-compiles sources when they change or fires events to the pluginManager.
  GrailsReloadServletFilter Copies resources from the source on content change and manages reloading if necessary.
  GroovyPageUtils Methods to establish template names, paths and so on.
  JSON A converter that converts domain classes, Maps, Lists, Arrays, POJOs and POGOs to JSON (Including nested Domain Classes)
  JUnit4GrailsTestType An `GrailsTestType` for JUnit4 tests.
  ListOrderedSet Forked from Apache Commons Collections' implementation of ListOrderedSet.
  XML A converter that converts domain classes to XML (including nested Domain Classes)

- Deprecated Annotation Types
  Annotation Type and Description
  Validateable @deprecated Use Validateable instead.

- Deprecated Methods
  Method and Description
  AbstractIvyDependencyManager#configureDependencyDescriptor(EnhancedDefaultDependencyDescriptor dependencyDescriptor, java.lang.String scope) @deprecated use registerDependency(String, EnhancedDefaultDependencyDescriptor)
  AbstractIvyDependencyManager#configureDependencyDescriptor(EnhancedDefaultDependencyDescriptor dependencyDescriptor, java.lang.String scope, boolean pluginMode) @deprecated use registerDependency(String, EnhancedDefaultDependencyDescriptor) or registerPluginDependency(String EnhancedDefaultDependencyDescriptor)
  DefaultGrailsApplicationAttributes#getApplicationUri(javax.servlet.ServletRequest request) @deprecated Use instead
  DefaultGrailsControllerClass#getCommandObjectActions() @return EMPTY_SET until the method is removed
  DefaultGrailsControllerClass#getCommandObjectClasses() @return EMPTY_SET until the method is removed
  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
  GrailsBuildEventListener#event(java.lang.String eventName, java.util.List arguments) For backwards compatibility with _Events.groovy script
  GrailsBuildEventListener#event(java.lang.String eventName) For backwards compatibility with _Events.groovy script
  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
  GrailsControllerClass#getCommandObjectActions() @deprecated This method is deprecated and will be removed in a future version of Grails
  GrailsControllerClass#getCommandObjectClasses() @deprecated This method is deprecated and will be removed in a future version of Grails
  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
  GrailsPluginUtils#getLowerVersion(java.lang.String pluginVersion) Returns the lower version of a Grails version number expression in a plugin
  GrailsPluginUtils#getPluginName(java.lang.Class clazz) Get the name of the a plugin for a particular class.
  GrailsPluginUtils#getPluginVersion(java.lang.Class clazz) Get the version of the a plugin for a particular class.
  GrailsPluginUtils#getUpperVersion(java.lang.String pluginVersion) Returns the upper version of a Grails version number expression in a plugin
  GrailsPluginUtils#isValidVersion(java.lang.String pluginVersion, java.lang.String requiredVersion) Check if the required version is a valid for the given plugin version.
  GrailsPluginUtils#isVersionGreaterThan(java.lang.String leftVersion, java.lang.String rightVersion) Returns true if rightVersion is greater than leftVersion
  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.
  GroovyPagesTemplateEngine#GroovyPagesTemplateEngine(javax.servlet.ServletContext servletContext) @param servletContext The servlet context
  IvyDependencyManager#serialize(def builder, boolean createRoot = true) Serializes the parsed dependencies using the given builder.
  MetadataGeneratingMetaClassCreationHandle#enable() Enables the ExpandoMetaClassCreationHandle with the registry.
  MockUtils#mockCommandObject(java.lang.Class clazz) Mocks a command object class by adding a "validate()" method and errors-related methods, like "getErrors()" and "hasErrors()".
  MockUtils#mockDomain(java.lang.Class clazz) Call this to mock the given domain class.
  MockUtils#mockDomain(GrailsDomainClass dc, java.lang.Class clazz, java.util.List testInstances)
  MockUtils#prepareForConstraintsTests(java.lang.Class clazz) Adds a `validate()` method to the given domain class that performs validation against the constraints and returns a map of errors.
  MockUtils#prepareForConstraintsTests(java.lang.Class clazz, java.util.List testInstances)
  PluginBuildSettings#getPluginSourceFiles() /*.properties") } }
  PluginBuildSettings#getPluginSourceFiles(java.io.File pluginDir) @deprecated Use getPluginSourceDirectories
  StreamCharBuffer#readAsCharArray() Reads the buffer to a char[].
  StreamCharBuffer#readAsString() Reads the buffer to a String.

- Deprecated Constructors
  Constructor and Description
  CommandLineHelper#CommandLineHelper(java.io.PrintStream out) @deprecated Use no-args constructor
  CommandLineHelper#CommandLineHelper(java.io.InputStream input, java.io.PrintStream out) @deprecated Use no-args constructor
  DefaultUrlMappingEvaluator#DefaultUrlMappingEvaluator(javax.servlet.ServletContext servletContext) @deprecated Used DefaultUrLMappingsEvaluator(ApplicationContext) instead
  GrailsAwareInjectionOperation#GrailsAwareInjectionOperation(groovy.lang.GroovyResourceLoader resourceLoader, ClassInjector classInjectors) @deprecated Custom resource loader no longer supported
  RedirectDynamicMethod#RedirectDynamicMethod(org.springframework.context.ApplicationContext applicationContext) @param applicationContext The ApplicationContext