Skip to Content.
Sympa Menu

notify-dpml - svn commit: r1491 - in development/main/central/site/src/docs/products/transit: . overview technical technical/cache technical/hosts technical/launcher technical/monitors technical/properties technical/protocol technical/repository

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: r1491 - in development/main/central/site/src/docs/products/transit: . overview technical technical/cache technical/hosts technical/launcher technical/monitors technical/properties technical/protocol technical/repository
  • Date: Sun, 16 Jan 2005 15:03:37 +0100

Author: mcconnell
Date: Sun Jan 16 15:03:37 2005
New Revision: 1491

Removed:

development/main/central/site/src/docs/products/transit/technical/properties/
Modified:
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/artifact.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/plugins.xml

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

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

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

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

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

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

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

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

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

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

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

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

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

development/main/central/site/src/docs/products/transit/technical/repository/index.xml
Log:
Close up all documentation (removal of non-final stuff, clean up formatting
in some pages, removal of pending comments, removal of headers without
comments, fix links, removal of verified tags). Next step is completion of
the repository service page.

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 Sun
Jan 16 15:03:37 2005
@@ -1,58 +1,51 @@
<?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
-
+ 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>
+<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>
+ </properties>

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


<p>
- Transit provides a flexible framework for:
- <ul>
- <li><a href="overview/artifact.html">dynamically retrieving</a>
system and application resources</li>
- <li><a href="overview/classloading.html">constructing</a>
classloaders</li>
- <li><a href="overview/plugins.html">managing</a> plugins</li>
- </ul>
- </p>
-
- <p>
- As a resource management system, Transit provides the foundation for
building
- <a href="overview/index.html">repository-enabled applications</a>.
+ Transit provides a flexible framework for dynamically
+ <a href="overview/artifact.html">retrieving</a>
+ system and application resources, constructing
+ <a href="overview/classloading.html">classloaders</a>, and
+ managing <a href="overview/plugins.html">plugins</a>.
+
+ As a resource management system, Transit provides the foundation
+ for building <a href="overview/index.html">repository-enabled</a>
+ applications.
</p>

<img src="/images/transit/repositories.png"/>
-
- <p>
- Learn more about
- <a href="overview/index.html">Transit features and benefits</a>.
- </p>
-
+
</section>
</body>
</document>

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
Sun Jan 16 15:03:37 2005
@@ -28,8 +28,10 @@
<menu>
<item name="Product Overview" href="overview/index.html"/>
<item name="Product Specifications" href="technical/index.html"/>
+ <!--
<item name="Glossary (to be moved...)"
href="../../@CENTRAL-SITE-GLOSSARY-PATH@"/>
<item name="Concepts (to be moved...)"
href="../../@CENTRAL-SITE-CONCEPTS-PATH@"/>
+ -->
</menu>

</body>

Modified:
development/main/central/site/src/docs/products/transit/overview/artifact.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/overview/artifact.xml
(original)
+++
development/main/central/site/src/docs/products/transit/overview/artifact.xml
Sun Jan 16 15:03:37 2005
@@ -7,7 +7,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body verified="true">
<section name="Dynamic Artifact Retrieval">

<p>
@@ -19,6 +19,7 @@
</p>

<subsection name="Artifact URI">
+
<p>
Each artifact has a unique identifier conforming to the Transit
<a href="../technical/protocol/index.html">protocol
specification</a>.
@@ -39,16 +40,6 @@
</p>

<p>
- Typically, an artifact is a JAR file, a
- <a invalid="true" href="">meta</a> file,
- or a <a
href="../../metro/composition/directives/container/index.html">
- block</a> descriptor file.
- However, there is no limitation to the type of resource that an
artifact
- can be. Essentially, you can use the Transit system to manage
virtually
- any type of resource.
- </p>
-
- <p>
The purpose of the group is to avoid naming conflicts in the
artifact
name space. The top level group should be a distinguishable and
well
accepted name of the organisation, and any sub groups to be decided
@@ -83,10 +74,6 @@

