Skip to Content.
Sympa Menu

notify-dpml - svn commit: r1496 - development/main/central/site/src/docs/products/transit/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: r1496 - development/main/central/site/src/docs/products/transit/technical/repository
  • Date: Sun, 16 Jan 2005 16:21:08 +0100

Author: mcconnell
Date: Sun Jan 16 16:21:08 2005
New Revision: 1496

Added:

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

development/main/central/site/src/docs/products/transit/technical/repository/descriptor.xml
Modified:

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

development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
Log:
breakout functions

Added:
development/main/central/site/src/docs/products/transit/technical/repository/chain.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/repository/chain.xml
Sun Jan 16 16:21:08 2005
@@ -0,0 +1,41 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Classloader Chain Creation">
+
+ <p>
+ A classloader chain is a sequence of classloaders that are created
+ by Transit using a meta descriptor file. The descriptor contains
+ the declaration of api, spi and implementation classloader jar files.
+ Each set of jar file entries represent the content of the respective
+ classloader. Entries are declared in the form of an artifact uri.
+ The classloader chain parent is supplied as an argument to the
+ <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Repository.html">
+ Repository</a> service interface and establishes the parent
+ classloader for the API classloader. The API classloader serves as
the
+ parent to the SPI classloader which in turn serves as the parent to
the IMPL
+ classloader.
+ </p>
+
+ <img src="/images/transit/chain.png"/>
+
+ <p><i>Example classloader creation:</i></p>
+ <pre>
+Repository repository = new <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/StandardLoader.html">StandardLoader()</a>;
+ClassLoader parent = getClass().getPluginClassLoader();
+URI uri = new URI( "@METRO-PLUGIN-URI@" );
+Classloader classloader = repository.getClassLoader( parent, uri );
+....
+ </pre>
+
+ </section>
+
+ </body>
+
+</document>

Added:
development/main/central/site/src/docs/products/transit/technical/repository/descriptor.xml
==============================================================================
--- (empty file)
+++
development/main/central/site/src/docs/products/transit/technical/repository/descriptor.xml
Sun Jan 16 16:21:08 2005
@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+
+<document>
+ <properties>
+ <author email="mcconnell AT dpml.net">Stephen McConnell</author>
+ <title>DPML Transit</title>
+ </properties>
+
+ <body>
+ <section name="Plugin Descriptor Creation">
+
+ <p>
+ Some applications may require information about a plugin prior to
loading the plugin. The
+ <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
+ class is an immutable datatype that serves this function. It
enables convinient access to
+ the api, spi and impl URI sets, and information related to the
declared main class or
+ resource and namespec declarations.
+ </p>
+
+ <p><i>Example plugin descriptor creation:</i></p>
+ <pre>
+Repository repository = new StandardLoader();
+URI uri = new URI( "@METRO-PLUGIN-URI@" );
+<a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
plugin = repository.getPluginDescriptor( uri );
+....
+ </pre>
+
+ </section>
+ </body>
+</document>

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 16:21:08 2005
@@ -11,60 +11,11 @@

<p>
The repository service provides support for the construction of
- classloader descriptors, classloader chains, plugin class loading,
+ classloader <a href="descriptor.html">descriptors</a>, classloader
+ <a href="chain.html">chains</a>, plugin class loading,
and plugin instantiation.
</p>

- <subsection name="Classloader Chain Creation">
-
- <p>
- A classloader chain is a sequence of classloaders that are created
- by Transit using a meta descriptor file. The descriptor contains
- the declaration of api, spi and implementation classloader jar files.
- Each set of jar file entries represent the content of the respective
- classloader. Entries are declared in the form of an artifact uri.
- The classloader chain parent is supplied as an argument to the
- <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Repository.html">
- Repository</a> service interface and establishes the parent
- classloader for the API classloader. The API classloader serves as
the
- parent to the SPI classloader which in turn serves as the parent to
the IMPL
- classloader.
- </p>
-
- <img src="/images/transit/chain.png"/>
-
- <p><i>Example classloader creation:</i></p>
- <pre>
-Repository repository = new <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/StandardLoader.html">StandardLoader()</a>;
-ClassLoader parent = getClass().getPluginClassLoader();
-URI uri = new URI( "@METRO-PLUGIN-URI@" );
-Classloader classloader = repository.getClassLoader( parent, uri );
-....
- </pre>
-
-
- </subsection>
-
- <subsection name="Plugin Descriptor Creation">
-
- <p>
- Some applications may require information about a plugin prior to
loading the plugin. The
- <a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
- class is an immutable datatype that serves this function. It
enables convinient access to
- the api, spi and impl URI sets, and information related to the
declared main class or
- resource and namespec declarations.
- </p>
-
- <p><i>Example plugin descriptor creation:</i></p>
- <pre>
-Repository repository = new StandardLoader();
-URI uri = new URI( "@METRO-PLUGIN-URI@" );
-<a
href="../../../../../@TRANSIT-DOCS-PATH@/net/dpml/transit/repository/Plugin.html">Plugin</a>
plugin = repository.getPluginDescriptor( uri );
-....
- </pre>
-
- </subsection>
-
</section>
</body>
</document>

Modified:
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
==============================================================================
---
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
(original)
+++
development/main/central/site/src/docs/products/transit/technical/repository/navigation.xml
Sun Jan 16 16:21:08 2005
@@ -25,6 +25,8 @@
<body>

<menu>
+ <item name="ClassLoader Chains" href="chain.html"/>
+ <item name="Plugin Descriptors" href="descriptor.html"/>
</menu>

</body>



  • svn commit: r1496 - development/main/central/site/src/docs/products/transit/technical/repository, mcconnell, 01/16/2005

Archive powered by MHonArc 2.6.24.

Top of Page