mcconnell 02/03/03 08:44:24
Modified: enterprise/tools/src/java/org/apache/avalon/excalibur/service
package.html
Added: enterprise/tools .cvsignore build.xml
Log:
no message
Revision Changes Path
1.1 jakarta-avalon-apps/enterprise/tools/.cvsignore
Index: .cvsignore
===================================================================
build
local.properties
dist
1.1 jakarta-avalon-apps/enterprise/tools/build.xml
Index: build.xml
===================================================================
<!--
PSS Service.
Copyright 2001-2002 OSM SARL, All Rights Reserved.
-->
<project name="tools" default="help" basedir=".">
<property file="local.properties"/>
<property file="build.properties"/>
<target name="help" >
<echo>
Description
-----------
Enterprise suite tools.
General Targets:
----------------
build - invokes the general build target
javadoc - javadoc API generation
dist - executes build, javadoc and support file creation
clean - destroy the build directory
install - upgrade merlin.jar in lib
</echo>
</target>
<property name="MAJOR" value="1"/>
<property name="MINOR" value="0"/>
<property name="MICRO" value="1"/>
<property name="VERSION" value="${MAJOR}.${MINOR}.${MICRO}"/>
<property name="enterprise" value=".." />
<property name="tools.path" value="${enterprise}/tools" />
<property name="tools.lib.path" value="${tools.path}/lib" />
<property name="merlin.jar" value="merlin.jar"/>
<property name="lib" value="lib" />
<property name="src" value="src" />
<property name="etc" value="${src}/etc" />
<property name="build" value="build" />
<property name="dist" value="dist" />
<property name="javadoc.root.path" value="${dist}/javadoc" />
<property name="avalon.href" value="http://jakarta.apache.org/avalon/api/";
/>
<property name="jdk.href" value="http://java.sun.com/j2se/1.4/docs/api/"; />
<property name="overview.html" value="${tools.path}/etc/overview.html" />
<!-- demo configuration -->
<property name="demo.verbose" value="false" />
<property name="demo.priority" value="debug" />
<!-- classpath -->
<path id="project.classpath">
<fileset dir="${tools.lib.path}">
<include name="*.jar" />
</fileset>
</path>
<!-- MAIN TARGETS -->
<target name="all" depends="clean,dist,examples"/>
<target name="build" depends="merlin"/>
<target name="dist" depends="build,javadoc,support"/>
<target name="install.context">
<available file="${tools.lib.path}" type="dir"
property="install.path.present"/>
</target>
<target name="install" depends="install.context,build"
if="install.path.present">
<copy todir="${tools.lib.path}">
<fileset dir="${dist}">
<include name="${merlin.jar}"/>
</fileset>
</copy>
</target>
<target name="clean">
<delete dir="${build}"/>
<delete dir="${dist}"/>
</target>
<!-- PREPARE -->
<target name="prepare" >
<mkdir dir="${build}" />
<mkdir dir="${build}/src" />
<mkdir dir="${build}/lib" />
<mkdir dir="${dist}" />
</target>
<!-- MERLIN TOOL -->
<target name="merlin.context" depends="prepare">
<mkdir dir="dist"/>
<uptodate property="merlin.uptodate" targetfile="${dist}/${merlin.jar}">
<srcfiles dir="${src}/java">
<include name="org/apache/**/*.*"/>
</srcfiles>
<srcfiles dir="${etc}">
<include name="loader.mf"/>
</srcfiles>
</uptodate>
</target>
<target name="merlin" depends="merlin.context" unless="merlin.uptodate" >
<echo message="Building merlin Processor."/>
<javac debug="off" destdir="${build}/lib" deprecation="true"
target="1.2">
<classpath>
<path refid="project.classpath" />
</classpath>
<src path="${src}/java" />
<include name="org/apache/avalon/phoenix/**"/>
<include name="org/apache/avalon/excalibur/**"/>
</javac>
<copy todir="${build}/lib">
<fileset dir="${src}/java">
<include name="org/apache/avalon/excalibur/**/*.xinfo"/>
<include name="org/apache/avalon/excalibur/**/*.xml"/>
</fileset>
</copy>
<jar jarfile="${dist}/${merlin.jar}" basedir="${build}/lib"
manifest="${etc}/loader.mf" />
</target>
<target name="examples" depends="merlin">
<mkdir dir="${build}/demo"/>
<javac debug="off" destdir="${build}/demo" deprecation="true"
target="1.2">
<classpath>
<path refid="project.classpath" />
<pathelement location="${dist}/${merlin.jar}"/>
</classpath>
<src path="${src}/java" />
<include name="org/apache/demo/**"/>
</javac>
<copy todir="${build}/demo">
<fileset dir="${src}/java">
<include name="org/apache/demo/**/*.xinfo"/>
<include name="org/apache/demo/**/*.xml"/>
</fileset>
</copy>
<jar jarfile="${dist}/examples.jar" basedir="${build}/demo"
manifest="${etc}/demo.mf" />
</target>
<!-- UTILITY TARGETS -->
<target name="support">
<copy todir="${dist}">
<fileset dir="${etc}">
<include name="LICENSE.TXT"/>
<include name="README.TXT"/>
</fileset>
</copy>
</target>
<target name="javadoc" depends="prepare" >
<mkdir dir="${javadoc.root.path}" />
<copy todir="${javadoc.root.path}/">
<fileset dir="${etc}">
<include name="LICENSE.HTML"/>
<include name="license.css"/>
</fileset>
</copy>
<javadoc destdir="${javadoc.root.path}"
doctitle="<h1>Enterprise Suite Tools Package</h1>"
noindex="false" author="false"
use="true"
overview="${overview.html}"
windowtitle="Enterprise Tools"
bottom="<a href='[EMAIL PROTECTED]/LICENSE.HTML'/>License,
Disclaimer and due credits.</a>"
additionalparam="-breakiterator -J-Xmx128m"
packagenames="org.*"
excludepackagenames="org.apache.avalon.phoenix.*,org.apache.avalon.excalibur.service.ant,org.apache.demo"
>
<sourcepath path="${src}/java"/>
<classpath>
<path refid="project.classpath" />
<pathelement path="${dist}/${merlin.jar}" />
</classpath>
<link href="${jdk.href}" />
<link href="${avalon.href}" />
</javadoc>
</target>
<target name="loader.context">
<available property="merlin.available" file="${dist}/${merlin.jar}"/>
</target>
<target name="loader.defintion" depends="loader.context"
if="merlin.available">
<taskdef name="load"
classname="org.apache.avalon.excalibur.service.ant.Load">
<classpath>
<pathelement location="${dist}/${merlin.jar}"/>
<pathelement location="${tools.lib.path}/avalon-framework.jar"/>
<pathelement location="${tools.lib.path}/logkit.jar"/>
</classpath>
</taskdef>
</target>
<target name="demo" depends="loader.defintion,examples"
if="merlin.available">
<load target="org.apache.demo.ReferralBlock" priority="${demo.priority}"
disposal="false" verbose="${demo.verbose}">
<classpath>
<fileset dir="${dist}">
<include name="merlin.jar"/>
</fileset>
<fileset dir="${lib}">
<include name="avalon-framework.jar"/>
<include name="logkit.jar"/>
</fileset>
</classpath>
<!--
For all of the jar files in the fileset, load the jar file
into the classloader.
-->
<fileset dir="${dist}">
<include name="examples.jar"/>
</fileset>
</load>
</target>
</project>
1.2 +33 -6
jakarta-avalon-apps/enterprise/tools/src/java/org/apache/avalon/excalibur/service/package.html
Index: package.html
===================================================================
RCS file:
/home/cvs/jakarta-avalon-apps/enterprise/tools/src/java/org/apache/avalon/excalibur/service/package.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- package.html 3 Mar 2002 15:45:58 -0000 1.1
+++ package.html 3 Mar 2002 16:44:24 -0000 1.2
@@ -6,15 +6,42 @@
<tr><td width="20%"><b>Feature</b></td>
<td><b>Description</b></td></tr>
-<tr><td width="20%" valign="top">Service Composition</td>
+<tr><td valign="top">Service Composition</td>
<td>Handles automated composition of services based on declared component
dependencies.</td></tr>
-<tr><td>Default Configurations</td>
+<tr><td valign="top">Default Configurations</td>
<td>Provides support for configuration using component default
configurations together
with supplied configuration information using the CascadingConfiguration
model.</td></tr>
-<tr><td>Mixed execution modes</td>
+<tr><td valign="top">Mixed execution modes</td>
<td>Supports execution from the command line (main method), as a jar file,
as an Ant task,
-and as an embedded component.</td></tr>
+and as an embedded component.
+ <p><strong>java -jar form</strong></p>
+ <p>Execution using java -jar pattern requires the presence
+ of the following files under the same directory:</p>
+ <ul>
+ <li><code>merlin.jar</code>
+ <li><code>avalon-framework.jar</code>
+ <li><code>logkit.jar</code>
+ </ul>
+ <p>An example command line is shown below:</p>
+ <pre>
+ $ java -jar <strong>merlin.jar</strong> <supporting-jar-files>
+ -target <class-name>
+ </pre>
+ <p><strong>java -classpath form</strong></p>
+ <p>Execution using java -classpath pattern requires the inclusions
+ of the pipeline, framework and logkit jar files in the classpath
+ statement.</p>
+ <p>An example command line is shown below:</p>
+ <pre>
+ $ java -classpath
<strong>merlin.jar;avalon-framework.jar;logkit.jar</strong>
+ org.apache.avalon.excalibur.service.ServiceLoader
+ <supporting-jar-files> -target <class-name>
+ </pre>
+ </ul>
+
+</td></tr>
</table>
+
<h3>Component Creation</h3>
@@ -46,8 +73,8 @@
<p>For each component declared in a manifest, the implementation establishes
the available services
and dependencies based on information contained in an <code>.xinfo</code>
file. Given a component
-implementation class
<strong><code>org/apache/DirectoryBlock.class</code></strong> the
<code>Pipeline</code> processor
-will attempt to locate a
<strong><code>org/apache/DirectoryBlock.xinfo</code></strong> resource in the
jar file.</P>
+implementation class
<strong><code>org/apache/DirectoryBlock.class</code></strong> the
<code>Pipeline</code> processor will attempt to locate a
<strong><code>org/apache/DirectoryBlock.xinfo</code></strong>
+resource in the jar file.</P>
<pre>
<?xml version="1.0"?>
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
