net.trajano.commons.testing

Class ResourceUtil

java.lang.Object

net.trajano.commons.testing.ResourceUtil

public final class ResourceUtil
extends Object

Provides a utility class to load up resource streams.

Author:

Archimedes Trajano

Constructor Summary

Constructors

Modifier	Constructor and Description
private	ResourceUtil() Prevent instantiation of utility class.

Method Summary

Methods

Modifier and Type	Method and Description
static byte[]	getResourceAsBytes(Class<?> clazz, String name) Reads a resource as bytes from the the given class' class loader.
static byte[]	getResourceAsBytes(String name) Reads a resource as bytes from the context class loader.
static InputStream	getResourceAsStream(Class<?> clazz, String name) Reads a resource as a stream from the the given class' class loader.
static InputStream	getResourceAsStream(String name) Reads a resource as a stream from the context class loader.
static String	getResourceAsString(Class<?> clazz, String name) Reads a resource as a string from the the given class' class loader.
static String	getResourceAsString(String name) Reads a resource as a String from the from the context class loader.
static File	getResourceCopy(Class<?> clazz, String name) Creates a copy of the resource from the given class' class loader to a temporary file.
static File	getResourceCopy(String name) Creates a copy of the resource from the context class loader to a temporary file.
static byte[]	streamToBytes(InputStream is) Converts an InputStream to bytes.
static File	streamToTempFile(InputStream is) Copies the contents of an InputStream to a temporary file.

Methods inherited from class java.lang.Object

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

Constructor Detail

ResourceUtil

private ResourceUtil()

Prevent instantiation of utility class.

Method Detail

getResourceAsBytes

public static byte[] getResourceAsBytes(Class<?> clazz,
                        String name)

Reads a resource as bytes from the the given class' class loader.

Parameters:

clazz - class

name - name of the resource

Returns:

input stream

getResourceAsBytes

public static byte[] getResourceAsBytes(String name)

Reads a resource as bytes from the context class loader.

Parameters:

name - name of the resource

Returns:

input stream

getResourceAsStream

public static InputStream getResourceAsStream(Class<?> clazz,
                              String name)

Reads a resource as a stream from the the given class' class loader. Callers are expected to close the resource after.

Parameters:

clazz - class

name - name of the resource

Returns:

input stream

getResourceAsStream

public static InputStream getResourceAsStream(String name)

Reads a resource as a stream from the context class loader. Callers are expected to close the resource after.

Parameters:

name - name of the resource

Returns:

input stream

getResourceAsString

public static String getResourceAsString(Class<?> clazz,
                         String name)

Reads a resource as a string from the the given class' class loader. Callers are expected to close the resource after. The data is expected to be UTF-8.

Parameters:

clazz - class

name - name of the resource

Returns:

input stream

getResourceAsString

public static String getResourceAsString(String name)

Reads a resource as a String from the from the context class loader. Callers are expected to close the resource after.

Parameters:

name - name of the resource

Returns:

string

getResourceCopy

public static File getResourceCopy(Class<?> clazz,
                   String name)

Creates a copy of the resource from the given class' class loader to a temporary file. It is expected that the test will delete the file afterwards.

Parameters:

clazz - class

name - name of the resource

Returns:

temporary file

getResourceCopy

public static File getResourceCopy(String name)

Creates a copy of the resource from the context class loader to a temporary file. It is expected that the test will delete the file afterwards.

Parameters:

name - name of the resource

Returns:

temporary file

streamToBytes

public static byte[] streamToBytes(InputStream is)

Converts an InputStream to bytes. This will not throw an IOException but wraps it in an AssertionError. This reads the InputStream to end of file, but does not close it.

Parameters:

is - input stream

Returns:

byte array.

streamToTempFile

public static File streamToTempFile(InputStream is)

Copies the contents of an InputStream to a temporary file. This will not throw an IOException but wraps it in an AssertionError. This reads the InputStream to end of file, but does not close it.

Parameters:

is - input stream

Returns:

temporary file.