1、新建一个java项目,并在该项目下新建相应的目录以及文件:
其中lib文件夹下为依赖的jar包:mybatis.jar为mybatis依赖,mysql-connector-java.jar为连接mysql数据库依赖,log4j为打印日志依赖。
dtd文件夹中的dtd文件是为了在mybatis配置文件中按下"alt+/" 有标签提示,相关操作见前一篇。
config用来存储一些配置文件以及mapper,需要右键点击该文件夹,然后将该文件夹选择为Use as Source Folder
db.properties为连接数据库的一些属性。
log4j.xml为配置日志文件。
mybatis-config.xml为配置mybatis的文件。
2、Employee.java
package com.gong.mybatis.bean; public class Employee { private Integer id; private String lastName; private String gender; private String email; public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getLastName() { return lastName; } public void setLastName(String lastName) { this.lastName = lastName; } public String getGender() { return gender; } public void setGender(String gender) { this.gender = gender; } public String getEmail() { return email; } public void setEmail(String email) { this.email = email; } @Override public String toString() { return "Employee [id=" + id + ", lastName=" + lastName + ", gender=" + gender + ", email=" + email + "]"; } }
3、db.properties
jdbc.driver=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://localhost:3306/mybatis jdbc.username=root jdbc.password=123456
4、log4j.xml
<?xml version="1.0" encoding="UTF-8" ?> <!DOCTYPE log4j:configuration SYSTEM "log4j.dtd"> <log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/"> <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender"> <param name="Encoding" value="UTF-8" /> <layout class="org.apache.log4j.PatternLayout"> <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m (%F:%L) \n" /> </layout> </appender> <logger name="java.sql"> <level value="debug" /> </logger> <logger name="org.apache.ibatis"> <level value="info" /> </logger> <root> <level value="debug" /> <appender-ref ref="STDOUT" /> </root> </log4j:configuration>
5、mybatis-config.xml
<?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> <properties resource="db.properties"></properties> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driver}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </dataSource> </environment> </environments> <!-- 将我们写好的sql映射文件(EmployeeMapper.xml)一定要注册到全局配置文件(mybatis-config.xml)中 --> <mappers> <mapper resource="EmployeeMapper.xml" /> </mappers> </configuration>
说明:properties标签用于引入外部的一些配置。在environments中的dataSource下可配置连接数据库的一些信息,具体的value值可以使用$来获取外部资源的相关属性值。同时我们还要配置mapper文件,在该文件中主要是编写与sql相关的映射,其具体位置根据Mapper中的属性的不同会稍有不同,以后再单独写。
6、EmployeeMapper.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.gong.mybatis.EmployeeMapper"> <!-- namespace:名称空间; id:唯一标识 resultType:返回值类型 #{id}:从传递过来的参数中取出id值 --> <select id="getEmpById" resultType="com.gong.mybatis.bean.Employee"> select id,last_name lastName,email,gender from tbl_employee where id = #{id} </select> </mapper>
select标签用于从数据库中查询数据,id为标识该查询语句的唯一标识,resultType为返回的结果。
7、在数据库中新建一个名为mybatis的数据库,然后新建一个tbl_employee表,相关信息如下:
8、TestMybatis.java
package com.gong.mybatis.test; import java.io.IOException; import java.io.InputStream; 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 org.junit.Test; import com.gong.mybatis.bean.Employee; public class TestMybatis { @Test public void test() throws IOException { String resource = "mybatis-config.xml"; InputStream is = Resources.getResourceAsStream(resource); SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is); SqlSession openSession = sqlSessionFactory.openSession(); //获取sqlSession实例,能够直接执行已经映射好的sql语句 try { //返回值类型为Employee,方法为EmployeeMapper.xml中namespace的值加上id标识 Employee employee = openSession.selectOne("com.gong.mybatis.EmployeeMapper.getEmpById",1); System.out.println(employee); }finally { openSession.close(); } } }
该文件用于单元测试,测试配置是否成功。
(1)根据xml配置文件(全局配置文件)创建一个SqlSessionFactory对象 有数据源一些运行环境信息
(2)sql映射文件;配置了每一个sql,以及sql的封装规则等。
(3)将sql映射文件注册在全局配置文件中
(4)写代码:
- 根据全局配置文件得到SqlSessionFactory;
- 使用sqlSession工厂,获取到sqlSession对象使用他来执行增删改查
- 一个sqlSession就是代表和数据库的一次会话,用完关闭
(5)使用sql的唯一标志来告诉MyBatis执行哪个sql。sql都是保存在sql映射文件中的。
执行test方法为单元测试,在控制台输出:
说明Mybatis程序运行成功。需要注意的是数据库中的字段名和实体类中的要相对应。在数据库中为last_name,在mapper.xml文件中对其取名为lastName。