1. 創(chuàng)建數(shù)據(jù)庫(kù)mybatis 及表
2. 創(chuàng)建 Web 應(yīng)用,并添加相關(guān) JAR 包
在 MyEclipse 中創(chuàng)建一個(gè)名為 myBatisDemo01 的 Web 應(yīng)用,將 MyBatis 的核心 JAR 包、依賴(lài) JAR 包以及 MySQL 數(shù)據(jù)庫(kù)的驅(qū)動(dòng) JAR 包一起復(fù)制到 /WEB-INF/lib 目錄下。添加后的 lib 目錄如圖 1 所示
創(chuàng)建日志文件
MyBatis 默認(rèn)使用 log4j 輸出日志信息,如果開(kāi)發(fā)者需要查看控制臺(tái)輸出的 SQL 語(yǔ)句,那么需要在 classpath 路徑下配置其日志文件。在 myBatis應(yīng)用的 src 目錄下創(chuàng)建 log4j.properties 文件,其內(nèi)容如下:
# Global logging configuration log4j.rootLogger=ERROR,stdout # MyBatis logging configuration... log4j.logger.com.mybatis=DEBUG # Console output... log4j.appender.stdout=org.apache.log4j.ConsoleAppender log4j.appender.stdout.layout=org.apache.log4j.PatternLayout log4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n
在日志文件中配置了全局的日志配置、MyBatis 的日志配置和控制臺(tái)輸出,其中 MyBatis 的日志配置用于將 com.mybatis 包下所有類(lèi)的日志記錄級(jí)別設(shè)置為 DEBUG。該配置文件內(nèi)容不需要開(kāi)發(fā)者全部手寫(xiě),可以從 MyBatis 使用手冊(cè)中的 Logging 小節(jié)復(fù)制,然后進(jìn)行簡(jiǎn)單修改。
4. 創(chuàng)建持久化類(lèi)
在 src 目錄下創(chuàng)建一個(gè)名為 com.mybatis.po 的包,在該包中創(chuàng)建持久化類(lèi) MyUser,注意在類(lèi)中聲明的屬性與數(shù)據(jù)表 user 的字段一致。
MyUser 的代碼如下:
package com.mybatis.po; public class MyUser { private Integer uid; //主鍵 private String uname; private String usex; // 此處省略setter和getter方法 @Override public String toString() {//為了方便查看結(jié)果,重寫(xiě)了toString方法 return "User[uid=" + uid + ", uname=" + uname + ",usex=" + usex +"]"; } public String getUname() { return uname; } public String getUsex() { return usex; } public Integer getUid() { return uid; } public void setUname(String uname) { this.uname = uname; } public void setUsex(String usex) { this.usex = usex; } public void setUid(Integer uid) { this.uid = uid; } }
5. 創(chuàng)建映射文件
在 src 目錄下創(chuàng)建一個(gè)名為 com.mybatis.mapper 的包,在該包中創(chuàng)建映射文件 UserMapper.xml。
UserMapper.xml 文件的內(nèi)容如下:
<?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"> <!-- 根據(jù)uid查詢(xún)一個(gè)用戶(hù)信息 --> <select id="selectUserById" parameterType="Integer" resultType="com.mybatis.po.MyUser"> select * from user where uid = #{uid} </select> <!-- 查詢(xún)所有用戶(hù)信息 --> <select id="selectAllUser" resultType="com.mybatis.po.MyUser"> select * from user </select> <!-- 添加一個(gè)用戶(hù),#{uname}為com.mybatis.po.MyUser的屬性值 --> <insert id="addUser" parameterType="com.mybatis.po.MyUser"> insert into user(uname,usex)values(#{uname},#{usex}) </insert> <!-- 修改一個(gè)用戶(hù) --> <update id="updateUser" parameterType="com.mybatis.po.MyUser"> update user set uname = #{uname},usex = #{usex} where uid = #{uid} </update> <!-- 刪除一個(gè)用戶(hù) --> <delete id="deleteUser" parameterType="Integer"> delete from user where uid = #{uid} </delete> </mapper>
在上述映射文件中,<mapper> 元素是配置文件的根元素,它包含了一個(gè) namespace 屬性,該屬性值通常設(shè)置為“包名+SQL映射文件名”,指定了唯一的命名空間。
子元素 <select>、<insert>、<update> 以及 <delete> 中的信息是用于執(zhí)行查詢(xún)、添加、修改以及刪除操作的配置。在定義的 SQL 語(yǔ)句中,“#{}”表示一個(gè)占位符,相當(dāng)于“?”,而“#{uid}”表示該占位符待接收參數(shù)的名稱(chēng)為 uid。
6. 創(chuàng)建 MyBatis 的配置文件
在 src 目錄下創(chuàng)建 MyBatis 的核心配置文件 mybatis-config.xml,在該文件中配置了數(shù)據(jù)庫(kù)環(huán)境和映射文件的位置,具體內(nèi)容如下:
<?xml version="1.0" encoding="utf-8"?> <!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN" "http://mybatis.org/dtd/mybatis-3-config.dtd"> <configuration> <settings> <setting name="logImpl" value="LOG4J" /> </settings> <!-- 配置mybatis運(yùn)行環(huán)境 --> <environments default="development"> <environment id="development"> <!-- 使用JDBC的事務(wù)管理 --> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <!-- MySQL數(shù)據(jù)庫(kù)驅(qū)動(dòng) --> <property name="driver" value="com.mysql.jdbc.Driver" /> <!-- 連接數(shù)據(jù)庫(kù)的URL --> <property name="url" value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf8" /> <property name="username" value="root" /> <property name="password" value="root" /> </dataSource> </environment> </environments> <!-- 將mapper文件加入到配置文件中 --> <mappers> <mapper resource="com/mybatis/mapper/UserMapper.xml" /> </mappers> </configuration>
7. 創(chuàng)建測(cè)試類(lèi)
在 src 目錄下創(chuàng)建一個(gè)名為 com.mybatis.test 的包,在該包中創(chuàng)建 MyBatisTest 測(cè)試類(lèi)。在測(cè)試類(lèi)中首先使用輸入流讀取配置文件,然后根據(jù)配置信息構(gòu)建 SqlSessionFactory 對(duì)象。
接下來(lái)通過(guò) SqlSessionFactory 對(duì)象創(chuàng)建 SqlSession 對(duì)象,并使用 SqlSession 對(duì)象的方法執(zhí)行數(shù)據(jù)庫(kù)操作。 MyBatisTest 測(cè)試類(lèi)的代碼如下:
package com.mybatis.test; import java.io.IOException; import java.io.InputStream; import java.util.List; import org.apache.ibatis.io.Resources; import org.apache.ibatis.session.SqlSession; import org.apache.ibatis.session.SqlSessionFactory; import org.apache.ibatis.session.SqlSessionFactoryBuilder; import com.mybatis.po.MyUser; public class MyBatisTest { public static void main(String[] args) { try { //讀取配置文件 mybatis-config.xml InputStream config = Resources.getResourceAsStream("mybatis-config.xml"); //根據(jù)配置文件構(gòu)建SqlSessionFactory SqlSessionFactory ssf = new SqlSessionFactoryBuilder().build(config); //通過(guò) SqlSessionFactory 創(chuàng)建SqlSession SqlSession ss = ssf.openSession(); //SqlSession執(zhí)行映射文件中定義的SQL,并返回映射結(jié)果 //com.mybatis.mapper.UserMapper.selectUserById為UserMapper.xml中的命名空間+select 的id //查詢(xún)一個(gè)用戶(hù) /*MyUser mu = ss.selectOne("com.mybatis.mapper.UserMapper.selectUserById", 1); System.out.println(mu.getUname() + mu.getUid());*/ //添加一個(gè)用戶(hù) MyUser addmu = new MyUser(); addmu.setUname("小李張"); addmu.setUsex("男"); Integer one = ss.insert("com.mybatis.mapper.UserMapper.addUser", addmu); ss.commit(); System.out.println(one); //修改一個(gè)用戶(hù) MyUser updatemu = new MyUser(); updatemu.setUid(1); updatemu.setUname("小小劉"); updatemu.setUsex("女"); Integer count = ss.update("com.mybatis.mapper.UserMapper.updateUser",updatemu); System.out.println(count); //刪除一個(gè)用戶(hù) ss.delete("com.mybatis.mapper.UserMapper.deleteUser",1); List<MyUser> result = ss.selectList("com.mybatis.mapper.UserMapper.selectAllUser"); for(MyUser row : result) { System.out.println(row); } ss.commit(); ss.close(); } catch(IOException e) { System.out.println(e.getMessage()); } } }
上述測(cè)試類(lèi)的運(yùn)行結(jié)果如圖 2 所示。