mybatis环境搭建

约定不等于承诺〃 2023-08-17 17:46 75阅读 0赞

### 什么是mybatis？ ###

1.  MyBatis是支持普通SQL查询，存储过程和高级映射的优秀持久层框架。
2.  MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及结果集的检索。
3.  MyBatis使用简单的XML或注解用于配置和原始映射，  
    将接口和Java的POJOs（Plan Old Java Objects，普通的Java对象）映射成数据库中的记录.

### orm工具的基本思想 ###

无论是用过的hibernate,mybatis,你都可以法相他们有一个共同点：

1.  从配置文件(通常是XML配置文件中)得到 sessionfactory.
2.  由sessionfactory 产生 session
3.  在session 中完成对数据的增删改查和事务提交等.
4.  在用完之后关闭session 。
5.  在java 对象和 数据库之间有做mapping 的配置文件，也通常是xml 文件。

### 环境搭建 ###

1.  相应的jar包的下载地址：[https://code.google.com/p/mybatis/downloads/list?can=1][https_code.google.com_p_mybatis_downloads_list_can_1]，这里使用的3.2版，我们要下载的是mybatis-jpetstore-6.0.1-bundle.zip（下面有例子文件）和mybatis-3.2.0-bundle.zip（包含相应的jar）
2.  现阶段，你可以直接建立java 工程，但一般都是开发web项目，这个系列教程最后也是web的，  
    所以一开始就建立web工程。
3.  将 mybatis-3.2.0.jar，mysql-connector-java-5.1.13-bin 和lib下的jar包，拷贝到 web工程的lib目录.并去  
    mybatis-jpetstore-6.0.1-bundle拷贝一个log4j.properties文件到src目录下
4.  创建mysql 测试数据库和用户表,注意，这里采用的是 utf-8 编码
    
        CREATE DATABASE `mybatis`
          CHARACTER SET 'utf8'
          COLLATE 'utf8_general_ci';
         创建用户表,并插入一条测试数据
         Create TABLE `user` (
         	`id` int(11) NOT NULL AUTO_INCREMENT,
         	`userName` varchar(50) DEFAULT NULL,
         	`userAge` int(11) DEFAULT NULL,
         	`userAddress` varchar(200) DEFAULT NULL,
         	PRIMARY KEY (`id`)
         ) ENGINE=InnoDB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8;
         Insert INTO `user` VALUES ('1', 'fjh', '100', '深圳,罗湖');

到此为止，前期准备工作就完成了。下面开始真正配置mybatis项目了。  
5. **设置mybatis配置文件**:Configuration.xml, 文件建立在项目的src路径下面，可以在MyBatis-3-User-Guide-Simplified-Chinese.pdf中找到配置文件的格式;内容如下

<?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>
    		<typeAliases> 
    			<typeAlias alias="User" type="com.fjh.bean.User"/> 
    		</typeAliases> 
    		<environments default="development">
    			<environment id="development">
    			<transactionManager type="JDBC"/>
    				<dataSource type="POOLED">
    				<property name="driver" value="com.mysql.jdbc.Driver"/>
    				<property name="url" value="jdbc:mysql://127.0.0.1:3306/mybatis" />
    				<property name="username" value="root"/>
    				<property name="password" value="123"/>
    				</dataSource>
    			</environment>
    		</environments>
        <mappers>
    	        <mapper resource="com/fjh/bean/User.xml"/>
    	    </mappers>
    	</configuration>

**6、 建立与数据库对应的 java class,以及映射文件.**  
在src\_user下建立package:com.fjh.bean ,并在这个 package 下建立 User 类

public class User { 
    	      private int id;
    	    	private String userName;
    	    	private String userAge;
    	    	private String userAddress;
    	    public int getId() { 
    				return id;
    			}
    			public void setId(int id) { 
    				this.id = id;
    			}
    			public String getUserName() { 
    				return userName;
    			}
    			public void setUserName(String userName) { 
    				this.userName = userName;
    			}
    			public String getUserAge() { 
    				return userAge;
    			}
    			public void setUserAge(String userAge) { 
    				this.userAge = userAge;
    			}
    			public String getUserAddress() { 
    				return userAddress;
    		}
    			public void setUserAddress(String userAddress) { 
    				this.userAddress = userAddress;
    			}
    	}

**7、在源文件的同目录建立User.xml文件**，文件的格式可以在  
mybatis-jpetstore-6.0.1-bundle\\mybatis-jpetstore-6.0.1\\mybatis-jpetstore-6.0.1.war\\WEB-INF\\classes\\org\\mybatis\\jpetstore\\persistence\\找到相应的格式，也可以在MyBatis-3-User-Guide-Simplified-Chinese.pdf找到相应的模板内容如下：

<?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.fjh.bean.User">
    	        <select id="selectUserByID" parameterType="int" resultType="User">
    	            select * from `user` where id = #{id}
    	        </select>
    	    </mapper>

**8、下面对这几个配置文件解释下：**  
1.Configuration.xml 是 mybatis 用来建立 sessionFactory 用的，里面主要包含了数据库连接相关东西，  
还有 java 类所对应的别名，比如  
这个别名非常重要，你在 具体的类的映射中，比如User.xml 中 resultType 就是对应这里的。  
要保持一致，当然这里的 resultType 还有另外单独的定义方式，后面再说。  
2. Configuration.xml 里面 的是包含要映射的类的xml配置文件。  
3. 在User.xml 文件里面 主要是定义各种SQL 语句，以及这些语句的参数，以及要返回的类型等.

**9、开始测试源码目录下建立com.fjh.test这个package,并建立测试类Test**，然后运行要看到从数据库查询的结果

package com.fjh.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 com.fjh.bean.User;
    
    	public class Test { 
    
    		private static SqlSessionFactory sqlSessionFactory;
    		
    		//根据配置文件初始化SqlSessionFactory
    		static { 
    		   try { 
    			//读取src目录下的配置文件
    			InputStream in = Resources.getResourceAsStream("Configuration.xml");
    			//初始化sqlSessionFactory 报错可能没有拷贝相应的jar包
    			sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);
    		} catch (IOException e) { 
    			// TODO Auto-generated catch block
    			e.printStackTrace();
    		}
    		}
    		
    		/** * @param args */
    		public static void main(String[] args) { 
    			//获取一个session
    			SqlSession sqlSession = sqlSessionFactory.openSession();
    			
    			try { 
    				//根据配置文件User.xml中的id去获取相应的sql语句
    				User user = (User)sqlSession.selectOne("com.fjh.bean.User.selectUserByID",new Integer(1));
    				System.out.println(user.getUserName() + " " + user.getUserAddress());
    			} catch (Exception e) { 
    				// TODO: handle exception
    			}
    			
    		}
    
    	}

