PathClassLoaderDataFinder

public class PathClassLoaderDataFinder implements ClassLoaderDataFinder

saker.util.classloader.PathClassLoaderDataFinder

java.lang.Object

saker.util.classloader.ClassLoaderDataFinder

java.io.Closeable

java.lang.AutoCloseable

ClassLoaderDataFinder implementation that is based on a path to a directory.

The path of the data finder points to a directory, and the resources are found by resolving the name against the directory.

Fields

protected final Path	path The absolute path to the directory that this data finder uses.

Constructors

public	PathClassLoaderDataFinder(File file) Creates a new instance that uses the directory at the argument path.
public	PathClassLoaderDataFinder(Path path) Creates a new instance that uses the directory at the argument path.

Methods

public Supplier<ByteSource>	getResource(String name) Gets a supplier for an existing resource stream specified by the given name.
public ByteSource	getResourceAsStream(String name) Opens a stream to the resource specified by the given name.
public ByteArrayRegion	getResourceBytes(String name) Gets the bytes of a resource specified by the given name.
public String	toString() Returns a string representation of the object.

Inherited methods
From: Object clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
From: ClassLoaderDataFinder close, getClassBytes

protected final Path path

The absolute path to the directory that this data finder uses.

public PathClassLoaderDataFinder(File file) throws NullPointerException, IllegalArgumentException

Creates a new instance that uses the directory at the argument path.

fileThe absolute path to the directory.

NullPointerExceptionIf the path is null.

IllegalArgumentExceptionIf the path is not absolute.

public PathClassLoaderDataFinder(Path path) throws NullPointerException, IllegalArgumentException

Creates a new instance that uses the directory at the argument path.

pathThe absolute path to the directory.

NullPointerExceptionIf the path is null.

IllegalArgumentExceptionIf the path is not absolute.

public Supplier<ByteSource> getResource(String name)

Overridden from: ClassLoaderDataFinder

Gets a supplier for an existing resource stream specified by the given name.

The name is a slash ('/') separated path to the resource to be found.

The opened stream by the returned supplier should be closed for each returned stream.

The returned supplier can still return null, if there was opening error in the stream.

nameThe name of the resource.

A supplier which opens a stream to the resource bytes or null if the resource is not found.

public ByteSource getResourceAsStream(String name)

Overridden from: ClassLoaderDataFinder

Opens a stream to the resource specified by the given name.

The name is a slash ('/') separated path to the resource to be found.

The returned stream should be closed by the caller.

nameThe name of the resource.

The opened stream to the resource, or null if not found.

public ByteArrayRegion getResourceBytes(String name)

Overridden from: ClassLoaderDataFinder

Gets the bytes of a resource specified by the given name.

The name is a slash ('/') separated path to the resource to be found.

Implementations of this functions should strive to be interrupt tolerant. Meaning that if they get interrupted while loading the bytes of the resources, they should store the interrupt flag, and retry the loading. After done, reinterrupt the current thread so the interrupt status is not lost.

nameThe name of the resource.

The bytes of the resource or null if not found.

public String toString()

Overridden from: Object

Returns a string representation of the object. In general, the toString method returns a string that "textually represents" this object. The result should be a concise but informative representation that is easy for a person to read. It is recommended that all subclasses override this method.

The toString method for class Object returns a string consisting of the name of the class of which the object is an instance, the at-sign character `@', and the unsigned hexadecimal representation of the hash code of the object. In other words, this method returns a string equal to the value of:

 getClass().getName() + '@' + Integer.toHexString(hashCode())

a string representation of the object.