org.apache.ivy.core.resolve

Class IvyNode

public class IvyNode extends Object implements Comparable

Constructor Summary
	IvyNode(ResolveData data, IvyNode parent, DependencyDescriptor dd)
	IvyNode(ResolveData data, ModuleDescriptor md)

Method Summary
void	addCaller(String rootModuleConf, IvyNode callerNode, String callerConf, String requestedConf, String[] dependencyConfs, DependencyDescriptor dd)
void	blacklist(IvyNodeBlacklist bdata) Blacklists the current node, so that a new resolve process won't ever consider this node as available in the repository.
void	clean() Clean data related to one root module configuration only
int	compareTo(Object obj)
void	discardConf(String rootModuleConf, String conf)
boolean	doesCallersExclude(String rootModuleConf, Artifact artifact, Stack callersStack)
boolean	equals(Object obj)
IvyNode	findNode(ModuleRevisionId mrid)
Artifact[]	getAllArtifacts() Returns all the artifacts of this dependency required in all the root module configurations
IvyNodeCallers.Caller[]	getAllCallers()
Collection	getAllCallersModuleIds()
Collection	getAllEvictingConflictManagers()
Collection	getAllEvictingNodes()
Collection	getAllEvictingNodesDetails()
IvyNodeCallers.Caller[]	getAllRealCallers()
Artifact[]	getArtifacts(String rootModuleConf) Returns the artifacts of this dependency required in the configurations themselves required in the given root module configuration
IvyNodeBlacklist	getBlacklistData(String rootModuleConf) Returns the blacklist data of this node in the given root module conf, or `null` if this node is not blacklisted in this root module conf.
IvyNodeCallers.Caller[]	getCallers(String rootModuleConf)
Configuration	getConfiguration(String conf)
String[]	getConfigurations(String rootModuleConf) Returns the configurations of the dependency required in a given root module configuration.
ConflictManager	getConflictManager(ModuleId mid)
String[]	getConfsToFetch()
ResolveData	getData()
Collection	getDependencies(String rootModuleConf, String[] confs)
Collection	getDependencies(String rootModuleConf, String conf, String requestedConf)
DependencyDescriptor	getDependencyDescriptor(IvyNode parent)
ModuleDescriptor	getDescriptor()
String[]	getEvictedConfs()
IvyNodeEviction.EvictionData	getEvictedData(String rootModuleConf)
Collection	getEvictedNodes(ModuleId mid, String rootModuleConf)
Collection	getEvictedRevisions(ModuleId mid, String rootModuleConf)
IvyNodeEviction.EvictionData	getEvictionDataInRoot(String rootModuleConf, IvyNode ancestor)
ModuleRevisionId	getId()
long	getLastModified() Returns the last modified timestamp of the module represented by this Node, or 0 if the last modified timestamp is currently unkwown (module not loaded)
IvyNodeUsage	getMainUsage()
ModuleId	getModuleId()
ResolvedModuleRevision	getModuleRevision()
Collection	getPendingConflicts(String rootModuleConf, ModuleId mid) Returns a collection of Nodes in conflict for which conflict has been detected but conflict resolution hasn't been done yet
Exception	getProblem()
String	getProblemMessage()
long	getPublication()
String[]	getRealConfs(String conf)
IvyNode	getRealNode()
String[]	getRequiredConfigurations(IvyNode in, String inConf) returns the required configurations from the given node
String[]	getRequiredConfigurations() returns all the current required configurations of the node
ModuleRevisionId	getResolvedId()
Set	getResolvedNodes(ModuleId moduleId, String rootModuleConf) A copy of the set of resolved nodes (real nodes)
Collection	getResolvedRevisions(ModuleId moduleId, String rootModuleConf)
IvyNode	getRoot()
String[]	getRootModuleConfigurations() Returns the root module configurations in which this dependency is required
Set	getRootModuleConfigurationsSet() Returns the root module configurations in which this dependency is required
Artifact[]	getSelectedArtifacts(Filter artifactFilter) Returns all the artifacts of this dependency required in the root module configurations in which the node is not evicted nor blacklisted
boolean	hasAnyMergedUsageWithTransitiveDependency(String rootModuleConf) Indicates if there is any of the merged usages of this node which has a depender with transitive dependency descriptor.
boolean	hasConfigurationsToLoad()
int	hashCode()
boolean	hasProblem()
boolean	isBlacklisted(String rootModuleConf) Indicates if this node has been blacklisted in the given root module conf.
boolean	isCompletelyBlacklisted() Indicates if this node has been blacklisted in all root module configurations.
boolean	isCompletelyEvicted()
protected boolean	isConfRequiredByMergedUsageOnly(String rootModuleConf, String conf)
boolean	isDownloaded()
boolean	isEvicted(String rootModuleConf)
boolean	isFetched(String conf)
boolean	isLoaded()
boolean	isSearched()
boolean	loadData(String rootModuleConf, IvyNode parent, String parentConf, String conf, boolean shouldBePublic, IvyNodeUsage usage) After the call node may be discarded.
void	markEvicted(IvyNodeEviction.EvictionData evictionData)
void	markEvicted(String rootModuleConf, IvyNode node, ConflictManager conflictManager, Collection resolved)
void	setEvictedNodes(ModuleId moduleId, String rootModuleConf, Collection evicted)
void	setPendingConflicts(ModuleId moduleId, String rootModuleConf, Collection conflicts)
void	setResolvedNodes(ModuleId moduleId, String rootModuleConf, Collection resolved)
String	toString()
void	updateConfsToFetch(Collection confs)

