org.apache.webbeans.container.InjectionResolver Maven / Gradle / Ivy
The newest version!
/*
* Licensed to the Apache Software Foundation (ASF) under one
* or more contributor license agreements. See the NOTICE file
* distributed with this work for additional information
* regarding copyright ownership. The ASF licenses this file
* to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance
* with the License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*/
package org.apache.webbeans.container;
import java.lang.annotation.Annotation;
import java.lang.reflect.GenericArrayType;
import java.lang.reflect.ParameterizedType;
import java.lang.reflect.Type;
import java.lang.reflect.TypeVariable;
import java.lang.reflect.WildcardType;
import java.util.Collections;
import java.util.HashSet;
import java.util.Iterator;
import java.util.Map;
import java.util.Set;
import java.util.concurrent.ConcurrentHashMap;
import java.util.logging.Level;
import java.util.logging.Logger;
import javax.enterprise.event.Event;
import javax.enterprise.inject.Instance;
import javax.enterprise.inject.New;
import javax.enterprise.inject.spi.Bean;
import javax.enterprise.inject.spi.InjectionPoint;
import org.apache.webbeans.annotation.AnyLiteral;
import org.apache.webbeans.annotation.DefaultLiteral;
import org.apache.webbeans.component.AbstractOwbBean;
import org.apache.webbeans.component.InjectionTargetBean;
import org.apache.webbeans.component.OwbBean;
import org.apache.webbeans.config.WebBeansContext;
import org.apache.webbeans.exception.WebBeansConfigurationException;
import org.apache.webbeans.exception.inject.DefinitionException;
import org.apache.webbeans.exception.inject.NullableDependencyException;
import org.apache.webbeans.logger.WebBeansLoggerFacade;
import org.apache.webbeans.spi.BDABeansXmlScanner;
import org.apache.webbeans.spi.ScannerService;
import org.apache.webbeans.util.AnnotationUtil;
import org.apache.webbeans.util.Asserts;
import org.apache.webbeans.util.ClassUtil;
import org.apache.webbeans.util.GenericsUtil;
import org.apache.webbeans.util.InjectionExceptionUtil;
import org.apache.webbeans.util.WebBeansUtil;
import static org.apache.webbeans.util.InjectionExceptionUtil.throwAmbiguousResolutionException;
/**
* Injection point resolver class.
*
*
* It is a singleton class per BeanManager. It is
* responsible for resolving the bean instances at the injection points for
* its bean manager.
*
*
* @version $Rev: 1641684 $ $Date: 2014-11-25 21:24:17 +0100 (Tue, 25 Nov 2014) $
* @see org.apache.webbeans.config.WebBeansFinder
*/
public class InjectionResolver
{
private final static Logger logger = WebBeansLoggerFacade.getLogger(InjectionResolver.class);
/**
* Bean Manager
*/
private WebBeansContext webBeansContext;
/**
* This Map contains all resolved beans via it's type and qualifiers.
* If a bean have resolved as not existing, the entry will contain null as value.
* The Long key is a hashCode, see {@link BeanCacheKey#BeanCacheKey(boolean, Type, String, Annotation...)}
*/
private Map>> resolvedBeansByType = new ConcurrentHashMap>>();
/**
* This Map contains all resolved beans via it's ExpressionLanguage name.
*/
private Map>> resolvedBeansByName = new ConcurrentHashMap>>();
/**
* Creates a new injection resolve for given bean manager.
*
* @param webBeansContext WebBeansContext
*/
public InjectionResolver(WebBeansContext webBeansContext)
{
this.webBeansContext = webBeansContext;
}
/**
* Clear caches.
*/
public void clearCaches()
{
resolvedBeansByName.clear();
resolvedBeansByType.clear();
}
/**
* Check the type of the injection point.
*
* Injection point type can not be {@link java.lang.reflect.TypeVariable}.
*
*
* @param injectionPoint injection point
* @throws WebBeansConfigurationException if not obey the rule
*/
public void checkInjectionPointType(InjectionPoint injectionPoint)
{
Type type = injectionPoint.getType();
//Check for injection point type variable
if (ClassUtil.isTypeVariable(type))
{
throw new WebBeansConfigurationException("Injection point type : " + injectionPoint + " can not define Type Variable generic type");
}
}
/**
* Check that a valid enabled bean exists in the deployment for the given
* injection point definition.
*
* @param injectionPoint injection point
* @throws WebBeansConfigurationException If bean is not available in the current deployment for given injection
*/
public void checkInjectionPoint(InjectionPoint injectionPoint)
{
WebBeansUtil.checkInjectionPointNamedQualifier(injectionPoint);
Type type = injectionPoint.getType();
Class clazz;
if (ClassUtil.isTypeVariable(type))
{
throw new WebBeansConfigurationException("Injection point type : " + injectionPoint + " type can not be defined as Typevariable or Wildcard type!");
}
if (type instanceof ParameterizedType)
{
ParameterizedType pt = (ParameterizedType) type;
clazz = (Class) pt.getRawType();
}
else
{
clazz = (Class) type;
}
Annotation[] qualifiers = new Annotation[injectionPoint.getQualifiers().size()];
qualifiers = injectionPoint.getQualifiers().toArray(qualifiers);
// OWB-890 some 3rd party InjectionPoints return null in getBean();
Class injectionPointClass = Object.class; // the fallback
Bean injectionPointBean = injectionPoint.getBean();
if (injectionPointBean != null)
{
injectionPointClass = injectionPointBean.getBeanClass();
}
if (injectionPointClass == null && type instanceof Class)
{
injectionPointClass = (Class) type;
}
Set> beanSet = implResolveByType(injectionPoint.isDelegate(), type, injectionPointClass, qualifiers);
if (beanSet.isEmpty())
{
if (qualifiers.length == 1 && qualifiers[0].annotationType().equals(New.class))
{
createNewBean(injectionPoint, type, qualifiers, beanSet);
}
}
Bean bean = resolve(beanSet, injectionPoint);
if (bean == null)
{
InjectionExceptionUtil.throwUnsatisfiedResolutionException(clazz, injectionPoint, qualifiers);
}
if (clazz.isPrimitive())
{
if (bean.isNullable())
{
throw new NullableDependencyException("Injection point type : " + injectionPoint +
" type is primitive but resolved bean can have nullable objects!");
}
}
}
/**
* Returns bean for injection point.
*
* @param injectionPoint injection point declaration
* @return bean for injection point
*/
public Bean getInjectionPointBean(InjectionPoint injectionPoint)
{
Type type = injectionPoint.getType();
Class clazz;
if (type instanceof ParameterizedType)
{
ParameterizedType pt = (ParameterizedType) type;
clazz = (Class) pt.getRawType();
}
else
{
clazz = (Class) type;
}
Set qualSet = injectionPoint.getQualifiers();
Annotation[] qualifiers = qualSet.toArray(new Annotation[qualSet.size()]);
if (isInstanceOrEventInjection(type))
{
qualifiers = AnyLiteral.ARRAY;
}
Set> beanSet = implResolveByType(injectionPoint.isDelegate(), type, clazz, qualifiers);
if (beanSet.isEmpty())
{
if (qualifiers.length == 1 && qualifiers[0].annotationType().equals(New.class))
{
createNewBean(injectionPoint, type, qualifiers, beanSet);
}
else
{
InjectionExceptionUtil.throwUnsatisfiedResolutionException(clazz, injectionPoint, qualifiers);
}
}
return resolve(beanSet, injectionPoint);
}
private void createNewBean(InjectionPoint injectionPoint, Type type, Annotation[] qualifiers, Set> beanSet)
{
New newQualifier = (New) qualifiers[0];
Class newType;
if (newQualifier.value() == New.class)
{
newType = ClassUtil.getClass(type);
}
else
{
newType = newQualifier.value();
}
Set> beans = implResolveByType(injectionPoint.isDelegate(), newType, injectionPoint.getBean().getBeanClass(), AnyLiteral.INSTANCE);
if (beans.isEmpty())
{
beanSet.add(webBeansContext.getWebBeansUtil().createNewComponent(newType));
}
else
{
// we just need the bean for the injection points. So when we find an InjectionTargetBean, we can just take it.
for (Bean bean: beans)
{
if (bean instanceof InjectionTargetBean)
{
beanSet.add(webBeansContext.getWebBeansUtil().createNewComponent((OwbBean)bean, (Class)newType));
break;
}
}
if (beanSet.isEmpty())
{
//Hmm, no InjectionTargetBean available, then we have to create the injection points on our own
beanSet.add(webBeansContext.getWebBeansUtil().createNewComponent((Class)newType));
}
}
}
private boolean isInstanceOrEventInjection(Type type)
{
Class clazz;
boolean injectInstanceOrEventProvider = false;
if (type instanceof ParameterizedType)
{
ParameterizedType pt = (ParameterizedType) type;
clazz = (Class) pt.getRawType();
if (clazz.isAssignableFrom(Instance.class) || clazz.isAssignableFrom(Event.class))
{
injectInstanceOrEventProvider = true;
}
}
return injectInstanceOrEventProvider;
}
/**
* Returns set of beans for given bean name.
*
* @param name bean name
* @return set of beans for given bean name
*/
@SuppressWarnings("unchecked")
public Set> implResolveByName(String name)
{
Asserts.assertNotNull(name, "name parameter can not be null");
String cacheKey = name;
Set> resolvedComponents = resolvedBeansByName.get(cacheKey);
if (resolvedComponents != null)
{
return resolvedComponents;
}
resolvedComponents = new HashSet>();
Set> deployedComponents = webBeansContext.getBeanManagerImpl().getBeans();
Iterator> it = deployedComponents.iterator();
//Finding all beans with given name
while (it.hasNext())
{
Bean component = it.next();
if (component.getName() != null)
{
if (component.getName().equals(name))
{
resolvedComponents.add(component);
}
}
}
//Look for enable/disable
resolvedComponents = findByEnabled(resolvedComponents);
//Still Ambigious, check for specialization
if (resolvedComponents.size() > 1)
{
//Check for specialization
Set> specializedComponents = findSpecializedForNameResolution(resolvedComponents);
if (specializedComponents.size() > 0)
{
resolvedComponents = specializedComponents;
}
}
if (resolvedComponents.isEmpty())
{
// maintain negative cache but use standard empty set so we can garbage collect
resolvedBeansByName.put(cacheKey, Collections.EMPTY_SET);
}
else
{
resolvedBeansByName.put(cacheKey, resolvedComponents);
}
if (logger.isLoggable(Level.FINE))
{
logger.log(Level.FINE, "DEBUG_ADD_BYNAME_CACHE_BEANS", cacheKey);
}
return resolvedComponents;
}
private Set> findByEnabled(Set> resolvedComponents)
{
Set> specializedComponents = new HashSet>();
if (resolvedComponents.size() > 0)
{
for (Bean bean : resolvedComponents)
{
AbstractOwbBean component = (AbstractOwbBean) bean;
if (component.isEnabled())
{
specializedComponents.add(component);
}
}
}
return specializedComponents;
}
/**
* Returns filtered set by specialization.
*
* @param resolvedComponents result beans
* @return filtered set by specialization
*/
private Set> findSpecializedForNameResolution(Set> resolvedComponents)
{
Set> specializedComponents = new HashSet>();
if (resolvedComponents.size() > 0)
{
for (Bean bean : resolvedComponents)
{
AbstractOwbBean component = (AbstractOwbBean) bean;
if (component.isSpecializedBean())
{
specializedComponents.add(component);
}
}
}
return specializedComponents;
}
/**
* Resolution by type.
*
* @param isDelegate whether the InjectionPoint is for a {@link javax.decorator.Delegate}
* @param injectionPointType injection point api type
* @param qualifiers qualifiers of the injection point
* @return set of resolved beans
*/
public Set> implResolveByType(boolean isDelegate, Type injectionPointType, Annotation... qualifiers)
{
return implResolveByType(isDelegate, injectionPointType, null, qualifiers);
}
private String getBDABeansXMLPath(Class injectionPointBeanClass)
{
if (injectionPointBeanClass == null)
{
return null;
}
ScannerService scannerService = webBeansContext.getScannerService();
BDABeansXmlScanner beansXMLScanner = scannerService.getBDABeansXmlScanner();
return beansXMLScanner.getBeansXml(injectionPointBeanClass);
}
/**
* Resolution by type.
*
* @param isDelegate whether the InjectionPoint is for a {@link javax.decorator.Delegate}
* @param injectionPointType injection point api type
* @param qualifiers qualifiers of the injection point
* @return set of resolved beans
*/
public Set> implResolveByType(boolean isDelegate, Type injectionPointType,
Class injectionPointClass, Annotation... qualifiers)
{
ScannerService scannerService = webBeansContext.getScannerService();
String bdaBeansXMLFilePath = null;
if (scannerService.isBDABeansXmlScanningEnabled())
{
bdaBeansXMLFilePath = getBDABeansXMLPath(injectionPointClass);
}
boolean currentQualifier = false;
if (isInstanceOrEventInjection(injectionPointType))
{
qualifiers = AnyLiteral.ARRAY;
}
else
{
if (qualifiers.length == 0)
{
qualifiers = DefaultLiteral.ARRAY;
currentQualifier = true;
}
}
validateInjectionPointType(injectionPointType);
BeanCacheKey cacheKey = new BeanCacheKey(isDelegate, injectionPointType, bdaBeansXMLFilePath, qualifiers);
Set> resolvedComponents = resolvedBeansByType.get(cacheKey);
if (resolvedComponents != null)
{
return resolvedComponents;
}
resolvedComponents = new HashSet>();
boolean returnAll = false;
if (injectionPointType.equals(Object.class) && currentQualifier)
{
returnAll = true;
}
for (Bean component : webBeansContext.getBeanManagerImpl().getBeans())
{
// no need to check instanceof OwbBean as we always wrap in a
// ThirdpartyBeanImpl at least
if (!((OwbBean) component).isEnabled())
{
continue;
}
if (returnAll)
{
resolvedComponents.add(component);
}
else
{
for (Type componentApiType : component.getTypes())
{
if (GenericsUtil.satisfiesDependency(isDelegate, injectionPointType, componentApiType))
{
resolvedComponents.add(component);
break;
}
}
}
}
// Look for qualifiers
resolvedComponents = findByQualifier(resolvedComponents, injectionPointType, qualifiers);
resolvedBeansByType.put(cacheKey, resolvedComponents);
if (logger.isLoggable(Level.FINE))
{
logger.log(Level.FINE, "DEBUG_ADD_BYTYPE_CACHE_BEANS", cacheKey);
}
return resolvedComponents;
}
/**
* Verify that we have a legal Type at the injection point.
* CDI can basically only handle Class and ParameterizedType injection points atm.
* @throws DefinitionException on TypeVariable, WildcardType and GenericArrayType
* @throws IllegalArgumentException if the type is not yet supported by the spec.
*/
private void validateInjectionPointType(Type injectionPointType)
{
if (injectionPointType instanceof TypeVariable || injectionPointType instanceof WildcardType || injectionPointType instanceof GenericArrayType)
{
throw new DefinitionException("Injection point cannot define Type Variable " + injectionPointType);
}
if (!(injectionPointType instanceof Class) &&
!(injectionPointType instanceof ParameterizedType))
{
throw new IllegalArgumentException("Unsupported type " + injectionPointType.getClass());
}
}
/**
* Returns specialized beans if exists, otherwise return input result
*
* @param result result beans
* @return specialized beans if exists, otherwise return input result
*/
public Set> findBySpecialization(Set> result)
{
Iterator> it = result.iterator();
Set> res = new HashSet>();
while (it.hasNext())
{
AbstractOwbBean component = (AbstractOwbBean) it.next();
if (component.isSpecializedBean() && component.isEnabled())
{
res.add(component);
}
}
if (res.size() > 0)
{
return res;
}
return result;
}
/**
* Gets alternatives from set.
*
* @param result resolved set
* @return containes alternatives
*/
public Set> findByAlternatives(Set> result)
{
return findByAlternatives(result, null);
}
/**
* Gets alternatives from set.
*
* @param result resolved set
* @return containes alternatives
*/
public Set> findByAlternatives(Set> result, String bdaBeansXMLFilePath)
{
Set> alternativeSet = new HashSet>();
Set> enableSet = new HashSet>();
boolean containsAlternative = false;
if (bdaBeansXMLFilePath != null)
{
// per BDA beans.xml
for (Bean bean : result)
{
if (bean.isAlternative())
{
if (isAltBeanInInjectionPointBDA(bdaBeansXMLFilePath, bean))
{
if (!containsAlternative)
{
containsAlternative = true;
}
alternativeSet.add(bean);
}
}
else
{
if (!containsAlternative)
{
// Do not check isEnabled flag to allow beans to be
// added on a per BDA basis when a bean is disabled due
// to specialize alternative defined in a different BDA
enableSet.add(bean);
}
}
}
}
else
{
for (Bean bean : result)
{
if (bean.isAlternative())
{
if (!containsAlternative)
{
containsAlternative = true;
}
alternativeSet.add(bean);
}
else
{
if (!containsAlternative)
{
AbstractOwbBean temp = (AbstractOwbBean) bean;
if (temp.isEnabled())
{
enableSet.add(bean);
}
}
}
}
}
if (containsAlternative)
{
return alternativeSet;
}
return enableSet;
}
/**
*
* @param beans
* @param injectionPoint only used for logging. Can be null.
* @param
* @return the single resolved bean, null if none is activated
* @throws javax.enterprise.inject.AmbiguousResolutionException if more than 1 bean is active
*/
public Bean resolve(Set> beans, InjectionPoint injectionPoint)
{
Set set = resolveAll(beans);
if (set.isEmpty())
{
return null;
}
if(set.size() > 1)
{
set = findBySpecialization(set);
if(set.size() > 1)
{
throwAmbiguousResolutionException(set, null, injectionPoint);
}
}
return (Bean)set.iterator().next();
}
public Set> resolveAll(Set> beans)
{
if (beans == null || beans.isEmpty())
{
return Collections.emptySet();
}
Set set = new HashSet>();
for(Bean obj : beans)
{
set.add(obj);
}
set = findByAlternatives(set);
if (set == null || set.isEmpty())
{
return Collections.emptySet();
}
return set;
}
private boolean isAltBeanInInjectionPointBDA(String bdaBeansXMLFilePath, Bean altBean)
{
ScannerService scannerService = webBeansContext.getScannerService();
BDABeansXmlScanner beansXMLScanner = scannerService.getBDABeansXmlScanner();
Set> definedAlternatives = beansXMLScanner.getAlternatives(bdaBeansXMLFilePath);
if (definedAlternatives.contains(altBean.getBeanClass()))
{
return true;
}
Set> definedStereotypes = beansXMLScanner.getStereotypes(bdaBeansXMLFilePath);
for (Class stereoAnnotations : definedStereotypes)
{
if (AnnotationUtil.hasClassAnnotation(altBean.getBeanClass(), stereoAnnotations))
{
return true;
}
}
return false;
}
/**
* Returns filtered bean set according to the qualifiers.
*
* @param remainingSet bean set for filtering by qualifier
* @param annotations qualifiers on injection point
* @return filtered bean set according to the qualifiers
*/
private Set> findByQualifier(Set> remainingSet, Type type, Annotation... annotations)
{
Iterator> it = remainingSet.iterator();
Set> result = new HashSet>();
while (it.hasNext())
{
Bean component = it.next();
Set qTypes = component.getQualifiers();
int i = 0;
for (Annotation annot : annotations)
{
Iterator itQualifiers = qTypes.iterator();
while (itQualifiers.hasNext())
{
Annotation qualifier = itQualifiers.next();
if (annot.annotationType().equals(qualifier.annotationType()))
{
if (AnnotationUtil.isCdiAnnotationEqual(qualifier, annot))
{
i++;
}
}
}
}
if (i == annotations.length)
{
result.add(component);
}
}
if (result.isEmpty() && annotations.length == 1 && New.class.equals(annotations[0].annotationType()) && Class.class.isInstance(type))
{ // happen in TCKs, shouldn't be the case in real apps
result.add(webBeansContext.getWebBeansUtil().createNewComponent(Class.class.cast(type)));
}
return result;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy