com.goldencode.p2j.util

Class JarUtil

java.lang.Object

com.goldencode.p2j.util.JarUtil

public class JarUtil
extends java.lang.Object

Utility methods for jar files.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	JarUtil.JarResource Object returned by a search for a resource in a jar file.

Constructor Summary

Constructors

Constructor and Description
JarUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	extractJarName(CentralLogger logger, java.net.URL url) Extract the jar name from the given URL.
static java.lang.String	prettyName(java.lang.String path) Get the actual jar name from the given path.
static java.util.List<java.lang.String>	resolveClasspathJars(CentralLogger logger) Returns a Set of resolved paths to the jars in the java class path.
static java.lang.String	resolveJarName(CentralLogger logger, java.lang.String jarName, boolean fullPath) Resolve the jar name and return it as an unique name.
private static java.lang.String	resolveJarName(java.lang.String absolutePathToJar) Returns the string of this abstract pathname to the found jar file.
static JarUtil.JarResource	searchResourceJars(CentralLogger logger, java.lang.String filename, java.util.function.Function<JarClassLoader,java.util.function.Function<java.lang.String,java.lang.String>> searchFn, java.util.function.Function<JarClassLoader,java.util.function.Function<java.lang.String,java.lang.String>> propathSearchFn, java.util.function.Supplier<java.util.List<java.lang.String>> propathSupplier) Search the resource jar files for the resource with the given filename.

Methods inherited from class java.lang.Object

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

Constructor Detail

JarUtil

public JarUtil()

Method Detail

searchResourceJars

public static JarUtil.JarResource searchResourceJars(CentralLogger logger,
                                                     java.lang.String filename,
                                                     java.util.function.Function<JarClassLoader,java.util.function.Function<java.lang.String,java.lang.String>> searchFn,
                                                     java.util.function.Function<JarClassLoader,java.util.function.Function<java.lang.String,java.lang.String>> propathSearchFn,
                                                     java.util.function.Supplier<java.util.List<java.lang.String>> propathSupplier)

Search the resource jar files for the resource with the given filename.

The algorithm first attempts to find an exact match for the filename. If not found, it applies the PROPATH to the filename, first prepending the package root to the name.

Parameters:

filename - Filename of the resource, optionally including a path.

searchFn - The search function for the resource with the given filename

propathSearchFn - The propath search function for the resource with the given filename found in PROPATH

propathSupplier - The propath supplier that list PROPATH entries.

Returns:

A JarResult object, if the search succeeds, else null.

resolveJarName

public static java.lang.String resolveJarName(CentralLogger logger,
                                              java.lang.String jarName,
                                              boolean fullPath)

Resolve the jar name and return it as an unique name. If the file does not exist, it is a directory or its canonical path can not be determined, then this method returns null.

Parameters:

jarName - The jar name.

fullPath - true if the jarName contains also the jar's path. When false, it is assumed that the path is the one specified in the "customer_libs" system property.

Returns:

See above.

resolveClasspathJars

public static java.util.List<java.lang.String> resolveClasspathJars(CentralLogger logger)

Returns a Set of resolved paths to the jars in the java class path. CentralLogger should be null if called from ClassLoader, otherwise causes recursion since the loader is still not initialized.

Parameters:

logger - null if called from ClassLoader, CentralLogger instance otherwise.

Returns:

See above.

prettyName

public static java.lang.String prettyName(java.lang.String path)

Get the actual jar name from the given path.

Parameters:

path - The jar name, with full path.

Returns:

See above.

extractJarName

public static java.lang.String extractJarName(CentralLogger logger,
                                              java.net.URL url)

Extract the jar name from the given URL.

Parameters:

logger - The logger.

url - The jar URL.

Returns:

See above.

resolveJarName

private static java.lang.String resolveJarName(java.lang.String absolutePathToJar)
                                        throws java.io.IOException

Returns the string of this abstract pathname to the found jar file.

Parameters:

absolutePathToJar - The absolute path to the jar file.

Returns:

See above.

Throws:

java.io.IOException - If the path doesn't exist or is not a file.