Constructor Detail

IvyNode

public IvyNode(ResolveData data, IvyNode parent, DependencyDescriptor dd)

IvyNode

public IvyNode(ResolveData data, ModuleDescriptor md)

Method Detail

addCaller

public void addCaller(String rootModuleConf, IvyNode callerNode, String callerConf, String requestedConf, String[] dependencyConfs, DependencyDescriptor dd)

blacklist

public void blacklist(IvyNodeBlacklist bdata)

Blacklists the current node, so that a new resolve process won't ever consider this node as available in the repository.

This is useful in combination with RestartResolveProcess for conflict manager implementation which use a best effort strategy to find compatible dependency set, like LatestCompatibleConflictManager

Parameters: rootModuleConf the root module configuration in which the node should be blacklisted

clean

public void clean()

Clean data related to one root module configuration only

discardConf

public void discardConf(String rootModuleConf, String conf)

doesCallersExclude

public boolean doesCallersExclude(String rootModuleConf, Artifact artifact, Stack callersStack)

findNode

public IvyNode findNode(ModuleRevisionId mrid)

getAllArtifacts

public Artifact[] getAllArtifacts()

Returns all the artifacts of this dependency required in all the root module configurations

Returns:

getAllCallers

public IvyNodeCallers.Caller[] getAllCallers()

getAllCallersModuleIds

public Collection getAllCallersModuleIds()

getAllEvictingConflictManagers

public Collection getAllEvictingConflictManagers()

getAllEvictingNodesDetails

public Collection getAllEvictingNodesDetails()

getAllRealCallers

public IvyNodeCallers.Caller[] getAllRealCallers()

getArtifacts

public Artifact[] getArtifacts(String rootModuleConf)

Returns the artifacts of this dependency required in the configurations themselves required in the given root module configuration

Parameters: rootModuleConf

Returns:

getBlacklistData

public IvyNodeBlacklist getBlacklistData(String rootModuleConf)

Returns the blacklist data of this node in the given root module conf, or null if this node is not blacklisted in this root module conf.

Parameters: rootModuleConf the root module configuration to consider

Returns: the blacklist data if any

getCallers

public IvyNodeCallers.Caller[] getCallers(String rootModuleConf)

getConfiguration

public Configuration getConfiguration(String conf)

getConfigurations

