|
| |
|
| java.lang.Object
 org.apache.tools.ant.launch.Locator
| Locator | | final public class Locator (Code) | | The Locator is a utility class which is used to find certain items
in the environment.
since:
Ant 1.6 |
| Method Summary | |
| public static String | decodeUri(String uri)
Decodes an Uri with % characters.
The URI is escaped
Parameters:
uri - String with the uri possibly containing % characters. | | public static String | encodeURI(String path)
Encodes an Uri with % characters.
The URI is escaped
Parameters:
path - String to encode. | | public static URL | fileToURL(File file)
Convert a File to a URL. | | public static String | fromURI(String uri)
Constructs a file path from a file: URI.
Will be an absolute path if the given URI is absolute.
Prior to Java 1.4,
swallows '%' that are not followed by two characters.
See dt-sysid
which makes some mention of how
characters not supported by URI Reference syntax should be escaped.
Parameters:
uri - the URI designating a file in the local filesystem. | | public static File | getClassSource(Class c)
Find the directory or jar file the class has been loaded from.
Parameters:
c - the class whose location is required. | | public static URL[] | getLocationURLs(File location)
Get an array of URLs representing all of the jar files in the
given location. | | public static URL[] | getLocationURLs(File location, String[] extensions)
Get an array of URLs representing all of the files of a given set of
extensions in the given location. | | public static File | getResourceSource(ClassLoader c, String resource)
Find the directory or jar a given resource has been loaded from.
Parameters:
c - the classloader to be consulted for the source.
Parameters:
resource - the resource whose location is required. | | public static File | getToolsJar()
Get the File necessary to load the Sun compiler tools. |
| URI_ENCODING | | final public static String URI_ENCODING(Code) | | encoding used to represent URIs
|
| fileToURL | | public static URL fileToURL(File file) throws MalformedURLException(Code) | | Convert a File to a URL.
File.toURL() does not encode characters like #.
File.toURI() has been introduced in java 1.4, so
ANT cannot use it (except by reflection)
FileUtils.toURI() cannot be used by Locator.java
Implemented this way.
File.toURL() adds file: and changes '\' to '/' for dos OSes
encodeURI converts characters like ' ' and '#' to %DD
Parameters:
file - the file to convert URL the converted File
throws:
MalformedURLException - on error |
| fromURI | | public static String fromURI(String uri)(Code) | | Constructs a file path from a file: URI.
Will be an absolute path if the given URI is absolute.
Prior to Java 1.4,
swallows '%' that are not followed by two characters.
See dt-sysid
which makes some mention of how
characters not supported by URI Reference syntax should be escaped.
Parameters:
uri - the URI designating a file in the local filesystem. the local file system path for the file.
throws:
IllegalArgumentException - if the URI is malformed or not a legal file: URL
since:
Ant 1.6 |
| getClassSource | | public static File getClassSource(Class c)(Code) | | Find the directory or jar file the class has been loaded from.
Parameters:
c - the class whose location is required. the file or jar with the class or null if we cannotdetermine the location.
since:
Ant 1.6 |
| getLocationURLs | | public static URL[] getLocationURLs(File location) throws MalformedURLException(Code) | | Get an array of URLs representing all of the jar files in the
given location. If the location is a file, it is returned as the only
element of the array. If the location is a directory, it is scanned for
jar files.
Parameters:
location - the location to scan for Jars. an array of URLs for all jars in the given location.
exception:
MalformedURLException - if the URLs for the jars cannot beformed. |
| getLocationURLs | | public static URL[] getLocationURLs(File location, String[] extensions) throws MalformedURLException(Code) | | Get an array of URLs representing all of the files of a given set of
extensions in the given location. If the location is a file, it is
returned as the only element of the array. If the location is a
directory, it is scanned for matching files.
Parameters:
location - the location to scan for files.
Parameters:
extensions - an array of extension that are to match in thedirectory search. an array of URLs of matching files.
exception:
MalformedURLException - if the URLs for the files cannot beformed. |
| getResourceSource | | public static File getResourceSource(ClassLoader c, String resource)(Code) | | Find the directory or jar a given resource has been loaded from.
Parameters:
c - the classloader to be consulted for the source.
Parameters:
resource - the resource whose location is required. the file with the resource source or null ifwe cannot determine the location.
since:
Ant 1.6 |
| getToolsJar | | public static File getToolsJar()(Code) | | Get the File necessary to load the Sun compiler tools. If the classes
are available to this class, then no additional URL is required and
null is returned. This may be because the classes are explicitly in the
class path or provided by the JVM directly.
the tools jar as a File if required, null otherwise. |
|
|
|