Package nbbrd.io

Class Resource

java.lang.Object

nbbrd.io.Resource

public final class Resource
extends Object

Author:

Philippe Charles

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	Resource.Loader<K>
static interface	Resource.Storer<K>

Method Summary

Modifier and Type	Method	Description
static void	closeBoth(@Nullable Closeable first, @Nullable Closeable second)
static long	copy(@NonNull Class<?> anchor, @NonNull String name, @NonNull Path target, @NonNull CopyOption... options)
static void	ensureClosed(@NonNull Throwable exception, @Nullable Closeable closeable)
static @NonNull Optional<File>	getFile(@NonNull Path path)	Returns a File object representing this path.
static @NonNull Optional<InputStream>	getResourceAsStream(@NonNull Class<?> anchor, @NonNull String name)	Deprecated. use newInputStream(Class, String) instead.
static @NonNull InputStream	newInputStream(@NonNull Class<?> anchor, @NonNull String name)
static void	process(@NonNull URI uri, @NonNull IOConsumer<? super Path> action)	Process a classpath resource as a Path.
static @NonNull InputStream	uncloseableInputStream(@NonNull InputStream delegate)
static @NonNull OutputStream	uncloseableOutputStream(@NonNull OutputStream delegate)

Methods inherited from class java.lang.Object

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

Method Details

getFile

@NonNull
public static @NonNull Optional<File> getFile(@NonNull
 @NonNull Path path)

Returns a File object representing this path. Where this Path is associated with the default provider, then this method is equivalent to returning a File object constructed with the String representation of this path.

If this path was created by invoking the File toPath method then there is no guarantee that the File object returned by this method is equal to the original File.

Parameters:

path -

Returns:

an optional File object representing this path if associated with the default provider

getResourceAsStream

@Deprecated
@NonNull
public static @NonNull Optional<InputStream> getResourceAsStream(@NonNull
 @NonNull Class<?> anchor,
 @NonNull
 @NonNull String name)

Deprecated.

use newInputStream(Class, String) instead.

newInputStream

@StaticFactoryMethod(java.io.InputStream.class)
@NonNull
public static @NonNull InputStream newInputStream(@NonNull
 @NonNull Class<?> anchor,
 @NonNull
 @NonNull String name)
                                           throws IOException

Throws:

IOException

copy

public static long copy(@NonNull
 @NonNull Class<?> anchor,
 @NonNull
 @NonNull String name,
 @NonNull
 @NonNull Path target,
 @NonNull
 @NonNull CopyOption... options)
                 throws IOException

Throws:

IOException

ensureClosed

public static void ensureClosed(@NonNull
 @NonNull Throwable exception,
 @Nullable Closeable closeable)

closeBoth

public static void closeBoth(@Nullable Closeable first,
 @Nullable Closeable second)
                      throws IOException

Throws:

IOException

process

public static void process(@NonNull
 @NonNull URI uri,
 @NonNull
 @NonNull IOConsumer<? super Path> action)
                    throws IOException

Process a classpath resource as a Path.

Parameters:

uri -

action -

Throws:

IOException

See Also:

• https://stackoverflow.com/a/36021165

uncloseableInputStream

@StaticFactoryMethod(java.io.InputStream.class)
@NonNull
public static @NonNull InputStream uncloseableInputStream(@NonNull
 @NonNull InputStream delegate)

uncloseableOutputStream

@StaticFactoryMethod(java.io.OutputStream.class)
@NonNull
public static @NonNull OutputStream uncloseableOutputStream(@NonNull
 @NonNull OutputStream delegate)