public String[] getConfigurations(String rootModuleConf)

Returns the configurations of the dependency required in a given root module configuration.

Parameters: rootModuleConf

Returns:

getConflictManager

public ConflictManager getConflictManager(ModuleId mid)

getDependencies

public Collection getDependencies(String rootModuleConf, String[] confs)

getDependencies

public Collection getDependencies(String rootModuleConf, String conf, String requestedConf)

getDependencyDescriptor

public DependencyDescriptor getDependencyDescriptor(IvyNode parent)

getEvictedData

public IvyNodeEviction.EvictionData getEvictedData(String rootModuleConf)

getEvictedNodes

public Collection getEvictedNodes(ModuleId mid, String rootModuleConf)

getEvictedRevisions

public Collection getEvictedRevisions(ModuleId mid, String rootModuleConf)

getEvictionDataInRoot

public IvyNodeEviction.EvictionData getEvictionDataInRoot(String rootModuleConf, IvyNode ancestor)

getLastModified

public long getLastModified()

Returns the last modified timestamp of the module represented by this Node, or 0 if the last modified timestamp is currently unkwown (module not loaded)

Returns: the last modified timestamp of the module represented by this Node

getModuleRevision

public ResolvedModuleRevision getModuleRevision()

getPendingConflicts

public Collection getPendingConflicts(String rootModuleConf, ModuleId mid)

Returns a collection of Nodes in conflict for which conflict has been detected but conflict resolution hasn't been done yet

Parameters: rootModuleConf mid the module id for which pending conflicts should be found

Returns: a Collection of IvyNode in pending conflict

getRealConfs

public String[] getRealConfs(String conf)

getRequiredConfigurations

public String[] getRequiredConfigurations(IvyNode in, String inConf)

returns the required configurations from the given node

Parameters: in

Returns:

getRequiredConfigurations

public String[] getRequiredConfigurations()

returns all the current required configurations of the node

Returns:

getResolvedNodes

public Set getResolvedNodes(ModuleId moduleId, String rootModuleConf)

A copy of the set of resolved nodes (real nodes)

getResolvedRevisions

public Collection getResolvedRevisions(ModuleId moduleId, String rootModuleConf)

getRootModuleConfigurations

public String[] getRootModuleConfigurations()

Returns the root module configurations in which this dependency is required

Returns:

getRootModuleConfigurationsSet

public Set getRootModuleConfigurationsSet()

Returns the root module configurations in which this dependency is required

Returns:

getSelectedArtifacts

public Artifact[] getSelectedArtifacts(Filter artifactFilter)

Returns all the artifacts of this dependency required in the root module configurations in which the node is not evicted nor blacklisted

Parameters: artifactFilter

Returns:

hasAnyMergedUsageWithTransitiveDependency

public boolean hasAnyMergedUsageWithTransitiveDependency(String rootModuleConf)

Indicates if there is any of the merged usages of this node which has a depender with transitive dependency descriptor.

If at there is at least one usage from the merged usages for which there is a depender in the given root module conf which has a dependency descriptor with transitive == true, then it returns true. Otherwise it returns false.

Parameters: rootModuleConf the root module configuration to consider

Returns: true if there is any merged usage with transitive dd, false otherwise.

hasConfigurationsToLoad

public boolean hasConfigurationsToLoad()

hashCode

public int hashCode()

hasProblem

public boolean hasProblem()

isBlacklisted

public boolean isBlacklisted(String rootModuleConf)

Indicates if this node has been blacklisted in the given root module conf.

A blacklisted node should be considered as if it doesn't even exist on the repository.

Parameters: rootModuleConf the root module conf for which we'd like to know if the node is blacklisted

Returns: true if this node is blacklisted int he given root module conf, false otherwise

isCompletelyBlacklisted

public boolean isCompletelyBlacklisted()

Indicates if this node has been blacklisted in all root module configurations.

Returns: true if this node is blacklisted in all root module configurations, false otherwise