You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@ant.apache.org by hi...@apache.org on 2010/12/13 19:32:02 UTC
svn commit: r1045278 [25/32] - in /ant/ivy/site/target/history/2.2.0-rc1: ./
configuration/ configuration/caches/ configuration/macrodef/
configuration/namespace/ dev/ ivyfile/ js/ resolver/ samples/ settings/
settings/caches/ settings/macrodef/ settin...
Modified: ant/ivy/site/target/history/2.2.0-rc1/tutorial/build-repository/advanced.html
URL: http://svn.apache.org/viewvc/ant/ivy/site/target/history/2.2.0-rc1/tutorial/build-repository/advanced.html?rev=1045278&r1=1045277&r2=1045278&view=diff
==============================================================================
--- ant/ivy/site/target/history/2.2.0-rc1/tutorial/build-repository/advanced.html (original)
+++ ant/ivy/site/target/history/2.2.0-rc1/tutorial/build-repository/advanced.html Mon Dec 13 18:31:56 2010
@@ -23,7 +23,7 @@
<script type="text/javascript">var xookiConfig = {level: 2};</script>
-<title>Using namespaces | Apache Ivy</title>
+<title>Using namespaces | Apache Ivy™</title>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<link rel="stylesheet" type="text/css" href="../../style/style.css" />
<script src="../../js/jquery.pack.js" type="text/javascript"></script>
@@ -79,7 +79,7 @@
<tr>
<td id="sidebar-left">
<div class="block block-book" id="block-book-0">
- <h2>Ivy</h2>
+ <h2>Apache Ivy™</h2>
<div class="content"><ul id="treemenu" class="treeview"><li id="xooki-index" class="submenu"><a href="../../index.html" >Documentation (2.2.0-rc1)</a><ul class="open"><li id="xooki-release-notes"><a href="../../release-notes.html" >Release Notes</a></li><li id="xooki-tutorial" class="submenu"><a href="../../tutorial.html" >Tutorials</a><ul class="open"><li id="xooki-tutorial/start"><a href="../../tutorial/start.html" >Quick Start</a></li><li id="xooki-tutorial/defaultconf"><a href="../../tutorial/defaultconf.html" >Adjusting default settings</a></li><li id="xooki-tutorial/multiple"><a href="../../tutorial/multiple.html" >Multiple Resolvers</a></li><li id="xooki-tutorial/dual"><a href="../../tutorial/dual.html" >Dual Resolver</a></li><li id="xooki-tutorial/dependence"><a href="../../tutorial/dependence.html" >Project dependencies</a></li><li id="xooki-tutorial/multiproject"><a href="../../tutorial/multiproject.html" >Using Ivy in multiple projects environment</a></li><li id
="xooki-tutorial/conf"><a href="../../tutorial/conf.html" >Using Ivy Module Configurations</a></li><li id="xooki-tutorial/build-repository" class="submenu"><a href="../../tutorial/build-repository.html" >Building a repository</a><ul class="open"><li id="xooki-tutorial/build-repository/basic"><a href="../../tutorial/build-repository/basic.html" >Basic repository copy</a></li><li id="xooki-tutorial/build-repository/advanced"><a href="../../tutorial/build-repository/advanced.html" class="current">Using namespaces</a></li></ul></li><li id="xooki-moreexamples"><a href="../../moreexamples.html" >More examples</a></li></ul></li><li id="xooki-reference" class="submenu"><a href="../../reference.html" >Reference</a><ul class="closed"><li id="xooki-intro" class="submenu">Introduction<ul class="closed"><li id="xooki-terminology"><a href="../../terminology.html" >Terminology</a></li><li id="xooki-concept"><a href="../../concept.html" >Main Concepts</a></li><li id="xooki-textual"><a href=
"../../textual.html" >Text Conventions</a></li><li id="xooki-principle"><a href="../../principle.html" >How does it work ?</a></li><li id="xooki-bestpractices"><a href="../../bestpractices.html" >Best practices</a></li><li id="xooki-install"><a href="../../install.html" >Installation</a></li></ul></li><li id="xooki-settings" class="submenu"><a href="../../settings.html" >Settings Files</a><ul class="closed"><li id="xooki-settings/property"><a href="../../settings/property.html" >property</a></li><li id="xooki-settings/properties"><a href="../../settings/properties.html" >properties</a></li><li id="xooki-settings/settings"><a href="../../settings/settings.html" >settings</a></li><li id="xooki-settings/include"><a href="../../settings/include.html" >include</a></li><li id="xooki-settings/classpath"><a href="../../settings/classpath.html" >classpath</a></li><li id="xooki-settings/typedef"><a href="../../settings/typedef.html" >typedef</a></li><li id="xooki-settings/credentials"
><a href="../../settings/credentials.html" >credentials</a></li><li id="xooki-settings/lock-strategies"><a href="../../settings/lock-strategies.html" >lock-strategies</a></li><li id="xooki-settings/caches" class="submenu"><a href="../../settings/caches.html" >caches</a><ul class="closed"><li id="xooki-settings/caches/cache" class="submenu"><a href="../../settings/caches/cache.html" >cache</a><ul class="closed"><li id="xooki-settings/caches/ttl"><a href="../../settings/caches/ttl.html" >ttl</a></li></ul></li></ul></li><li id="xooki-settings/latest-strategies"><a href="../../settings/latest-strategies.html" >latest-strategies</a></li><li id="xooki-settings/parsers"><a href="../../settings/parsers.html" >parsers</a></li><li id="xooki-settings/namespaces" class="submenu"><a href="../../settings/namespaces.html" >namespaces</a><ul class="closed"><li id="xooki-settings/namespace" class="submenu"><a href="../../settings/namespace.html" >namespace</a><ul class="closed"><li id="xooki
-settings/namespace/rule" class="submenu"><a href="../../settings/namespace/rule.html" >rule</a><ul class="closed"><li id="xooki-settings/namespace/fromtosystem" class="submenu"><a href="../../settings/namespace/fromtosystem.html" >fromsystem / tosystem</a><ul class="closed"><li id="xooki-settings/namespace/src"><a href="../../settings/namespace/src.html" >src</a></li><li id="xooki-settings/namespace/dest"><a href="../../settings/namespace/dest.html" >dest</a></li></ul></li></ul></li></ul></li></ul></li><li id="xooki-settings/macrodef" class="submenu"><a href="../../settings/macrodef.html" >macrodef</a><ul class="closed"><li id="xooki-settings/macrodef/attribute"><a href="../../settings/macrodef/attribute.html" >attribute</a></li></ul></li><li id="xooki-settings/resolvers" class="submenu"><a href="../../settings/resolvers.html" >resolvers</a><ul class="closed"><li id="xooki-resolver/ivyrep"><a href="../../resolver/ivyrep.html" >IvyRep Resolver</a></li><li id="xooki-resolver/
ibiblio"><a href="../../resolver/ibiblio.html" >IBiblio Resolver</a></li><li id="xooki-resolver/packager"><a href="../../resolver/packager.html" >Packager resolver</a></li><li id="xooki-resolver/filesystem"><a href="../../resolver/filesystem.html" >File System resolver</a></li><li id="xooki-resolver/url"><a href="../../resolver/url.html" >Url Resolver</a></li><li id="xooki-resolver/chain"><a href="../../resolver/chain.html" >Chain Resolver</a></li><li id="xooki-resolver/dual"><a href="../../resolver/dual.html" >Dual resolver</a></li><li id="xooki-resolver/sftp"><a href="../../resolver/sftp.html" >sftp resolver</a></li><li id="xooki-resolver/ssh"><a href="../../resolver/ssh.html" >ssh resolver</a></li><li id="xooki-resolver/vfs"><a href="../../resolver/vfs.html" >vfs</a></li></ul></li><li id="xooki-settings/conflict-managers"><a href="../../settings/conflict-managers.html" >conflict-managers</a></li><li id="xooki-settings/modules" class="submenu"><a href="../../settings/modul
es.html" >modules</a><ul class="closed"><li id="xooki-settings/module"><a href="../../settings/module.html" >module</a></li></ul></li><li id="xooki-settings/outputters"><a href="../../settings/outputters.html" >outputters</a></li><li id="xooki-settings/statuses" class="submenu"><a href="../../settings/statuses.html" >statuses</a><ul class="closed"><li id="xooki-settings/status"><a href="../../settings/status.html" >status</a></li></ul></li><li id="xooki-settings/triggers"><a href="../../settings/triggers.html" >triggers</a></li><li id="xooki-settings/version-matchers"><a href="../../settings/version-matchers.html" >version-matchers</a></li></ul></li><li id="xooki-ivyfile" class="submenu"><a href="../../ivyfile.html" >Ivy Files</a><ul class="closed"><li id="xooki-ivyfile/info" class="submenu"><a href="../../ivyfile/info.html" >info</a><ul class="closed"><li id="xooki-ivyfile/extends"><a href="../../ivyfile/extends.html" >extends</a></li><li id="xooki-ivyfile/license"><a href=
"../../ivyfile/license.html" >license</a></li><li id="xooki-ivyfile/ivyauthor"><a href="../../ivyfile/ivyauthor.html" >ivyauthor</a></li><li id="xooki-ivyfile/repository"><a href="../../ivyfile/repository.html" >repository</a></li><li id="xooki-ivyfile/description"><a href="../../ivyfile/description.html" >description</a></li></ul></li><li id="xooki-ivyfile/configurations" class="submenu"><a href="../../ivyfile/configurations.html" >configurations</a><ul class="closed"><li id="xooki-ivyfile/conf"><a href="../../ivyfile/conf.html" >conf</a></li><li id="xooki-ivyfile/include"><a href="../../ivyfile/include.html" >include</a></li></ul></li><li id="xooki-ivyfile/publications" class="submenu"><a href="../../ivyfile/publications.html" >publications</a><ul class="closed"><li id="xooki-ivyfile/artifact" class="submenu"><a href="../../ivyfile/artifact.html" >artifact</a><ul class="closed"><li id="xooki-ivyfile/artifact-conf"><a href="../../ivyfile/artifact-conf.html" >conf</a></li></
ul></li></ul></li><li id="xooki-ivyfile/dependencies" class="submenu"><a href="../../ivyfile/dependencies.html" >dependencies</a><ul class="closed"><li id="xooki-ivyfile/dependency" class="submenu"><a href="../../ivyfile/dependency.html" >dependency</a><ul class="closed"><li id="xooki-ivyfile/dependency-conf" class="submenu"><a href="../../ivyfile/dependency-conf.html" >conf</a><ul class="closed"><li id="xooki-ivyfile/mapped"><a href="../../ivyfile/mapped.html" >mapped</a></li></ul></li><li id="xooki-ivyfile/dependency-artifact" class="submenu"><a href="../../ivyfile/dependency-artifact.html" >artifact</a><ul class="closed"><li id="xooki-ivyfile/dependency-artifact-conf"><a href="../../ivyfile/dependency-artifact-conf.html" >conf</a></li></ul></li><li id="xooki-ivyfile/artifact-exclude" class="submenu"><a href="../../ivyfile/artifact-exclude.html" >exclude</a><ul class="closed"><li id="xooki-ivyfile/artifact-exclude-conf"><a href="../../ivyfile/artifact-exclude-conf.html" >c
onf</a></li></ul></li><li id="xooki-ivyfile/dependency-include" class="submenu"><a href="../../ivyfile/dependency-include.html" >include</a><ul class="closed"><li id="xooki-ivyfile/dependency-include-conf"><a href="../../ivyfile/dependency-include-conf.html" >conf</a></li></ul></li></ul></li><li id="xooki-ivyfile/exclude"><a href="../../ivyfile/exclude.html" >exclude</a></li><li id="xooki-ivyfile/override"><a href="../../ivyfile/override.html" >override</a></li><li id="xooki-ivyfile/conflict"><a href="../../ivyfile/conflict.html" >conflict</a></li></ul></li><li id="xooki-ivyfile/conflicts" class="submenu"><a href="../../ivyfile/conflicts.html" >conflicts</a><ul class="closed"><li id="xooki-ivyfile/manager"><a href="../../ivyfile/manager.html" >manager</a></li></ul></li></ul></li><li id="xooki-ant" class="submenu"><a href="../../ant.html" >Ant Tasks</a><ul class="closed"><li id="xooki-use/artifactproperty"><a href="../../use/artifactproperty.html" >artifactproperty</a></li><l
i id="xooki-use/artifactreport"><a href="../../use/artifactreport.html" >artifactreport</a></li><li id="xooki-use/buildlist"><a href="../../use/buildlist.html" >buildlist</a></li><li id="xooki-use/buildnumber"><a href="../../use/buildnumber.html" >buildnumber</a></li><li id="xooki-use/cachefileset"><a href="../../use/cachefileset.html" >cachefileset</a></li><li id="xooki-use/cachepath"><a href="../../use/cachepath.html" >cachepath</a></li><li id="xooki-use/cleancache"><a href="../../use/cleancache.html" >cleancache</a></li><li id="xooki-use/configure"><a href="../../use/configure.html" >configure</a></li><li id="xooki-use/deliver"><a href="../../use/deliver.html" >deliver</a></li><li id="xooki-use/findrevision"><a href="../../use/findrevision.html" >findrevision</a></li><li id="xooki-use/info"><a href="../../use/info.html" >info</a></li><li id="xooki-use/install"><a href="../../use/install.html" >install</a></li><li id="xooki-use/listmodules"><a href="../../use/listmodules.h
tml" >listmodules</a></li><li id="xooki-use/makepom"><a href="../../use/makepom.html" >makepom</a></li><li id="xooki-use/postresolvetask"><a href="../../use/postresolvetask.html" >post resolve tasks</a></li><li id="xooki-use/publish"><a href="../../use/publish.html" >publish</a></li><li id="xooki-use/repreport"><a href="../../use/repreport.html" >repreport</a></li><li id="xooki-use/resolve"><a href="../../use/resolve.html" >resolve</a></li><li id="xooki-use/retrieve"><a href="../../use/retrieve.html" >retrieve</a></li><li id="xooki-use/report" class="submenu"><a href="../../use/report.html" >report</a><ul class="closed"><li id="xooki-yed"><a href="../../yed.html" >Using yEd to layout report graphs</a></li></ul></li><li id="xooki-use/settings"><a href="../../use/settings.html" >settings</a></li><li id="xooki-use/var"><a href="../../use/var.html" >var</a></li></ul></li><li id="xooki-standalone"><a href="../../standalone.html" >Using standalone</a></li></ul></li><li id="xooki-d
ev" class="submenu"><a href="../../dev.html" >Developer doc</a><ul class="closed"><li id="xooki-extend"><a href="../../extend.html" >Extending Ivy</a></li><li id="xooki-dev/makerelease"><a href="../../dev/makerelease.html" >Making a release</a></li><li id="xooki-dev/updatesite"><a href="../../dev/updatesite.html" >Updating the updatesite</a></li></ul></li></ul></li></ul></div>
@@ -100,59 +100,11 @@
We will study in this section how to build a <strong>professionnal</strong> repository. What is a <strong>professionnal</strong> repository? Our vision is to say that a good quality repository must follow clear rules about projects naming and must offer corrects, usuables, configurables and verified project descriptors. In order to achieve those goals, we think that you have to build your own repository.<br class="xooki-br"/>We have seen in the previous example, that we could use some public repositories to begin to build our own repository. <br class="xooki-br"/>Nevertheless, the result is not always the expected one, especially concerning the naming rules used. <br class="xooki-br"/><br class="xooki-br"/>This problem is pretty usual when you have an existing repository, and want to benefit from a large public repositories which do not follow the same naming conventions. Or simply because you find the public repository you use as a basis is not consistent enough - why all a
pache commons module aren't don't use the org.apache.commons organization? For historical reasons. But if you setup your own repository you may not want to suffer from history.<br class="xooki-br"/><br class="xooki-br"/>Fortunately Ivy has a very powerful answer to this kind of problem: <a href="../../settings/namespaces.html">namespaces</a>.<br class="xooki-br"/><br class="xooki-br"/><h1>Using namespaces</h1>
If you look at the repository built with the <a href="../../tutorial/build-repository/basic.html">previous tutorial</a>, you will see exactly what we were talking about: all apache commons module use their own name as organization.<br class="xooki-br"/><br class="xooki-br"/>So let's see what Ivy can do using namespaces (we will dig into details later):
<div class="shell"><pre>
-[ivy@apache:/ivy/build-a-ivy-repository]$ ant maven2-namespace
-Buildfile: /ivy/build-a-ivy-repository/build.xml
-
-load-ivy:
-
-init-ivy:
-
-maven2-namespace:
-[ivy:install] :: Ivy 2.2.0-rc1 - 20100629224905 :: http://ant.apache.org/ivy/ ::
-[ivy:install] :: loading settings :: file = /ivy/build-a-ivy-repository/settings/ivysettings-advanced.xml
-[ivy:install] DEPRECATED: 'defaultCache' is deprecated, use 'caches[@defaultCacheDir]' instead (file://ivy/build-a-ivy-repository/settings/ivysettings-advanced.xml)
-[ivy:install] :: installing apache#commons-lang;1.0 ::
-[ivy:install] :: resolving dependencies ::
-[ivy:install] found apache#commons-lang;1.0 in libraries
-[ivy:install] :: downloading artifacts to cache ::
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/1.0/commons-lang-1.0.jar ...
-[ivy:install] ....................................................................................................................... (62kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] apache#commons-lang;1.0!commons-lang.jar (1919ms)
-[ivy:install] downloading http://repo1.maven.org/maven2/commons-lang/commons-lang/1.0/commons-lang-1.0-javadoc.jar ...
-[ivy:install] .................................................................................................................................................................................................................................................................................................................................................................... (170kB)
-[ivy:install] .. (0kB)
-[ivy:install] [SUCCESSFUL ] apache#commons-lang;1.0!commons-lang.jar(javadoc) (3478ms)
-[ivy:install] :: installing in my-repository ::
-[ivy:install] published commons-lang to /ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/jars/commons-lang-1.0.jar
-[ivy:install] published commons-lang to /ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/javadocs/commons-lang-1.0.jar
-[ivy:install] published ivy to /ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/ivys/ivy-1.0.xml
-[ivy:install] :: install resolution report ::
-[ivy:install] :: resolution report :: resolve 0ms :: artifacts dl 5428ms
- ---------------------------------------------------------------------
- | | modules || artifacts |
- | conf | number| search|dwnlded|evicted|| number|dwnlded|
- ---------------------------------------------------------------------
- | default | 1 | 1 | 1 | 0 || 2 | 2 |
- ---------------------------------------------------------------------
-
-BUILD SUCCESSFUL
-Total time: 9 seconds
</pre></div>
Now if we look at our repository, it seems to look fine.
<div class="shell"><pre>
-$ find /ivy/build-a-ivy-repository/myrepository/advanced -type f -print
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/ivys/ivy-1.0.xml
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/ivys/ivy-1.0.xml.md5
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/ivys/ivy-1.0.xml.sha1
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/jars/commons-lang-1.0.jar
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/jars/commons-lang-1.0.jar.md5
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/jars/commons-lang-1.0.jar.sha1
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/javadocs/commons-lang-1.0.jar
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/javadocs/commons-lang-1.0.jar.md5
-/ivy/build-a-ivy-repository/myrepository/advanced/apache/commons-lang/javadocs/commons-lang-1.0.jar.sha1
</pre></div>
We can even have a look at the commons-lang ivy file in our repo:
@@ -197,10 +149,12 @@ Ok, you should now get the idea behind n
</tr>
</table>
-
-
-<div id="footer-message"></div>
-
+<div id="footer-message" class="footer">
+ <hr />
+ <i>Copyright © 2010 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0.txt">Apache License, Version 2.0</a>.</i><br />
+ <i>Apache Ivy, Apache Ant, Ivy, Ant, Apache, the Apache Ivy logo, the Apache Ant logo and the Apache feather logo are trademarks of The Apache Software Foundation.</i><br />
+ <i>All other marks mentioned may be trademarks or registered trademarks of their respective owners. </i>
+</div>
</div><!-- body -->
</body>