Package com.ultikits.ultitools.utils

Class PluginYmlReader

java.lang.Object

com.ultikits.ultitools.utils.PluginYmlReader

public final class PluginYmlReader
extends Object

Reads a module's own plugin.yml straight from its class's code source, given only a bare Class<?> - before any UltiToolsPlugin instance exists (D-12). This is the third place in the codebase that would otherwise open a JAR to read plugin.yml; extracting it once here is the point.

Every failure path - null code source, a directory code source with no plugin.yml (the common case for test/dev classpaths), a missing JAR entry, an unreadable archive, or malformed YAML - returns PluginYmlReader.PluginYmlInfo.EMPTY rather than throwing, logging at most one WARNING. This class runs once per plugin class during dependency-graph construction, and a single bad archive must not take the whole graph down (T-04-20).

Since:

6.3.0

Author:

wisdomme

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	PluginYmlReader.PluginYmlInfo	The subset of a module's plugin.yml this framework's dependency graph needs: its declared name: (nullable - absent when the archive has none or reading failed) and its loadAfter: list (never null; empty when absent or reading failed).

Field Summary

Fields

Modifier and Type	Field	Description
private static final Logger	LOGGER
private static final String	PLUGIN_YML_ENTRY

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PluginYmlReader()

Method Summary

Modifier and Type	Method	Description
private static PluginYmlReader.PluginYmlInfo	parse(InputStream inputStream)
static PluginYmlReader.PluginYmlInfo	read(Class<?> pluginClass)	Reads plugin.yml for the given class's own code source.
private static PluginYmlReader.PluginYmlInfo	readFromDirectory(File directory)
private static PluginYmlReader.PluginYmlInfo	readFromJar(URL jarLocation)
private static File	toFile(URL location)

Methods inherited from class java.lang.Object

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

Field Details

LOGGER

private static final Logger LOGGER

PLUGIN_YML_ENTRY

private static final String PLUGIN_YML_ENTRY

See Also:

• Constant Field Values

Constructor Details

PluginYmlReader

private PluginYmlReader()

Method Details

read

public static PluginYmlReader.PluginYmlInfo read(Class<?> pluginClass)

Reads plugin.yml for the given class's own code source.

Parameters:

pluginClass - the class whose containing JAR (or classes directory) should be read; may be null

Returns:

the module's declared name and loadAfter list, or PluginYmlReader.PluginYmlInfo.EMPTY on any failure path

Since:

6.3.0

toFile

private static File toFile(URL location)

readFromDirectory

private static PluginYmlReader.PluginYmlInfo readFromDirectory(File directory)

readFromJar

private static PluginYmlReader.PluginYmlInfo readFromJar(URL jarLocation)

parse

private static PluginYmlReader.PluginYmlInfo parse(InputStream inputStream)