com.aspectran.core.context.rule.BeanRule Maven / Gradle / Ivy
/*
* Copyright (c) 2008-2023 The Aspectran Project
*
* Licensed 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 com.aspectran.core.context.rule;
import com.aspectran.core.component.bean.ablility.DisposableBean;
import com.aspectran.core.component.bean.ablility.FactoryBean;
import com.aspectran.core.component.bean.ablility.InitializableBean;
import com.aspectran.core.context.rule.ability.BeanReferenceable;
import com.aspectran.core.context.rule.ability.Replicable;
import com.aspectran.core.context.rule.params.FilterParameters;
import com.aspectran.core.context.rule.type.BeanRefererType;
import com.aspectran.core.context.rule.type.ScopeType;
import com.aspectran.core.util.BooleanUtils;
import com.aspectran.core.util.StringUtils;
import com.aspectran.core.util.ToStringBuilder;
import java.lang.reflect.Method;
import java.util.ArrayList;
import java.util.List;
/**
* The Class BeanRule.
*
* Created: 2009. 03. 09 PM 23:48:09
*/
public class BeanRule implements Replicable, BeanReferenceable {
public static final String CLASS_DIRECTIVE_PREFIX = "class:";
private static final BeanRefererType BEAN_REFERER_TYPE = BeanRefererType.BEAN_RULE;
private String id;
private String className;
private Class beanClass;
private String scanPattern;
private String maskPattern;
private FilterParameters filterParameters;
private ScopeType scopeType;
private Boolean singleton;
private String factoryBeanId;
private Class factoryBeanClass;
private String factoryMethodName;
private Method factoryMethod;
private ParameterBindingRule[] factoryMethodParameterBindingRules;
private boolean factoryOffered;
private Class targetBeanClass;
private String initMethodName;
private Method initMethod;
private ParameterBindingRule[] initMethodParameterBindingRules;
private String destroyMethodName;
private Method destroyMethod;
private ItemRuleMap constructorArgumentItemRuleMap;
private ItemRuleMap propertyItemRuleMap;
private Boolean lazyInit;
private Boolean lazyDestroy;
private Boolean important;
private boolean factoryBean;
private boolean disposableBean;
private boolean initializableBean;
private boolean innerBean;
private boolean replicated;
private Boolean proxied;
private List autowireRuleList;
private AutowireRule constructorAutowireRule;
private boolean constructorAutowireParsed;
private boolean fieldAutowireParsed;
private boolean methodAutowireParsed;
private DescriptionRule descriptionRule;
/**
* Returns the bean id.
* @return the bean id
*/
public String getId() {
return id;
}
/**
* Sets the bean id.
* @param id the bean id
*/
public void setId(String id) {
this.id = id;
}
/**
* Gets the class type.
* @return the class type
*/
public String getClassName() {
return className;
}
/**
* Sets the class type.
* @param className the new class name
*/
public void setClassName(String className) {
this.className = className;
}
/**
* Gets the bean class.
* @return the bean class
*/
public Class getBeanClass() {
return beanClass;
}
/**
* Sets the bean class.
* @param beanClass the new bean class
*/
public void setBeanClass(Class beanClass) {
this.beanClass = beanClass;
this.className = beanClass.getName();
this.factoryBean = FactoryBean.class.isAssignableFrom(beanClass);
this.disposableBean = DisposableBean.class.isAssignableFrom(beanClass);
this.initializableBean = InitializableBean.class.isAssignableFrom(beanClass);
}
/**
* Gets the scan pattern.
* @return the scan pattern
*/
public String getScanPattern() {
return scanPattern;
}
/**
* Sets the scan pattern.
* @param scanPattern the new scan pattern
*/
public void setScanPattern(String scanPattern) {
this.scanPattern = scanPattern;
}
/**
* Gets the mask pattern.
* @return the mask pattern
*/
public String getMaskPattern() {
return maskPattern;
}
/**
* Gets the filter parameters.
* @return the filter parameters
*/
public FilterParameters getFilterParameters() {
return filterParameters;
}
/**
* Sets the filter parameters.
* @param filterParameters the new filter parameters
*/
public void setFilterParameters(FilterParameters filterParameters) {
this.filterParameters = filterParameters;
}
/**
* Sets the mask pattern.
* @param maskPattern the new mask pattern
*/
public void setMaskPattern(String maskPattern) {
this.maskPattern = maskPattern;
}
/**
* Gets the scope type.
* @return the scope type
*/
public ScopeType getScopeType() {
return scopeType;
}
/**
* Sets the scope type.
* @param scopeType the new scope type
*/
public void setScopeType(ScopeType scopeType) {
this.scopeType = scopeType;
}
/**
* Returns whether this bean is a singleton.
*
* @return whether this bean is a singleton
*/
public Boolean getSingleton() {
return singleton;
}
/**
* Sets whether this bean is a singleton.
*
* @param singleton whether this bean is a singleton
*/
public void setSingleton(Boolean singleton) {
this.singleton = singleton;
}
/**
* Returns whether this bean is a singleton.
*
* @return whether this bean is a singleton
*/
public boolean isSingleton() {
return (this.scopeType == ScopeType.SINGLETON);
}
/**
* Gets the factory bean id.
* @return the factory bean id
*/
public String getFactoryBeanId() {
return factoryBeanId;
}
/**
* Sets the factory bean id.
* @param factoryBeanId the new factory bean id
*/
public void setFactoryBeanId(String factoryBeanId) {
this.factoryBeanId = factoryBeanId;
}
/**
* Gets factory bean class.
* @return the factory bean class
*/
public Class getFactoryBeanClass() {
return factoryBeanClass;
}
/**
* Sets factory bean class.
* @param factoryBeanClass the factory bean class
*/
public void setFactoryBeanClass(Class factoryBeanClass) {
this.factoryBeanClass = factoryBeanClass;
}
/**
* Gets the factory method name.
* @return the factory method
*/
public String getFactoryMethodName() {
return factoryMethodName;
}
/**
* Sets the factory method name.
* @param factoryMethodName the new factory method name
*/
public void setFactoryMethodName(String factoryMethodName) {
this.factoryMethodName = factoryMethodName;
}
public Method getFactoryMethod() {
return factoryMethod;
}
public void setFactoryMethod(Method factoryMethod) {
this.factoryMethod = factoryMethod;
}
public ParameterBindingRule[] getFactoryMethodParameterBindingRules() {
return factoryMethodParameterBindingRules;
}
public void setFactoryMethodParameterBindingRules(ParameterBindingRule[] parameterBindingRules) {
this.factoryMethodParameterBindingRules = parameterBindingRules;
}
public boolean isFactoryOffered() {
return factoryOffered;
}
public void setFactoryOffered(boolean factoryOffered) {
this.factoryOffered = factoryOffered;
}
public boolean isFactoryProductionRequired() {
return (!isFactoryOffered() && (isFactoryBean() || getFactoryMethod() != null));
}
public Class getTargetBeanClass() {
return (targetBeanClass != null ? targetBeanClass : beanClass);
}
public void setTargetBeanClass(Class targetBeanClass) {
this.targetBeanClass = targetBeanClass;
}
public String getTargetBeanClassName() {
return (targetBeanClass != null ? targetBeanClass.getName() : className);
}
/**
* Returns the initialization method name.
* @return the initialization method name
*/
public String getInitMethodName() {
return initMethodName;
}
/**
* Sets the initialization method name.
* @param initMethodName the new initialization method name
*/
public void setInitMethodName(String initMethodName) {
this.initMethodName = initMethodName;
}
/**
* Returns the initialization method.
* @return the initialization method
*/
public Method getInitMethod() {
return initMethod;
}
/**
* Sets the initialization method.
* @param initMethod the initialization method
*/
public void setInitMethod(Method initMethod) {
this.initMethod = initMethod;
}
public ParameterBindingRule[] getInitMethodParameterBindingRules() {
return initMethodParameterBindingRules;
}
public void setInitMethodParameterBindingRules(ParameterBindingRule[] parameterBindingRules) {
this.initMethodParameterBindingRules = parameterBindingRules;
}
/**
* Returns the destroy method name.
* @return the destroy method name
*/
public String getDestroyMethodName() {
return destroyMethodName;
}
/**
* Sets the destroy method name.
* @param destroyMethodName the new destroy method name
*/
public void setDestroyMethodName(String destroyMethodName) {
this.destroyMethodName = destroyMethodName;
}
/**
* Returns the destroy method.
* @return the destroy method
*/
public Method getDestroyMethod() {
return destroyMethod;
}
/**
* Sets the destroy method.
* @param destroyMethod the new destroy method
*/
public void setDestroyMethod(Method destroyMethod) {
this.destroyMethod = destroyMethod;
}
/**
* Returns whether this bean is to be lazily initialized.
* @return true, if this bean is to be lazily initialized
*/
public Boolean getLazyInit() {
return lazyInit;
}
/**
* Sets whether this bean is to be lazily initialized.
* @param lazyInit whether this bean is to be lazily initialized
*/
public void setLazyInit(Boolean lazyInit) {
this.lazyInit = lazyInit;
}
/**
* Returns whether this bean is to be lazily initialized.
* @return true, if this bean is to be lazily initialized
*/
public boolean isLazyInit() {
return BooleanUtils.toBoolean(lazyInit);
}
/**
* Returns whether this bean is to be lazily destroyed.
* @return true, if this bean is to be lazily destroyed
*/
public Boolean getLazyDestroy() {
return lazyDestroy;
}
/**
* Sets whether this bean is to be lazily destroyed.
* @param lazyDestroy whether this bean is to be lazily destroyed
*/
public void setLazyDestroy(Boolean lazyDestroy) {
this.lazyDestroy = lazyDestroy;
}
/**
* Returns whether this bean is to be lazily destroyed
* @return true, if this bean is to be lazily destroyed
*/
public boolean isLazyDestroy() {
return BooleanUtils.toBoolean(lazyDestroy);
}
/**
* Returns whether this bean is important.
* @return whether this bean is important
*/
public Boolean getImportant() {
return important;
}
/**
* Sets whether this bean is important.
* If specified as an important bean, it can not be overridden
* by another bean rule with the same name.
* @param important whether important bean
*/
public void setImportant(Boolean important) {
this.important = important;
}
/**
* Returns whether this bean is important.
* @return whether this bean is important
*/
public boolean isImportant() {
return BooleanUtils.toBoolean(important);
}
/**
* Gets the constructor argument item rule map.
* @return the constructor argument item rule map
*/
public ItemRuleMap getConstructorArgumentItemRuleMap() {
return constructorArgumentItemRuleMap;
}
/**
* Sets the constructor argument item rule map.
* @param constructorArgumentItemRuleMap the new constructor argument item rule map
*/
public void setConstructorArgumentItemRuleMap(ItemRuleMap constructorArgumentItemRuleMap) {
this.constructorArgumentItemRuleMap = constructorArgumentItemRuleMap;
}
/**
* Adds a new constructor argument item rule and returns it.
* @return the constructor argument item rule
*/
public ItemRule newConstructorArgumentItemRule() {
ItemRule itemRule = new ItemRule();
itemRule.setAutoNamed(true);
addConstructorArgumentItemRule(itemRule);
return itemRule;
}
/**
* Adds the constructor argument item rule.
* @param constructorArgumentItemRule the constructor argument item rule
*/
public void addConstructorArgumentItemRule(ItemRule constructorArgumentItemRule) {
if (constructorArgumentItemRuleMap == null) {
constructorArgumentItemRuleMap = new ItemRuleMap();
}
constructorArgumentItemRuleMap.putItemRule(constructorArgumentItemRule);
}
/**
* Gets the property item rule map.
* @return the property item rule map
*/
public ItemRuleMap getPropertyItemRuleMap() {
return propertyItemRuleMap;
}
/**
* Sets the property item rule map.
* @param propertyItemRuleMap the new property item rule map
*/
public void setPropertyItemRuleMap(ItemRuleMap propertyItemRuleMap) {
this.propertyItemRuleMap = propertyItemRuleMap;
}
/**
* Adds a new property rule with the specified name and returns it.
* @param propertyName the property name
* @return the property item rule
*/
public ItemRule newPropertyItemRule(String propertyName) {
ItemRule itemRule = new ItemRule();
itemRule.setName(propertyName);
addPropertyItemRule(itemRule);
return itemRule;
}
/**
* Adds the property item rule.
* @param propertyItemRule the new property item rule
*/
public void addPropertyItemRule(ItemRule propertyItemRule) {
if (propertyItemRuleMap == null) {
propertyItemRuleMap = new ItemRuleMap();
}
propertyItemRuleMap.putItemRule(propertyItemRule);
}
/**
* Returns whether this bean implements FactoryBean.
* @return the boolean
*/
public boolean isFactoryBean() {
return factoryBean;
}
/**
* Returns whether this bean implements DisposableBean.
* @return the boolean
*/
public boolean isDisposableBean() {
return disposableBean;
}
/**
* Returns whether this bean implements InitializableBean.
* @return the boolean
*/
public boolean isInitializableBean() {
return initializableBean;
}
public boolean isInnerBean() {
return innerBean;
}
public void setInnerBean(boolean innerBean) {
this.innerBean = innerBean;
}
/**
* Returns whether this bean has been replicated.
* @return true if this bean has been replicated; false otherwise
*/
public boolean isReplicated() {
return replicated;
}
/**
* Sets whether this bean is replicated.
* @param replicated true, if this bean is replicated
*/
public void setReplicated(boolean replicated) {
this.replicated = replicated;
}
/**
* Returns whether this bean is proxied.
* @return true if this bean is proxied; false otherwise
*/
public boolean isProxied() {
return BooleanUtils.toBoolean(proxied);
}
public Boolean getProxied() {
return proxied;
}
/**
* Sets whether this bean is proxied.
* @param proxied true, if this bean is proxied
*/
public void setProxied(boolean proxied) {
this.proxied = proxied;
}
/**
* Returns whether this bean can be proxied.
* @return true if this bean can be proxied; false otherwise
*/
public boolean isFactoryable() {
return (factoryOffered || factoryBean || factoryMethod != null);
}
public List getAutowireRuleList() {
return autowireRuleList;
}
public void addAutowireRule(AutowireRule autowireRule) {
if (autowireRuleList == null) {
autowireRuleList = new ArrayList<>();
}
autowireRuleList.add(autowireRule);
}
public AutowireRule getConstructorAutowireRule() {
return constructorAutowireRule;
}
public void setConstructorAutowireRule(AutowireRule constructorAutowireRule) {
this.constructorAutowireRule = constructorAutowireRule;
}
public boolean isConstructorAutowireParsed() {
return constructorAutowireParsed;
}
public void setConstructorAutowireParsed(boolean constructorAutowireParsed) {
this.constructorAutowireParsed = constructorAutowireParsed;
}
public boolean isFieldAutowireParsed() {
return fieldAutowireParsed;
}
public void setFieldAutowireParsed(boolean fieldAutowireParsed) {
this.fieldAutowireParsed = fieldAutowireParsed;
}
public boolean isMethodAutowireParsed() {
return methodAutowireParsed;
}
public void setMethodAutowireParsed(boolean methodAutowireParsed) {
this.methodAutowireParsed = methodAutowireParsed;
}
public DescriptionRule getDescriptionRule() {
return descriptionRule;
}
public void setDescriptionRule(DescriptionRule descriptionRule) {
this.descriptionRule = descriptionRule;
}
@Override
public BeanRule replicate() {
return replicate(this);
}
@Override
public BeanRefererType getBeanRefererType() {
return BEAN_REFERER_TYPE;
}
@Override
public String toString() {
ToStringBuilder tsb = new ToStringBuilder();
tsb.append("id", id);
if (!factoryOffered) {
tsb.append("class", className);
tsb.append("scope", scopeType);
tsb.append("initMethod", initMethodName);
tsb.append("destroyMethod", destroyMethodName);
tsb.append("factoryMethod", factoryMethodName);
tsb.append("initializableBean", initializableBean);
tsb.append("disposableBean", disposableBean);
tsb.append("factoryBean", factoryBean);
tsb.append("lazyInit", lazyInit);
tsb.append("lazyDestroy", lazyDestroy);
tsb.append("important", important);
tsb.append("proxied", proxied);
if (constructorArgumentItemRuleMap != null) {
tsb.append("constructorArguments", constructorArgumentItemRuleMap.keySet());
}
if (propertyItemRuleMap != null) {
tsb.append("properties", propertyItemRuleMap.keySet());
}
} else {
tsb.append("scope", scopeType);
tsb.append("factoryBean", factoryBeanId);
tsb.append("factoryMethod", factoryMethodName);
tsb.append("initMethod", initMethodName);
tsb.append("destroyMethod", destroyMethodName);
tsb.append("lazyInit", lazyInit);
tsb.append("lazyDestroy", lazyDestroy);
tsb.append("important", important);
tsb.append("proxied", proxied);
}
tsb.append("factoryOffered", factoryOffered);
return tsb.toString();
}
public static BeanRule newInstance(
String id,
String className,
String scanPattern,
String maskPattern,
String initMethodName,
String destroyMethodName,
String factoryMethodName,
String scope,
Boolean singleton,
Boolean lazyInit,
Boolean lazyDestroy,
Boolean important) throws IllegalRuleException {
if (className == null && scanPattern == null) {
throw new IllegalRuleException("The 'bean' element requires a 'class' attribute");
}
ScopeType scopeType = ScopeType.resolve(scope);
if (scope != null && scopeType == null) {
throw new IllegalRuleException("No scope type for '" + scope + "'");
}
if (scopeType == null) {
scopeType = (singleton == null || singleton == Boolean.TRUE ? ScopeType.SINGLETON : ScopeType.PROTOTYPE);
}
BeanRule beanRule = new BeanRule();
beanRule.setId(id);
if (scanPattern == null) {
beanRule.setClassName(className);
} else {
beanRule.setScanPattern(scanPattern);
beanRule.setMaskPattern(maskPattern);
}
beanRule.setScopeType(scopeType);
beanRule.setSingleton(singleton);
beanRule.setInitMethodName(initMethodName);
beanRule.setDestroyMethodName(destroyMethodName);
beanRule.setFactoryMethodName(factoryMethodName);
beanRule.setLazyInit(lazyInit);
beanRule.setLazyDestroy(lazyDestroy);
beanRule.setImportant(important);
return beanRule;
}
public static BeanRule newOfferedFactoryBeanInstance(
String id,
String factoryBeanId,
String factoryMethodName,
String initMethodName,
String destroyMethodName,
String scope,
Boolean singleton,
Boolean lazyInit,
Boolean lazyDestroy,
Boolean important) throws IllegalRuleException {
if (factoryBeanId == null || factoryMethodName == null) {
throw new IllegalRuleException("The 'bean' element requires both 'factoryBean' attribute and 'factoryMethod' attribute");
}
ScopeType scopeType = ScopeType.resolve(scope);
if (scope != null && scopeType == null) {
throw new IllegalRuleException("No scope type for '" + scope + "'");
}
if (scopeType == null) {
scopeType = (singleton == null || singleton == Boolean.TRUE) ? ScopeType.SINGLETON : ScopeType.PROTOTYPE;
}
BeanRule beanRule = new BeanRule();
beanRule.setId(id);
beanRule.setScopeType(scopeType);
beanRule.setSingleton(singleton);
beanRule.setFactoryBeanId(factoryBeanId);
beanRule.setFactoryMethodName(factoryMethodName);
beanRule.setFactoryOffered(true);
beanRule.setInitMethodName(initMethodName);
beanRule.setDestroyMethodName(destroyMethodName);
beanRule.setLazyInit(lazyInit);
beanRule.setLazyDestroy(lazyDestroy);
beanRule.setImportant(important);
return beanRule;
}
public static BeanRule newInnerBeanRule(
String className,
String initMethodName,
String destroyMethodName,
String factoryMethodName) throws IllegalRuleException {
if (StringUtils.hasText(destroyMethodName)) {
throw new IllegalRuleException("Inner beans does not support destroy methods");
}
BeanRule beanRule = newInstance(null, className, null, null,
initMethodName, destroyMethodName, factoryMethodName,
null, false, null, null,null);
beanRule.setInnerBean(true);
return beanRule;
}
public static BeanRule newInnerOfferedFactoryBeanRule(
String factoryBeanId,
String factoryMethodName,
String initMethodName,
String destroyMethodName) throws IllegalRuleException {
if (StringUtils.hasText(destroyMethodName)) {
throw new IllegalRuleException("Inner beans does not support destroy methods");
}
BeanRule beanRule = newOfferedFactoryBeanInstance(null, factoryBeanId, factoryMethodName,
initMethodName, destroyMethodName, null, false, null, null,null);
beanRule.setInnerBean(true);
return beanRule;
}
public static BeanRule replicate(BeanRule beanRule) {
BeanRule newBeanRule = new BeanRule();
newBeanRule.setId(beanRule.getId());
if (beanRule.getScanPattern() == null) {
newBeanRule.setBeanClass(beanRule.getBeanClass());
}
newBeanRule.setScopeType(beanRule.getScopeType());
newBeanRule.setSingleton(beanRule.getSingleton());
newBeanRule.setFactoryBeanId(beanRule.getFactoryBeanId());
newBeanRule.setFactoryMethodName(beanRule.getFactoryMethodName());
newBeanRule.setInitMethodName(beanRule.getInitMethodName());
newBeanRule.setDestroyMethodName(beanRule.getDestroyMethodName());
newBeanRule.setConstructorArgumentItemRuleMap(beanRule.getConstructorArgumentItemRuleMap());
newBeanRule.setPropertyItemRuleMap(beanRule.getPropertyItemRuleMap());
newBeanRule.setLazyInit(beanRule.getLazyInit());
newBeanRule.setLazyDestroy(beanRule.getLazyDestroy());
newBeanRule.setImportant(beanRule.getImportant());
newBeanRule.setDescriptionRule(beanRule.getDescriptionRule());
newBeanRule.setInnerBean(beanRule.isInnerBean());
newBeanRule.setReplicated(true);
return newBeanRule;
}
}