mcconnell 2003/10/07 11:03:11
Added: merlin/kernel/unit .cvsignore maven.xml project.xml
merlin/kernel/unit/conf block.xml
merlin/kernel/unit/src/java/org/apache/avalon/merlin/unit
AbstractMerlinTestCase.java UnitException.java
UnitRuntimeException.java package.html
merlin/kernel/unit/src/test/org/apache/avalon/merlin/unit
Hello.java HelloComponent.java HelloComponent.xinfo
StandardTestCase.java
Log:
Abstract testcase incorporating an embedded merlin kernel.
Revision Changes Path
1.1 avalon/merlin/kernel/unit/.cvsignore
Index: .cvsignore
===================================================================
maven.log
velocity.log
build.properties
target
snapshot.properties
1.1 avalon/merlin/kernel/unit/maven.xml
Index: maven.xml
===================================================================
<project default="jar:install" xmlns:maven="jelly:maven" xmlns:j="jelly:core"
xmlns:util="jelly:util" xmlns:ant="jelly:ant">
<ant:property name="maven.jar.manifest.extensions.add" value="false"/>
<ant:property file="project.properties"/>
<preGoal name="jar:jar">
<maven:snapshot project="${pom}"/>
<j:set var="timestamp"
value="${snapshotSignature.substring(pom.artifactId.length)}"/>
<ant:property name="merlin.timestamp" value="${timestamp}"/>
<ant:echo file="${basedir}/snapshot.properties">
build.signature = ${snapshotSignature}
</ant:echo>
<j:forEach var="dep" items="${pom.dependencies}">
<j:if test="${dep.getId() != 'junit:junit'}">
<unzip src="${pom.getDependencyPath( dep.getId() )}"
dest="${maven.build.dir}/classes"/>
</j:if>
</j:forEach>
</preGoal>
<goal name="build" prereqs="jar:install">
<ant:property environment="env"/>
<ant:property name="merlinEnvironment" value="${env.MERLIN_HOME}"/>
<j:if test="${merlinEnvironment != ''}">
<ant:property name="merlin.home" value="${merlinEnvironment}"/>
</j:if>
<ant:property name="merlin.home" value="${user.home}/.merlin"/>
<copy toDir="${merlin.home}/bin/lib"
file="${maven.build.dir}/${maven.final.name}.jar"/>
</goal>
</project>
1.1 avalon/merlin/kernel/unit/project.xml
Index: project.xml
===================================================================
<?xml version="1.0" encoding="UTF-8"?>
<project>
<extend>${basedir}/../../project.xml</extend>
<groupId>merlin</groupId>
<id>merlin-unit</id>
<name>Merlin Unit Test</name>
<currentVersion>1.0</currentVersion>
<package>*</package>
<inceptionYear>2003</inceptionYear>
<shortDescription>Merlin Unit Test.</shortDescription>
<description>
Anstract unit test class.
</description>
<dependencies>
<dependency>
<groupId>avalon-framework</groupId>
<artifactId>avalon-framework-api</artifactId>
<version>4.1.5</version>
</dependency>
<dependency>
<groupId>avalon-framework</groupId>
<artifactId>avalon-framework-impl</artifactId>
<version>4.1.5</version>
</dependency>
<dependency>
<groupId>avalon-repository</groupId>
<artifactId>avalon-repository-spi</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-repository</groupId>
<artifactId>avalon-repository-impl</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>merlin</groupId>
<artifactId>merlin-kernel-spi</artifactId>
<version>3.1b1</version>
</dependency>
<dependency>
<groupId>merlin</groupId>
<artifactId>merlin-kernel-impl</artifactId>
<version>3.1b1</version>
</dependency>
<dependency>
<groupId>avalon-composition</groupId>
<artifactId>avalon-composition-api</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-composition</groupId>
<artifactId>avalon-composition-spi</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-composition</groupId>
<artifactId>avalon-composition-impl</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-activation</groupId>
<artifactId>avalon-activation-api</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-activation</groupId>
<artifactId>avalon-activation-spi</artifactId>
<version>1.0b1</version>
</dependency>
<dependency>
<groupId>avalon-activation</groupId>
<artifactId>avalon-activation-impl</artifactId>
<version>1.0b2</version>
</dependency>
<dependency>
<groupId>avalon-extension</groupId>
<artifactId>avalon-extension-spi</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<groupId>avalon-extension</groupId>
<artifactId>avalon-extension-impl</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<groupId>avalon-meta</groupId>
<artifactId>avalon-meta-api</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<groupId>avalon-meta</groupId>
<artifactId>avalon-meta-spi</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<groupId>avalon-meta</groupId>
<artifactId>avalon-meta-impl</artifactId>
<version>1.1</version>
</dependency>
<dependency>
<id>logkit</id>
<version>1.2</version>
</dependency>
<dependency>
<groupId>excalibur-lifecycle</groupId>
<artifactId>excalibur-lifecycle-api</artifactId>
<version>1.0</version>
</dependency>
<dependency>
<id>excalibur-i18n</id>
<version>1.1</version>
</dependency>
<dependency>
<id>excalibur-thread</id>
<version>1.1.1</version>
</dependency>
<dependency>
<id>excalibur-event</id>
<version>1.0.3</version>
</dependency>
<dependency>
<groupId>excalibur</groupId>
<artifactId>excalibur-util-concurrent</artifactId>
<version>1.3.1</version>
</dependency>
<dependency>
<id>excalibur-configuration</id>
<version>1.1</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>3.8.1</version>
<properties>
<classloader>root</classloader>
</properties>
</dependency>
<!-- mx4j dependecies -->
<dependency>
<groupId>mx4j</groupId>
<artifactId>mx4j-jmx</artifactId>
<version>1.1.1</version>
</dependency>
<dependency>
<groupId>mx4j</groupId>
<artifactId>mx4j-tools</artifactId>
<version>1.1.1</version>
</dependency>
</dependencies>
<build>
<sourceDirectory>src/java</sourceDirectory>
<unitTestSourceDirectory>src/test</unitTestSourceDirectory>
<unitTest>
<includes>
<include>**/*TestCase.*</include>
</includes>
<excludes>
<include>**/Abstract*.*</include>
</excludes>
<resources>
<resource>
<directory>${basedir}/src/test</directory>
<includes>
<include>**/*.dtd</include>
<include>**/*.properties</include>
<include>**/*.x*</include>
</includes>
</resource>
<resource>
<directory>${basedir}/conf</directory>
<targetPath>BLOCK-INF</targetPath>
<includes>
<include>block.xml</include>
</includes>
</resource>
</resources>
</unitTest>
<testResources></testResources>
<integrationUnitTestPatterns></integrationUnitTestPatterns>
<resources>
<resource>
<directory>${basedir}/src/java</directory>
<includes>
<include>**/*.dtd</include>
<include>**/*.properties</include>
<include>**/*.x*</include>
</includes>
</resource>
<resource>
<directory>${basedir}</directory>
<includes>
<include>snapshot.properties</include>
</includes>
</resource>
</resources>
<jars></jars>
</build>
</project>
1.1 avalon/merlin/kernel/unit/conf/block.xml
Index: block.xml
===================================================================
<container name="tutorial">
<classloader>
<classpath>
<repository>
<resource id="avalon-framework:avalon-framework-impl" version="4.1.5"/>
</repository>
</classpath>
</classloader>
<services>
<service type="org.apache.avalon.merlin.unit.Hello">
<source>hello</source>
</service>
</services>
<component name="hello" class="org.apache.avalon.merlin.unit.HelloComponent"/>
</container>
1.1
avalon/merlin/kernel/unit/src/java/org/apache/avalon/merlin/unit/AbstractMerlinTestCase.java
Index: AbstractMerlinTestCase.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 2002-2003 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
import java.io.File;
import java.io.InputStream;
import java.net.URL;
import java.net.URLClassLoader;
import java.util.List;
import java.util.ArrayList;
import java.util.StringTokenizer;
import java.util.Properties;
import java.util.Map;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
import java.lang.reflect.InvocationTargetException;
import org.apache.avalon.merlin.kernel.impl.DefaultKernel;
import org.apache.avalon.merlin.kernel.impl.DefaultKernelContext;
import org.apache.avalon.merlin.kernel.KernelContext;
import org.apache.avalon.merlin.kernel.Kernel;
import org.apache.avalon.activation.appliance.Appliance;
import org.apache.avalon.activation.appliance.Block;
import org.apache.avalon.repository.Repository;
import org.apache.avalon.repository.ProxyContext;
import org.apache.avalon.repository.impl.DefaultFileRepository;
import org.apache.avalon.repository.impl.DefaultAuthenticator;
import org.apache.avalon.composition.util.ExceptionHelper;
import org.apache.avalon.composition.model.ContainmentModel;
import org.apache.avalon.framework.logger.Logger;
import junit.framework.TestCase;
/**
* Abstract Merlin Test Case.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a>
* @version $Revision: 1.1 $ $Date: 2003/10/07 18:03:11 $
*/
public class AbstractMerlinTestCase extends TestCase
{
//-------------------------------------------------------------------
// static
//-------------------------------------------------------------------
private static boolean DEBUG = false;
private static boolean INFO = false;
private static URL BLOCK = getTargetClassesPath();
//-------------------------------------------------------------------
// state
//-------------------------------------------------------------------
private final KernelContext m_context;
private final Kernel m_kernel;
private final ContainmentModel m_test;
private Block m_block;
private Logger m_logger;
//-------------------------------------------------------------------
// constructors
//-------------------------------------------------------------------
/**
* Creation of a new test case instance using the default info and debug
* policies and a test container path of ${basedir}/target/classes
*/
public AbstractMerlinTestCase()
{
this( "testcase" );
}
/**
* Creation of a new test case instance using the default info and debug
* policies and a test container path of ${basedir}/target/classes
*
* @param name the name of the test case
*/
public AbstractMerlinTestCase( String name )
{
this( BLOCK, INFO, DEBUG, name );
}
/**
* Creation of a new test case instance using the test container
* path of ${basedir}/target/classes
*
* @param info information summary display policy
* @param debug internal container debug policy
* @param name the name of the test case
*/
public AbstractMerlinTestCase( boolean info, boolean debug, String name )
{
this( BLOCK, info, debug, name );
}
/**
* Creation of a new test case instance using a supplied test container
* path, info and debug policies and unit test name.
*
* @param url the test container deployment path
* @param info information summary display policy
* @param debug internal container debug policy
* @param name the name of the test case
*/
public AbstractMerlinTestCase(
URL url, boolean info, boolean debug, String name )
{
super( name );
File base =
new File(
System.getProperty(
"basedir",
System.getProperty( "user.dir" ) ) );
File repo = getSystemRepositoryDirectory();
Repository repository = createBootstrapRepository( repo );
File library = base;
URL kernel = null;
URL config = null;
//
// bootstrap the kernel
//
try
{
m_context =
new DefaultKernelContext(
repository, repo, library, base, kernel, new URL[0],
config, true, info, debug );
m_kernel = new DefaultKernel( m_context );
m_logger = m_context.getLoggerForCategory( "testcase" ).getChildLogger(
name );
}
catch( Throwable e )
{
final String error =
"Internal error while attempting to establish the kernel.";
throw new UnitRuntimeException( error, e );
}
//
// Programatically add the test container to the root containment
// model so that we get a reference to the test model enabling
// access to the test block following setup of the test case. This
// allows us to directly lookup objects relative to the test container.
//
try
{
ContainmentModel root = m_kernel.getContainmentModel();
m_test = (ContainmentModel) root.addModel( url );
}
catch( Throwable e )
{
final String error =
"Internal error while attempting to establish the test container.";
throw new UnitRuntimeException( error, e );
}
}
//-------------------------------------------------------------------
// testcase
//-------------------------------------------------------------------
/**
* Startup the Merlin Kernel.
*/
public void setUp() throws Exception
{
getKernel().startup();
try
{
m_block = getKernel().getBlock( m_test );
}
catch( Throwable e )
{
final String message =
"Internal error while attempting to establish the test container: "
+ m_test;
final String error = ExceptionHelper.packException( message, e, false );
throw new UnitException( error, e );
}
}
/**
* Shutdown the Merlin Kernel.
*/
public void tearDown()
{
m_kernel.shutdown();
}
//-------------------------------------------------------------------
// service access
//-------------------------------------------------------------------
/**
* Return a reference to the kernel.
* @return the kernel
*/
protected Kernel getKernel()
{
return m_kernel;
}
/**
* Resolve a service relative to the test container. The supplied
* path may be relative or absolute. Relative paths will be resolved
* relative to the test container wheras absolute paths will be resolved
* relative to the root container.
*
* @param path the absolute or relative path to a component type
* @return the object resolved from an appliance defined by the supplied path
* @exception UnitException if a resolution error occurs
*/
protected Object resolve( String path ) throws UnitException
{
if( path == null ) throw new NullPointerException( "path" );
try
{
Appliance appliance = m_block.resolveAppliance( path );
return appliance.resolve( this );
}
catch( Throwable e )
{
final String error =
"Service resolution error from path: " + path;
final String msg = ExceptionHelper.packException( error, e, false );
throw new UnitException( msg, e );
}
}
/**
* Return the assigned logging channel for the test case.
* @return the logging channel
*/
protected Logger getLogger()
{
return m_logger;
}
//-------------------------------------------------------------------
// implementation
//-------------------------------------------------------------------
/**
* Return the repository from which we will build the kernel classloader.
* @param repo the system repository directory
* @return the repository
*/
private Repository createBootstrapRepository( File repo )
{
ProxyContext proxy = createProxyContext();
URL[] hosts = createHostsSequence();
return new DefaultFileRepository( repo, proxy, hosts );
}
/**
* Return an array of hosts based on the maven.repo.remote property value.
* @return the array of remote hosts
*/
private URL[] createHostsSequence()
{
ArrayList list = new ArrayList();
String path = System.getProperty( "maven.repo.remote" );
if( path == null ) return new URL[0];
StringTokenizer tokenizer = new StringTokenizer( path, "," );
while( tokenizer.hasMoreElements() )
{
String token = tokenizer.nextToken();
appendEntry( list, token );
}
return (URL[]) list.toArray( new URL[0] );
}
private void appendEntry( List list, String token )
{
try
{
list.add( new URL( token ) );
}
catch( Throwable e )
{
final String error =
"Unable to convert token [" + token + "] to a URL.";
throw new UnitRuntimeException( error, e );
}
}
/**
* Create of the proxy context. If no proxy properties are declared a null
* value is returned. Proxy values are based assessment of
* properties maven.proxy.host, maven.proxy.port, maven.proxy.username and
* maven.proxy.password.
*
* @return the proxy context or null if not required
*/
private ProxyContext createProxyContext()
{
String host = System.getProperty( "maven.proxy.host" );
if( host != null )
{
String proxyPort = System.getProperty( "maven.proxy.port" );
if( proxyPort == null )
throw new IllegalStateException( "maven.proxy.port" );
int port = new Integer( proxyPort ).intValue();
String username = System.getProperty( "maven.proxy.username" );
DefaultAuthenticator authenticator = null;
if( username != null )
{
String password = System.getProperty( "maven.proxy.password" );
authenticator = new DefaultAuthenticator( username, password );
}
return new ProxyContext( host, port, authenticator );
}
else
{
return null;
}
}
/**
* Return the file corresponding to the merlin system repository.
*
* @return the system repository directory
*/
private static File getSystemRepositoryDirectory()
{
final String system = System.getProperty( "maven.repo.local" );
if( system != null )
{
return new File( new File( system ), "repository" );
}
else
{
final String home = System.getProperty( "maven.home" );
if( home != null )
{
return new File( new File( home ), "repository" );
}
else
{
File user = new File( System.getProperty( "user.dir" ) );
return new File( user, ".merlin/system" );
}
}
}
/**
* Convinience method to get the ${basedir}/target/classes directory
* as a deployment url.
* @return the deployment url
*/
public static URL getTargetClassesPath()
{
return getBlockPath( "target/classes" );
}
/**
* Convinience method to get the ${basedir}/target/test-classes directory
* as a deployment url.
* @return the deployment url
*/
public static URL getTargetTestClassesPath()
{
return getBlockPath( "target/test-classes" );
}
/**
* Convinience method to get the ${basedir}/[path] directory
* as a deployment url.
* @return the deployment url
*/
public static URL getBlockPath( String path )
{
File base = getBaseDirectory();
File inf = new File( base, path );
try
{
if( inf.exists() ) return inf.toURL();
}
catch( Throwable e )
{
final String error =
"Unexpected error while constructing block path: " + inf;
throw new UnitRuntimeException( error, e );
}
final String error =
"Test path ${basedir}/[" + path + "] does not exist.";
throw new UnitRuntimeException( error );
}
private static File getBaseDirectory()
{
String basedir = System.getProperty( "basedir" );
return new File( basedir );
}
}
1.1
avalon/merlin/kernel/unit/src/java/org/apache/avalon/merlin/unit/UnitException.java
Index: UnitException.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
import org.apache.avalon.framework.CascadingException;
/**
* Exception to indicate that there was an error relating to unit execution.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a>
* @version $Revision: 1.1 $ $Date: 2003/10/07 18:03:11 $
*/
public class UnitException
extends CascadingException
{
/**
* Construct a new <code>UnitException</code> instance.
*
* @param message The detail message for this exception.
*/
public UnitException( final String message )
{
this( message, null );
}
/**
* Construct a new <code>UnitException</code> instance.
*
* @param message The detail message for this exception.
* @param throwable the root cause of the exception
*/
public UnitException( final String message, final Throwable throwable )
{
super( message, throwable );
}
}
1.1
avalon/merlin/kernel/unit/src/java/org/apache/avalon/merlin/unit/UnitRuntimeException.java
Index: UnitRuntimeException.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
import org.apache.avalon.framework.CascadingRuntimeException;
/**
* Exception to indicate that there was an error relating to unit execution.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Avalon Development Team</a>
* @version $Revision: 1.1 $ $Date: 2003/10/07 18:03:11 $
*/
public class UnitRuntimeException
extends CascadingRuntimeException
{
/**
* Construct a new <code>UnitRuntimeException</code> instance.
*
* @param message The detail message for this exception.
*/
public UnitRuntimeException( final String message )
{
this( message, null );
}
/**
* Construct a new <code>UnitRuntimeException</code> instance.
*
* @param message The detail message for this exception.
* @param throwable the root cause of the exception
*/
public UnitRuntimeException( final String message, final Throwable throwable )
{
super( message, throwable );
}
}
1.1
avalon/merlin/kernel/unit/src/java/org/apache/avalon/merlin/unit/package.html
Index: package.html
===================================================================
<body>
<p>
The unit package is an extended UnitTest class that handles the establishment of
a Merlin Kernel using the target/classes as the primary deployment path. The
unit test builds and deploys the container and provides convinient access to
services via component paths.
</p>
<h3>Usage Example</h3>
<p>The package include the class AbstractMerlinTestCase. To create a new test
case including the Merlin service handling simply extend AbstractMerlinTestCase.</p>
<pre>
public class SampleTestCase extends AbstractMerlinTestCase
{
public void testSomething()
{
// resolve a service established by Merlin
Hello hello = resolve( "hello" );
// do some tests against the Hello service
assetTrue( hello.getMessage().equals( "Hello" ) );
}
}
</pre>
<p>In the above example the abstract testcase is establishing a merlin kernel and
loading a container relative to the default deployment path
${basedir}/target/classes.
You can override default behaviour by using constructor arguments to qualify an
alternative deployment path, info, and debugging policies.</p>
</body>
1.1
avalon/merlin/kernel/unit/src/test/org/apache/avalon/merlin/unit/Hello.java
Index: Hello.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
public interface Hello
{
/**
* Return the hello message.
* @return the message
*/
public String getMessage();
}
1.1
avalon/merlin/kernel/unit/src/test/org/apache/avalon/merlin/unit/HelloComponent.java
Index: HelloComponent.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 1999-2002 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
import org.apache.avalon.framework.logger.Logger;
import org.apache.avalon.framework.logger.LogEnabled;
import org.apache.avalon.framework.activity.Disposable;
import org.apache.avalon.framework.activity.Executable;
import org.apache.avalon.framework.activity.Initializable;
/**
* A sample component. This component implements a number
* of lifecycle interface. Each lifecycle interface is a stage
* that is processed by a container during the deployment of
* the component. The lifecycle stages demonstrated here include
* LogEnabled (association of a logging channel), Initializable
* (initialization of the component), Executable (component
* execution), and Disposable (componet disposal). PLease note
* that all lifecycle stages are optional.
*
* @avalon.component version="1.0" name="hello"
*/
public class HelloComponent
implements LogEnabled, Initializable, Disposable, Hello
{
//------------------------------------------------------------
// state
//------------------------------------------------------------
/**
* Internal reference to the logging channel supplied to us
* by the container.
*/
private Logger m_logger;
//------------------------------------------------------------
// Hello
//------------------------------------------------------------
/**
* Return the hello message.
* @return the message
*/
public String getMessage()
{
return "Hello";
}
//------------------------------------------------------------
// lifecycle
//------------------------------------------------------------
/**
* Supply of a logging channel by the container.
*
* @param logger the logging channel for this component
*/
public void enableLogging( final Logger logger )
{
m_logger = logger;
getLogger().info( "logging" );
}
/**
* Initialization of the component by the container.
* @exception Exception if an initialization error occurs
*/
public void initialize() throws Exception
{
getLogger().info( "initialization" );
}
/**
* Component disposal trigger by the container during which
* the component will release consumed resources.
*/
public void dispose()
{
getLogger().info( "disposal" );
m_logger = null;
}
/**
* Return the logging channel assigned to us by the container.
* @return the logging channel
*/
private Logger getLogger()
{
return m_logger;
}
}
1.1
avalon/merlin/kernel/unit/src/test/org/apache/avalon/merlin/unit/HelloComponent.xinfo
Index: HelloComponent.xinfo
===================================================================
<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE type PUBLIC "-//AVALON/Type DTD Version 1.0//EN"
"http://avalon.apache.org/dtds/meta/type_1_1.dtd"; >
<type>
<info>
<name>hello</name>
<version>1.0.0</version>
<lifestyle>singleton</lifestyle>
</info>
<services>
<service type="org.apache.avalon.merlin.unit.Hello"/>
</services>
</type>
1.1
avalon/merlin/kernel/unit/src/test/org/apache/avalon/merlin/unit/StandardTestCase.java
Index: StandardTestCase.java
===================================================================
/*
============================================================================
The Apache Software License, Version 1.1
============================================================================
Copyright (C) 2002-2003 The Apache Software Foundation. All rights reserved.
Redistribution and use in source and binary forms, with or without modifica-
tion, are permitted provided that the following conditions are met:
1. Redistributions of source code must retain the above copyright notice,
this list of conditions and the following disclaimer.
2. Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
3. The end-user documentation included with the redistribution, if any, must
include the following acknowledgment: "This product includes software
developed by the Apache Software Foundation (http://www.apache.org/)."
Alternately, this acknowledgment may appear in the software itself, if
and wherever such third-party acknowledgments normally appear.
4. The names "Jakarta", "Apache Avalon", "Avalon Framework" and
"Apache Software Foundation" must not be used to endorse or promote
products derived from this software without prior written
permission. For written permission, please contact [EMAIL PROTECTED]
5. Products derived from this software may not be called "Apache", nor may
"Apache" appear in their name, without prior written permission of the
Apache Software Foundation.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
APACHE SOFTWARE FOUNDATION OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLU-
DING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contributions made by many individuals
on behalf of the Apache Software Foundation. For more information on the
Apache Software Foundation, please see <http://www.apache.org/>.
*/
package org.apache.avalon.merlin.unit;
import java.net.URL;
import org.apache.avalon.merlin.unit.AbstractMerlinTestCase;
import org.apache.avalon.framework.logger.Logger;
/**
* Abstract Merlin Test Case.
*
* @author [EMAIL PROTECTED]
*/
public class StandardTestCase extends AbstractMerlinTestCase
{
//--------------------------------------------------------
// static
//--------------------------------------------------------
private static boolean DEBUG = false;
private static boolean INFO = false;
private static URL BLOCK = getTargetTestClassesPath();
//--------------------------------------------------------
// constructors
//--------------------------------------------------------
/**
* @param name the name of the test case
* @param root the merlin system install directory
*/
public StandardTestCase( )
{
this( "standard" );
}
/**
* @param name the name of the test case
* @param root the merlin system install directory
*/
public StandardTestCase( String name )
{
super( BLOCK, INFO, DEBUG, name );
}
//--------------------------------------------------------
// testcase
//--------------------------------------------------------
public void testServiceResolution() throws Exception
{
Hello hello = (Hello) resolve( "hello" );
getLogger().info( "Message from hello service: " + hello.getMessage() );
}
}
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
