Package io.dropwizard.util

Class Resources

java.lang.Object

io.dropwizard.util.Resources

public final class Resources
extends Object

Since:

2.0

Method Summary

Modifier and Type	Method	Description
static void	copy(URL from, OutputStream to)	Copies all bytes from a URL to an output stream.
static URL	getResource(String resourceName)	Returns a URL pointing to resourceName if the resource is found using the context class loader.
static byte[]	toByteArray(URL url)	Reads all bytes from a URL into a byte array.
static String	toString(URL url, Charset charset)	Reads all characters from a URL into a String, using the given character set.

Methods inherited from class java.lang.Object

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

Method Detail

getResource

public static URL getResource(String resourceName)

Returns a URL pointing to resourceName if the resource is found using the context class loader. In simple environments, the context class loader will find resources from the class path. In environments where different threads can have different class loaders, for example app servers, the context class loader will typically have been set to an appropriate loader for the current thread.

In the unusual case where the context class loader is null, the class loader that loaded this class (Resources) will be used instead.

Throws:

IllegalArgumentException - if the resource is not found

toByteArray

public static byte[] toByteArray(URL url)
                          throws IOException

Reads all bytes from a URL into a byte array.

Parameters:

url - the URL to read from

Returns:

a byte array containing all the bytes from the URL

Throws:

IOException - if an I/O error occurs

toString

public static String toString(URL url,
                              Charset charset)
                       throws IOException

Reads all characters from a URL into a String, using the given character set.

Parameters:

url - the URL to read from

charset - the charset used to decode the input stream; see StandardCharsets for helpful predefined constants

Returns:

a string containing all the characters from the URL

Throws:

IOException - if an I/O error occurs.

copy

public static void copy(URL from,
                        OutputStream to)
                 throws IOException

Copies all bytes from a URL to an output stream.

Parameters:

from - the URL to read from

to - the output stream

Throws:

IOException - if an I/O error occurs