一、基本信息
AliasRegistry接口用于管理Bean的别名信息(一个Bean可以对应多个别名),位于spring-core模块中,首次发布是在spring2.5.2版本,直接实现类是SimpleAliasRegistry。
二、方法
1.void registerAlias(String name, String alias)
给Bean注册别名,方法实现:由于Bean的注册是多线程的,该方法的实现逻辑用synchronized关键字包裹,采用ConcurrentHashMap缓存Bean名称和别名的映射关系。
@Override
public void registerAlias(String name, String alias) {
Assert.hasText(name, "'name' must not be empty");
Assert.hasText(alias, "'alias' must not be empty");
//ConcurrentHashMap只能保证单个put、remove方法的原子性。而不能保证多个操作同时的原子性。比如一个线程添加、一个线程删除 显然这是不被允许的,因此需要对注册逻辑加锁
synchronized (this.aliasMap) {
//当Bean名称和别名相同时,此时别名将失去意义,于是把这个映射关系移除
if (alias.equals(name)) {
this.aliasMap.remove(alias);
if (logger.isDebugEnabled()) {
logger.debug("Alias definition '" + alias + "' ignored since it points to same name");
}
}
else {
String registeredName = this.aliasMap.get(alias);
//判断当前别名是否已注册
if (registeredName != null) {
//已注册且和当前Bean的名称相同,直接返回
if (registeredName.equals(name)) {
// An existing alias - no need to re-register
return;
}
//若该别名映射了Bean且不允许覆写此别名(让其指向别的Bean),直接报错
if (!allowAliasOverriding()) {
throw new IllegalStateException("Cannot define alias '" + alias + "' for name '" +
name + "': It is already registered for name '" + registeredName + "'.");
}
if (logger.isDebugEnabled()) {
logger.debug("Overriding alias '" + alias + "' definition for registered name '" +
registeredName + "' with new target name '" + name + "'");
}
}
//检查别名循环引用的情况,如注册了(A->B),后面再注册(B->A)的时候就会报错
checkForAliasCircle(name, alias);
//别名注册
this.aliasMap.put(alias, name);
if (logger.isTraceEnabled()) {
logger.trace("Alias definition '" + alias + "' registered for name '" + name + "'");
}
}
}
}
2.void removeAlias(String alias)
从Bean别名注册表中移除给定的别名映射关系,方法实现:
@Override
public void removeAlias(String alias) {
synchronized (this.aliasMap) {
String name = this.aliasMap.remove(alias);
if (name == null) {
throw new IllegalStateException("No alias '" + alias + "' registered");
}
}
}
3.boolean isAlias(String name)
判断指定的Bean的name是否已作为别名
4.String[] getAliases(String name)
获取指定的Bean的所有别名,具体逻辑:遍历别名注册表获取所有alias