Field Detail

• public static final String CLASSPATH_URL_PREFIX

  Pseudo URL prefix for loading from the class path: "classpath:"

• public static final String CLASS_EXTENSION

• public static Pattern[] COMPILER_ROOT_PATTERNS

• public static final String DOMAIN_DIR_PATH

• public static Pattern DOMAIN_PATH_PATTERN

  Domain path is always matched against the normalized File representation of the URL and can therefore work with slashes as separators.

• public static Pattern DOMAIN_PATH_PATTERN_NEW

• public static final String FILE_URL_PREFIX

  URL prefix for loading from the file system: "file:"

• public static final String GRAILS_APP_DIR

  The name of the Grails application directory

• public static final Pattern GRAILS_RESOURCE_PATTERN_EIGHTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_ELEVENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_FIFTEENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_FIFTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_FIRST_MATCH

  Resources are resolved against the platform specific path and must therefore obey the specific File.separator.

• public static final Pattern GRAILS_RESOURCE_PATTERN_FOURTEENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_FOURTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_NINTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_SECOND_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_SEVENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_SIXTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_TENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_THIRD_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_THIRTEENTH_MATCH

• public static final Pattern GRAILS_RESOURCE_PATTERN_TWELFTH_MATCH

• public static final String JAR_URL_SEPARATOR

• public static final String REGEX_FILE_SEPARATOR

  backslashes need escaping in regexes

• public static Pattern RESOURCE_PATH_PATTERN

  This pattern will match any resource within a given directory inside grails-app

• public static Pattern RESOURCE_PATH_PATTERN_NEW

• public static Pattern SPRING_SCRIPTS_PATH_PATTERN

• public static Pattern SPRING_SCRIPTS_PATH_PATTERN_NEW

• public static final String URL_PROTOCOL_CODE_SOURCE

  URL protocol for an entry from an OC4J jar file: "code-source"

• public static final String URL_PROTOCOL_FILE

  URL protocol for a file in the file system: "file"

• public static final String URL_PROTOCOL_JAR

  URL protocol for an entry from a jar file: "jar"

• public static final String URL_PROTOCOL_VFS

  URL protocol for a JBoss VFS resource: "vfs"

• public static final String URL_PROTOCOL_VFSZIP

  URL protocol for an entry from a JBoss jar file: "vfszip"

• public static final String URL_PROTOCOL_WSJAR

  URL protocol for an entry from a WebSphere jar file: "wsjar"

• public static final String URL_PROTOCOL_ZIP

  URL protocol for an entry from a zip file: "zip"

• public static final String VIEWS_DIR_PATH

  The path to the views directory

• public static final String VIEWS_DIR_PATH_NO_SLASH

  The path to the views directory without a trailing slash

• public static final String WEB_APP_DIR

  The name of the Web app dir within Grails

• public static final String WEB_INF

  The relative path to the WEB-INF directory

• public static final Pattern[] grailsAppResourcePatterns

• public static final Pattern[] patterns

Method Detail

• public static String appendPiecesForUri(String pieces)

  Takes any number of Strings and appends them into a uri, making sure that a forward slash is inserted between each piece and making sure that no duplicate slashes are in the uri

   Input: ""
   Output: ""
  
   Input: "/alpha", "/beta", "/gamma"
   Output: "/alpha/beta/gamma
  
   Input: "/alpha/, "/beta/", "/gamma"
   Output: "/alpha/beta/gamma
  
   Input: "/alpha/", "/beta/", "/gamma/"
   Output "/alpha/beta/gamma/
  
   Input: "alpha", "beta", "gamma"
   Output: "alpha/beta/gamma
   

  Parameters:

  pieces - Strings to concatenate together into a uri

  Returns:

  a uri

• public static String applyRelativePath(String path, String relativePath)

  Apply the given relative path to the given path, assuming standard Java folder separation (i.e. "/" separators).

  Parameters:

  path - the path to start from (usually a full file path)

  relativePath - the relative path to apply (relative to the full file path above)

  Returns:

  the full file path that results from applying the relative path

