Class DependencyResolver

java.lang.Object

org.pf4j.DependencyResolver

public class DependencyResolver
extends Object

This class builds a dependency graph for a list of plugins (descriptors). The entry point is the resolve(List) method, method that returns a DependencyResolver.Result object. The Result class contains nice information about the result of resolve operation (if it's a cyclic dependency, they are not found dependencies, they are dependencies with wrong version). This class is very useful for if-else scenarios. Only some attributes (pluginId, dependencies and pluginVersion) from PluginDescriptor are used in the process of resolve operation.

Author:

Decebal Suiu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	DependencyResolver.CyclicDependencyException	It will be thrown if a cyclic dependency is detected.
static class	DependencyResolver.DependenciesNotFoundException	Indicates that the dependencies required were not found.
static class	DependencyResolver.DependenciesWrongVersionException	Indicates that some dependencies have wrong version.
static class	DependencyResolver.Result
static class	DependencyResolver.WrongDependencyVersion

Constructor Summary

Constructors

Constructor	Description
DependencyResolver(VersionManager versionManager)

Method Summary

Modifier and Type	Method	Description
protected boolean	checkDependencyVersion(String requiredVersion, String existingVersion)	Check if an existing version of dependency is compatible with the required version (from plugin descriptor).
List<String>	getDependencies(String pluginId)	Retrieves the plugins ids that the given plugin id directly depends on.
List<String>	getDependents(String pluginId)	Retrieves the plugins ids that the given content is a direct dependency of.
DependencyResolver.Result	resolve(List<PluginDescriptor> plugins)

Methods inherited from class Object

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

Constructor Details

DependencyResolver

public DependencyResolver(VersionManager versionManager)

Method Details

resolve

public DependencyResolver.Result resolve(List<PluginDescriptor> plugins)

getDependencies

public List<String> getDependencies(String pluginId)

Retrieves the plugins ids that the given plugin id directly depends on.

Parameters:

pluginId - the unique plugin identifier, specified in its metadata

Returns:

getDependents

public List<String> getDependents(String pluginId)

Retrieves the plugins ids that the given content is a direct dependency of.

Parameters:

pluginId - the unique plugin identifier, specified in its metadata

Returns:

checkDependencyVersion

protected boolean checkDependencyVersion(String requiredVersion,
 String existingVersion)

Check if an existing version of dependency is compatible with the required version (from plugin descriptor).

Parameters:

requiredVersion -

existingVersion -

Returns: