donaldp 01/05/31 10:21:50
Added: proposal/myrmidon/src/java/org/apache/myrmidon/components/type
ComponentFactory.java DefaultComponentFactory.java
RoleManager.java TypedComponentSelector.java
Log:
Started the type registry impl.
Revision Changes Path
1.1
jakarta-ant/proposal/myrmidon/src/java/org/apache/myrmidon/components/type/ComponentFactory.java
Index: ComponentFactory.java
===================================================================
/*
* Copyright (C) The Apache Software Foundation. All rights reserved.
*
* This software is published under the terms of the Apache Software License
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE file.
*/
package org.apache.myrmidon.components.type;
import org.apache.avalon.framework.component.Component;
import org.apache.avalon.framework.component.ComponentException;
/**
* Create a component based on role and hint.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Peter Donald</a>
* @version CVS $Revision: 1.1 $ $Date: 2001/05/31 17:21:47 $
*/
public interface ComponentFactory
{
/**
* Create a Component with appropriate name.
*
* @param name the name
* @return the created component
* @exception ComponentException if an error occurs
*/
Component create( String name )
throws ComponentException;
}
1.1
jakarta-ant/proposal/myrmidon/src/java/org/apache/myrmidon/components/type/DefaultComponentFactory.java
Index: DefaultComponentFactory.java
===================================================================
/*
* Copyright (C) The Apache Software Foundation. All rights reserved.
*
* This software is published under the terms of the Apache Software License
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE file.
*/
package org.apache.myrmidon.components.type;
import java.net.URL;
import java.util.HashMap;
import java.net.URLClassLoader;
import org.apache.avalon.framework.component.Component;
import org.apache.avalon.framework.component.ComponentException;
/**
* Create a component based on name.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Peter Donald</a>
* @version CVS $Revision: 1.1 $ $Date: 2001/05/31 17:21:48 $
*/
public class DefaultComponentFactory
implements ComponentFactory
{
///A Map of shortnames to classnames
private final HashMap m_classNames = new HashMap();
///A list of URLs from which classLoader is constructed
private final URL[] m_urls;
///The parent classLoader (if any)
private final ClassLoader m_parent;
///The parent classLoader (if any)
private ClassLoader m_classLoader;
public DefaultComponentFactory( final URL[] urls )
{
this( urls, null );
}
public DefaultComponentFactory( final URL[] urls, final ClassLoader
parent )
{
m_urls = urls;
m_parent = parent;
}
public DefaultComponentFactory( final ClassLoader classLoader )
{
this( null, null );
m_classLoader = classLoader;
}
public void addNameClassMapping( final String name, final String
className )
{
m_classNames.put( name, className );
}
/**
* Create a Component with appropriate name.
*
* @param name the name
* @return the created component
* @exception ComponentException if an error occurs
*/
public Component create( final String name )
throws ComponentException
{
final String className = getClassName( name );
try
{
return (Component)getClassLoader().loadClass( className
).newInstance();
}
catch( final Exception e )
{
throw new ComponentException( "Unable to instantiate '" + name +
"'", e );
}
}
private String getClassName( final String name )
throws ComponentException
{
final String className = (String)m_classNames.get( name );
if( null == className )
{
throw new ComponentException( "Malconfigured factory, no clasname
for '" +
name + "'" );
}
return className;
}
private ClassLoader getClassLoader()
{
if( null == m_classLoader )
{
m_classLoader = new URLClassLoader( m_urls, m_parent );
}
return m_classLoader;
}
}
1.1
jakarta-ant/proposal/myrmidon/src/java/org/apache/myrmidon/components/type/RoleManager.java
Index: RoleManager.java
===================================================================
/*
* Copyright (C) The Apache Software Foundation. All rights reserved.
*
* This software is published under the terms of the Apache Software License
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE file.
*/
package org.apache.myrmidon.components.type;
import java.util.HashMap;
/**
* Interface to manage roles and mapping to shorthand names.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Berin Loritsch</a>
* @author <a href="mailto:[EMAIL PROTECTED],org">Ricardo Rocha</a>
* @author <a href="mailto:[EMAIL PROTECTED],org">Giacomo Pati</a>
* @author <a href="mailto:[EMAIL PROTECTED]">Peter Donald</a>
* @version CVS $Revision: 1.1 $ $Date: 2001/05/31 17:21:48 $
*/
public class RoleManager
{
/** Parent <code>RoleManager</code> for nested resolution */
private final RoleManager m_parent;
/** Map for shorthand to role mapping */
private final HashMap m_shorthands = new HashMap();
/**
* constructor--this RoleManager has no parent.
*/
public RoleManager()
{
this( null );
}
/**
* Alternate constructor--this RoleManager has the specified
* parent.
*
* @param parent The parent <code>RoleManager</code>.
*/
public RoleManager( final RoleManager parent )
{
m_parent = parent;
}
/**
* Find Role name based on shorthand name.
*
* @param shorthandName the shorthand name
* @return the role
*/
public String getRoleForName( final String shorthandName )
{
final String role = (String)m_shorthands.get( shorthandName );
if( null == role && null != m_parent )
{
return m_parent.getRoleForName( shorthandName );
}
return role;
}
/**
* Add a mapping between shorthand name and role
*
* @param shorthandName the shorthand name
* @param role the role
* @exception IllegalArgumentException if an name is already mapped to a
different role
*/
public void addNameRoleMapping( final String shorthandName, final String
role )
throws IllegalArgumentException
{
final String oldRole = (String)m_shorthands.get( shorthandName );
if( null != oldRole && oldRole.equals( role ) )
{
throw new IllegalArgumentException( "Name already mapped to
another role (" +
oldRole + ")" );
}
m_shorthands.put( shorthandName, role );
}
}
1.1
jakarta-ant/proposal/myrmidon/src/java/org/apache/myrmidon/components/type/TypedComponentSelector.java
Index: TypedComponentSelector.java
===================================================================
/*
* Copyright (C) The Apache Software Foundation. All rights reserved.
*
* This software is published under the terms of the Apache Software License
* version 1.1, a copy of which has been included with this distribution in
* the LICENSE file.
*/
package org.apache.myrmidon.components.type;
import java.util.HashMap;
import org.apache.avalon.framework.component.Component;
import org.apache.avalon.framework.component.ComponentSelector;
import org.apache.avalon.framework.component.ComponentException;
/**
* This is a ComponentSelector implementation that acts as factory
* for objects and checks type on creation.
*
* @author <a href="mailto:[EMAIL PROTECTED]">Peter Donald</a>
*/
public class TypedComponentSelector
implements ComponentSelector
{
private final HashMap m_factorys = new HashMap();
private final Class m_type;
public TypedComponentSelector( final Class type )
{
m_type = type;
}
/**
* Select the desired component.
* This creates component and checks if type appropriate.
*
* @param hint the hint to retrieve Component
* @return the Component
* @exception ComponentException if an error occurs
*/
public Component select( Object hint )
throws ComponentException
{
if( !(hint instanceof String) )
{
throw new ComponentException( "Invalid hint, expected a string
not a " +
hint.getClass().getName() );
}
final Component component = createComponent( (String)hint );
if( null != component )
{
if( m_type.isInstance( component ) )
{
throw new ComponentException( "Implementation of " + hint + "
is not of " +
"correct type (" +
m_type.getClass().getName() + ")" );
}
return component;
}
else
{
throw new ComponentException( "Unable to provide implementation
for " + hint );
}
}
/**
* Release component.
*
* @param component the component
*/
public void release( final Component component )
{
}
/**
* Populate the ComponentSelector.
*/
public void put( final String name, final ComponentFactory factory )
{
m_factorys.put( name, factory );
}
/**
* Helper method for subclasses to retrieve component map.
*
* @return the component map
*/
private Component createComponent( final String name )
throws ComponentException
{
final ComponentFactory factory = (ComponentFactory)m_factorys.get(
name );
if( null == factory ) return null;
else
{
return factory.create( name );
}
}
}
