JarClassLoaderDataFinder

package saker.build.thirdparty.saker.util.classloader

public class JarClassLoaderDataFinder implements ClassLoaderDataFinder

saker.build.thirdparty.saker.util.classloader.JarClassLoaderDataFinder

java.lang.Object

saker.build.thirdparty.saker.util.classloader.ClassLoaderDataFinder

java.io.Closeable

java.lang.AutoCloseable

ClassLoaderDataFinder implementation that is backed by a JarFile.

This data finder will resolve the resources based on the opened JAR file. Any resources and classes will be retrieved and read from it.

Any meta-data in the JAR file is ignored, i.e. manifest and others are not analyzed by the data finder itself. Subclasses may modify this behaviour.

Fields

protected final JarFile	jar The opened JAR file.

Constructors

public	JarClassLoaderDataFinder(File jar) Creates a new instance by opening the jar file at the given path.
public	JarClassLoaderDataFinder(Path jar) Creates a new instance by opening the jar file at the given path.
public	JarClassLoaderDataFinder(JarFile jar) Creates a new data finder which uses the argument JAR file.

Methods

public void	close() Closes this stream and releases any system resources associated with it.
protected void	closeJar() Closes the JAR file itself.
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 getClassBytes

protected final JarFile jar

The opened JAR file.

public JarClassLoaderDataFinder(File jar) throws IOException, NullPointerException

Creates a new instance by opening the jar file at the given path.

The JAR file will be opened in a multi-release way on JDK9+.

jarThe path to the JAR file.

IOExceptionIn case of I/O error.

NullPointerExceptionIf the argument is null.

public JarClassLoaderDataFinder(Path jar) throws IOException, NullPointerException

Creates a new instance by opening the jar file at the given path.

The JAR file will be opened in a multi-release way on JDK9+.

jarThe path to the JAR file.

IOExceptionIn case of I/O error.

NullPointerExceptionIf the argument is null.

public JarClassLoaderDataFinder(JarFile jar) throws NullPointerException

Creates a new data finder which uses the argument JAR file.

jarThe JAR file.

NullPointerExceptionIf the argument is null.

public void close() throws IOException

Overridden from: Closeable

Closes this stream and releases any system resources associated with it. If the stream is already closed then invoking this method has no effect.

As noted in AutoCloseable.close(), cases where the close may fail require careful attention. It is strongly advised to relinquish the underlying resources and to internally mark the Closeable as closed, prior to throwing the IOException.

IOExceptionif an I/O error occurs

protected void closeJar() throws IOException

Closes the JAR file itself.

Subclasses can override this method to do other work, or maybe avoid closing the JAR file if the subclass decides to handle it themselves.

IOExceptionIn case of I/O error.

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.