mybatis 在typeAliases別名時報錯的解決

更新時間：2021年09月29日 10:29:27 作者：Joker_nupt

這篇文章主要介紹了mybatis 在typeAliases別名時報錯的解決方案，具有很好的參考價值，希望對大家有所幫助。如有錯誤或未考慮完全的地方，望不吝賜教

mybatis 在typeAliases別名時報錯

Exception in thread "main" org.apache.ibatis.exceptions.PersistenceException:
### Error building SqlSession.
### Cause: org.apache.ibatis.builder.BuilderException: Error creating document instance. Cause: org.xml.sax.SAXParseException; lineNumber: 36; columnNumber: 18; 元素類型為 "configuration" 的內(nèi)容必須匹配 "(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)"。
at org.apache.ibatis.exceptions.ExceptionFactory.wrapException(ExceptionFactory.java:30)
at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:80)
at org.apache.ibatis.session.SqlSessionFactoryBuilder.build(SqlSessionFactoryBuilder.java:64)
at me.gacl.test.Test1.main(Test1.java:20)

原因

元素順序錯誤，元素類型為 "configuration" 的內(nèi)容必須匹配

"(properties?,settings?,typeAliases?,typeHandlers?,objectFactory?,objectWrapperFactory?,reflectorFactory?,plugins?,environments?,databaseIdProvider?,mappers?)"

修改如下圖后，正常。

mybatis typeAliases別名標簽

在xxxxMapper.xml文件中User無論是作為參數(shù)還是作為查詢返回數(shù)據(jù)類型，都需要寫上全限定名，實際可以寫上簡單類名即可，但是需要配置別名

MyBatis框架提供了兩種別名機制，一種是自定義別名，一種是內(nèi)置別名

自定義別名

單個的取別名

第一步：修改mybatis-config.xml配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!-- dtd約束 -->
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
  <settings>
  	<!-- 使用駝峰命名法 -->
  	<setting name="mapUnderscoreToCamelCase" value="true"/>
  </settings>
  <!-- ####################################################  -->
   <typeAliases>
   		<!--typeAlias子標簽：設置單個類型的別名
   			type:pojo或vo的數(shù)據(jù)類型，值為全限定名
   			alias:別名，一般都使用類的簡單名稱
   		  -->	
   		<typeAlias type="com.mybatis.pojo.User" alias="user"/>
   		<!-- <typeAlias type="com.mybatis.pojo.XXX" alias="xxx"/> -->
   </typeAliases>
   <!-- ####################################################  -->
  <environments default="dev_mysql">
    <environment id="dev_mysql">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/gj1?characterEncoding=utf8"/>
        <property name="username" value="root"/>
        <property name="password" value="123456"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
  	<mapper resource="com\mybatis\mapper\UserMapper.xml"/>
  </mappers>
</configuration>

第二步：修改UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.mybatis.mapper.UserMapper">
    <!-- 單行查詢功能
      resultType : 返回類型，必須和對應映射接口方法的返回類型一致，值必須為全限定名
      此時的resultType必須跟mybatis-config.xml中alias屬性值一致
     -->
     <select id="selectByPrimaryKey" parameterType="int" resultType="user">
      select id u_c_a_id,username u_c_a_name,password u_c_a_pwd,age from user where id=#{id}
     </select>
     
</mapper>

一次性給所有pojo取別名

第一步：修改mybatis-config.xml配置文件

<?xml version="1.0" encoding="UTF-8" ?>
<!-- dtd約束 -->
<!DOCTYPE configuration
  PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
  <settings>
  	<!-- 使用駝峰命名法 -->
  	<setting name="mapUnderscoreToCamelCase" value="true"/>
  </settings>
<!--    <typeAliases>
   		typeAlias子標簽：設置單個類型的別名
   			type:pojo或vo的數(shù)據(jù)類型，值為全限定名
   			alias:別名，一般都使用類的簡單名稱
   		 	
   		<typeAlias type="com.mybatis.pojo.User" alias="user"/>
   		<typeAlias type="com.mybatis.pojo.XXX" alias="xxx"/>
   </typeAliases> -->
    <!-- ####################################################  -->
   <typeAliases>
   		<!--
   			package標簽：使用包掃描配置別名
   			為對應包下面的所有類都取了別名
   			默認使用簡單的名稱作為別名
   		  -->	
   		<package name="com.mybatis.pojo"/>
   </typeAliases>
   <!-- ####################################################  -->
  <environments default="dev_mysql">
    <environment id="dev_mysql">
      <transactionManager type="JDBC"/>
      <dataSource type="POOLED">
        <property name="driver" value="com.mysql.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql://localhost:3306/gj1?characterEncoding=utf8"/>
        <property name="username" value="root"/>
        <property name="password" value="123456"/>
      </dataSource>
    </environment>
  </environments>
  <mappers>
  	<mapper resource="com\mybatis\mapper\UserMapper.xml"/>
  </mappers>
</configuration>

第二步：修改UserMapper.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE mapper
  PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="com.mybatis.mapper.UserMapper">
    <!-- 單行查詢功能
      resultType : 返回類型，必須和對應映射接口方法的返回類型一致，值必須為全限定名
      此時的resultType為pojo的簡單名，可以為user，也可以為User
     -->
     <select id="selectByPrimaryKey" parameterType="int" resultType="user">
      select id u_c_a_id,username u_c_a_name,password u_c_a_pwd,age from user where id=#{id}
     </select>     
</mapper>