**10、实现以接口的形式编程。**  
其实还有更简单的方法，而且是更好的方法，使用合理描述参数和SQL语句返回值的接口  
（比如UserMap.class），这样现在就可以至此那个更简单，  
更安全的代码，没有容易发生的字符串文字和转换的错误.下面是详细过程

package com.fjh.inter;
    		import com.fjh.bean.User;
    		public interface UserMap { 
    		/** * selectUserByID 名字是配置文件中<select id="selectUserByID" * @return */
    		public User selectUserByID(int id);
    	}

接口和原来的User.xml不在同一包下所以要修改配置文件

<mapper namespace="com.fjh.inter.UserMap">
    		<select id="selectUserByID" parameterType="int" resultType="User">
    			select * from `user` where id = #{id}
    		</select>
    	</mapper>

测试的调用说明：

SqlSession sqlSession = sqlSessionFactory.openSession();
    	
    	try { 
    		//根据配置文件User.xml中的id去获取相应的sql语句
    		//User user = (User)sqlSession.selectOne("com.fjh.bean.User.selectUserByID",new Integer(1));
    		
    		//以接口的形式编程 在配置文件中要修改<mapper namespace="com.fjh.inter.UserMap">
    		UserMap userManager = (UserMap)sqlSession.getMapper(UserMap.class);
    		User user = userManager.selectUserByID(1);
    		System.out.println(user);
    		System.out.println(user.getUserName() + " : " + user.getUserAddress());
    	} catch (Exception e) { 
    		e.printStackTrace();
    	}
    //如果配置User.xml和接口不在同一个包中，则需要在定义namespace的时候给定接口的全名

[https_code.google.com_p_mybatis_downloads_list_can_1]: https://code.google.com/p/mybatis/downloads/list?can=1