<b>Tag:</b> resolvers Defines a list of dependency resolvers usable in ivy. Each dependency resolver is identified by its name, given as an attribute. The child tag used for the dependency resolver must be equal to a name of a dependency resolver type (either built-in or added with the typedef tag). <span class="since">since 1.3</span> Once defined, resolvers can be referenced by their name, using the following syntax: <code type="xml"> <resolver ref="alreadydefinedresolver"/> </code> Note that this works only if the resolver has been already defined, and not if it is defined later in the ivysettings file. <h1>Child elements</h1> <table class="ivy-children"> <thead> <tr><th class="ivy-chld">Element</th><th class="ivy-chld-desc">Description</th><th class="ivy-chld-card">Cardinality</th></tr> </thead> <tbody> <tr><td>any resolver</td><td>adds a resolver to the list of available resolvers</td> <td>1..n</td></tr> </tbody> </table> <h1>Built-in Resolvers</h1> Ivy comes with a set of built-in dependency resolvers able to answer to the most common needs. If you don't find the one you want here, you can also check if some one has not contributed it in the [[links links page]], or even <a href="../extend.html">write your own</a>. There are basically two types of resolver in Ivy: composite and standard resolvers. A composite resolver is a resolver which delegates the work to other resolvers. The other resolvers are standard resolvers. Here is the list of built-in resolvers: <table class="ivy-attributes"> <thead> <tr><th>Name</th><th>Type</th><th>Description</th></tr> </thead> <tbody> <tr><td><a href="../resolver/ivyrep.html">IvyRep</a></td><td>Standard</td><td>Finds ivy files on ivyrep and artifacts on ibiblio.</td></tr> <tr><td><a href="../resolver/ibiblio.html">IBiblio</a></td><td>Standard</td><td>Finds artifacts on ibiblio.</td></tr> <tr><td><a href="../resolver/filesystem.html">FileSystem</a></td><td>Standard</td><td>This very performant resolver finds ivy files and artifacts in your file system.</td></tr> <tr><td><a href="../resolver/url.html">Url</a></td><td>Standard</td><td>Finds ivy files and artifacts in any repository accessible with urls.</td></tr> <tr><td><a href="../resolver/vfs.html">Vfs</a></td><td>Standard</td><td>Finds ivy files and artifacts in any repository accessible with <a href="http://jakarta.apache.org/commons/vfs/">apache commons vfs</a>.</td></tr> <tr><td><a href="../resolver/ssh.html">ssh</a></td><td>Standard</td><td>Finds ivy files and artifacts in any repository accessible with ssh.</td></tr> <tr><td><a href="../resolver/sftp.html">sftp</a></td><td>Standard</td><td>Finds ivy files and artifacts in any repository accessible with sftp.</td></tr> <tr><td><a href="../resolver/chain.html">Chain</a></td><td>Composite</td><td>Delegates the finding to a chain of sub resolvers.</td></tr> <tr><td><a href="../resolver/dual.html">Dual</a></td><td>Composite</td><td>Delegates the finding of ivy files to one resolver and of artifacts to another.</td></tr> </tbody> </table> <h1><a name="common">Common attributes</a></h1> All resolvers of the same type share some common attributes detailed here: <table class="ivy-attributes"> <thead> <tr><th class="ivy-att">Attribute</th><th class="ivy-att-desc">Description</th><th class="ivy-att-req">Required</th><th>Composite</th><th>Standard</th></tr> </thead> <tbody> <tr><td>name</td><td>the name which identify the resolver</td> <td>Yes</td> <td>Yes</td> <td>Yes</td> </tr> <tr><td>validate</td><td>indicates if resolved ivy files should be validated against ivy xsd</td> <td>No, defaults to call setting</td> <td>Yes</td> <td>Yes</td> </tr> <tr><td>checkmodified</td><td>Indicates if this resolver should check lastmodified date to know if an ivy file is up to date.</td> <td>No, defaults to ${ivy.resolver.default.check.modified}</td> <td>No</td> <td>Yes</td> </tr> <tr><td>changingPattern</td><td>Indicates for which revision pattern this resolver should check lastmodified date to know if an artifact file is up to date. <span class="since">since 1.4</span>. See <a href="../concept.html#change">cache and change management</a> for details.</td> <td>No, defaults to none</td> <td>Yes</td> <td>Yes</td> </tr> <tr><td>changingMatcher</td><td>The name of the <a href="../concept.html#matcher">pattern matcher</a> to use to match a revision against the configured changingPattern. <span class="since">since 1.4</span>. See <a href="../concept.html#change">cache and change management</a> for details.</td> <td>No, defaults to exactOrRegexp</td> <td>Yes</td> <td>Yes</td> </tr> <tr><td>alwaysCheckExactRevision</td><td>Indicates if this resolver should check the given revision even if it's a special one (like latest.integration). <span class="since">since 1.3</span></td> <td>No, defaults to ${ivy.default.always.check.exact.revision}</td> <td>No</td> <td>Yes</td> </tr> <tr><td>namespace</td><td>The name of the namespace to which this resolver belong <span class="since">since 1.3</span></td> <td>No, defaults to 'system'</td> <td>Yes</td> <td>Yes</td> </tr> <tr><td>checkconsistency</td><td>true to check consistency of module descriptors found by this resolver, false to avoid consistency check <span class="since">since 1.3</span></td> <td>No, defaults to true</td> <td>No</td> <td>Yes</td> </tr> <tr><td>allownomd</td><td>true if the absence of module descriptor (usually an ivy file) is authorised for this resolver, false to refuse modules without module descriptor <span class="since">since 1.4</span></td> <td>No, defaults to true</td> <td>No (except dual)</td> <td>Yes</td> </tr> <tr><td>checksums</td><td>a comma separated list of <a href="../concept.html#checksum">checksum algorithms</a> to use both for publication and checking <span class="since">since 1.4</span></td> <td>No, defaults to ${ivy.checksums}</td> <td>No</td> <td>Yes</td> </tr> <tr><td>latest</td><td>The name of the latest strategy to use.</td> <td>No, defaults to 'default'</td> <td>Yes</td> <td>Yes</td> </tr> </tbody> </table> <h1>Examples</h1> <code type="xml"> <resolvers> <filesystem name="1"> <ivy pattern="${ivy.settings.dir}/1/[organisation]/[module]/ivys/ivy-[revision].xml"/> <artifact pattern="${ivy.settings.dir}/1/[organisation]/[module]/[type]s/[artifact]-[revision].[ext]"/> </filesystem> <chain name="chain1"> <resolver ref="1"/> <ivyrep name="ivyrep"/> </chain> <chain name="chain2" returnFirst="true" dual="true"> <resolver ref="1"/> <ibiblio name="ibiblio"/> </chain> </resolvers> </code> Defines a filesystem resolver, named '1', which is then used in two chains, the first which seconds the filesystem resolver with an ivyrep resolver, and second which seconds the filesystem resolver with an ibiblio resolver, and which returns the first module found, and uses the whole chain to download artifacts (see corresponding resolvers documentation for details about them).