Skip to Content.
Sympa Menu

notify-dpml - svn commit: r1432 - in development/main/central/site/src/docs/products: . transit transit/concepts transit/launcher transit/overview transit/properties transit/protocol transit/tasks transit/technical transit/technical/concepts transit/technical/launcher transit/technical/properties transit/technical/protocol transit/technical/tasks

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: dleangen AT netcompartner.com
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: svn commit: r1432 - in development/main/central/site/src/docs/products: . transit transit/concepts transit/launcher transit/overview transit/properties transit/protocol transit/tasks transit/technical transit/technical/concepts transit/technical/launcher transit/technical/properties transit/technical/protocol transit/technical/tasks
  • Date: Mon, 10 Jan 2005 12:03:10 +0100

Author: dleangen
Date: Mon Jan 10 12:03:10 2005
New Revision: 1432

Added:
development/main/central/site/src/docs/products/transit/overview/

development/main/central/site/src/docs/products/transit/overview/classloading.xml
development/main/central/site/src/docs/products/transit/overview/index.xml

development/main/central/site/src/docs/products/transit/overview/management.xml

development/main/central/site/src/docs/products/transit/overview/navigation.xml

development/main/central/site/src/docs/products/transit/overview/retrieval.xml
development/main/central/site/src/docs/products/transit/technical/
development/main/central/site/src/docs/products/transit/technical/concepts/

development/main/central/site/src/docs/products/transit/technical/concepts/artifact.xml

development/main/central/site/src/docs/products/transit/technical/concepts/cache.xml

development/main/central/site/src/docs/products/transit/technical/concepts/hosts.xml

development/main/central/site/src/docs/products/transit/technical/concepts/index.xml

development/main/central/site/src/docs/products/transit/technical/concepts/monitors.xml

development/main/central/site/src/docs/products/transit/technical/concepts/navigation.xml

development/main/central/site/src/docs/products/transit/technical/concepts/plugins.xml
development/main/central/site/src/docs/products/transit/technical/index.xml
development/main/central/site/src/docs/products/transit/technical/launcher/

development/main/central/site/src/docs/products/transit/technical/launcher/index.xml

development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml

development/main/central/site/src/docs/products/transit/technical/navigation.xml

development/main/central/site/src/docs/products/transit/technical/properties/

development/main/central/site/src/docs/products/transit/technical/properties/cache.xml

development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml

development/main/central/site/src/docs/products/transit/technical/properties/index.xml

development/main/central/site/src/docs/products/transit/technical/properties/navigation.xml

development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
development/main/central/site/src/docs/products/transit/technical/protocol/

development/main/central/site/src/docs/products/transit/technical/protocol.xml

development/main/central/site/src/docs/products/transit/technical/protocol/classic.xml

development/main/central/site/src/docs/products/transit/technical/protocol/index.xml

development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
development/main/central/site/src/docs/products/transit/technical/tasks/

development/main/central/site/src/docs/products/transit/technical/tasks/index.xml

development/main/central/site/src/docs/products/transit/technical/tasks/init.xml

development/main/central/site/src/docs/products/transit/technical/tasks/navigation.xml

development/main/central/site/src/docs/products/transit/technical/tasks/plugin.xml
Removed:
development/main/central/site/src/docs/products/transit/concepts/
development/main/central/site/src/docs/products/transit/launcher/
development/main/central/site/src/docs/products/transit/properties/
development/main/central/site/src/docs/products/transit/protocol/
development/main/central/site/src/docs/products/transit/protocol.xml
development/main/central/site/src/docs/products/transit/tasks/
Modified:
development/main/central/site/src/docs/products/index.xml
development/main/central/site/src/docs/products/transit/index.xml
development/main/central/site/src/docs/products/transit/navigation.xml
Log:
Demoted technical information to a subsection. Added "overview" section.


Modified: development/main/central/site/src/docs/products/index.xml
==============================================================================
--- development/main/central/site/src/docs/products/index.xml (original)
+++ development/main/central/site/src/docs/products/index.xml Mon Jan 10
12:03:10 2005
@@ -8,52 +8,48 @@
</properties>

<body>
- <section name="DPML Products">
+ <section name="DPML Product Overview">

- <table>
- <tr>
- <th>Product</th>
- <th>Function</th>
- </tr>
- <tr>
- <td><a href="metro/index.html"><strong>Metro</strong></a></td>
- <td>
- The Metro system is a <strong>light weight container</strong>
- that provides comprehensive support for
- the management of complex component based systems based on an
underlying
- meta-model that facilitates automated assembly and deployment
of components.
- Metro aims to simplify the process of managing component-based
systems. It
- achieves this objective through delivery of functionality
supporting automated
- component assembly and deployment combined with strong support
for the
- isolation of implementation from the service that a component
provides.
- Applications are implemented through component composition. In
turn,
- applications can be exposed as simple components and used by
other components
- as building blocks.
- </td>
- </tr>
- <tr>
- <td><a href="magic/index.html"><strong>Magic</strong></a></td>
- <td>
- Magic is an <strong>advanced build system</strong> for Java
based component
- development.
- It provides support for a centralized project object model,
version and
- dependency management, and a suite of tools that automate the
processes
- of building well-structured component solutions.
- </td>
- </tr>
- <tr>
- <td><a
href="transit/index.html"><strong>Transit</strong></a></td>
- <td>
- Transit is a <strong>protocol handler</strong> that provides
support for the
- <a href="../concepts/index.html#cache_management_layer">cache
management layer</a>
- of a
- <a
href="../concepts/index.html#repository_enabled_application">repository
enabled application</a>.
- The notion of
- "<a href="../concepts/index.html#enabled_solution">enabled
solutions</a>"
- is central theme present in all DPML solutions.
- </td>
- </tr>
- </table>
+ <subsection name="Metro Light Weight Container Framework">
+ <p>
+ The Metro system is a light weight container framework
+ that provides comprehensive support for
+ the management of complex component based systems based on an
underlying
+ meta-model that facilitates automated assembly and deployment of
components.
+ Metro aims to simplify the process of managing component-based
systems. It
+ achieves this objective through delivery of functionality
supporting automated
+ component assembly and deployment combined with strong support for
the
+ isolation of implementation from the service that a component
provides.
+ Applications are implemented through component composition. In
turn,
+ applications can be exposed as simple components and used by other
components
+ as building blocks.
+ </p>
+ </subsection>
+
+ <subsection name="Magic Build System">
+ <p>
+ Magic is an advanced build system for Java based component
+ development.
+ It provides support for a centralized project object model,
version and
+ dependency management, and a suite of tools that automate the
processes
+ of building well-structured component solutions.
+ </p>
+ </subsection>
+
+ <subsection name="Transit Resource Management System">
+ <p>
+ Transit provides a flexible framework for dynamically retrieving
+ system and application resources, constructing classloaders, and
+ managing plugins.
+
+ As a resource management system, Transit provides the foundation
+ for building repository-enabled applications.
+ <a href="transit/index.html">more &gt;&gt;</a>
+ </p>
+
+ <img src="/images/transit/repositories.png"/>
+
+ </subsection>

