public class IvySettings extends java.lang.Object implements SortEngineSettings, PublishEngineSettings, ParserSettings, DeliverEngineSettings, CheckEngineSettings, InstallEngineSettings, ResolverSettings, ResolveEngineSettings, RetrieveEngineSettings, RepositoryManagementEngineSettings
Constructor and Description |
---|
IvySettings() |
IvySettings(IvyVariableContainer variableContainer) |
Modifier and Type | Method and Description |
---|---|
void |
addAllVariables(java.util.Map<?,?> variables) |
void |
addAllVariables(java.util.Map<?,?> variables,
boolean overwrite) |
void |
addClasspathURL(java.net.URL url) |
void |
addConfigured(AbstractWorkspaceResolver workspaceResolver) |
void |
addConfigured(ArchivePacking packing) |
void |
addConfigured(CircularDependencyStrategy strategy) |
void |
addConfigured(ConflictManager cm) |
void |
addConfigured(DependencyResolver resolver) |
void |
addConfigured(LatestStrategy latest) |
void |
addConfigured(LockStrategy lockStrategy) |
void |
addConfigured(ModuleDescriptorParser parser) |
void |
addConfigured(NamedTimeoutConstraint timeoutConstraint) |
void |
addConfigured(Namespace ns) |
void |
addConfigured(PatternMatcher m) |
void |
addConfigured(ReportOutputter outputter) |
void |
addConfigured(RepositoryCacheManager c) |
void |
addConfigured(SignatureGenerator generator) |
void |
addConfigured(Trigger trigger) |
void |
addConfigured(VersionMatcher vmatcher) |
void |
addConflictManager(java.lang.String name,
ConflictManager cm) |
void |
addLatestStrategy(java.lang.String name,
LatestStrategy latest) |
void |
addLockStrategy(java.lang.String name,
LockStrategy lockStrategy) |
void |
addMatcher(PatternMatcher m) |
void |
addModuleConfiguration(java.util.Map<java.lang.String,java.lang.String> attributes,
PatternMatcher matcher,
java.lang.String resolverName,
java.lang.String branch,
java.lang.String conflictManager,
java.lang.String resolveMode)
regular expressions as explained in Pattern class may be used in attributes
|
void |
addNamespace(Namespace ns) |
void |
addReportOutputter(ReportOutputter outputter) |
void |
addRepositoryCacheManager(RepositoryCacheManager c) |
void |
addResolver(DependencyResolver resolver) |
void |
addSignatureGenerator(SignatureGenerator generator) |
void |
addTrigger(Trigger trigger) |
void |
addVersionMatcher(VersionMatcher vmatcher) |
void |
configureDefaultVersionMatcher() |
void |
configureRepositories(boolean remote)
Call this method to ask ivy to configure some variables using either a remote or a local
properties file
|
boolean |
debugConflictResolution() |
boolean |
debugLocking() |
void |
defaultInit()
Default initialization of settings, useful when you don't want to load your settings from a
settings file or URL, but prefer to set them manually.
|
boolean |
doValidate() |
boolean |
dumpMemoryUsage() |
void |
filterIgnore(java.util.Collection<java.lang.String> names)
Filters the names list by removing all names that should be ignored as defined by the listing
ignore list
|
java.io.File |
getBaseDir() |
CircularDependencyStrategy |
getCircularDependencyStrategy() |
CircularDependencyStrategy |
getCircularDependencyStrategy(java.lang.String name) |
ConflictManager |
getConflictManager(ModuleId moduleId) |
ConflictManager |
getConflictManager(java.lang.String name) |
Namespace |
getContextNamespace() |
static java.net.URL |
getDefault14SettingsURL() |
java.lang.String |
getDefaultBranch() |
java.lang.String |
getDefaultBranch(ModuleId moduleId) |
java.io.File |
getDefaultCache() |
java.lang.String |
getDefaultCacheArtifactPattern() |
java.lang.String |
getDefaultCacheIvyPattern() |
ConflictManager |
getDefaultConflictManager() |
java.io.File |
getDefaultIvyUserDir() |
LatestStrategy |
getDefaultLatestStrategy() |
LockStrategy |
getDefaultLockStrategy() |
static java.net.URL |
getDefaultPropertiesURL() |
java.io.File |
getDefaultRepositoryCacheBasedir() |
RepositoryCacheManager |
getDefaultRepositoryCacheManager() |
java.io.File |
getDefaultResolutionCacheBasedir() |
java.lang.String |
getDefaultResolveMode() |
DependencyResolver |
getDefaultResolver() |
static java.net.URL |
getDefaultSettingsURL() |
java.lang.String[] |
getIgnorableFilenames()
Returns the file names of the files that should be ignored when creating a file listing.
|
long |
getInterruptTimeout() |
LatestStrategy |
getLatestStrategy(java.lang.String name) |
LockStrategy |
getLockStrategy(java.lang.String name) |
PatternMatcher |
getMatcher(java.lang.String name) |
java.util.Collection<java.lang.String> |
getMatcherNames() |
Namespace |
getNamespace(java.lang.String name) |
PackingRegistry |
getPackingRegistry() |
RelativeUrlResolver |
getRelativeUrlResolver() |
ReportOutputter |
getReportOutputter(java.lang.String name) |
ReportOutputter[] |
getReportOutputters() |
RepositoryCacheManager |
getRepositoryCacheManager(java.lang.String name) |
RepositoryCacheManager[] |
getRepositoryCacheManagers() |
ResolutionCacheManager |
getResolutionCacheManager() |
java.lang.String |
getResolveMode(ModuleId moduleId) |
DependencyResolver |
getResolver(ModuleRevisionId mrid) |
DependencyResolver |
getResolver(java.lang.String resolverName) |
java.lang.String |
getResolverName(ModuleRevisionId mrid) |
java.util.Collection<java.lang.String> |
getResolverNames() |
java.util.Collection<DependencyResolver> |
getResolvers() |
SignatureGenerator |
getSignatureGenerator(java.lang.String name) |
StatusManager |
getStatusManager() |
Namespace |
getSystemNamespace() |
TimeoutConstraint |
getTimeoutConstraint(java.lang.String name) |
java.util.List<Trigger> |
getTriggers() |
java.lang.Class<?> |
getTypeDef(java.lang.String name) |
java.util.Map<java.lang.String,java.lang.Class<?>> |
getTypeDefs() |
java.lang.String |
getVariable(java.lang.String name) |
boolean |
getVariableAsBoolean(java.lang.String name,
boolean valueIfUnset)
Returns a variable as boolean value.
|
IvyVariableContainer |
getVariableContainer() |
IvyVariableContainer |
getVariables()
Returns the variables loaded in configuration file.
|
VersionMatcher |
getVersionMatcher() |
VersionMatcher |
getVersionMatcher(java.lang.String name) |
VersionMatcher[] |
getVersionMatchers() |
boolean |
hasResolver(java.lang.String resolverName) |
boolean |
isCheckUpToDate() |
boolean |
isDefaultUseOrigin() |
boolean |
isUseRemoteConfig() |
void |
load(java.io.File settingsFile) |
void |
load(java.net.URL settingsURL) |
void |
loadDefault() |
void |
loadDefault14() |
void |
loadProperties(java.io.File file) |
void |
loadProperties(java.io.File file,
boolean overwrite) |
void |
loadProperties(java.net.URL url) |
void |
loadProperties(java.net.URL url,
boolean overwrite) |
boolean |
logModulesInUse() |
boolean |
logModuleWhenFound() |
boolean |
logNotConvertedExclusionRule() |
boolean |
logResolvedRevision() |
java.io.File |
resolveFile(java.lang.String fileName)
Return the canonical form of a filename.
|
void |
setBaseDir(java.io.File baseDir) |
void |
setCheckUpToDate(boolean checkUpToDate) |
void |
setCircularDependencyStrategy(CircularDependencyStrategy strategy) |
void |
setDefaultBranch(java.lang.String defaultBranch) |
void |
setDefaultCache(java.io.File cacheDirectory) |
void |
setDefaultCacheArtifactPattern(java.lang.String defaultCacheArtifactPattern) |
void |
setDefaultCacheIvyPattern(java.lang.String defaultCacheIvyPattern) |
void |
setDefaultConflictManager(ConflictManager defaultConflictManager) |
void |
setDefaultIvyUserDir(java.io.File defaultUserDir) |
void |
setDefaultLatestStrategy(LatestStrategy defaultLatestStrategy) |
void |
setDefaultLockStrategy(LockStrategy defaultLockStrategy) |
void |
setDefaultRepositoryCacheBasedir(java.lang.String repositoryCacheRoot) |
void |
setDefaultRepositoryCacheManager(RepositoryCacheManager cache) |
void |
setDefaultResolutionCacheBasedir(java.lang.String resolutionCacheRoot) |
void |
setDefaultResolveMode(java.lang.String defaultResolveMode) |
void |
setDefaultResolver(java.lang.String resolverName) |
void |
setDefaultUseOrigin(boolean useOrigin) |
void |
setDictatorResolver(DependencyResolver resolver) |
void |
setLogNotConvertedExclusionRule(boolean logNotConvertedExclusionRule) |
void |
setResolutionCacheManager(ResolutionCacheManager resolutionCacheManager) |
void |
setSettingsVariables(java.io.File settingsFile) |
void |
setSettingsVariables(java.net.URL settingsURL) |
void |
setStatusManager(StatusManager statusManager) |
void |
setUseRemoteConfig(boolean useRemoteConfig) |
void |
setValidate(boolean validate) |
void |
setVariable(java.lang.String varName,
java.lang.String value) |
void |
setVariable(java.lang.String varName,
java.lang.String value,
boolean overwrite) |
void |
setVariable(java.lang.String varName,
java.lang.String value,
boolean overwrite,
java.lang.String ifSetVar,
java.lang.String unlessSetVar) |
void |
setVariableContainer(IvyVariableContainer variables)
Use a different variable container.
|
java.util.Map<java.lang.String,java.lang.String> |
substitute(java.util.Map<java.lang.String,java.lang.String> strings)
Substitute variables in the given map values by their value found in the current set of
variables
|
java.lang.String |
substitute(java.lang.String str)
Substitute variables in the given string by their value found in the current set of variables
|
java.lang.Class<?> |
typeDef(java.lang.String name,
java.lang.String className) |
java.lang.Class<?> |
typeDef(java.lang.String name,
java.lang.String className,
boolean silentFail) |
void |
typeDefs(java.io.InputStream stream) |
void |
typeDefs(java.io.InputStream stream,
boolean silentFail) |
void |
typeDefs(java.util.Properties p) |
void |
typeDefs(java.util.Properties p,
boolean silentFail) |
void |
useDeprecatedUseOrigin() |
void |
validate()
Validates the settings, throwing an
IllegalStateException if the current state is not
valid. |
public IvySettings()
public IvySettings(IvyVariableContainer variableContainer)
public void configureRepositories(boolean remote)
configureRepositories
in interface ResolverSettings
remote
- booleanpublic void typeDefs(java.io.InputStream stream) throws java.io.IOException
java.io.IOException
public void typeDefs(java.io.InputStream stream, boolean silentFail) throws java.io.IOException
java.io.IOException
public void typeDefs(java.util.Properties p)
public void typeDefs(java.util.Properties p, boolean silentFail)
public void load(java.io.File settingsFile) throws java.text.ParseException, java.io.IOException
java.text.ParseException
java.io.IOException
public void load(java.net.URL settingsURL) throws java.text.ParseException, java.io.IOException
java.text.ParseException
java.io.IOException
public void defaultInit() throws java.io.IOException
java.io.IOException
- if something goes wrongpublic void loadDefault() throws java.text.ParseException, java.io.IOException
java.text.ParseException
java.io.IOException
public void loadDefault14() throws java.text.ParseException, java.io.IOException
java.text.ParseException
java.io.IOException
public static java.net.URL getDefaultPropertiesURL()
public static java.net.URL getDefaultSettingsURL()
public static java.net.URL getDefault14SettingsURL()
public void setSettingsVariables(java.io.File settingsFile)
public void setSettingsVariables(java.net.URL settingsURL)
public void loadProperties(java.net.URL url) throws java.io.IOException
java.io.IOException
public void loadProperties(java.net.URL url, boolean overwrite) throws java.io.IOException
java.io.IOException
public void loadProperties(java.io.File file) throws java.io.IOException
java.io.IOException
public void loadProperties(java.io.File file, boolean overwrite) throws java.io.IOException
java.io.IOException
public void setVariable(java.lang.String varName, java.lang.String value)
public void setVariable(java.lang.String varName, java.lang.String value, boolean overwrite)
public void setVariable(java.lang.String varName, java.lang.String value, boolean overwrite, java.lang.String ifSetVar, java.lang.String unlessSetVar)
public void addAllVariables(java.util.Map<?,?> variables)
public void addAllVariables(java.util.Map<?,?> variables, boolean overwrite)
public java.lang.String substitute(java.lang.String str)
substitute
in interface DeliverEngineSettings
substitute
in interface PublishEngineSettings
substitute
in interface ParserSettings
str
- the string in which substitution should be madepublic java.util.Map<java.lang.String,java.lang.String> substitute(java.util.Map<java.lang.String,java.lang.String> strings)
substitute
in interface ParserSettings
strings
- the map of strings in which substitution should be madepublic IvyVariableContainer getVariables()
getVariables
in interface RetrieveEngineSettings
public java.lang.Class<?> typeDef(java.lang.String name, java.lang.String className)
public java.lang.Class<?> typeDef(java.lang.String name, java.lang.String className, boolean silentFail)
public void addClasspathURL(java.net.URL url)
public java.util.Map<java.lang.String,java.lang.Class<?>> getTypeDefs()
public java.lang.Class<?> getTypeDef(java.lang.String name)
public void addConfigured(DependencyResolver resolver)
public void addConfigured(ModuleDescriptorParser parser)
public void addConfigured(SignatureGenerator generator)
public void addSignatureGenerator(SignatureGenerator generator)
public SignatureGenerator getSignatureGenerator(java.lang.String name)
getSignatureGenerator
in interface ResolverSettings
public void addResolver(DependencyResolver resolver)
public void setDefaultCache(java.io.File cacheDirectory)
public void setDefaultResolver(java.lang.String resolverName)
public void addModuleConfiguration(java.util.Map<java.lang.String,java.lang.String> attributes, PatternMatcher matcher, java.lang.String resolverName, java.lang.String branch, java.lang.String conflictManager, java.lang.String resolveMode)
attributes
- Mapmatcher
- PatternMatcherresolverName
- Stringbranch
- StringconflictManager
- StringresolveMode
- Stringpublic java.io.File resolveFile(java.lang.String fileName)
If the specified file name is relative it is resolved with respect to the settings's base directory.
resolveFile
in interface ParserSettings
fileName
- The name of the file to resolve. Must not be null
.public void setBaseDir(java.io.File baseDir)
public java.io.File getBaseDir()
public java.io.File getDefaultIvyUserDir()
public void setDefaultIvyUserDir(java.io.File defaultUserDir)
public java.io.File getDefaultCache()
public void setDefaultRepositoryCacheBasedir(java.lang.String repositoryCacheRoot)
public void setDefaultResolutionCacheBasedir(java.lang.String resolutionCacheRoot)
public java.io.File getDefaultRepositoryCacheBasedir()
public java.io.File getDefaultResolutionCacheBasedir()
public void setDictatorResolver(DependencyResolver resolver)
setDictatorResolver
in interface ResolveEngineSettings
public DependencyResolver getResolver(ModuleRevisionId mrid)
getResolver
in interface ParserSettings
public boolean hasResolver(java.lang.String resolverName)
public DependencyResolver getResolver(java.lang.String resolverName)
getResolver
in interface CheckEngineSettings
getResolver
in interface InstallEngineSettings
getResolver
in interface PublishEngineSettings
public DependencyResolver getDefaultResolver()
public java.lang.String getResolverName(ModuleRevisionId mrid)
getResolverName
in interface ResolveEngineSettings
public java.lang.String getDefaultBranch(ModuleId moduleId)
getDefaultBranch
in interface ParserSettings
public java.lang.String getDefaultBranch()
public void setDefaultBranch(java.lang.String defaultBranch)
public ConflictManager getConflictManager(ModuleId moduleId)
getConflictManager
in interface ResolveEngineSettings
public java.lang.String getResolveMode(ModuleId moduleId)
getResolveMode
in interface ResolverSettings
public java.lang.String getDefaultResolveMode()
public void setDefaultResolveMode(java.lang.String defaultResolveMode)
public void addConfigured(ConflictManager cm)
public ConflictManager getConflictManager(java.lang.String name)
getConflictManager
in interface ParserSettings
public void addConflictManager(java.lang.String name, ConflictManager cm)
public void addConfigured(LatestStrategy latest)
public LatestStrategy getLatestStrategy(java.lang.String name)
getLatestStrategy
in interface ResolverSettings
public void addLatestStrategy(java.lang.String name, LatestStrategy latest)
public void addConfigured(LockStrategy lockStrategy)
public LockStrategy getLockStrategy(java.lang.String name)
public void addLockStrategy(java.lang.String name, LockStrategy lockStrategy)
public void addConfigured(Namespace ns)
public Namespace getNamespace(java.lang.String name)
getNamespace
in interface ParserSettings
getNamespace
in interface ResolverSettings
public final Namespace getSystemNamespace()
getSystemNamespace
in interface ResolverSettings
public void addNamespace(Namespace ns)
public void addConfigured(NamedTimeoutConstraint timeoutConstraint)
public TimeoutConstraint getTimeoutConstraint(java.lang.String name)
getTimeoutConstraint
in interface ParserSettings
name
- The name of the TimeoutConstraint
TimeoutConstraint
which is identified by the passed name
. Returns null
if no such TimeoutConstraint
existspublic void addConfigured(PatternMatcher m)
public PatternMatcher getMatcher(java.lang.String name)
getMatcher
in interface InstallEngineSettings
getMatcher
in interface ParserSettings
public void addMatcher(PatternMatcher m)
public void addConfigured(RepositoryCacheManager c)
public RepositoryCacheManager getRepositoryCacheManager(java.lang.String name)
getRepositoryCacheManager
in interface ResolverSettings
public void addRepositoryCacheManager(RepositoryCacheManager c)
public RepositoryCacheManager[] getRepositoryCacheManagers()
getRepositoryCacheManagers
in interface ResolverSettings
public void addConfigured(ReportOutputter outputter)
public ReportOutputter getReportOutputter(java.lang.String name)
public void addReportOutputter(ReportOutputter outputter)
public ReportOutputter[] getReportOutputters()
getReportOutputters
in interface InstallEngineSettings
getReportOutputters
in interface ResolveEngineSettings
public void addConfigured(VersionMatcher vmatcher)
public VersionMatcher getVersionMatcher(java.lang.String name)
public void addVersionMatcher(VersionMatcher vmatcher)
public VersionMatcher[] getVersionMatchers()
public VersionMatcher getVersionMatcher()
getVersionMatcher
in interface SortEngineSettings
getVersionMatcher
in interface ResolverSettings
public void configureDefaultVersionMatcher()
public CircularDependencyStrategy getCircularDependencyStrategy()
getCircularDependencyStrategy
in interface SortEngineSettings
public CircularDependencyStrategy getCircularDependencyStrategy(java.lang.String name)
public void setCircularDependencyStrategy(CircularDependencyStrategy strategy)
public void addConfigured(CircularDependencyStrategy strategy)
public StatusManager getStatusManager()
getStatusManager
in interface InstallEngineSettings
getStatusManager
in interface ParserSettings
public void setStatusManager(StatusManager statusManager)
public java.lang.String[] getIgnorableFilenames()
getIgnorableFilenames
in interface RetrieveEngineSettings
public void filterIgnore(java.util.Collection<java.lang.String> names)
filterIgnore
in interface ResolverSettings
names
- dittopublic boolean isCheckUpToDate()
isCheckUpToDate
in interface RetrieveEngineSettings
public void setCheckUpToDate(boolean checkUpToDate)
public boolean doValidate()
doValidate
in interface CheckEngineSettings
public void setValidate(boolean validate)
public java.lang.String getVariable(java.lang.String name)
getVariable
in interface ParserSettings
getVariable
in interface ResolverSettings
public boolean getVariableAsBoolean(java.lang.String name, boolean valueIfUnset)
name
- name of the variablevalueIfUnset
- value if the variable is unsetpublic ConflictManager getDefaultConflictManager()
public void setDefaultConflictManager(ConflictManager defaultConflictManager)
public LatestStrategy getDefaultLatestStrategy()
getDefaultLatestStrategy
in interface ResolverSettings
public void setDefaultLatestStrategy(LatestStrategy defaultLatestStrategy)
public LockStrategy getDefaultLockStrategy()
public void setDefaultLockStrategy(LockStrategy defaultLockStrategy)
public RepositoryCacheManager getDefaultRepositoryCacheManager()
getDefaultRepositoryCacheManager
in interface ResolverSettings
public void setDefaultRepositoryCacheManager(RepositoryCacheManager cache)
public ResolutionCacheManager getResolutionCacheManager()
getResolutionCacheManager
in interface ParserSettings
public void setResolutionCacheManager(ResolutionCacheManager resolutionCacheManager)
public void addTrigger(Trigger trigger)
public java.util.List<Trigger> getTriggers()
public void addConfigured(Trigger trigger)
public boolean isUseRemoteConfig()
public void setUseRemoteConfig(boolean useRemoteConfig)
public boolean logModulesInUse()
public boolean logModuleWhenFound()
logModuleWhenFound
in interface ResolveEngineSettings
public boolean logResolvedRevision()
logResolvedRevision
in interface ResolveEngineSettings
public boolean debugConflictResolution()
debugConflictResolution
in interface ResolveEngineSettings
public boolean debugLocking()
public boolean dumpMemoryUsage()
dumpMemoryUsage
in interface RepositoryManagementEngineSettings
public boolean logNotConvertedExclusionRule()
logNotConvertedExclusionRule
in interface InstallEngineSettings
logNotConvertedExclusionRule
in interface ResolveEngineSettings
public void setLogNotConvertedExclusionRule(boolean logNotConvertedExclusionRule)
setLogNotConvertedExclusionRule
in interface InstallEngineSettings
public final long getInterruptTimeout()
public java.util.Collection<DependencyResolver> getResolvers()
public java.util.Collection<java.lang.String> getResolverNames()
getResolverNames
in interface InstallEngineSettings
public java.util.Collection<java.lang.String> getMatcherNames()
getMatcherNames
in interface InstallEngineSettings
public IvyVariableContainer getVariableContainer()
public void setVariableContainer(IvyVariableContainer variables)
variables
- IvyVariableContainerpublic RelativeUrlResolver getRelativeUrlResolver()
getRelativeUrlResolver
in interface ParserSettings
public void setDefaultCacheIvyPattern(java.lang.String defaultCacheIvyPattern)
public java.lang.String getDefaultCacheIvyPattern()
public void setDefaultCacheArtifactPattern(java.lang.String defaultCacheArtifactPattern)
public java.lang.String getDefaultCacheArtifactPattern()
public void setDefaultUseOrigin(boolean useOrigin)
public boolean isDefaultUseOrigin()
public void useDeprecatedUseOrigin()
public void validate()
IllegalStateException
if the current state is not
valid.java.lang.IllegalStateException
- if the settings is not valid.public Namespace getContextNamespace()
getContextNamespace
in interface ParserSettings
public void addConfigured(ArchivePacking packing)
public PackingRegistry getPackingRegistry()
public void addConfigured(AbstractWorkspaceResolver workspaceResolver)
Copyright ©2007-2022 The Apache Software Foundation, Licensed under Apache License, Version 2.0.