notify-dpml AT lists.ibiblio.org
Subject: DPML Notify
List archive
svn commit: r1357 - in development/main/central/site/src/docs/products/transit: . properties/hosts protocol
- From: mcconnell AT netcompartner.com
- To: notify-dpml AT lists.ibiblio.org
- Subject: svn commit: r1357 - in development/main/central/site/src/docs/products/transit: . properties/hosts protocol
- Date: Mon, 03 Jan 2005 13:42:20 +0100
Author: mcconnell
Date: Mon Jan 3 13:42:20 2005
New Revision: 1357
Added:
development/main/central/site/src/docs/products/transit/protocol/
development/main/central/site/src/docs/products/transit/protocol/index.xml
(contents, props changed)
development/main/central/site/src/docs/products/transit/protocol/maven.xml
(contents, props changed)
development/main/central/site/src/docs/products/transit/protocol/navigation.xml
(contents, props changed)
Removed:
development/main/central/site/src/docs/products/transit/properties/hosts/maven.xml
Modified:
development/main/central/site/src/docs/products/transit/navigation.xml
development/main/central/site/src/docs/products/transit/properties/hosts/navigation.xml
Log:
Update the location of the maven repo format info - should be clearer and
easier to follow.
Modified:
development/main/central/site/src/docs/products/transit/navigation.xml
==============================================================================
--- development/main/central/site/src/docs/products/transit/navigation.xml
(original)
+++ development/main/central/site/src/docs/products/transit/navigation.xml
Mon Jan 3 13:42:20 2005
@@ -26,7 +26,7 @@
<menu>
<item name="Properties" href="properties/index.html"/>
- <item name="Protocol Specification" href="protocol.html"/>
+ <item name="Protocol Specification" href="protocol/index.html"/>
<!--<item name="Repository" href="repository.html"/>-->
<item name="Javadoc" href="../../../@TRANSIT-DOCS-PATH@/index.html"/>
</menu>
Modified:
development/main/central/site/src/docs/products/transit/properties/hosts/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/properties/hosts/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/properties/hosts/navigation.xml
Mon Jan 3 13:42:20 2005
@@ -20,12 +20,11 @@
<project>
- <title>Magic</title>
+ <title>Transit</title>
<body>
<menu>
- <item name="Maven Protocol" href="maven.html"/>
</menu>
</body>
Added:
development/main/central/site/src/docs/products/transit/protocol/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/protocol/index.xml
Mon Jan 3 13:42:20 2005
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 2004 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Artifact Protocol">
+
+ <p>
+ The key to the repository comes through the artifact protocol. It
+ makes a separation of concern between the requested resource and the
+ location where such a resource can be found. The location is handled
+ by a the protocol handler, and is configured by the user. In reality,
+ once DPML Transit is in place, it is possible to request any type of
+ resource via the familiar java.net.URL() and many existing
+ applications can easily be made <strong>repository enabled</strong>
+ just by providing DPML Transit in the classpath and setting one or
+ two system properties.
+ </p>
+
+ <subsection name="Official Format." >
+ <p>
+ The official format for the artifact protocol is as follows;
+ </p>
+<source> artifact:[type]:[group]/[name]#[version] </source>
+ </subsection>
+
+ <subsection name="Using an artifact URL" >
+ <p>
+ Using artifact URLs are no different from any http or ftp URLs. You
+ create them by instantiating the <code>java.net.URL</code> class,
+ and setting the protocol to "artifact" (no quotes).
+ </p>
+ </subsection>
+
+ </section>
+ </body>
+</document>
+
+
+
Added:
development/main/central/site/src/docs/products/transit/protocol/maven.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/protocol/maven.xml
Mon Jan 3 13:42:20 2005
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 2004 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<document>
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Resource Host - Maven">
+ <p>
+ Apache Maven was one of the first applications that start using a
+ central repository for build artifacts, typically Jar files. I am not
+ sure whether the format of this repository layout was made by the
Maven
+ project itself, or if it used work from somewhere else.
+ </p>
+ <subsection name="Resolution">
+ <p>
+ The official format for the artifact protocol is as follows;
+ </p>
+<source> artifact:[type]:[group]/[name]#version </source>
+ <p>
+ which for Maven resource hosts will be translated into;
+ </p>
+<source> [resourcehost]/[group]/[type]s/[name]-[version].[type] </source>
+ <p>
+ where,
+ </p>
+ <table>
+ <tr>
+ <td>type</td>
+ <td>
+ The type of the resource.
+ </td>
+ </tr>
+ <tr>
+ <td>group</td>
+ <td>
+ The group the resource belongs to. Slashes in the group are
+ allowed and denotes subgrouping.
+ </td>
+ </tr>
+ <tr>
+ <td>name</td>
+ <td>
+ The name of the resource.
+ </td>
+ </tr>
+ <tr>
+ <td>version</td>
+ <td>
+ The version of the resource. The version is an opaque string
+ in the current Maven resource host implementation, but may
+ evolve in the future, and known version formats should be used
+ for maximum future compatibility.
+ </td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ </body>
+</document>
+
+
+
Added:
development/main/central/site/src/docs/products/transit/protocol/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/protocol/navigation.xml
Mon Jan 3 13:42:20 2005
@@ -0,0 +1,33 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.dpml.net/central/about/legal/
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied.
+
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<project>
+
+ <title>Transit</title>
+
+ <body>
+
+ <menu>
+ <item name="Maven Model" href="maven.html"/>
+ </menu>
+
+ </body>
+
+</project>
- svn commit: r1357 - in development/main/central/site/src/docs/products/transit: . properties/hosts protocol, mcconnell, 01/03/2005
Archive powered by MHonArc 2.6.24.