</section>
</body>

Modified: development/main/central/site/src/docs/products/transit/index.xml
==============================================================================
--- development/main/central/site/src/docs/products/transit/index.xml
(original)
+++ development/main/central/site/src/docs/products/transit/index.xml Mon
Jan 10 12:03:10 2005
@@ -25,109 +25,33 @@
<author email="mcconnell AT dpml.net">Stephen McConnell</author>
<author email="niclas AT hedhman.org">Niclas Hedhman</author>
<author email="david.leangen AT konova.com">David Leangen</author>
- <title>DPML Transit</title>
+ <title>DPML Products</title>
</properties>

<body>
- <section name="Transit Resource Management">
+ <section name="Transit Resource Management System">

- <p>
- Transit is a resource management system that provides a flexible
- framework for dynamic retrieval of system and application resources,
- classloader construction, and plugin management. Collectively, these
- facilities provide the structure on which <a
href="concepts/index.html">
- repository enabled</a> applications can be build.
- </p>
-
- <img src="/images/transit/repositories.png"/>
-
- <subsection name="Features and Benefits">
-
- <p>
- The core of the Transit product is a URL protocol handler which
serves as
- the basic construct on which classloader management in provided.
The classloader
- creation services provide the framework with a simple plugin
framework.
- </p>

<p>
- Key features of the Transit system include:
- </p>
+ Transit provides a flexible framework for dynamically retrieving
+ system and application resources, constructing classloaders, and
+ managing plugins.

- <ol>
- <li>high level of integration with the JVM</li>
- <li>simple configuration model</li>
- <li>small footprint</li>
- <li>flexible event monitoring</li>
- </ol>
-
- <p>
- Key benefits delivered by Transit include:
+ As a resource management system, Transit provides the foundation
+ for building repository-enabled applications.
</p>

- <ol>
- <li>cost reduction on product deployment and upgrade</li>
- <li>reduced risk though improved control over version management</li>
- <li>improved quality through reduction in class conflicts</li>
- <li>improved security through repository management</li>
- <li>low maintenance though centralized configuration</li>
- </ol>
-
- </subsection>
-
- <!--
- <p>
-that provides support for the
- <a href="features/cache.html">cache management</a> layer of a
- <a href="features/enabled.html">repository enabled</a> application.
- </p>
-
- <p>
- A DPML-enabled application will normally make content requests using
an
- artifact uri. The uri identifies a resource and provides support
for
- resource resolution using possibly multiple remote and local hosts.
-
-to a
- <a href="/about/concepts/index.html#local_cache_manager">local cache
manager</a>.
- The cache manager interacts with one or more
- <a href="/about/concepts/index.html#remote_repository">remote
repositories</a> to resolve
- application requests.
- </p>
-
- <p>
- Applications will make such requests when they require resources,
such as
- JAR files, in order to operate correctly.
- </p>
+ <img src="/images/transit/repositories.png"/>

<p>
- In most cases, other than understanding the
- <a href="protocol/index.html">artifact protocol</a>, you will not
need to interact
- directly with Transit. Other DPML solutions, such as
- <a href="../magic/index.html">Magic</a> and
- <a href="../metro/index.html">Metro</a>,
- will use Transit transparently to the user.
- </p>
- -->
-
- <!-- #This info goes in explanation of "remote repository"
- Varying levels of quality of service are provided by
- repository systems, for example, a local cache manager can provide a
level
- of control over which repositories are accesses and provide content
- validation. In addition, intelligent remote repositories can provide
advanced
- solutions including automated generation of artifacts relative to
cache
- manager requests, content filtering, referral management, and
solutions
- customized relative to client identity.
- -->
-
-
- <subsection name="More Information">
+ Learn more about:
<ul>
- <li><a href="/guide/setup/index.html">installation</a></li>
- <li><a href="/guide/transit/index.html">Transit Guide</a></li>
- <li><a href="properties/index.html">properties
specifications</a></li>
- <li><a href="protocol/index.html">artifact protocol</a></li>
- <li><a href="launcher/index.html">application launcher</a></li>
+ <li><a href="overview/index.html">Transit features and
benefits</a></li>
+ <li><a href="overview/retrieval.html">Dynamic Retrieval</a></li>
+ <li><a href="overview/classloading.html">Classloader
Construction</a></li>
+ <li><a href="overview/management.html">Plugin Management</a></li>
</ul>
- </subsection>
+ </p>

</section>
</body>

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 10 12:03:10 2005
@@ -2,6 +2,7 @@
<!--
Copyright 2004 Stephen McConnell
Copyright 2004 Niclas Hedhman
+ Copyright 2005 David Leangen

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
@@ -25,11 +26,8 @@
<body>

