Skip to Content.
Sympa Menu

notify-dpml - svn commit: r1439 - in development/main/central/site/src/docs/products: magic/antlib magic/tasks transit transit/overview transit/technical transit/technical/cache transit/technical/concepts transit/technical/hosts transit/technical/launcher transit/technical/monitors transit/technical/properties transit/technical/protocol transit/technical/repository transit/technical/tasks

notify-dpml AT lists.ibiblio.org

Subject: DPML Notify

List archive

Chronological Thread  
  • From: mcconnell AT netcompartner.com
  • To: notify-dpml AT lists.ibiblio.org
  • Subject: svn commit: r1439 - in development/main/central/site/src/docs/products: magic/antlib magic/tasks transit transit/overview transit/technical transit/technical/cache transit/technical/concepts transit/technical/hosts transit/technical/launcher transit/technical/monitors transit/technical/properties transit/technical/protocol transit/technical/repository transit/technical/tasks
  • Date: Mon, 10 Jan 2005 15:40:06 +0100

Author: mcconnell
Date: Mon Jan 10 15:40:05 2005
New Revision: 1439

Added:
development/main/central/site/src/docs/products/magic/antlib/import.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/overview/artifact.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/overview/features.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/overview/plugins.xml
(contents, props changed)
development/main/central/site/src/docs/products/transit/technical/cache/

development/main/central/site/src/docs/products/transit/technical/cache/index.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/cache/navigation.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
(contents, props changed)
development/main/central/site/src/docs/products/transit/technical/hosts/

development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/hosts/navigation.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
(contents, props changed)
development/main/central/site/src/docs/products/transit/technical/monitors/

development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/monitors/navigation.xml
(contents, props changed)

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

development/main/central/site/src/docs/products/transit/technical/repository/index.xml
(contents, props changed)

development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
(contents, props changed)
Removed:

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

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

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/tasks/
Modified:
development/main/central/site/src/docs/products/magic/antlib/navigation.xml
development/main/central/site/src/docs/products/magic/tasks/reactor.xml
development/main/central/site/src/docs/products/transit/index.xml
development/main/central/site/src/docs/products/transit/navigation.xml

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/navigation.xml
development/main/central/site/src/docs/products/transit/technical/index.xml

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/cache.xml

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

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

development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
Log:
Restructure content to better separate overview material from specification
material and imporove a bunch of spec related stuff.

Added: development/main/central/site/src/docs/products/magic/antlib/import.xml
==============================================================================
--- (empty file)
+++ development/main/central/site/src/docs/products/magic/antlib/import.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,27 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<document>
+
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Magic</title>
+ </properties>
+
+ <body>
+ <section name="Import Task">
+
+ <p>
+ The import task imports an ant template file from a supplied
+ artifact uri.
+ </p>
+
+ <p><i>Example of a import request.</i></p>
+
+<source><![CDATA[
+ <magic:import uri="artifact:template:dpml/magic/standard"/>
+]]></source>
+
+ </section>
+ </body>
+
+</document>
+

Modified:
development/main/central/site/src/docs/products/magic/antlib/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/magic/antlib/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/magic/antlib/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -27,6 +27,7 @@
<menu>
<item name="Init" href="init.html"/>
<item name="Plugin" href="plugin.html"/>
+ <item name="Import" href="import.html"/>
</menu>

</body>

Modified:
development/main/central/site/src/docs/products/magic/tasks/reactor.xml
==============================================================================
--- development/main/central/site/src/docs/products/magic/tasks/reactor.xml
(original)
+++ development/main/central/site/src/docs/products/magic/tasks/reactor.xml
Mon Jan 10 15:40:05 2005
@@ -29,66 +29,165 @@

<p><i>
Example output when invoking the reactor from the root
- avalon directory:</i></p>
+ dpml directory:</i></p>