</subsection>

- <subsection name="Artifact Retrieval">
-
- </subsection>
-
</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
Sun Jan 16 15:03:37 2005
@@ -28,7 +28,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body verified="true">
<section name="Classloader Construction">

<p>

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
Sun Jan 16 15:03:37 2005
@@ -28,7 +28,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body verified="true">

<section name="Product Overview">

@@ -42,9 +42,7 @@
Although a fundamental issue, classloading has remained
a rather obscure topic. Not surprisingly, many Java projects fail
to manage classloaders effectively.
- </p>

- <p>
Transit provides a solution to this problem.
</p>

@@ -56,7 +54,7 @@
independent way. That means, applications don't need to be concerned
over
where the jars and other resources are located, whether on the local
file
system, on LAN servers or somewhere on the Internet.
- This allows an application to provide extendability, hot-redeploy
+ This allows an application to provide extendability, hot-redeployment
and more advanced services.
</p>

@@ -65,10 +63,10 @@
Java application.
</p>

+<!--
<subsection name="Features and Benefits">
<a name="features"/>

-<!--
<p>
Key features of the Transit system include:
</p>
@@ -91,8 +89,8 @@
<li>improved security through repository management</li>
<li>low maintenance though centralized configuration</li>
</ol>
--->
</subsection>
+-->

</section>


Modified:
development/main/central/site/src/docs/products/transit/overview/plugins.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/overview/plugins.xml
(original)
+++
development/main/central/site/src/docs/products/transit/overview/plugins.xml
Sun Jan 16 15:03:37 2005
@@ -7,7 +7,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body verified="true">
<section name="Plugin Management">