<menu>
- <item name="Repository Enabled" href="concepts/index.html"/>
- <item name="Protocol Specification" href="protocol/index.html"/>
- <item name="Application Launcher" href="launcher/index.html"/>
- <item name="Properties" href="properties/index.html"/>
- <item name="Javadocs" href="../../../@TRANSIT-DOCS-PATH@/index.html"/>
+ <item name="Product Overview" href="index.html"/>
+ <item name="Product Specifications" href="technical/index.html"/>
</menu>

</body>

Added:
development/main/central/site/src/docs/products/transit/overview/classloading.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/classloading.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Products</title>
+ </properties>
+
+ <body>
+ <section name="Transit Resource Management System">
+
+ <subsection name="Features and Benefits">
+
+ <p>
+ The core of the Transit product is a URL protocol handler which
serves as
+ the basic construct on which classloader management in provided.
The classloader
+ creation services provide the framework with a simple plugin
framework.
+ </p>
+
+ <p>
+ Key features of the Transit system include:
+ </p>
+
+ <ol>
+ <li>high level of integration with the JVM</li>
+ <li>simple configuration model</li>
+ <li>small footprint</li>
+ <li>flexible event monitoring</li>
+ </ol>
+
+ <p>
+ Key benefits delivered by Transit include:
+ </p>
+
+ <ol>
+ <li>cost reduction on product deployment and upgrade</li>
+ <li>reduced risk though improved control over version management</li>
+ <li>improved quality through reduction in class conflicts</li>
+
+ <li>improved security through repository management</li>
+ <li>low maintenance though centralized configuration</li>
+ </ol>
+
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/overview/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Products</title>
+ </properties>
+
+ <body>
+ <section name="Transit Resource Management System">
+
+ <subsection name="Features and Benefits">
+
+ <p>
+ The core of the Transit product is a URL protocol handler which
serves as
+ the basic construct on which classloader management in provided.
The classloader
+ creation services provide the framework with a simple plugin
framework.
+ </p>
+
+ <p>
+ Key features of the Transit system include:
+ </p>
+
+ <ol>
+ <li>high level of integration with the JVM</li>
+ <li>simple configuration model</li>
+ <li>small footprint</li>
+ <li>flexible event monitoring</li>
+ </ol>
+
+ <p>
+ Key benefits delivered by Transit include:
+ </p>
+
+ <ol>
+ <li>cost reduction on product deployment and upgrade</li>
+ <li>reduced risk though improved control over version management</li>
+ <li>improved quality through reduction in class conflicts</li>
+
+ <li>improved security through repository management</li>
+ <li>low maintenance though centralized configuration</li>
+ </ol>
+
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/overview/management.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/management.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Products</title>
+ </properties>
+
+ <body>
+ <section name="Transit Resource Management System">
+
+ <subsection name="Features and Benefits">
+
+ <p>
+ The core of the Transit product is a URL protocol handler which
serves as
+ the basic construct on which classloader management in provided.
The classloader
+ creation services provide the framework with a simple plugin
framework.
+ </p>
+
+ <p>
+ Key features of the Transit system include:
+ </p>
+
+ <ol>
+ <li>high level of integration with the JVM</li>
+ <li>simple configuration model</li>
+ <li>small footprint</li>
+ <li>flexible event monitoring</li>
+ </ol>
+
+ <p>
+ Key benefits delivered by Transit include:
+ </p>
+
+ <ol>
+ <li>cost reduction on product deployment and upgrade</li>
+ <li>reduced risk though improved control over version management</li>
+ <li>improved quality through reduction in class conflicts</li>
+
+ <li>improved security through repository management</li>
+ <li>low maintenance though centralized configuration</li>
+ </ol>
+
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/overview/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ Copyright 2004 Stephen McConnell
+ Copyright 2004 Niclas Hedhman
+ Copyright 2005 David Leangen
+
+ 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="Features and Benefits" href="index.html"/>
+ <item name="Dynamic Retrieval" href="retrieval.html"/>
+ <item name="Classloader Construction" href="classloading.html"/>
+ <item name="Plugin Management" href="management.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/overview/retrieval.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/retrieval.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Products</title>
+ </properties>
+
+ <body>
+ <section name="Transit Resource Management System">
+
+ <subsection name="Features and Benefits">
+
+ <p>
+ The core of the Transit product is a URL protocol handler which
serves as
+ the basic construct on which classloader management in provided.
The classloader
+ creation services provide the framework with a simple plugin
framework.
+ </p>
+
+ <p>
+ Key features of the Transit system include:
+ </p>
+
+ <ol>
+ <li>high level of integration with the JVM</li>
+ <li>simple configuration model</li>
+ <li>small footprint</li>
+ <li>flexible event monitoring</li>
+ </ol>
+
+ <p>
+ Key benefits delivered by Transit include:
+ </p>
+
+ <ol>
+ <li>cost reduction on product deployment and upgrade</li>
+ <li>reduced risk though improved control over version management</li>
+ <li>improved quality through reduction in class conflicts</li>
+
+ <li>improved security through repository management</li>
+ <li>low maintenance though centralized configuration</li>
+ </ol>
+
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/artifact.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/artifact.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,32 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Artifact URI">
+
+ <p>
+ An artifact is a resource identified by an
+ artifact uri. Artifact <a href="../protocol/index.html">uris</a>
+ describe a resource type, group, name, and resource version. These
+ identifiers dissassociate the definition of an application from
+ the source of the resources needed to build and deploy the
+ application.
+ </p>
+
+ <p>
+ The following example artifact uri identifies a resource named
+ 'dpml-http-server' associated with the 'dpml/http' group, a
+ resource type called 'block' and a version value of 1024.
+ </p>
+
+ <source>artifact:block:dpml/http/dpml-http-server#1024</source>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/cache.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/cache.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Cache Management">
+
+ <p>
+ Resource are retrived from one or more repository
+ <a href="hosts.html">hosts</a> and maintained under a local
+ cache. The default location of the cache is
+ <code>${dpml.home}/cache</code> where the value of
+ <code>${dpml.home}</code> is either declared explicity via
+ the <code>DPM_HOME</code> environment variable or the
+ fallback default location <code>${user.home}/.dpml</code>.
+ </p>
+
+ <p>
+ Please see the <a href="/guide/setup/dpml.html">environment
+ setup guide</a> for additional information concerning the
+ declaration of the DPML_HOME and PATH environment variables.
+ The <a href="../properties/cache.html">cache properties</a>
+ page provides additional information concerning cache location
+ management and mechanism supporting cache controller customization.
+ </p>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/hosts.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/hosts.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+
+ <section name="Host Management">
+
+ <p>
+ Transit uses <a href="artifact.html">artifact uris</a> to identify
+ a resource. These identifiers are in turn mapped internally to a
+ a repository url (i.e. mapping identity to a location). Locations
+ are defined relative to one or more a Transit host.
+ </p>
+
+ <p>
+ Each Transit host declares a base url, an implementation strategy
+ (typically dealing with uri to url mapping), and policies concerning
+ the handling of timestamped resources.
+ </p>
+
+ <p>
+ The Transit <a href="../properties/hosts.html">hosts configuration</a>
+ enables the declaration of local file based repositories and remote
+ repositories accessible via http and https protocols.
+ </p>
+
+ <p>
+ Example of artifact retrival and remote repositories are included in
+ the <a href="/guide/transit/resources/index.html">Transit Guide</a>.
+ </p>
+
+ </section>
+
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,46 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+
+ <section name="Repository Enabled">
+
+ <p>
+ A repository enabled application is an application the leverages a
local
+ <a href="cache.html">cache</a> of <a
href="artifact.html">artifacts</a>.
+ Transit is the system infrastructure that provides support for
artifact
+ identification, retrieval, and related application functions such as
+ classloader construction and <a href="plugins.html">plugin</a>
management
+ required by repository enabled solutions.
+ </p>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/monitors.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/monitors.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Event Monitoring">
+
+ <p>
+ Internal events within the Transit system are forwarded to a set of
+ event routers, each dealing with a particular Transit sub-system.
Routers
+ forward events to registered monitors.
+ </p>
+
+ <img src="/images/transit/monitors.png"/>
+
+
+ <subsection name="Router/Monitor Types">
+
+ <table>
+ <tr><th>Type</th><th>Description</th></tr>
+ <tr>
+ <td>
+ <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/CacheMonitor.html">CacheMonitor</a></td>
+ <td>Handles events related to resource requests, modification of
the
+ local cache, and download failures.</td>
+ </tr>
+ <tr>
+ <td>
+ <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/ConnectionMonitor.html">
+ConnectionMonitor</a></td>
+ <td>Handles events dealing with the openning and closing of
connections.</td>
+ </tr>
+ <tr>
+ <td>
+ <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/NetworkMonitor.html">
+NetworkMonitor</a></td>
+ <td>Handles events dealing with network activitiy including
progressive
+ download activitiy and download completion.</td>
+ </tr>
+ <tr>
+ <td>
+ <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/RepositoryMonitor.html">
+RepositoryMonitor</a></td>
+ <td>Handles events dealing with plugin requests, plugin class
establishment, constructor
+ discovery, plugin instantiation, classloader creation, and
plugin error reporting.</td>
+ </tr>
+ </table>
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,37 @@
+<?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="Artifacts" href="artifact.html"/>
+ <item name="Cache Management" href="cache.html"/>
+ <item name="Local and Remote Hosts" href="hosts.html"/>
+ <item name="Classloaders and Plugins" href="plugins.html"/>
+ <item name="Event Monitoring" href="monitors.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/concepts/plugins.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/concepts/plugins.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <contributor email="dleangen AT dpml.net">David Leangen</contributor>
+ <title>DPML Concepts</title>
+ </properties>
+
+ <body>
+ <section name="Classloaders and Plugins">
+
+ <subsection name="Meta - Classloader Descriptor Resource">
+
+ <p>
+ Layer above the Transit artifact handler is a system that provides
+ support for the creation of classloaders. Classloaders are described
+ under a 'meta' file which is basically a list of artifact uris. The
+ meta file is itself normally referenced as an artifact which means
+ that the list is itself versioned, named, associated with a group,
and
+ dynamically resolvable.
+ </p>
+
+ <p><i>Example classloader descriptor artifact uri:</i></p>
+
+ <code>@METRO-PLUGIN-URI@</code>
+
+ <p>
+ The meta file declares api, spi and implementation jar files in
+ the form of artifact uris. Transit uses this infomation to
+ construct a classloader chain.
+ </p>
+
+ <img src="/images/transit/chain.png"/>
+
+ <p>
+ Meta files use a simple property file format to declare features of
+ of the classloader, including information used when resolving
plugins.
+ This information is normally created automatically using the
+ <a href="/products/magic/tasks/export.html">Export Task</a> from the
+ <a href="/products/magic/index.html">Magic</a> build system.
+ </p>
+
+ <p>
+ The following code fragment demonstrates the relativly simple
process of
+ creating a new classloader using Transit.
+ </p>
+
+<source>
+Repository repository = new StandardLoader();
+ClassLoader parent = getClass().getClassLoader();
+URI uri = new URI( "artifact:meta:dpml/examples/hello/hello-world#1.0.0" );
+ClassLoader classloader = repository.getClassloader( parent, uri );
+</source>
+
+ </subsection>
+
+ <subsection name="Plugin Management">
+
+ <p>
+ In addition to the structural classloader information - the meta file
+ may contain the declaration of a main class or and antlib resource
and
+ namespace. The antlib information is a special case used within the
+ Magic build system to support dynamic task loading. The main class
+ declaration is the entry point for classic plugin class loading
relative
+ to the established classloader.
+ </p>
+
+ <p>
+ The Transit repository service provides support for class creation
and
+ object instantiation. Class creation is typically used by
applications
+ that handle a particular semantics concerning a plugin model whereas
+ the Tranit object instantiation provides a simple but flexible model
+ suitable for control over selectable sub-system strategies (e.g. the
+ loading of a logging system or application runtime).
+ </p>
+
+ <p>
+ The following code fragment demonstrates the creation of a plugin
instance
+ using Transit's standard plugin loader.
+ </p>
+
+<source>
+ Repository repository = new StandardLoader();
+ ClassLoader parent = getClass().getClassLoader();
+ URI uri = new URI( "artifact:meta:dpml/examples/hello/hello-world#1.0.0" );
+ Object[] args = new Object[] { "Hello, World!" };
+ Object plugin = repository.getPlugin( parent, uri, args );
+</source>
+
+ <p>
+ Example of plugin loading and general plugin handling is provided
+ under the <a href="/guide/transit/plugins/index.html">Transit
Guide</a>.
+ </p>
+
+ </subsection>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,57 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 David Leangen
+ 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.
+-->
+
+<document verified="false">
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Products</title>
+ </properties>
+
+ <body>
+ <section name="Transit Resource Management System">
+
+
+ <p>
+ Transit provides a flexible framework for dynamically retrieving
+ system and application resources, constructing classloaders, and
+ managing plugins.
+
+ As a resource management system, Transit provides the foundation
+ for building repository-enabled applications.
+ </p>
+
+<!--
+ <subsection name="More Information">
+ <ul>
+ <li><a href="/guide/setup/index.html">installation</a></li>
+ <li><a href="/guide/transit/index.html">Transit Guide</a></li>
+ <li><a href="properties/index.html">properties
specifications</a></li>
+ <li><a href="protocol/index.html">artifact protocol</a></li>
+ <li><a href="launcher/index.html">application launcher</a></li>
+ </ul>
+ </subsection>
+-->
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,213 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<!--
+ Copyright 2005 Stephen McConnell
+
+ 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="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Transit Application Launcher">
+
+ <source>@TRANSIT-PLUGIN-URI@</source>
+
+ <subsection name="Overview">
+
+ <p>
+ The application launcher is a plugin established by the Transit handler
+ that is responsible for the deployment of application plugins. The
+ launcher is responsible for low-level debug tracing, assignment of a
+ shutdown hook, the instantiation and deployment of a target
+ application, and a number of utility tasks.
+ </p>
+ <p>
+ The transit application launcher may be initialized via a command line
script
+ or through direct invocation with a java programe.
+ </p>
+ <p><i>CLI Usage example:</i></p>
+<source>$ transit [-load uri] [arg1 arg2 arg3 ...]</source>
+ </subsection>
+
+ <subsection name="Bootstrap CLI Options">
+
+ <p>
+ The <code>-Xbootstrap</code> cli option is recognized by the Transit
Main class
+ and is used to establish the application launcher plugin uri.
+ </p>
+
+ <table>
+ <tr>
+ <th width="100">Option</th>
+ <th>Argument Type</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>-Xbootstrap</td>
+ <td>URI</td>
+ <td>
+ The uri of the application launcher to be used. This value is
normally
+ set by the transit commandline script. The value declared under
the script
+ is the artifact uri <code>"@TRANSIT-PLUGIN-URI@"</code>. The
loaded plugin is required
+ to handle the cli options described below.
+ </td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ <subsection name="Standard CLI Options">
+
+ <p>
+ The transit application launcher evaluates the supplied commandline
arguments
+ and processes only those arguments applicable to itself. Remaining
arguments
+ are forwarded on to the application that is the target of a launch
request.
+ </p>
+
+ <p>
+ The standard CLI Options recognized by the launcher are listed in
the following table.
+ </p>
+ <table>
+ <tr>
+ <th>Option</th>
+ <th width="170">Argument Type</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>-debug</td>
+ <td>none</td>
+ <td>
+ Enable stacktrace and debug message reporting.
+ </td>
+ </tr>
+ <tr>
+ <td>-lang</td>
+ <td>language code</td>
+ <td>A two-letter language code to provide hooks for I18N.</td>
+ </tr>
+ <!--
+ <tr>
+ <td>-get</td>
+ <td>none</td>
+ <td>
+ downloads the supplied artifacts into the local cache
+ </td>
+ </tr>
+ -->
+ <tr>
+ <td>-load</td>
+ <td>plugin uri</td>
+ <td>
+ Transit loads the (single) plugin from the supplied artifact
URI.
+ If the plugin is an instance of
<code>java.lang.Runnable</code>, it
+ will be started by the controller using the
<code>start()</code>
+ method. A shutdown hook is added to the newly loaded plugin
to
+ enable clean shutdown together with the transit instance.
+ <br/><br/>For example, Metro is started via:
+ <br/><code>transit -load @METRO-PLUGIN-URI@</code>
+ </td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ <subsection name="-XOptions">
+
+ <p>Supplimentary CLI arguments that are processed by the launcher
include:</p>
+
+ <table>
+ <tr>
+ <th>Option</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>-Xhelp</td>
+ <td>
+ Prints a help message on the available transit launcher plugin
CLI options
+ </td>
+ </tr>
+ <tr>
+ <td>-Xversion</td>
+ <td>
+ Prints version information of the transit launcher plugin
version
+ </td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ <subsection name="Deployment Model">
+
+ <p>Using information derived from system properties and command line
options, the
+ Transit Application Launcher will build up a map containing keys
and options
+ to be supplied as an optional constructor argument.</p>
+
+ <p>Constructor argument values populated by the launcher and
supplied to
+ the transit repository plugin handler are detailed in the
following table.</p>
+
+ <table>
+ <tr>
+ <th>Argument</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>Map</td>
+ <td>
+ Will be supplied with the Transit context map.
+ </td>
+ </tr>
+ <tr>
+ <td>String[]</td>
+ <td>
+ Will be supplied with the remaining command line arguments
following
+ removal of standard and -X cli options recognized by Transit.
+ </td>
+ </tr>
+ </table>
+
+ <p>Transit context map keys and values are detailed in the following
table.</p>
+
+ <table>
+ <tr>
+ <th>Key</th>
+ <th>Value</th>
+ </tr>
+ <tr>
+ <td>urn:transit.debug.policy</td>
+ <td>
+ A Boolean value declaring the debug policy.
+ </td>
+ </tr>
+ <tr>
+ <td>urn:transit.cli.args</td>
+ <td>
+ The non-processed cli arguments.
+ </td>
+ </tr>
+ </table>
+
+ </subsection>
+
+ </section>
+
+ </body>
+
+</document>
+

