/**************************************************************************************
* Copyright (c) Jonas Bon�r, Alexandre Vasseur. All rights reserved. *
* http://aspectwerkz.codehaus.org *
* ---------------------------------------------------------------------------------- *
* The software in this package is published under the terms of the QPL license *
* a copy of which has been included with this distribution in the license.txt file. *
**************************************************************************************/
package org.codehaus.aspectwerkz.attribdef.aspect;
import org.codehaus.aspectwerkz.exception.WrappedRuntimeException;
import org.codehaus.aspectwerkz.exception.DefinitionException;
import org.codehaus.aspectwerkz.attribdef.definition.IntroductionDefinition;
import org.codehaus.aspectwerkz.transform.TransformationUtil;
import org.codehaus.aspectwerkz.DeploymentModel;
import java.lang.reflect.Method;
import java.lang.reflect.InvocationTargetException;
import java.util.WeakHashMap;
import java.util.Map;
import java.util.HashMap;
import java.util.List;
import java.util.Iterator;
/**
* Container for Introductions.
*
* @author <a href="mailto:alex@gnilux.com">Alexandre Vasseur</a>
*/
public class DefaultIntroductionContainerStrategy implements IntroductionContainer {
/**
* Holds a reference to the sole per JVM introduction.
*/
protected Introduction m_perJvm;
/**
* Holds references to the per class introductions.
*
* @TODO shoould be weak for 0.10
*/
protected Map m_perClass = new HashMap();
/**
* Holds references to the per instance introductions.
*/
protected Map m_perInstance = new WeakHashMap();
/**
* Holds references to the per thread introductions.
*/
protected Map m_perThread = new WeakHashMap();
/**
* The introduction prototype.
*/
protected Introduction m_prototype;
/**
* The methods repository.
*/
protected Method[] m_methodRepository = new Method[0];
/**
* Creates a new container strategy.
*
* @param prototype the advice prototype
*/
public DefaultIntroductionContainerStrategy(final Introduction prototype, final AspectContainer definingAspectContainer) {
if (prototype == null) throw new IllegalArgumentException("introduction prototype can not be null");
m_prototype = prototype;
createMethodRepository();
// link it to the aspect container
definingAspectContainer.addIntroductionContainer(prototype.___AW_getName(), this);
}
/**
* Invokes the method on a per JVM basis.
*
* @param methodIndex the method index
* @param parameters the parameters for the invocation
* @return the result from the method invocation
*/
public Object invokeIntroductionPerJvm(final int methodIndex, final Object[] parameters) {
Object result = null;
try {
if (m_perJvm == null) {
// only compatible aspect deployment is perJVM
Aspect perJVMAspect = getRelatedAspect(null);
m_perJvm = Introduction.newInstance(m_prototype, perJVMAspect);
}
result = m_methodRepository[methodIndex].invoke(m_perJvm.___AW_getImplementation(), parameters);
}
catch (InvocationTargetException e) {
throw new WrappedRuntimeException(e.getTargetException());
}
catch (Exception e) {
throw new WrappedRuntimeException(e);
}
return result;
}
/**
* Invokes the method on a per class basis.
*
* @param targetInstance a reference to the calling object
* @param methodIndex the method index
* @param parameters the parameters for the invocation
* @return the result from the method invocation
*/
public Object invokeIntroductionPerClass(final Object targetInstance,
final int methodIndex,
final Object[] parameters) {
final Class targetClass = targetInstance.getClass();
Object result = null;
try {
if (!m_perClass.containsKey(targetClass)) {
synchronized (m_perClass) {
// only compatible aspect deployments are perJVM and perClass
Aspect relatedAspect = getRelatedAspect(targetClass);
Introduction perClassIntroduction = Introduction.newInstance(
m_prototype, relatedAspect
);
m_perClass.put(targetClass, perClassIntroduction);
}
}
result = m_methodRepository[methodIndex].invoke(
((Introduction)m_perClass.get(targetClass)).___AW_getImplementation(),
parameters
);
}
catch (InvocationTargetException e) {
throw new WrappedRuntimeException(e.getTargetException());
}
catch (Exception e) {
throw new WrappedRuntimeException(e);
}
return result;
}
/**
* Invokes the method on a per instance basis.
*
* @param targetInstance a reference to the target instance
* @param methodIndex the method index
* @param parameters the parameters for the invocation
* @return the result from the method invocation
*/
public Object invokeIntroductionPerInstance(final Object targetInstance,
final int methodIndex,
final Object[] parameters) {
Object result = null;
try {
if (!m_perInstance.containsKey(targetInstance)) {
synchronized (m_perInstance) {
// only compatible aspect deployments are perJVM and perClass
Aspect relatedAspect = getRelatedAspect(targetInstance);
Introduction perInstanceIntroduction = Introduction.newInstance(
m_prototype, relatedAspect
);
m_perInstance.put(targetInstance, perInstanceIntroduction);
}
}
result = m_methodRepository[methodIndex].invoke(
((Introduction)m_perInstance.get(targetInstance)).___AW_getImplementation(),
parameters
);
}
catch (InvocationTargetException e) {
throw new WrappedRuntimeException(e.getTargetException());
}
catch (Exception e) {
throw new WrappedRuntimeException(e);
}
return result;
}
/**
* Invokes the method on a per thread basis.
*
* @param methodIndex the method index
* @param parameters the parameters for the invocation
* @return the result from the method invocation
*/
public Object invokeIntroductionPerThread(final int methodIndex, final Object[] parameters) {
Object result;
try {
final Thread currentThread = Thread.currentThread();
if (!m_perThread.containsKey(currentThread)) {
synchronized (m_perThread) {
// only compatible aspect deployments is perThread
Aspect perThread = getRelatedAspect(currentThread);
m_perThread.put(currentThread, Introduction.newInstance(m_prototype, perThread));
}
}
result = m_methodRepository[methodIndex].invoke(
((Introduction)m_perThread.get(currentThread)).___AW_getImplementation(),
parameters
);
}
catch (InvocationTargetException e) {
throw new WrappedRuntimeException(e.getTargetException());
}
catch (Exception e) {
throw new WrappedRuntimeException(e);
}
return result;
}
/**
* Retrieve the related aspect instance from the aspect container
* The mixin deployment model is tight to the aspect deployement model as follows:
* Mixin Aspect possible models
* perJVM perJVM
* perClass perJVM,perClass
* perInstance perJVM,perClass,perInstance
* perThread perThread
*
* @param referent (null, targetClass, targetInstance or currentThread depending of mixin deployment model)
* @return related aspect
*/
private Aspect getRelatedAspect(Object referent) {
Aspect aspect = m_prototype.getAspect();
switch (m_prototype.___AW_getDeploymentModel()) {
case (DeploymentModel.PER_JVM) :
return aspect.___AW_getContainer().getPerJvmAspect();
case (DeploymentModel.PER_CLASS) :
if (aspect.___AW_getDeploymentModel() == DeploymentModel.PER_CLASS) {
return aspect.___AW_getContainer().getPerClassAspect((Class)referent);
} else {//PER_JVM
return aspect.___AW_getContainer().getPerJvmAspect();
}
case (DeploymentModel.PER_INSTANCE) :
if (aspect.___AW_getDeploymentModel() == DeploymentModel.PER_INSTANCE) {
return aspect.___AW_getContainer().getPerInstanceAspect(referent);
} else if (aspect.___AW_getDeploymentModel() == DeploymentModel.PER_CLASS) {
return aspect.___AW_getContainer().getPerClassAspect((Class)referent.getClass());
} else {//PER_JVM
return aspect.___AW_getContainer().getPerJvmAspect();
}
case (DeploymentModel.PER_THREAD) :
return aspect.___AW_getContainer().getPerThreadAspect();
}
throw new RuntimeException("should not get here");
}
/**
* Swaps the current mixin implementation.
*
* @param newImplementationClass the class of the new implementation to use
*/
public void swapImplementation(final Class newImplementationClass) {
if (newImplementationClass == null) throw new IllegalArgumentException("new implementation class class can not be null");
// check compatibility
IntroductionDefinition def = m_prototype.getIntroductionDefinition();
for (Iterator intfs = def.getInterfaceClassNames().iterator(); intfs.hasNext();) {
if ( ! findInterfaceInHierarchy(newImplementationClass, (String) intfs.next()) ) {
throw new DefinitionException("new implementation class is not compatible");
}
}
synchronized (this) {
try {
// create the new introduction to replace the current one
m_prototype.swapImplementation(newImplementationClass);
createMethodRepository();
// clear the current introduction storages
m_perJvm = null;
m_perClass = new HashMap(m_perClass.size());
m_perInstance = new WeakHashMap(m_perClass.size());
m_perThread = new WeakHashMap(m_perClass.size());
}
catch (Exception e) {
new WrappedRuntimeException(e);
}
}
}
/**
* Recursively traverse the interface hierarchy implemented by the given root class in
* order to find one that matches the given name.
* Looks in the class hierarchy as well.
*
* @param root is the class or interface to start the search at.
* @param requiredInterface that we are looking for.
* @return <code>true</code> if we found the interface, <code>false</code> otherwise.
*/
private static boolean findInterfaceInHierarchy(final Class root, final String requiredInterface) {
if (root == null)
return false;
// looks in directly implemented interface first
Class[] interfaces = root.getInterfaces();
for (int i = 0; i < interfaces.length; i++) {
Class implemented = interfaces[i];
if (implemented.getName().equals(requiredInterface)
|| findInterfaceInHierarchy(implemented, requiredInterface)) {
return true;
}
}
return findInterfaceInHierarchy(root.getSuperclass(), requiredInterface);
}
/**
* Creates a method repository for the introduced methods.
*/
private void createMethodRepository() {
synchronized (m_methodRepository) {
List methodList = TransformationUtil.createSortedMethodList(
m_prototype.___AW_getImplementation().getClass());
m_methodRepository = new Method[methodList.size()];
for (int i = 0; i < m_methodRepository.length; i++) {
Method method = (Method)methodList.get(i);
method.setAccessible(true);
m_methodRepository[i] = method;
}
}
}
/**
* Returns the target instance from an introduction
* @param mixinImpl aka "this" from the mixin impl
* @return the target instance or null (if not perInstance deployed mixin)
*/
public Object getTargetInstance(Object mixinImpl) {
Object targetInstance = null;
if (m_prototype.___AW_getDeploymentModel() == DeploymentModel.PER_INSTANCE) {
for (Iterator i = m_perInstance.entrySet().iterator(); i.hasNext();) {
Map.Entry entry = (Map.Entry)i.next();
Object mixin = ((Introduction)entry.getValue()).___AW_getImplementation();
if (mixinImpl.equals(mixin)) {
targetInstance = entry.getKey();
break;
}
}
}
return targetInstance;
}
/**
* Returns the target class from an introduction
* @param mixinImpl aka "this" from the mixin impl
* @return the target instance or null (if not perInstance or perClas deployed mixin)
*/
public Class getTargetClass(Object mixinImpl) {
Class targetClass = null;
if (m_prototype.___AW_getDeploymentModel() == DeploymentModel.PER_INSTANCE) {
Object instance = getTargetInstance(mixinImpl);
if (instance != null)
targetClass = instance.getClass();
} else if (m_prototype.___AW_getDeploymentModel() == DeploymentModel.PER_CLASS) {
for (Iterator i = m_perClass.entrySet().iterator(); i.hasNext();) {
Map.Entry entry = (Map.Entry)i.next();
Object mixin = ((Introduction)entry.getValue()).___AW_getImplementation();
if (mixinImpl.equals(mixin)) {
targetClass = (Class)entry.getKey();
break;
}
}
}
return targetClass;
}
}