<p>
@@ -33,11 +33,12 @@
using Transit's standard plugin loader.
</p>
<p>
- We create a API project called hello-api, which contains this
advanced
+ We create a API project called hello-api, which contains the
following
interface.
</p>
<source>
-/** API of the Hello service.
+/**
+ * API of the Hello service.
*/
public interface Hello
{
@@ -49,27 +50,30 @@
hello-impl.
</p>
<source>
-/** Implementation of the Hello API.
+/**
+ * Implementation of the Hello API.
*/
public class HelloImpl
implements Hello
{
- private String m_Message;
+ private String m_message;

public Hello( String message )
{
- m_Message = message;
+ m_message = message;
}

public void announce()
{
- System.out.println( m_Message );
+ System.out.println( m_message );
}
}
</source>
- <p>
- so we need to do the following from the class that loads the
plugin;
- </p>
+
+ <p>
+ so we need to do the following from the class that loads the plugin;
+ </p>
+
<source>
Repository repository = new StandardLoader();
ClassLoader parent = getClass().getClassLoader();
@@ -144,7 +148,7 @@
then the Classloader in question is not created.
</p>
<p>
- Example of plugin loading and general plugin handling is provided
+ Examples of plugin loading and general plugin handling is provided
under the <a href="/guide/transit/plugins/index.html">Transit
Guide</a>.
</p>
</section>

Modified:
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/cache/index.xml
Sun Jan 16 15:03:37 2005
@@ -7,7 +7,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Cache Management">

<p>

Modified:
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/cache/properties.xml
Sun Jan 16 15:03:37 2005
@@ -18,14 +18,14 @@
limitations under the License.
-->

-<document verified="false">
+<document>
<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 verified="false">
+ <body>
<section name="Cache Properties">
<p>
The transit system stores the downloaded resources

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/authorative.xml
Sun Jan 16 15:03:37 2005
@@ -23,7 +23,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="true">
+ <body>

<section name="Authorative Host">


Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/classic.xml
Sun Jan 16 15:03:37 2005
@@ -23,7 +23,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="true">
+ <body>
<section name="Resource Host - Classic Layout">
<p>
The Classic resource host management model is based on the

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/hosts.xml
Sun Jan 16 15:03:37 2005
@@ -23,7 +23,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Hosts Configuration">

<p>

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/index.xml
Sun Jan 16 15:03:37 2005
@@ -7,13 +7,13 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <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
+ are in turn mapped internally to a repository url (i.e. mapping
identity to a location). Locations are defined relative to one or
more hosts.
</p>
@@ -22,9 +22,6 @@
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

Modified:
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/hosts/properties.xml
Sun Jan 16 15:03:37 2005
@@ -23,7 +23,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Host Properties">

<p>

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
Sun Jan 16 15:03:37 2005
@@ -20,7 +20,7 @@
limitations under the License.
-->

-<document verified="false">
+<document>
<properties>
<author email="mcconnell AT dpml.net">Stephen McConnell</author>
<author email="niclas AT hedhman.org">Niclas Hedhman</author>
@@ -28,9 +28,20 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Transit Reference Specifications">

+ <p>
+ The section contains the formal specification of the Transit system.
+ This includes the description of the <a
href="protocol\index.html">artifact protocol</a>
+ (a uri that can be used to construct a url which in turn can be used
to resolve
+ an artifact to a locally cached resource), the underlying <a
href="cache\index.html">
+ cache</a> management system and associated <a
href="hosts/index.html">hosts</a>. In
+ addition, the specification cover the transit <a
href="monitors/index.html">event</a>
+ monitoring system, the <a href="repository/index.html">repository
service</a> and the
+ application <a href="launcher/index.html">launcher</a>.
+ </p>
+
</section>
</body>
</document>

Modified:
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/cli.xml
Sun Jan 16 15:03:37 2005
@@ -24,7 +24,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Commandline Options">

<subsection name="Bootstrap CLI Options">

Modified:
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/deployment.xml
Sun Jan 16 15:03:37 2005
@@ -24,7 +24,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Runtime Deployment Model">

<p>Using information derived from system properties and command line
options, the

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
Sun Jan 16 15:03:37 2005
@@ -24,7 +24,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Transit Application Launcher">

<source>@TRANSIT-PLUGIN-URI@</source>

Modified:
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/launcher/properties.xml
Sun Jan 16 15:03:37 2005
@@ -24,7 +24,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>

<section name="Runtime Properties">


Modified:
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/monitors/index.xml
Sun Jan 16 15:03:37 2005
@@ -7,7 +7,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Event Monitoring">

<p>
@@ -25,26 +25,26 @@
<tr><th>Type</th><th>Description</th></tr>
<tr>
<td>
- <a
href="../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/monitors/CacheMonitor.html">CacheMonitor</a></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">
+ <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">
+ <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">
+ <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>

Modified:
development/main/central/site/src/docs/products/transit/technical/protocol/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/protocol/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/protocol/index.xml
Sun Jan 16 15:03:37 2005
@@ -23,7 +23,7 @@
<title>DPML Transit</title>
</properties>

- <body verified="false">
+ <body>
<section name="Artifact Protocol">

<p>
@@ -38,9 +38,9 @@
two system properties.
</p>

- <subsection name="Official Format." >
+ <subsection name="Specification">
<p>
- The official format for the artifact protocol is as follows;
+ The official specification of the artifact protocol is as follows;
</p>
<source> artifact:[type]:[group]/[name]#[version] </source>
</subsection>
@@ -93,15 +93,13 @@
create them by instantiating the <code>java.net.URL</code> class,
and setting the protocol to "artifact" (no quotes).
</p>
-[[Look into where this should go]]
- <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>
+ <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>

</subsection>


Modified:
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/repository/index.xml
Sun Jan 16 15:03:37 2005
@@ -3,11 +3,10 @@
<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 verified="false">
+ <body>
<section name="Repository Service">

</section>



  • svn commit: r1491 - in development/main/central/site/src/docs/products/transit: . overview technical technical/cache technical/hosts technical/launcher technical/monitors technical/properties technical/protocol technical/repository, mcconnell, 01/16/2005

Archive powered by MHonArc 2.6.24.

Top of Page