Added:
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,32 @@
+<?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>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,37 @@
+<?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="Repository Enabled" href="concepts/index.html"/>
+ <item name="Protocol Specification" href="protocol/index.html"/>
+ <item name="Application Launcher" href="launcher/index.html"/>
+ <item name="Properties" href="properties/index.html"/>
+ <item name="Javadocs" href="../../../@TRANSIT-DOCS-PATH@/index.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,76 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 2004 Niclas Hedhman
+ Copyright 2005 David Leangen
+
+ 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 verified="false">
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Cache Properties">
+ <p>
+ The transit system stores the downloaded resources
+ on your local file system. The cache provides DPML-enabled
+ applications with quickly retrieval of required resources.
+ </p>
+
+ <p>
+ When requested by your application, a cache manager will first
+ check the local cache for the required resource.
+ If the resource is not available in the local cache, the cache
manager
+ will then query each remote repository defined under the <a
href="hosts.html">
+ host configuration</a> until the resource is resolved.
+ </p>
+
+ <p>
+ Requests to remote repositories are conducted sequentially in order
of
+ priority, with the highest priority value queried first.
+ </p>
+
+ <subsection name="Properties" >
+ <table>
+ <tr>
+ <th>Property</th>
+ <th>Default Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>dpml.transit.cache.location</td>
+ <td><code>${dpml.home}/cache</code></td>
+ <td>The location of the cache system.</td>
+ </tr>
+ <tr>
+ <td>dpml.transit.cache.class</td>
+ <td>net.dpml.transit.artifact.FileCacheHandler</td>
+ <td>
+ The class that implements the cache handler interface
+ <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">net.dpml.transit.artifact.CacheHandler</a>.
+ </td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ </body>
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,357 @@
+<?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="Hosts Configuration">
+
+ <p>
+ A Resource Host is a place where Artifacts can be downloaded. Transit
+ is capable of handling many types of resource hosts. Conceptually,
you
+ only need to implement the
+ <code><a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/ResourceHost.html">
+ net.dpml.transit.artifact.ResourceHost</a></code> interface, and
+ specify the implementation class of the host handler.
+ host.
+ </p>
+
+ <p>
+ Resource hosts may be declared via XML (default) or property files.
+ </p>
+
+ <subsection name="XML Specification">
+
+ <p>
+ The hosts configuation files when full expanded contains multiple
&lt;host&gt;
+ element entries. The following example shows a host element with
all
+ elements declared:
+ </p>
+
+<source><![CDATA[
+<hosts>
+
+ <host href="http://www.dpml.net"; enabled="true">
+ <priority>20</priority>
+ <policy>fast</policy>
+ <trusted>false</trusted>
+ <class>net.dpml.transit.artifact.ClassicResourceHost</class>
+ <index href="index.idx">
+ <credentials>
+ <username>fred</username>
+ <password>blogs</password>
+ </credentials>
+ <scheme>basic</scheme>
+ <prompt>repository</prompt>
+ </host>
+
+</hosts>
+]]></source>
+
+ <p>
+ The default host configuration file is shown below, and find the
+ description of the elements in the <strong>properties</strong>
section
+ below.
+ </p>
+
+<source><![CDATA[
+<hosts>
+
+ <host dir="local/SNAPSHOT">
+ <priority>10</priority>
+ <trusted>true</trusted>
+ </host>
+
+ <host href="http://www.dpml.net/repository";>
+ <priority>20</priority>
+ </host>
+
+ <host href="http://www.ibiblio.org/maven";>
+ <priority>50</priority>
+ </host>
+
+ <host href="http://www.apache.org/dist/java-repository";>
+ <priority>70</priority>
+ </host>
+
+</hosts>]]></source>
+
+ </subsection>
+
+ <subsection name="Properties Specification">
+
+ <p>
+ If a host.xml file is not present, Transit will atempt to resolve
hosts using
+ a set of property based host descriptors. Property files describing
remote hosts
+ are based on the following property specification.
+ </p>
+
+ <table>
+ <tr>
+ <th>Property</th>
+ <th>Default Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.enabled</td>
+ <td>true</td>
+ <td>
+ If true, the remote host repository will be used. If false, it
+ will be skipped completely.
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.base</td>
+ <td></td>
+ <td>This defines the base URL of the remote host repository.</td>

