git-svn-id: https://svn.apache.org/repos/asf/ant/core/trunk@269075 13f79535-47bb-0310-9956-ffa450edef68master
| @@ -0,0 +1,30 @@ | |||||
| /* | |||||
| * 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:donaldp@apache.org">Peter Donald</a> | |||||
| * @version CVS $Revision$ $Date$ | |||||
| */ | |||||
| 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; | |||||
| } | |||||
| @@ -0,0 +1,104 @@ | |||||
| /* | |||||
| * 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:donaldp@apache.org">Peter Donald</a> | |||||
| * @version CVS $Revision$ $Date$ | |||||
| */ | |||||
| 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; | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,86 @@ | |||||
| /* | |||||
| * 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:bloritsch@apache.org">Berin Loritsch</a> | |||||
| * @author <a href="mailto:ricardo@apache,org">Ricardo Rocha</a> | |||||
| * @author <a href="mailto:giacomo@apache,org">Giacomo Pati</a> | |||||
| * @author <a href="mailto:donaldp@apache.org">Peter Donald</a> | |||||
| * @version CVS $Revision$ $Date$ | |||||
| */ | |||||
| 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 ); | |||||
| } | |||||
| } | |||||
| @@ -0,0 +1,101 @@ | |||||
| /* | |||||
| * 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:donaldp@apache.org">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 ); | |||||
| } | |||||
| } | |||||
| } | |||||