Mybatis配置之typeAlias标签
在实际的工程之中，类的全限定名称很长，当我们需要大量使用的时候，这非常不方便的，然而mybatis提供了typeAlias别名标签供我们别名和自定义别名，然而在mybatis之中别名的注册实际上由TypeAliasRegistry去定义，需要非常注意的是，在mybatis中名不区分大小写的，这一点非常重要。下面展示了mybatis自己自动初始化了一些别名：
那么他是如何实现初始化别名的呢？
一般的是通过Configuration获取TypeAliasRegistry类对象其中有一个getTypeAliasRegisry方法获取别名，获取之后就可以通过registerAlias方法对别名注册了。事实上Configuration对象也对一些常用的配置项配置了别名：
public class TypeAliasRegistry {
//使用的HashMap来传记录，String为键或者属性名称，Class则为键值或者为
//属性值。
private final Map> TYPE_ALIASES = new HashMap>();
/*
* TypeAliasRegistry主要进行初始化别名的配置，
*/
public TypeAliasRegistry() {
/*
* 初始化别名
* e.g. 调用registerAlias方法注册别名
*
*/
registerAlias("string", String.class);
registerAlias("byte", Byte.class);
registerAlias("long", Long.class);
registerAlias("short", Short.class);
registerAlias("int", Integer.class);
registerAlias("integer", Integer.class);
registerAlias("double", Double.class);
registerAlias("float", Float.class);
registerAlias("boolean", Boolean.class);
registerAlias("byte[]", Byte[].class);
registerAlias("long[]", Long[].class);
registerAlias("short[]", Short[].class);
registerAlias("int[]", Integer[].class);
registerAlias("integer[]", Integer[].class);
registerAlias("double[]", Double[].class);
registerAlias("float[]", Float[].class);
registerAlias("boolean[]", Boolean[].class);
registerAlias("_byte", byte.class);
registerAlias("_long", long.class);
registerAlias("_short", short.class);
registerAlias("_int", int.class);
registerAlias("_integer", int.class);
registerAlias("_double", double.class);
registerAlias("_float", float.class);
registerAlias("_boolean", boolean.class);
registerAlias("_byte[]", byte[].class);
registerAlias("_long[]", long[].class);
registerAlias("_short[]", short[].class);
registerAlias("_int[]", int[].class);
registerAlias("_integer[]", int[].class);
registerAlias("_double[]", double[].class);
registerAlias("_float[]", float[].class);
registerAlias("_boolean[]", boolean[].class);
registerAlias("date", Date.class);
registerAlias("decimal", BigDecimal.class);
registerAlias("bigdecimal", BigDecimal.class);
registerAlias("biginteger", BigInteger.class);
registerAlias("object", Object.class);
registerAlias("date[]", Date[].class);
registerAlias("decimal[]", BigDecimal[].class);
registerAlias("bigdecimal[]", BigDecimal[].class);
registerAlias("biginteger[]", BigInteger[].class);
registerAlias("object[]", Object[].class);
registerAlias("map", Map.class);
registerAlias("hashmap", HashMap.class);
registerAlias("list", List.class);
registerAlias("arraylist", ArrayList.class);
registerAlias("collection", Collection.class);
registerAlias("iterator", Iterator.class);
registerAlias("ResultSet", ResultSet.class);
}
@SuppressWarnings("unchecked")
// throws class cast exception as well if types cannot be assigned
public Class resolveAlias(String string) {
try {
if (string == null) {
return null;
}
// issue #748
String key = string.toLowerCase(Locale.ENGLISH);
Class value;
if (TYPE_ALIASES.containsKey(key)) {
value = (Class) TYPE_ALIASES.get(key);
} else {
value = (Class) Resources.classForName(string);
}
return value;
} catch (ClassNotFoundException e) {
throw new TypeException("Could not resolve type alias '" + string + "'. Cause: " + e, e);
}
}
/*
* registerAlias方法输入参数为包的路径名称，并且其要注册的对应的类
* 既可以仅通过包的完整名称进行注册，也可以通过提供包名和对应的类的注册
* 类型。
* 方法1，通过提供包名称进行注册，默认的注册为Object类
*/
public void registerAliases(String packageName){
registerAliases(packageName, Object.class);
}
/*
* ResolverUtil用于定位，某一个类的路径，可满足任意条件类。两个最常见的条件是
* 一个类实现/继承另一个类，或者用一个特定的注释注释它。但是，通过使用测试类，
* 可以使用任意条件进行搜索。
* 类加载器是用于定位所有位置（目录和JAR文件）在类路径中包含在一定的包装类，
* 然后加载这些类和检查。默认情况下，类加载器使用的的线程可以由currentthread()。
* getcontextclassloader()获取其名称， 但这可以通过调用setclassloader（ClassLoader）
* 方法重写
*/
/*
* 方法2：主要是利用ResolverUtil对提供的超类，和包名方式进行注册
*/
public void registerAliases(String packageName, Class superType){
ResolverUtil> resolverUtil = new ResolverUtil>();
resolverUtil.find(new ResolverUtil.IsA(superType), packageName);
Set>> typeSet = resolverUtil.getClasses();
for(Class type : typeSet){
// Ignore inner classes and interfaces (including package-info.java)
// Skip also inner classes. See issue #6
//判断是否为匿名类或者是接口，成员类即类中的嵌套类，是的话不注册
if (!type.isAnonymousClass() && !type.isInterface() && !type.isMemberClass()) {
registerAlias(type);
}
}
}
/*
* 方法3，仅提供注册类型
*/
public void registerAlias(Class type) {
String alias = type.getSimpleName();
Alias aliasAnnotation = type.getAnnotation(Alias.class);
if (aliasAnnotation != null) {
alias = aliasAnnotation.value();
}
registerAlias(alias, type);
}
public void registerAlias(String alias, Class value) {
if (alias == null) {
throw new TypeException("The parameter alias cannot be null");
}
// issue #748
String key = alias.toLowerCase(Locale.ENGLISH);
if (TYPE_ALIASES.containsKey(key) && TYPE_ALIASES.get(key) != null && !TYPE_ALIASES.get(key).equals(value)) {
throw new TypeException("The alias '" + alias + "' is already mapped to the value '" + TYPE_ALIASES.get(key).getName() + "'.");
}
TYPE_ALIASES.put(key, value);
}
public void registerAlias(String alias, String value) {
try {
registerAlias(alias, Resources.classForName(value));
} catch (ClassNotFoundException e) {
throw new TypeException("Error registering type alias "+alias+" for "+value+". Cause: " + e, e);
}
}
/**
* @since 3.2.2
*/
public Map> getTypeAliases() {
return Collections.unmodifiableMap(TYPE_ALIASES);
}
}
这样就会扫描指定的这个包，并将这个包中的类的第一个字母变为小写字母的新名字作为别名，假如扫描的多个包中有同名称的类，这时候就会产生异常，此时我们可以在pojo类添加Alias注解。
@Alias("User2")
public class User{
····
}