+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.class</td>
+ <td>(see description)</td>
+ <td>
+ Defines the class to use for the management of the remote host.
+ If undefined the value defaults to
<code>net.dpml.transit.artifact.ClassicResourceHost</code>.
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.knowngroups</td>
+ <td></td>
+ <td>
+ A URL pointing to a file containing a line-separated list of
+ groups that are known to be installed on the remote host
+ repository. (named &lt;index&gt; in the hosts.xml file.)
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.username</td>
+ <td></td>
+ <td>The username required for the remote host.</td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.password</td>
+ <td></td>
+ <td>The password for the user required to access the remote
host.</td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.scheme</td>
+ <td></td>
+ <td>The authentication scheme used for the connection.</td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.prompt</td>
+ <td></td>
+ <td>
+ The authentication <strong>prompt</strong> or
+ <strong>realm</strong> sent by the server.
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.policy</td>
+ <td>fast</td>
+ <td>
+ Download policy. "fast"=if the artifact exist in the cache, use
+ it.
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.priority</td>
+ <td>80</td>
+ <td>
+ The priority defines which host should take precedence over
+ another host for obtaining the artifact. A lower number indicates
+ a higher priority.
+ </td>
+ </tr>
+ <tr>
+ <td>dpml.transit.resourcehost.trusted</td>
+ <td>false</td>
+ <td>
+ If true Transit shall assume that the host connection is trusted.
+ When set to "true" in conjunction with an https:// conection,
the
+ certificate chain of the host will be accepted unconditionally.
+ </td>
+ </tr>
+ <!--
+ <tr>
+ <td>dpml.transit.resourcehost.upload</td>
+ <td>false</td>
+ <td>
+ Upload policy. If true, writing a versioned artifact to its
+ output stream will also initiate an attempt to upload that
+ artifact to the remote host. SCP will be used, and username and
+ password will be used from the above property settings.
+ </td>
+ <td>Not Implemented</td>
+ </tr>
+ -->
+ </table>
+
+ </subsection>
+
+ <subsection name="Authorative Host">
+
+ <p>
+ The Transit system may be configured locally or remotely depending on
+ the value of the "dpml.transit.authority" property. The property
identifies
+ a remote or local path to the authorative configuration and is held
within a
+ file of the same name.
+ </p>
+
+ <p>Search sequence:</p>
+
+ <ol>
+ <li><code>${java.ext.dirs}/dpml.transit.authority</code></li>
+ <li><code>${dpml.home}/transit/dpml.transit.authority</code></li>
+ </ol>
+
+ <p>
+ In the "dpml.transit.authority" file, a single property
+ "dpml.transit.authority" is resolved to a URL of the
+ Authorative Host. If no protocol is given, it is assumed to be a
+ directory in the local file system relative to
+ <i>${dpml.home}/transit</i>.
+ </p>
+
+ <p>Default contents of dpml.transit.authority file:</p>
+
+<source>
+dpml.transit.authority=authority/
+</source>
+
+ <p>The default value of the above is equivalent to:</p>
+
+<pre>
+ ${dpml.home}/transit/authority/
+</pre>
+
+ <p>
+ The configuration of available hosts is contained in the file:
+ </p>
+<pre>
+ ${dpml.transit.authority}/hosts.xml
+</pre>
+
+ <p>
+ Transit will also look for property based host descriptors. If the
+ value of ${dpml.transit.authority} is a file url host properties
files
+ will be resolved relative to the following path:
+ </p>
+
+<pre>
+ ${dpml.transit.authority}/hosts/*.*
+</pre>
+ <p>
+ All files found in the hosts/ directory will be read one by one.
+ The priority property will determine in which order the hosts are
+ queried for artifacts.
+ </p>
+ <p>
+ If the location is a remote URL, it will read the file
+ "index.lst" at that location. "index.lst" must contain a line
+ separated list of files that can be read at the location,
containing
+ the resource host defintions.
+ </p>
+
+ </subsection>
+
+ <!--
+ <subsection name="Properties" >
+ <p>
+ The following properties must be located in the file authorative
host
+ configuration file, default file location is
+ ${dpml.home}/transit/authority/transit.conf
+ </p>
+ <table>
+ <tr>
+ <th>Property</th>
+ <th>Default Value</th>
+ <th>Description</th>
+ <th>Note</th>
+ </tr>
+ <tr>
+ <td>dpml.transit.authority.checksum.required</td>
+ <td>false</td>
+ <td>
+ If true, artifacts that doesn't have a valid checksum will not
be
+ loaded.
+ </td>
+ <td><strong>Not Implemented.</strong></td>
+ </tr>
+ <tr>
+ <td>dpml.authority.checksum.from.trusted</td>
+ <td>true</td>
+ <td>
+ If true, checksums will only be downloaded from the trusted
+ repository hosts. This increases the security against spoofed
+ codebases, by ensuring that the checksum of trusted host
matches
+ the downloaded artifact from the non-trusted host. NOTE! It is
+ still possible (although difficult) to create a codebase
artifact
+ with a matching checksum, so for better security, please use
+ signed codebases and a web of trust or a CA.
+ </td>
+ <td><strong>Not Implemented.</strong></td>
+ </tr>
+ <tr>
+ <td>dpml.transit.authority.signature.required</td>
+ <td>false</td>
+ <td>
+ If true, artifacts must be signed or the artifact will not
+ be loaded. PGP signatures is the default requirement, but
+ other signature system should be supported in the future.
+ Signatures increases the trust level by many magnitudes. By
+ installing signed keys it is fairly easy to establish a web of
+ trust, without spending money on expensive certificates.
+ </td>
+ <td><strong>Not Implemented.</strong></td>
+ </tr>
+ <tr>
+ <td>dpml.transit.authority.signature.anonymous.allow</td>
+ <td>false</td>
+ <td>
+ If true, anonymous signatures will be allowed. Anonymous
+ signatures are those that does not belong in the web of trust
+ nor lead to a known CA.
+ </td>
+ <td><strong>Not Implemented.</strong></td>
+ </tr>
+ <tr>
+ <td>dpml.transit.authority.signature.from.trusted</td>
+ <td>true</td>
+ <td>
+ If true, signatures will only be downloaded from the trusted
+ repository hosts. This increases the security, especially if
+ anonymous signatures are allowed, to ensure that code bases
are
+ not spoofed.
+ </td>
+ <td><strong>Not Implemented.</strong></td>
+ </tr>
+ </table>
+ </subsection>
+ -->
+
+ </section>
+ </body>
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/properties/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/properties/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!--
+ Copyright 2004 Niclas Hedhman
+ Copyright 2005 David Leangen
+
+ 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 verified="false">
+ <properties>
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <author email="david.leangen AT konova.com">David Leangen</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+
+ <section name="Transit Properties">
+
+ <p>
+ Transit provides several configuration properties.
+ </p>
+
+ <p>
+ You can define your own configuration for:
+ <ul>
+ <li><a href="cache.html">your local cache</a></li>
+ <li><a href="hosts.html">remote hosts</a></li>
+ <li><a href="runtime.html">runtime properties</a></li>
+ </ul>
+ </p>
+
+ </section>
+ </body>
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/properties/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/properties/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,35 @@
+<?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>Magic</title>
+
+ <body>
+
+ <menu>
+ <item name="Cache Properties" href="cache.html"/>
+ <item name="Host Config Properties" href="hosts.html"/>
+ <item name="Runtime Properties" href="runtime.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,67 @@
+<?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="Runtime Properties">
+
+ <p>
+ In addition to the classic protocol handling, Transit provides
support
+ for the deployment of a runtime application via the
+ <a href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/Main.html">
+ Transit Main</a> handler class. This class looks for the
+ "dpml.transit.bootstrap.uri" system property and value corresponding
to
+ a uri of a bootstrap plugin that handles the deployment of
application
+ plugins (the bootstrap uri may be overriden with the -Xbootstrap cli
+ argument in command-line scenarios).
+ </p>
+
+ <subsection name="Properties">
+ <table>
+ <tr>
+ <th>Property</th>
+ <th>Default Value</th>
+ <th>Description</th>
+ </tr>
+ <tr>
+ <td>dpml.transit.bootstrap.uri</td>
+ <td><a href="../launcher/index.html">plugin</a></td>
+ <td>URI of an application launcher plugin. The plugin handles
+ the loading and deployment of application plugins such as
+ the metro component managment platform cli handler and other
+ application hanlders.</td>
+ </tr>
+ </table>
+ </subsection>
+
+ </section>
+
+ </body>
+
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/protocol.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/protocol.xml
Mon Jan 10 12:03:10 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 verified="false">
+ <author email="niclas AT hedhman.org">Niclas Hedhman</author>
+ <title>DPML Products</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/technical/protocol/classic.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/protocol/classic.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,84 @@
+<?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 - Classic">
+ <p>
+ The Classic resource host management model is based on the
+ conventions popularized by the maven platform and subsequently used
+ within the Apache Software Foundation as a format for repository
+ layout. The Classic layout can be viewed as a super-set of the
+ Maven model in that Transit implementation fully supports unlimited
+ group segmentation.
+ </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 Classic 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 Classic 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/technical/protocol/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/protocol/index.xml
Mon Jan 10 12:03:10 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/technical/protocol/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
Mon Jan 10 12:03:10 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="Classic Repository Layout" href="classic.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/tasks/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/tasks/index.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,47 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Transit for Ant">
+
+ <subsection name="Namespace">
+
+<source>antlib:net.dpml.magic</source>
+
+ </subsection>
+
+ <subsection name="Description">
+
+ <p>
+ Transit provides two ant tasks that provide the entry point to
transit
+ based repository access. These include the init task and the plugin
task.
+ The init task is used to established a number of transit related ant
+ properties and the plugin task is used to load antlibs, taskdefs,
typedefs
+ and build listeners using classloaders established relative to
resources
+ managed by the transit system.
+ </p>
+
+ <p><i>Example build file:</i></p>
+
+<pre><![CDATA[
+<project name="example"
+ xmlns:magic="antlib:net.dpml.magic">
+
+ <transit:init/>
+ <import file="${dpml.templates}/standard.xml"/>
+
+</project>
+]]></pre>
+
+
+ </subsection>
+
+ </section>
+ </body>
+</document>
+

Added:
development/main/central/site/src/docs/products/transit/technical/tasks/init.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/tasks/init.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,45 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Initialization Task">
+
+ <p>
+ The init task is used to establish the transit initial context
+ and from this a small number of properties that can be used in
+ a build file.
+ </p>
+
+ <p><i>Example build file:</i></p>
+
+<source><![CDATA[
+<project name="example"
+ xmlns:magic="antlib:net.dpml.magic">
+
+ <transit:init/>
+
+ <echo message="Home: ${dpml.home}"/>
+ <echo message="Cache: ${dpml.cache}"/>
+ <echo message="Templates: ${dpml.templates}"/>
+ <echo message="Docs: ${dpml.docs}"/>
+
+</project>
+]]></source>
+
+ <p><i>Output:</i></p>
+<pre><![CDATA[
+ [echo] Home: C:\system\dpml
+ [echo] Cache: C:\system\dpml\main
+ [echo] Templates: C:\system\dpml\templates
+ [echo] Docs: C:\system\dpml\docs
+]]></pre>
+
+ </section>
+ </body>
+</document>
+

Added:
development/main/central/site/src/docs/products/transit/technical/tasks/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/tasks/navigation.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+
+<!--
+ Copyright 2004 Stephen McConnell
+
+ 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>Magic</title>
+
+ <body>
+
+ <menu>
+ <item name="Init" href="init.html"/>
+ <item name="Plugin" href="plugin.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/tasks/plugin.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/tasks/plugin.xml
Mon Jan 10 12:03:10 2005
@@ -0,0 +1,39 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Plugin Task">
+
+ <p>
+ The plugin task locates plugin meta-data, and from that data, creates
+ a classloader, loads the plugin from the repository, and declares to
ant
+ any tasks, taskdefs, and/or listeners that the user declares.
+ </p>
+
+ <p><i>Example of a request to load an antlib.</i></p>
+
+<source><![CDATA[
+ <magic:plugin uri="artifact:meta:dpml/magic/dpml-magic-core#SNAPSHOT">
+ <antlib resource="net/dpml/magic/antlib.xml"
urn="plugin:dpml/magic/dpml-magic-core"/>
+ </magic:plugin>
+]]></source>
+
+ <p><i>Example of a request to load and register a task
definition.</i></p>
+
+<source><![CDATA[
+ <magic:plugin uri="${spec}">
+ <task class="net.dpml.magic.doc.DocTask" name="docs"/>
+ </magic:plugin>
+ <docs/>
+]]></source>
+
+ </section>
+ </body>
+
+</document>
+



  • svn commit: r1432 - in development/main/central/site/src/docs/products: . transit transit/concepts transit/launcher transit/overview transit/properties transit/protocol transit/tasks transit/technical transit/technical/concepts transit/technical/launcher transit/technical/properties transit/technical/protocol transit/technical/tasks, dleangen, 01/10/2005

Archive powered by MHonArc 2.6.24.

Top of Page