• @Override
  public Object call(Object args)

• public static String classPackageAsResourcePath(Class<?> clazz)

  Given an input class object, return a string which consists of the class's package name as a pathname, i.e., all dots ('.') are replaced by slashes ('/'). Neither a leading nor trailing slash is added. The result could be concatenated with a slash and the name of a resource and fed directly to ClassLoader.getResource(). For it to be fed to Class.getResource instead, a leading slash would also have to be prepended to the returned value.

  Parameters:

  clazz - the input class. A null value or the default (empty) package will result in an empty string ("") being returned.

  Returns:

  a path which represents the package name

  See Also:

  ClassLoader.getResource

  Class.getResource

• public static String cleanPath(String path)

  Normalize the path by suppressing sequences like "path/.." and inner simple dots.

  The result is convenient for path comparison. For other uses, notice that Windows separators ("\") are replaced by simple slashes.

  Parameters:

  path - the original path

  Returns:

  the normalized path

• public static URL extractJarFileURL(URL jarUrl)

  Extract the URL for the actual jar file from the given URL (which may point to a resource in a jar file or to a jar file itself).

  throws:

  MalformedURLException if no valid jar file URL could be extracted

  Parameters:

  jarUrl - the original URL

  Returns:

  the URL for the actual jar file

• public static Resource getAppDir(Resource resource)

• public static String getArtefactDirectory(String path)

  Takes a file path and returns the name of the folder under grails-app i.e:

   Input: /usr/joe/project/grails-app/domain/com/mystartup/Book.groovy
   Output: domain
   

  Parameters:

  path - The path

  Returns:

  The domain or null if not known

• public static String getClassName(Resource resource)

  Gets the class name of the specified Grails resource

  Parameters:

  resource - The Spring Resource

  Returns:

  The class name or null if the resource is not a Grails class

• public static String getClassName(String path)

  Returns the class name for a Grails resource.

  Parameters:

  path - The path to check

  Returns:

  The class name or null if it doesn't exist

• public static String getClassNameForClassFile(String rootDir, String path)

  Returns the class name for a compiled class file

  Parameters:

  path - The path to check

  Returns:

  The class name or null if it doesn't exist

• public static File getFile(URL resourceUrl, String description)

  Resolve the given resource URL to a java.io.File, i.e. to a file in the file system.

  throws:

  java.io.FileNotFoundException if the URL cannot be resolved to a file in the file system

  Parameters:

  resourceUrl - the resource URL to resolve

  description - a description of the original resource that the URL was created for (for example, a class path location)

  Returns:

  a corresponding File object

• public static File getFile(URI resourceUri, String description)

  Resolve the given resource URI to a java.io.File, i.e. to a file in the file system.

  throws:

  FileNotFoundException if the URL cannot be resolved to a file in the file system

  Parameters:

  resourceUri - the resource URI to resolve

  description - a description of the original resource that the URI was created for (for example, a class path location)

  Returns:

  a corresponding File object

• public static File getFile(URI resourceUri)

  Resolve the given resource URI to a java.io.File, i.e. to a file in the file system.

  throws:

  FileNotFoundException if the URL cannot be resolved to a file in the file system

  Parameters:

  resourceUri - the resource URI to resolve

  Returns:

  a corresponding File object

• public static String getFilename(String path)

  Extract the filename from the given path, e.g. "mypath/myfile.txt" -> "myfile.txt".

  Parameters:

  path - the file path (maybe null)

  Returns:

  the extracted filename, or null if none

• public static String getPathFromBaseDir(String path)

  Gets the path relative to the project base directory.

   Input: /usr/joe/project/grails-app/conf/BootStrap.groovy
   Output: grails-app/conf/BootStrap.groovy
   

  Parameters:

  path - The path

  Returns:

  The path relative to the base directory or null if it can't be established

• public static String getPathFromRoot(String path)

  Get the path relative to an artefact folder under grails-app i.e:

   Input: /usr/joe/project/grails-app/conf/BootStrap.groovy
   Output: BootStrap.groovy
  
   Input: /usr/joe/project/grails-app/domain/com/mystartup/Book.groovy
   Output: com/mystartup/Book.groovy
   

  Parameters:

  path - The path to evaluate

  Returns:

  The path relative to the root folder grails-app

• public static String getRelativeInsideWebInf(Resource resource)

  Takes a Grails resource (one located inside the grails-app dir) and gets its relative path inside the WEB-INF directory when deployed.

  Parameters:

  resource - The Grails resource, which is a file inside the grails-app dir

  Returns:

  The relative URL of the file inside the WEB-INF dir at deployment time or null if it cannot be established

• public static String getStaticResourcePathForResource(Resource resource, String contextPath)

  Retrieves the static resource path for the given Grails resource artifact (controller/taglib etc.)

  Parameters:

  resource - The Resource

  contextPath - The additional context path to prefix

  Returns:

  The resource path

• public static Resource getViewsDir(Resource resource)

• @SuppressWarnings("unchecked")
  public static Object instantiateFromConfig(ConfigObject config, String configKey, String defaultClassName)

• public static Object instantiateFromFlatConfig(Map<String, Object> flatConfig, String configKey, String defaultClassName)

• public static boolean isDomainClass(URL url)

• public static boolean isFileURL(URL url)

  Determine whether the given URL points to a resource in the file system, that is, has protocol "file" or "vfs".

  Parameters:

  url - the URL to check

  Returns:

  whether the URL has been identified as a file system URL

• public static boolean isGrailsPath(String path)

  Checks whether the specified path is a Grails path.

  Parameters:

  path - The path to check

  Returns:

  true if it is a Grails path

• public static boolean isGrailsResource(Resource r)

  Checks whether the specific resources is a Grails resource. A Grails resource is a Groovy or Java class under the grails-app directory

  Parameters:

  r - The resource to check

  Returns:

  True if it is a Grails resource

• public static boolean isJarURL(URL url)

  Determine whether the given URL points to a resource in a jar file, that is, has protocol "jar", "zip", "wsjar" or "code-source".

  "zip" and "wsjar" are used by BEA WebLogic Server and IBM WebSphere, respectively, but can be treated like jar files. The same applies to "code-source" URLs on Oracle OC4J, provided that the path contains a jar separator.

  Parameters:

  url - the URL to check

  Returns:

  whether the URL has been identified as a JAR URL

• public static boolean isProjectSource(String path)

  Checks whether the specified path is a Grails path.

  Parameters:

  path - The path to check

  Returns:

  true if it is a Grails path

• public static boolean isProjectSource(Resource r)

  Checks whether the specified path is a Grails path.

  Parameters:

  r - The resource to check

  Returns:

  true if it is a Grails path

• @Override
  protected boolean removeEldestEntry(Map.Entry eldest)

• @Override
  protected boolean removeEldestEntry(Map.Entry<String, Boolean> eldest)

• public static URI toURI(URL url)

  Create a URI instance for the given URL, replacing spaces with "%20" quotes first.

  Furthermore, this method works on JDK 1.4 as well, in contrast to the URL.toURI() method.

  throws:

  URISyntaxException if the URL wasn't a valid URI

  Parameters:

  url - the URL to convert into a URI instance

  Returns:

  the URI instance

  See Also:

  URL.toURI

• public static URI toURI(String location)

  Create a URI instance for the given location String, replacing spaces with "%20" quotes first.

  throws:

  URISyntaxException if the location wasn't a valid URI

  Parameters:

  location - the location String to convert into a URI instance

  Returns:

  the URI instance

• public static void useCachesIfNecessary(URLConnection con)