jadex.bridge.component.impl.ComponentFeatureFactory Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of jadex-platform-bridge Show documentation
Jadex bridge is a base package for kernels and platforms, i.e., it is used by both and provides commonly used interfaces and classes for active components and their management.
There is a newer version: 4.0.267
Show newest version
package jadex.bridge.component.impl;

import java.lang.reflect.Constructor;
import java.util.Collections;
import java.util.HashSet;
import java.util.Set;

import jadex.bridge.IInternalAccess;
import jadex.bridge.component.ComponentCreationInfo;
import jadex.bridge.component.IComponentFeature;
import jadex.bridge.component.IComponentFeatureFactory;
import jadex.bridge.component.ILifecycleComponentFeature;
import jadex.commons.SReflect;
import jadex.commons.SUtil;

/**
 *  Feature factory allowing the creation of component features.
 */
public class ComponentFeatureFactory implements IComponentFeatureFactory
{
	//-------- attributes --------
	
	/** The interface type. */
	protected Class type;
	
	/** The implementation type. */
	protected Class impl;
	
	/** The presdecessors. */
	protected Set> pres;
	
	/** The successors. */
	protected Set> sucs;
	
	/** The lookup types. */
	protected Class[] lookuptypes;
	
	//-------- constructors --------
	
	/**
	 *  Bean constructor for type level.
	 */
	public ComponentFeatureFactory()
	{
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl)
	{
		this(type, impl, null, null);
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl, Class... lookuptypes)
	{
		this(type, impl, null, null, lookuptypes);
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl, Class[] pres, Class[] sucs)
	{
		this(type, impl, pres, sucs, true, null);
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl, Class[] pres, Class[] sucs, Class... lookuptypes)
	{
		this(type, impl, pres, sucs, true, lookuptypes);
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl, Class[] pres, Class[] sucs, boolean autoaddlast)
	{
		this(type, impl, pres, sucs, autoaddlast, null);
	}
	
	/**
	 *  Create a new feature factory.
	 */
	public ComponentFeatureFactory(Class type, Class impl, Class[] pres, Class[] sucs, boolean autoaddlast, Class[] lookuptypes)
	{
		this.type = type;
		this.impl = impl;
		this.pres = pres==null? null: (Set)SUtil.arrayToSet(pres);
		this.sucs = sucs==null? null: (Set)SUtil.arrayToSet(sucs);
		this.lookuptypes = lookuptypes;
		
		// automallically add the lifecycle feature as precondition for all (besides itself)
		if(autoaddlast)
		{
			if(this.sucs==null)
				this.sucs = new HashSet>();
			this.sucs.add(ILifecycleComponentFeature.class);
		}
	}
	
	//-------- IComponentFeature interface / type level --------
	
	/**
	 *  Get the predecessors, i.e. features that should be inited first.
	 */
	public Set> getPredecessors()
	{
		return pres!=null? pres: (Set)Collections.emptySet();
	}
	
	/**
	 *  The predecessors to set.
	 *  @param predecessors The predecessors to set
	 */
	public void setPredecessors(Set> pres)
	{
		this.pres = pres;
	}
	
	/**
	 *  Get the successors, i.e. features that should be inited after this feature.
	 */
	public Set>	getSuccessors()
	{
		return sucs!=null? sucs: (Set)Collections.emptySet();
	}
	
	/**
	 *  The successors to set.
	 *  @param sucs The successors to set
	 */
	public void setSuccessors(Set> sucs)
	{
		this.sucs = sucs;
	}
	
	/**
	 *  Get the user interface type of the feature.
	 */
	public Class getType()
	{
		return type;
	}
	
	/**
	 *  The type to set.
	 *  @param type The type to set
	 */
	public void setType(Class type)
	{
		this.type = type;
	}
	
	/**
	 *  Get the impl.
	 *  @return The impl
	 */
	public Class getImplementationClass()
	{
		return impl;
	}

	/**
	 *  The impl to set.
	 *  @param impl The impl to set
	 */
	public void setImplementationClass(Class impl)
	{
		this.impl = impl;
	}

	/**
	 *  Get the lookuptypes.
	 *  @return The lookuptypes
	 */
	public Class[] getLookupTypes()
	{
		return lookuptypes==null? SUtil.EMPTY_CLASS_ARRAY: lookuptypes;
	}

	/**
	 *  The lookuptypes to set.
	 *  @param lookuptypes The lookuptypes to set
	 */
	public void setLookupTypes(Class[] lookuptypes)
	{
		this.lookuptypes = lookuptypes;
	}

	/**
	 *  Create an instance of the feature.
	 *  @param access	The access of the component.
	 *  @param info	The creation info.
	 */
	public IComponentFeature createInstance(IInternalAccess access, ComponentCreationInfo info)
	{
		try
		{
			Constructor con = impl.getConstructor(new Class[]{IInternalAccess.class, ComponentCreationInfo.class});
			return (IComponentFeature)con.newInstance(new Object[]{access, info});
		}
		catch(Exception e)
		{
			throw new RuntimeException(e);
		}
	}
	
	
	
	/**
	 *  Create a string representation.
	 */
	public String	toString()
	{
//		return "ComponentFeatureFactory("+SReflect.getUnqualifiedClassName(type)+")";
		return SReflect.getUnqualifiedClassName(type);
	}
}