org.daisy.common.file

Class URLs

java.lang.Object

org.daisy.common.file.URLs

public final class URLs
extends Object

Method Summary

Modifier and Type	Method and Description
static URI	asURI(File file)
static URI	asURI(String url)
static URI	asURI(URL url)
static URL	asURL(File file)
static URL	asURL(String url)
static URL	asURL(URI url)
static URI	encode(URL url)
static File	getCurrentJAR(Class<?> context)
static URL	getResourceFromJAR(String resource, Class<?> context)
static Path	getResourceFromJAR(String resource, Path jarFilePath) Closing the file system of the returned path is the responsibility of the caller.
static Iterator<String>	listResourcesFromJAR(String directory, Class<?> context)
static Iterator<String>	listResourcesFromJAR(String directory, Path jarFilePath)
static URI	relativize(URI base, URI url)
static URI	resolve(URI base, URI url)

Methods inherited from class java.lang.Object

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

Method Detail

asURL

public static URL asURL(File file)

Parameters:

file - A file

asURL

public static URL asURL(String url)

Parameters:

url - An encoded absolute URL

Throws:

IllegalArgumentException

asURL

public static URL asURL(URI url)

Parameters:

url - An encoded absolute URL

Throws:

IllegalArgumentException

asURI

public static URI asURI(File file)

Parameters:

url - A file

asURI

public static URI asURI(String url)

Parameters:

url - An encoded absolute or relative URL

Throws:

IllegalArgumentException

asURI

public static URI asURI(URL url)

Parameters:

url - An encoded absolute or relative URL

Throws:

IllegalArgumentException

encode

public static URI encode(URL url)

Parameters:

url - An unencoded absolute URL

Returns:

An encoded absolute URL

resolve

public static URI resolve(URI base,
                          URI url)

Parameters:

base - An encoded absolute or relative URL

url - An encoded absolute or relative URL

Returns:

An encoded absolute or relative URL

relativize

public static URI relativize(URI base,
                             URI url)

Parameters:

base - An encoded absolute or relative URL

url - An encoded absolute or relative URL

Returns:

An encoded absolute or relative URL

getResourceFromJAR

public static URL getResourceFromJAR(String resource,
                                     Class<?> context)

Parameters:

resource - The (not URL-encoded) path of a resource inside the specified JAR or class directory

context - A class from the JAR or class directory that is to be searched for resources

Returns:

An encoded absolute URL

getCurrentJAR

public static File getCurrentJAR(Class<?> context)

getResourceFromJAR

public static Path getResourceFromJAR(String resource,
                                      Path jarFilePath)

Closing the file system of the returned path is the responsibility of the caller.

listResourcesFromJAR

public static Iterator<String> listResourcesFromJAR(String directory,
                                                    Class<?> context)

Parameters:

directory - The (not URL-encoded) path of a directory inside the specified JAR or class directory

context - A class from the JAR or class directory that is to be searched for resources

Returns:

A list of resource paths (not URL-encoded)

listResourcesFromJAR

public static Iterator<String> listResourcesFromJAR(String directory,
                                                    Path jarFilePath)

Parameters:

directory - The (not URL-encoded) path of a directory inside the specified JAR or class directory

jarFilePath - The location of the JAR file in a file system. Does not need to be be representable by a File.

Returns:

A list of resource paths (not URL-encoded)