<pre>
default:
[x:reactor] Preparing build sequence.
------------------------------------------------------------------------
-[avalon/util/avalon-util-criteria]
-[avalon/logkit/avalon-logkit]
-[avalon/util/avalon-util-env]
-[avalon/util/avalon-util-defaults]
-[avalon/util/avalon-util-i18n]
-[avalon/util/avalon-util-exception]
-[avalon/repository/avalon-repository-api]
-[avalon/repository/avalon-repository-util]
-[avalon/repository/avalon-repository-spi]
-[avalon/repository/avalon-repository-main]
-[avalon/framework/avalon-framework-api]
-[avalon/framework/avalon-framework-legacy]
-[avalon/framework/avalon-framework-impl]
-[avalon/util/avalon-util-configuration]
-[avalon/meta/avalon-meta-api]
-[avalon/meta/avalon-meta-spi]
-[avalon/meta/avalon-meta-impl]
-[avalon/meta/avalon-meta-tools]
-[avalon/util/avalon-util-lifecycle]
-[avalon/test/avalon-test-playground]
-[avalon/test/avalon-test-components]
-[avalon/repository/avalon-repository-impl]
-[avalon/repository/avalon-repository-test]
-[avalon/logging/avalon-logging-api]
-[avalon/logging/avalon-logging-spi]
-[avalon/logging/avalon-logging-impl]
-[avalon/logging/avalon-logging-logkit-api]
-[avalon/logging/avalon-logging-logkit-datagram]
-[avalon/logging/avalon-logging-logkit-socket]
-[avalon/logging/avalon-logging-logkit-syslog]
-[avalon/logging/avalon-logging-log4j]
-[avalon/logging/avalon-logging-logkit-impl]
-[avalon/logging/avalon-logging-test]
-[avalon/test/avalon-test-teste]
-[avalon/test/avalon-test-testd]
-[avalon/test/avalon-test-testc]
-[avalon/test/avalon-test-testb]
-[avalon/test/avalon-test-testa]
-[avalon/test/avalon-test-includes]
-[avalon/test/avalon-test-dynamics]
-[avalon/util/avalon-util-extension-api]
-[avalon/util/avalon-util-extension-impl]
-[avalon/composition/avalon-composition-api]
-[avalon/composition/avalon-composition-spi]
-[avalon/composition/avalon-composition-impl]
-[avalon/activation/avalon-activation-api]
-[avalon/activation/avalon-activation-impl]
-[avalon/merlin/avalon-merlin-api]
-[avalon/merlin/avalon-merlin-impl]
-[avalon/merlin/avalon-merlin-cli]
-[avalon/runtime]
-[avalon/site]
-[avalon/repository/avalon-repository-cli]
-[avalon/tools/avalon-tools-magic]
+[artifact:jar:dpml/metro/public/dpml-service-api#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-configuration-api#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-parameters-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-parameters-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-configuration-impl#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-i18n#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-meta-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-meta-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-meta-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-meta-tools#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-api#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-util#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-logging-api#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-context-casting]
+[artifact:jar:dpml/transit/dpml-transit-main#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-extension-api#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-logging-data#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-context-api#SNAPSHOT]
+[artifact:jar:dpml/metro/protected/dpml-composition-api#SNAPSHOT]
+[artifact:jar:dpml/console/dpml-console-api#SNAPSHOT]
+[artifact:jar:dpml/console/dpml-console-commands#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-cli#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-exception#SNAPSHOT]
+[artifact:jar:dpml/util/dpml-util-criteria#SNAPSHOT]
+[artifact:jar:dpml/transit/dpml-transit-plugin#SNAPSHOT]
+[artifact:jar:dpml/transit/dpml-transit-installer#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/public/dpml-activity-api#SNAPSHOT]
+[artifact:jar:dpml/http/dpml-http-impl#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-tapestry#1.0]
+[artifact:jar:dpml/http/examples/hangman/hangman-api#2.0.0]
+[artifact:war:dpml/http/examples/hangman/hangman-view]
+[artifact:jar:dpml/http/examples/hangman/hangman-game#2.0.0]
+[artifact:block:dpml/http/examples/hangman/hangman-app#2.0.0]
+[artifact:jar:dpml/central/dpml-tutorial-config-defaults]
+[artifact:jar:dpml/db/dpml-db-api#SNAPSHOT]
+[artifact:jar:dpml/dbcp/dpml-dbcp-api#SNAPSHOT]
+[artifact:jar:dpml/dbcp/dpml-dbcp-impl#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-servlet#1.0]
+[artifact:jar:dpml/metro/private/dpml-system-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-util-defaults#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-criteria#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-datagram#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-syslog#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-log4j#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-context-impl#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-playground]
+[artifact:jar:dpml/metro/private/dpml-system-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-system-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-composition-spi#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-api#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-avalon-provider#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-metro-provider#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-activation-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-extension-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-composition-impl#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-config-injection]
+[artifact:block:dpml/central/dpml-tutorial-config-override]
+[artifact:jar:dpml/central/dpml-tutorial-selection]
+[artifact:jar:dpml/magic/dpml-magic-bootstrap#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-api#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-spi#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-typehandlers#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-publisher-api]
+[artifact:jar:dpml/central/dpml-tutorial-publisher-impl]
+[artifact:jar:dpml/central/dpml-tutorial-context-phased]
+[artifact:jar:dpml/jms/dpml-jms-api#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-config-block]
+[artifact:jar:dpml/central/dpml-tutorial-dependency-manual]
+[artifact:jar:dpml/jms/dpml-jms-impl#SNAPSHOT]
+[artifact:jar:dpml/jms/dpml-jms-test]
+[artifact:jar:dpml/magic/dpml-magic-core#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-upload#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-testa]
+[artifact:jar:dpml/test/dpml-test-teste]
+[artifact:jar:dpml/test/dpml-test-testd]
+[artifact:jar:dpml/test/dpml-test-testb]
+[artifact:jar:dpml/test/dpml-test-testc]
+[artifact:jar:dpml/test/dpml-test-includes]
+[artifact:jar:dpml/central/dpml-tutorial-dynamics]
+[artifact:jar:dpml/central/dpml-tutorial-dependency-auto]
+[artifact:block:dpml/http/dpml-http-webappserver#1.0]
+[artifact:block:dpml/http/dpml-http-static#1.0]
+[artifact:jar:dpml/magic/dpml-magic-doc#SNAPSHOT]
+[artifact:theme:dpml/magic/dpml-magic-themes-modern]
+[artifact:jar:dpml/test/dpml-test-testschema]
+[artifact:jar:dpml/test/dpml-test-dynamics]
+[artifact:jar:dpml/test/dpml-test-testcyclic]
+[artifact:jar:dpml/test/dpml-composition-test#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-magic-example#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-bar#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-publish#SNAPSHOT]
+[artifact:meta:dpml/test/dpml-magic-test#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-metro-unit#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-hello]
+[artifact:block:dpml/http/dpml-http-hash-basic#1.0]
+[artifact:jar:dpml/central/dpml-tutorial-location-api]
+[artifact:jar:dpml/central/dpml-tutorial-profiles]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-artifact]
+[artifact:jar:dpml/finder/dpml-finder-api#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-test-components]
+[artifact:jar:dpml/console/dpml-console-impl#SNAPSHOT]
+[artifact:jar:dpml/reflector/dpml-reflector-impl#SNAPSHOT]
+[artifact:block:dpml/reflector/dpml-reflector-blocks-standard#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-util#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-api#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-spi#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-mx4j#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-server#1.0]
+[artifact:jar:dpml/magic/dpml-magic-style#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-checkstyle#SNAPSHOT]
+[artifact:module:dpml/util/dpml-util#SNAPSHOT]
+[artifact:jar:dpml/magic/dpml-magic-eclipse#SNAPSHOT]
+[artifact:module:dpml/transit/dpml-transit#SNAPSHOT]
+[artifact:theme:dpml/magic/dpml-magic-themes-docbook.sf.net]
+[artifact:module:dpml/magic/dpml-magic#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-handler#SNAPSHOT]
+[artifact:jar:dpml/jmx/dpml-jmx-test]
+[artifact:jar:dpml/central/dpml-tutorial-main]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-cli]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-controller]
+[artifact:jar:dpml/central/dpml-tutorial-parameters]
+[artifact:jar:dpml/test/dpml-system-test#SNAPSHOT]
+[artifact:jar:dpml/finder/dpml-finder-impl#SNAPSHOT]
+[artifact:jar:dpml/metro/private/dpml-logging-logkit-socket#SNAPSHOT]
+[artifact:jar:dpml/test/dpml-logging-logkit-test#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-location-impl]
+[artifact:jar:dpml/central/dpml-tutorial-application-impl]
+[artifact:jar:dpml/http/dpml-http-test]
+[artifact:jar:dpml/test/dpml-logging-log4j-test#SNAPSHOT]
+[artifact:jar:dpml/metro/tools/dpml-metro-main#SNAPSHOT]
+[artifact:module:dpml/metro/dpml-metro#SNAPSHOT]
+[artifact:jar:dpml/central/dpml-tutorial-context-injection]
+[artifact:jar:dpml/central/dpml-tutorial-context-custom]
+[artifact:doc:dpml/central/dpml-central-site]
+[artifact:jar:dpml/central/dpml-tutorial-context-alias]
+[artifact:jar:dpml/central/dpml-tutorial-lifecycle-modern]
+[artifact:module:dpml/central/dpml-central#SNAPSHOT]
+[artifact:block:dpml/http/dpml-http-hash-form#1.0]
+[artifact:block:dpml/console/dpml-console-default#SNAPSHOT]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-plugin-simple]
+[artifact:jar:dpml/http/examples/hello/dpml-http-hello#2.0.0]
+[artifact:block:dpml/http/dpml-http-hash-clientcert#1.0]
+[artifact:block:dpml/http/dpml-http-hash-digest#1.0]
+[artifact:block:dpml/http/dpml-http-context#1.0]
+[artifact:module:dpml/http/dpml-http#SNAPSHOT]
+[artifact:block:dpml/reflector/dpml-reflector-blocks-complete#SNAPSHOT]
+[artifact:jar:dpml/db/dpml-db-hsql#SNAPSHOT]
+[artifact:jar:dpml/tutorial/dpml-transit-tutorial-extension]
+[artifact:jar:dpml/test/dpml-activation-test#SNAPSHOT]

....


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 15:40:05 2005
@@ -25,7 +25,7 @@
<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>
+ <title>DPML Transit</title>
</properties>

<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 15:40:05 2005
@@ -21,12 +21,12 @@

<project>

- <title>Transit</title>
+ <title>DPML Transit</title>

<body>

<menu>
- <item name="Product Overview" href="index.html"/>
+ <item name="Product Overview" href="overview/index.html"/>
<item name="Product Specifications" href="technical/index.html"/>
</menu>


Added:
development/main/central/site/src/docs/products/transit/overview/artifact.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/artifact.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,33 @@
+<?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 Transit</title>
+ </properties>
+
+ <body>
+ <section name="Dynamic Artifact Retrieval">
+
+ <p>
+ An artifact is a resource identified by an
+ artifact uri. The Artifact
+ <a href="../technical/protocol/index.html">protocol
specification</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>

Modified:
development/main/central/site/src/docs/products/transit/overview/classloading.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/overview/classloading.xml
(original)
+++
development/main/central/site/src/docs/products/transit/overview/classloading.xml
Mon Jan 10 15:40:05 2005
@@ -25,45 +25,52 @@
<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>
+ <title>DPML Transit</title>
</properties>

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

- <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>
+ <p>
+ Layered 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>

</section>
</body>

Added:
development/main/central/site/src/docs/products/transit/overview/features.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/features.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,66 @@
+<?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="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>
+
+ </section>
+ </body>
+</document>

Modified:
development/main/central/site/src/docs/products/transit/overview/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/overview/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/overview/index.xml
Mon Jan 10 15:40:05 2005
@@ -25,46 +25,63 @@
<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>
+ <title>DPML Transit</title>
</properties>

<body>
- <section name="Transit Resource Management System">
+
+ <section name="Product Overview">
+
+ <subsection name="Repository Enabled">
+
+ <p>
+ A repository enabled application is an application the leverages a
local
+ cache of artifacts backed by a formal repository model.
+ Transit is the system infrastructure that provides support for
artifact
+ identification, <a href="artifact.html">retrieval</a>, and related
+ application functions including
+ <a href="classloading.html">classloader</a> construction and
+ <a href="plugins.html">plugin</a> management required by repository
+ enabled solutions.
+ </p>
+
+ </subsection>

<subsection name="Features and Benefits">

- <p>
+ <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>

- <p>
+ <p>
Key features of the Transit system include:
- </p>
+ </p>

- <ol>
+ <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>
+ </ol>

- <p>
+ <p>
Key benefits delivered by Transit include:
- </p>
+ </p>

- <ol>
+ <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>
+ </ol>

</subsection>

</section>
+
</body>
</document>

Modified:
development/main/central/site/src/docs/products/transit/overview/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/overview/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/overview/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -26,10 +26,16 @@
<body>

<menu>
- <item name="Features and Benefits" href="index.html"/>
+
+ <!--
+ <item name="Features and Benefits" href="features.html"/>
<item name="Dynamic Retrieval" href="retrieval.html"/>
+ -->
+
+ <item name="Dynamic Retrieval" href="artifact.html"/>
<item name="Classloader Construction" href="classloading.html"/>
- <item name="Plugin Management" href="management.html"/>
+ <item name="Plugin Management" href="plugins.html"/>
+
</menu>

</body>

Added:
development/main/central/site/src/docs/products/transit/overview/plugins.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/overview/plugins.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,51 @@
+<?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 Transit</title>
+ </properties>
+
+ <body>
+ <section 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>
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
Mon Jan 10 15:40:05 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 Transit</title>
+ </properties>
+
+ <body>
+ <section name="Cache Management">
+
+ <p>
+ Resource are retrieved from one or more
+ <a href="../hosts/index.html">host</a> repositories
+ 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>DPML_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.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/cache/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/cache/navigation.xml
Mon Jan 10 15:40:05 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="Cache Properties" href="properties.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,80 @@
+<?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/index.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>
+ <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">
+ <code>FileCacheHandler</code>
+ </a>
+ </td>
+ <td>
+ The class that implements the cache handler interface.
+ </td>
+ </tr>
+ </table>
+ </subsection>
+ </section>
+ </body>
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,172 @@
+<?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="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 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/hosts/classic.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
Mon Jan 10 15:40:05 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 Layout">
+ <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/hosts/hosts.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,105 @@
+<?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.
+ </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>
+
+ </section>
+ </body>
+</document>
+
+
+

Added:
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,45 @@
+<?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 Transit</title>
+ </properties>
+
+ <body>
+
+ <section name="Host Management">
+
+ <p>
+ Transit uses artifact uris 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 hosts.
+ </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="hosts.html">hosts configuration</a>
+ enables the declaration of local file based repositories and remote
+ repositories accessible via http and https protocols. Host
+ configurations may also be declared using <a href="properties.html">
+ properties</a>. In both cases the source of the <a
href="authorative.html">
+ authorative configuration</a> may be managed locally or centralized
under
+ a remote location.
+ </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/hosts/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,36 @@
+<?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="Authorative Host" href="authorative.html"/>
+ <item name="Host Configuration" href="hosts.html"/>
+ <item name="Host Properties" href="properties.html"/>
+ <item name="Classic Repository Layout" href="classic.html"/>
+ </menu>
+
+ </body>
+
+</project>

Added:
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,140 @@
+<?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="Host Properties">
+
+ <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>
+
+ </section>
+ </body>
+</document>
+
+
+

Modified:
development/main/central/site/src/docs/products/transit/technical/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/index.xml
Mon Jan 10 15:40:05 2005
@@ -25,33 +25,12 @@
<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>
+ <title>DPML Transit</title>
</properties>

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

-
- <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/cli.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,142 @@
+<?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="Commandline Options">
+
+ <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>
+
+ </section>
+
+ </body>
+
+</document>
+

Added:
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,83 @@
+<?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="Runtime 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>
+
+ </section>
+
+ </body>
+
+</document>
+

Modified:
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/index.xml
Mon Jan 10 15:40:05 2005
@@ -29,181 +29,19 @@

<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
+ that is responsible for the deployment of a single application plugin.
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.
+ shutdown hook, the instantiation and deployment of the target
+ application.
</p>
<p>
- The transit application launcher may be initialized via a command line
script
- or through direct invocation with a java programe.
+ 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>
+<code>$ transit [-load uri] [arg1 arg2 arg3 ...]</code>

</section>


Modified:
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -25,6 +25,9 @@
<body>

<menu>
+ <item name="Commandline Options" href="cli.html"/>
+ <item name="Deployment Model" href="deployment.html"/>
+ <item name="Properties" href="properties.html"/>
</menu>

</body>

Added:
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
Mon Jan 10 15:40:05 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/monitors/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
Mon Jan 10 15:40:05 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 Transit</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/monitors/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/monitors/navigation.xml
Mon Jan 10 15:40:05 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>

Modified:
development/main/central/site/src/docs/products/transit/technical/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -25,11 +25,13 @@
<body>

<menu>
- <item name="Repository Enabled" href="concepts/index.html"/>
- <item name="Protocol Specification" href="protocol/index.html"/>
+ <item name="Artifact Protocol" href="protocol/index.html"/>
+ <item name="Cache Management" href="cache/index.html"/>
+ <item name="Local and Remote Hosts" href="hosts/index.html"/>
+ <item name="Event Monitors" href="monitors/index.html"/>
+ <item name="Repository Service" href="repository/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="Javadocs"
href="../../../../@TRANSIT-DOCS-PATH@/index.html"/>
</menu>

</body>

Modified:
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/properties/cache.xml
Mon Jan 10 15:40:05 2005
@@ -63,7 +63,7 @@
<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>.
+ <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/artifact/CacheHandler.html">net.dpml.transit.artifact.CacheHandler</a>.
</td>
</tr>
</table>

Modified:
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/properties/hosts.xml
Mon Jan 10 15:40:05 2005
@@ -30,7 +30,7 @@
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">
+ <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.

Modified:
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/properties/runtime.xml
Mon Jan 10 15:40:05 2005
@@ -31,7 +31,7 @@
<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">
+ <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

Modified:
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/protocol/navigation.xml
Mon Jan 10 15:40:05 2005
@@ -25,7 +25,6 @@
<body>

<menu>
- <item name="Classic Repository Layout" href="classic.html"/>
</menu>

</body>

Added:
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
Mon Jan 10 15:40:05 2005
@@ -0,0 +1,15 @@
+<?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 Transit</title>
+ </properties>
+
+ <body>
+ <section name="Repository Service">
+
+ </section>
+ </body>
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
Mon Jan 10 15:40:05 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>



  • svn commit: r1439 - in development/main/central/site/src/docs/products: magic/antlib magic/tasks transit transit/overview transit/technical transit/technical/cache transit/technical/concepts transit/technical/hosts transit/technical/launcher transit/technical/monitors transit/technical/properties transit/technical/protocol transit/technical/repository transit/technical/tasks, mcconnell, 01/10/2005

Archive powered by MHonArc 2.6.24.

Top of Page