info.magnolia.cms.core
Class Path

java.lang.Object
  info.magnolia.cms.core.Path

public final class Path
extends Object

Utility class to retrieve files or directory used by Magnolia. Examples: cache directory, tmp files, ..

Version:

2.0 $Id: Path.java 41137 2011-01-06 18:19:25Z gjoseph $

Author:

Sameer Charles

Method Summary

static String	getAbsoluteFileSystemPath(String path) Gets absolute filesystem path, adds application root if path is not absolute.
static String	getAbsolutePath(String path)
static String	getAbsolutePath(String path, String label)
static File	getAppRootDir() Gets the root directory for the magnolia web application.
static File	getCacheDirectory()
static String	getCacheDirectoryPath() Gets the cache directory path (cms.cache.startdir) as set with Java options while startup or in web.xml.
static File	getHistoryFile()
static String	getHistoryFilePath() Gets cms.exchange.history file location as set with Java options while startup or in web.xml.
static String	getNodePath(String path) Deprecated. since 4.0 - untested and unused
static String	getNodePath(String path, String label) Deprecated. since 4.0 - untested and unused
static String	getParentPath(String path) Deprecated. since 4.0 - untested and unused
static File	getRepositoriesConfigFile()
static String	getRepositoriesConfigFilePath() Gets repositories file location as set with Java options while startup or in web.xml.
static File	getTempDirectory()
static String	getTempDirectoryPath() Gets the temporary directory path (cms.upload.tmpdir) as set with Java options while startup or in web.xml.
static String	getUniqueLabel(Content parent, String label)
static String	getUniqueLabel(HierarchyManager hierarchyManager, String parent, String label)
static String	getValidatedLabel(String label) Replace illegal characters based on system property magnolia.ut8.enabled.
static String	getValidatedLabel(String label, String charset) If charset eq to UTF-8 replaces these characters: jackrabbit not allowed 32: [ ] 91: [[] 93: []] 42: [*] 34: ["] 46: [.] 58 [:] 92: [\] 39 :['] url not valid 59: [;] 47: [/] 63: [?] 43: [+] 37: [%] 33: [!] 35:[#] 94: [^] else replace illegal characters except [_] [0-9], [A-Z], [a-z], [-], [_].
static boolean	isAbsolute(String path)
static boolean	isCharValid(int charCode, String charset)

Methods inherited from class java.lang.Object

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

Method Detail

getCacheDirectoryPath

public static String getCacheDirectoryPath()

Gets the cache directory path (cms.cache.startdir) as set with Java options while startup or in web.xml.

Returns:

Cache directory path

getCacheDirectory

public static File getCacheDirectory()

getTempDirectoryPath

public static String getTempDirectoryPath()

Gets the temporary directory path (cms.upload.tmpdir) as set with Java options while startup or in web.xml.

Returns:

Temporary directory path

getTempDirectory

public static File getTempDirectory()

getHistoryFilePath

public static String getHistoryFilePath()

Gets cms.exchange.history file location as set with Java options while startup or in web.xml.

Returns:

exchange history file location

getHistoryFile

public static File getHistoryFile()

getRepositoriesConfigFilePath

public static String getRepositoriesConfigFilePath()

Gets repositories file location as set with Java options while startup or in web.xml.

Returns:

file location

getRepositoriesConfigFile

public static File getRepositoriesConfigFile()

getAppRootDir

public static File getAppRootDir()

Gets the root directory for the magnolia web application.

Returns:

magnolia root dir

getAbsoluteFileSystemPath

public static String getAbsoluteFileSystemPath(String path)

Gets absolute filesystem path, adds application root if path is not absolute.

getUniqueLabel

public static String getUniqueLabel(HierarchyManager hierarchyManager,
                                    String parent,
                                    String label)

getUniqueLabel

public static String getUniqueLabel(Content parent,
                                    String label)

isAbsolute

public static boolean isAbsolute(String path)

getValidatedLabel

public static String getValidatedLabel(String label)

Replace illegal characters based on system property magnolia.ut8.enabled.

Parameters:

label - label to validate

Returns:

validated label

getValidatedLabel

public static String getValidatedLabel(String label,
                                       String charset)

If charset eq to UTF-8 replaces these characters: jackrabbit not allowed 32: [ ] 91: [[] 93: []] 42: [*] 34: ["] 46: [.] 58 [:] 92: [\] 39 :['] url not valid 59: [;] 47: [/] 63: [?] 43: [+] 37: [%] 33: [!] 35:[#] 94: [^] else replace illegal characters except [_] [0-9], [A-Z], [a-z], [-], [_].

Parameters:

label - label to validate

Returns:

validated label

isCharValid

public static boolean isCharValid(int charCode,
                                  String charset)

Parameters:

charCode - char code

charset - charset (ex. UTF-8)

Returns:

true if char can be used as a content name

getAbsolutePath

public static String getAbsolutePath(String path,
                                     String label)

getAbsolutePath

public static String getAbsolutePath(String path)

getNodePath

public static String getNodePath(String path,
                                 String label)

Deprecated. since 4.0 - untested and unused

getNodePath

public static String getNodePath(String path)

Deprecated. since 4.0 - untested and unused

getParentPath

public static String getParentPath(String path)

Deprecated. since 4.0 - untested and unused