io.appulse.utils

Class ResourceUtils

java.lang.Object

io.appulse.utils.ResourceUtils

public final class ResourceUtils
extends Object

The set of helper methods for working with classpath resources.

Since:

1.3.0

Author:

Artem Labazin

Method Summary

Modifier and Type	Method and Description
static Optional<byte[]>	getBytesContent(@NonNull URL url) Returns bytes content of a resource file by its URL.
static Optional<String>	getResource(@NonNull String name) Deprecated.
static Optional<String>	getResource(@NonNull String name, @NonNull Charset charset) Deprecated.
static List<URL>	getResourceUrls(@NonNull String folder, @NonNull Pattern pattern) Searches resource files in specific folder and by pattern.
static List<URL>	getResourceUrls(@NonNull String folder, @NonNull String glob) Searches resource files in specific folder and by glob-pattern.
static Optional<String>	getTextContent(@NonNull String name) Returns a concrete resource content by its name.
static Optional<String>	getTextContent(@NonNull String name, @NonNull Charset charset) Returns a concrete resource content by its name.
static Optional<String>	getTextContent(@NonNull URL url) Returns text content of a resource file by its URL.
static Optional<String>	getTextContent(@NonNull URL url, @NonNull Charset charset) Returns text content of a resource file by its URL.

Methods inherited from class java.lang.Object

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

Method Detail

getResource

@Deprecated
public static Optional<String> getResource(@NonNull
                                                       @NonNull String name)

Deprecated.

getResource

@Deprecated
public static Optional<String> getResource(@NonNull
                                                       @NonNull String name,
                                                       @NonNull
                                                       @NonNull Charset charset)

Deprecated.

getBytesContent

public static Optional<byte[]> getBytesContent(@NonNull
                                               @NonNull URL url)

Returns bytes content of a resource file by its URL.

Parameters:

url - adress to a resource.

Returns:

file's bytes representation, if exists, or empty.

Since:

1.10.0

getTextContent

public static Optional<String> getTextContent(@NonNull
                                              @NonNull URL url,
                                              @NonNull
                                              @NonNull Charset charset)

Returns text content of a resource file by its URL.

Parameters:

url - adress to a resource.

charset - text content charset.

Returns:

file's text representation, if exists, or empty.

Since:

1.10.0

getTextContent

public static Optional<String> getTextContent(@NonNull
                                              @NonNull String name)

Returns a concrete resource content by its name.

Parameters:

name - file's name

Returns:

file's text representation, if exists, or empty.

Since:

1.10.0

getTextContent

public static Optional<String> getTextContent(@NonNull
                                              @NonNull String name,
                                              @NonNull
                                              @NonNull Charset charset)

Returns a concrete resource content by its name.

Parameters:

name - file's name

charset - text content charset.

Returns:

file's text representation, if exists, or empty.

Since:

1.10.0

getTextContent

public static Optional<String> getTextContent(@NonNull
                                              @NonNull URL url)

Returns text content of a resource file by its URL.

Parameters:

url - adress to a resource.

Returns:

file's text representation, if exists, or empty.

Since:

1.10.0

getResourceUrls

public static List<URL> getResourceUrls(@NonNull
                                        @NonNull String folder,
                                        @NonNull
                                        @NonNull String glob)

Searches resource files in specific folder and by glob-pattern.

It uses glob-like pattern sysytem...honestly speaking only '*' and '?' signs.

Parameters:

folder - where to search the files

glob - files name glob-pattern

Returns:

the URLs of found files

Since:

1.10.0

getResourceUrls

public static List<URL> getResourceUrls(@NonNull
                                        @NonNull String folder,
                                        @NonNull
                                        @NonNull Pattern pattern)

Searches resource files in specific folder and by pattern.

Parameters:

folder - where to search the files

pattern - files name pattern

Returns:

the URLs of found files

Since:

1.10.0