Mybatis（一）

一、Mybatis介绍

1、介绍

MyBatis 本是apache的一个开源项目iBatis, 2010年这个项目由apache software foundation 迁移到了google code，并且改名为MyBatis 。2013年11月迁移到Github。
  MyBatis是一个优秀的持久层框架，它对jdbc的操作数据库的过程进行封装，使开发者只需要关注 SQL 本身，而不需要花费精力去处理例如注册驱动、创建connection、创建statement、手动设置参数、结果集检索等jdbc繁杂的过程代码。
Mybatis通过xml或注解的方式将要执行的各种statement（statement、preparedStatemnt、CallableStatement）配置起来，并通过java对象和statement中的sql进行映射生成最终执行的sql语句，最后由mybatis框架执行sql并将结果映射成java对象并返回。

2、Mybatis架构

（1）mybatis配置
SqlMapConfig.xml，此文件作为mybatis的全局配置文件，配置了mybatis的运行环境等信息。
mapper.xml文件即sql映射文件，文件中配置了操作数据库的sql语句。此文件需要在SqlMapConfig.xml中加载。
（2）通过mybatis环境等配置信息构造SqlSessionFactory即会话工厂
（3）由会话工厂创建sqlSession即会话，操作数据库需要通过sqlSession进行。
（4）mybatis底层自定义了Executor执行器接口操作数据库，Executor接口有两个实现，一个是基本执行器、一个是缓存执行器。
（5）Mapped Statement也是mybatis一个底层封装对象，它包装了mybatis配置信息及sql映射信息等。mapper.xml文件中一个sql对应一个Mapped Statement对象，sql的id即是Mapped statement的id。
（6）Mapped Statement对sql执行输入参数进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql前将输入的java对象映射至sql中，输入参数映射就是jdbc编程中对preparedStatement设置参数。
（7）Mapped Statement对sql执行输出结果进行定义，包括HashMap、基本类型、pojo，Executor通过Mapped Statement在执行sql后将输出结果映射至java对象中，输出结果映射过程相当于jdbc编程中对结果的解析处理过程。

二、Mybatis入门

1、下载网址：https://github.com/mybatis/mybatis-3/releases

入门学习：http://www.mybatis.org/mybatis-3/zh/getting-started.html

2、入门程序

（1）导入jar包

加入mybatis核心包、依赖包、数据驱动包。

mybatis核心包：

依赖包：

数据库驱动包：

（2）加入配置文件

编写log4j.properties和SqlMapConfig.xml配置文件

log4j.properties

# Global logging configurationlog4j.rootLogger=DEBUG, stdout# Console output...log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

mybatis默认使用log4j作为输出日志信息。

SqlMapConfig.xml

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 和spring整合后 environments配置将废除 --><environments default="development"><environment id="development"><!-- 使用jdbc事务管理 --><transactionManager type="JDBC" /><!-- 数据库连接池 --><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver" /><property name="url"value="jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8" /><property name="username" value="root" /><property name="password" value="root" /></dataSource></environment></environments><!-- 加载映射文件 --><mappers><mapper resource="sqlmap/User.xml" /></mappers></configuration>

（3）创建pojo和映射文件

User.java

package com.sh.mybatis.pojo;import java.io.Serializable;import java.util.Date;public class User implements Serializable {private static final long serialVersionUID = 1L;private Integer id;private String username;// 用户姓名private String sex;// 性别private Date birthday;// 生日private String address;// 地址public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getUsername() {return username;}public void setUsername(String username) {this.username = username;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}public Date getBirthday() {return birthday;}public void setBirthday(Date birthday) {this.birthday = birthday;}public String getAddress() {return address;}public void setAddress(String address) {this.address = address;}@Overridepublic String toString() {return "User [id=" + id + ", username=" + username + ", sex=" + sex+ ", birthday=" + birthday + ", address=" + address + "]";}}

User.xml

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 --><mapper namespace="test"><!-- 通过id查询一个用户 --><select id="findUserById" parameterType="Integer" resultType="com.sh.mybatis.pojo.User">select * from user where id = #{v}</select><!-- 根据用户名称查询用列表 --><!-- #{} select * from user where id = ? 占位符? == '王五'${} select * from user where usrename like 字符串拼接 --><select id="findUserByUsername" parameterType="String" resultType="com.sh.mybatis.pojo.User"><!-- select * from user where username like  '%${value}%' -->select * from user where username like  "%"#{haha}"%"</select><!-- 添加用户 --><insert id="insertUser" parameterType="com.sh.mybatis.pojo.User"><!-- 获得最新id并添加到id字段 --><selectKey keyProperty="id" resultType="Integer" order="AFTER">select LAST_INSERT_ID()</selectKey>insert into user (username,birthday,address,sex) values (#{username},#{birthday},#{address},#{sex})</insert><!-- 更新用户 --><update id="updateUserById" parameterType="com.sh.mybatis.pojo.User">update user set username = #{username},sex = #{sex},birthday = #{birthday},address = #{address} where id = #{id}</update><!-- 删除用户 --><delete id="deleteUserById" parameterType="Integer">delete from user where id = #{v}</delete></mapper>

（4）在SqlMapConfig.xml中加载映射文件

（5）测试程序

MybatisFirstTest.java

package com.sh.mybatis.junit;import static org.junit.Assert.*;import java.io.InputStream;import java.util.Date;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 org.junit.Test;import com.sh.mybatis.pojo.User;public class MybatisFirstTest {// 根据用户id查询@Testpublic void testMybatis() throws Exception {// 1.加载核心配置文件String resource = "sqlMapConfig.xml";InputStream is = Resources.getResourceAsStream(resource);// 2.创建一个 SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);// 3.创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4.执行sql语句User user = sqlSession.selectOne("test.findUserById", 10);System.out.println(user);}// 根据用户名模糊查询@Testpublic void testfindUserByUsername() throws Exception {// 1.加载核心配置文件String resource = "sqlMapConfig.xml";InputStream is = Resources.getResourceAsStream(resource);// 2.创建一个 SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);// 3.创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4.执行sql语句List<User> list = sqlSession.selectList("test.findUserByUsername", "五");for (User user : list) {System.out.println(user);}}// 添加用户@Testpublic void testInsertUser() throws Exception {// 加载核心配置文件String resource = "sqlMapConfig.xml";InputStream in = Resources.getResourceAsStream(resource);// 创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);// 创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 执行Sql语句User user = new User();user.setUsername("徐志摩");user.setBirthday(new Date());user.setAddress("上海滩");user.setSex("男");int i = sqlSession.insert("test.insertUser", user);sqlSession.commit();System.out.println(user.getId());}// 修改用户@Testpublic void testUpdateUserById() throws Exception {// 加载核心配置文件String resource = "sqlMapConfig.xml";InputStream in = Resources.getResourceAsStream(resource);// 创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);// 创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 执行Sql语句User user = new User();user.setId(29);user.setUsername("戴望舒");user.setBirthday(new Date());user.setAddress("上海滩");user.setSex("男");int i = sqlSession.update("test.updateUserById", user);sqlSession.commit();}// 删除用户@Testpublic void testDeleteUserById() throws Exception {// 加载核心配置文件String resource = "sqlMapConfig.xml";InputStream in = Resources.getResourceAsStream(resource);// 创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(in);// 创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 执行Sql语句sqlSession.delete("test.deleteUserById",30);sqlSession.commit();}}

（6）User.xml映射文件的sql配置

前文已经给出配置好的代码

（7）小结

A、#{}和${}

#{}表示一个占位符号，通过#{}可以实现preparedStatement向占位符中设置值，自动进行java类型和jdbc类型转换。#{}可以有效防止sql注入。 #{}可以接收简单类型值或pojo属性值。 如果parameterType传输单个简单类型值，#{}括号中可以是value或其它名称。


${}表示拼接sql串，通过${}可以将parameterType 传入的内容拼接在sql中且不进行jdbc类型转换， ${}可以接收简单类型值或pojo属性值，如果parameterType传输单个简单类型值，${}括号中只能是value。

B、parameterType和resultType

parameterType：指定输入参数类型，mybatis通过ognl从输入对象中获取参数值拼接在sql中。
resultType：指定输出结果类型，mybatis将sql查询结果的一行记录数据映射为resultType指定类型的对象。如果有多条数据，则分别进行映射，并把对象放到容器List中

C、selectOne和selectList

selectOne查询一条记录，如果使用selectOne查询多条记录则抛出异常：
org.apache.ibatis.exceptions.TooManyResultsException: Expected one result (or null) to be returned by selectOne(), but found: 3
at org.apache.ibatis.session.defaults.DefaultSqlSession.selectOne(DefaultSqlSession.java:70)
selectList可以查询一条或多条记录。

三、Mybatis解决jdbc编程问题

1、 数据库连接创建、释放频繁造成系统资源浪费从而影响系统性能，如果使用数据库连接池可解决此问题。

解决：在SqlMapConfig.xml中配置数据连接池，使用连接池管理数据库链接。

2、 Sql语句写在代码中造成代码不易维护，实际应用sql变化的可能较大，sql变动需要改变java代码。

解决：将Sql语句配置在XXXXmapper.xml文件中与java代码分离。

3、 向sql语句传参数麻烦，因为sql语句的where条件不一定，可能多也可能少，占位符需要和参数一一对应。

解决：Mybatis自动将java对象映射至sql语句，通过statement中的parameterType定义输入参数的类型。

4、 对结果集解析麻烦，sql变化导致解析代码变化，且解析前需要遍历，如果能将数据库记录封装成pojo对象解析比较方便。

解决：Mybatis自动将sql执行结果映射至java对象，通过statement中的resultType定义输出结果的类型。

四、Mybatis与Hibernate的不同（面试）

1、Mybatis和hibernate不同，它不完全是一个ORM框架，因为MyBatis需要程序员自己编写Sql语句。mybatis可以通过XML或注解方式灵活配置要运行的sql语句，并将java对象和sql语句映射生成最终执行的sql，最后将sql执行的结果再映射生成java对象。

2、Mybatis学习门槛低，简单易学，程序员直接编写原生态sql，可严格控制sql执行性能，灵活度高，非常适合对关系数据模型要求不高的软件开发，例如互联网软件、企业运营类软件等，因为这类软件需求变化频繁，一但需求变化要求成果输出迅速。但是灵活的前提是mybatis无法做到数据库无关性，如果需要实现支持多种数据库的软件则需要自定义多套sql映射文件，工作量大。

3、Hibernate对象/关系映射能力强，数据库无关性好，对于关系模型要求高的软件（例如需求固定的定制化软件）如果用hibernate开发可以节省很多代码，提高效率。但是Hibernate的学习门槛高，要精通门槛更高，而且怎么设计O/R映射，在性能和对象模型之间如何权衡，以及怎样用好Hibernate需要具有很强的经验和能力才行。

总之，按照用户的需求在有限的资源环境下只要能做出维护性、扩展性良好的软件架构都是好架构，所以框架只有适合才是最好。 

五、Dao开发

使用MyBatis开发Dao，通常有两个方法，即原始Dao开发方法和Mapper动态代理开发方法。

1、需求

使用MyBatis开发DAO实现以下的功能：
根据用户id查询一个用户信息
根据用户名称模糊查询用户信息列表
添加用户信息

2、SqlSession的使用范围

SqlSession中封装了对数据库的操作，如：查询、插入、更新、删除等。
SqlSession通过SqlSessionFactory创建。
SqlSessionFactory是通过SqlSessionFactoryBuilder进行创建。

（1）SqlSessionFactoryBuilder
SqlSessionFactoryBuilder用于创建SqlSessionFacoty，SqlSessionFacoty一旦创建完成就不需要SqlSessionFactoryBuilder了，因为SqlSession是通过SqlSessionFactory创建的。所以可以将SqlSessionFactoryBuilder当成一个工具类使用，最佳使用范围是方法范围即方法体内局部变量。
（2）SqlSessionFactory
SqlSessionFactory是一个接口，接口中定义了openSession的不同重载方法，SqlSessionFactory的最佳使用范围是整个应用运行期间，一旦创建后可以重复使用，通常以单例模式管理SqlSessionFactory。
（3）SqlSession
SqlSession是一个面向用户的接口，sqlSession中定义了数据库操作方法。
每个线程都应该有它自己的SqlSession实例。SqlSession的实例不能共享使用，它也是线程不安全的。因此最佳的范围是请求或方法范围。绝对不能将SqlSession实例的引用放在一个类的静态字段或实例字段中。


打开一个 SqlSession；使用完毕就要关闭它。通常把这个关闭操作放到 finally 块中以确保每次都能执行关闭。如下：

SqlSession session = sqlSessionFactory.openSession();try { // do work} finally {session.close();}

3、原始Dao开发

（1）映射文件User.xml

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 --><mapper namespace="test"><!-- 通过id查询一个用户 --><select id="findUserById" parameterType="Integer" resultType="com.sh.mybatis.pojo.User">select * from user where id = #{v}</select><!-- 根据用户名称查询用列表 --><!-- #{} select * from user where id = ? 占位符? == '王五'${} select * from user where usrename like 字符串拼接 --><select id="findUserByUsername" parameterType="String" resultType="com.sh.mybatis.pojo.User"><!-- select * from user where username like  '%${value}%' -->select * from user where username like  "%"#{haha}"%"</select><!-- 添加用户 --><insert id="insertUser" parameterType="com.sh.mybatis.pojo.User"><!-- 获得最新id并添加到id字段 --><selectKey keyProperty="id" resultType="Integer" order="AFTER">select LAST_INSERT_ID()</selectKey>insert into user (username,birthday,address,sex) values (#{username},#{birthday},#{address},#{sex})</insert><!-- 更新用户 --><update id="updateUserById" parameterType="com.sh.mybatis.pojo.User">update user set username = #{username},sex = #{sex},birthday = #{birthday},address = #{address} where id = #{id}</update><!-- 删除用户 --><delete id="deleteUserById" parameterType="Integer">delete from user where id = #{v}</delete></mapper>

（2）Dao接口

package com.sh.mybatis.dao;import com.sh.mybatis.pojo.User;public interface UserDao {public User selectUserById(Integer id);}

（3）实现类

package com.sh.mybatis.dao;import org.apache.ibatis.session.SqlSession;import org.apache.ibatis.session.SqlSessionFactory;import com.sh.mybatis.pojo.User;public class UserDaoImpl implements UserDao {//注入工厂private SqlSessionFactory sqlSessionFactory;public UserDaoImpl(SqlSessionFactory sqlSessionFactory) {super();this.sqlSessionFactory = sqlSessionFactory;}//通过id查询一个用户public User selectUserById(Integer id) {SqlSession sqlSession = sqlSessionFactory.openSession();return sqlSession.selectOne("test.findUserById",id);}}

（4）测试

public class UserDaoImplTest {public SqlSessionFactory sqlSessionFactory;@Beforepublic void Before() throws Exception {// 1.加载核心配置文件String resource = "sqlMapConfig.xml";InputStream is = Resources.getResourceAsStream(resource);// 2.创建一个 SqlSessionFactorysqlSessionFactory = new SqlSessionFactoryBuilder().build(is);}@Testpublic void testDao() {UserDao userDao = new UserDaoImpl(sqlSessionFactory);User user = userDao.selectUserById(10);System.out.println(user);}}

（5）问题

原始Dao开发中存在以下问题：
Dao方法体存在重复代码：通过SqlSessionFactory创建SqlSession，调用SqlSession的数据库操作方法
调用sqlSession的数据库操作方法需要指定statement的id，这里存在硬编码，不得于开发维护。

4、Mapper动态代理方式

（1）开发规范

Mapper接口开发方法只需要程序员编写Mapper接口（相当于Dao接口），由Mybatis框架根据接口定义创建接口的动态代理对象，代理对象的方法体同上边Dao接口实现类方法。


Mapper接口开发需要遵循以下规范：
A、Mapper.xml文件中的namespace与mapper接口的类路径相同。
B、Mapper接口方法名和Mapper.xml中定义的每个statement的id相同 
C、Mapper接口方法的输入参数类型和mapper.xml中定义的每个sql 的parameterType的类型相同
D、Mapper接口方法的输出参数类型和mapper.xml中定义的每个sql的resultType的类型相同

（2）User.xml配置文件

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-//mybatis.org//DTD Mapper 3.0//EN""http://mybatis.org/dtd/mybatis-3-mapper.dtd"><!-- namespace：命名空间，用于隔离sql，还有一个很重要的作用，后面会讲 --><!-- 使用动态代理开发DAO,1. namespace必须和Mapper接口类路径一致 --><mapper namespace="com.sh.mybatis.mapper.UserMapper"><!-- 通过id查询一个用户 --><!-- 2. id必须和Mapper接口方法名一致 --><!-- 3. parameterType必须和接口方法参数类型一致 --><!-- 4. resultType必须和接口方法返回值类型一致 --><select id="findUserById" parameterType="Integer" resultType="User">select * from user where id = #{v}</select>

（3）UserMapper接口文件

package com.sh.mybatis.mapper;import com.sh.mybatis.pojo.User;public interface UserMapper {//遵循四个原则//接口 方法名 == User.xml 中id名//返回值类型与Mapper.xml文件中返回值类型要一致//方法的入参类型与Mapper.xml中入参类型要一致//命名空间绑定此接口public User findUserById(Integer id);}

（4）加载User.xml文件

修改SqlMapConfig.xml文件，添加以下所示的内容：

<!-- 加载映射文件 --><mappers><mapper resource="sqlmap/User.xml" /></mappers>

（5）测试

public class UserMapperTest {@Testpublic void testUserMapper() throws Exception {// 1.加载核心配置文件String resource = "sqlMapConfig.xml";InputStream is = Resources.getResourceAsStream(resource);// 2.创建一个 SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(is);// 3.创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//sqlSession帮忙生成一个实现类（给接口）UserMapper userMapper = sqlSession.getMapper(UserMapper.class);User user = userMapper.findUserById(10);System.out.println(user);}}

（6）小结

A、selectOne和selectList

动态代理对象调用sqlSession.selectOne()和sqlSession.selectList()是根据mapper接口方法的返回值决定，如果返回list则调用selectList方法，如果返回单个对象则调用selectOne方法。

B、namespace
mybatis官方推荐使用mapper代理方法开发mapper接口，程序员不用编写mapper接口实现类，使用mapper代理方法时，输入参数可以使用pojo包装对象或map对象，保证dao的通用性。

六、SqlMapConfig.xml配置文件

1、配置内容

SqlMapConfig.xml中配置的内容和顺序如下：
properties（属性）
settings（全局配置参数）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境集合属性对象）
environment（环境子属性对象）
transactionManager（事务管理）
dataSource（数据源）
mappers（映射器）

2、properties（属性）

在src下定义db.properties文件

jdbc.driver=com.mysql.jdbc.Driverjdbc.url=jdbc:mysql://localhost:3306/mybatis?characterEncoding=utf-8jdbc.username=rootjdbc.password=root

SqlMapConfig.xml引用如下：

<!-- 加载db.properties配置文件 --><properties resource="db.properties"><!-- 在properties内部用property定义属性 --><!-- 如果外部配置文件有该属性，则内部定义属性被外部属性覆盖 --><property name="jdbc.username" value="root123" /><property name="jdbc.password" value="root123" /></properties>

<!-- 和spring整合后 environments配置将废除 --><environments default="development"><environment id="development"><!-- 使用jdbc事务管理 --><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>

注意： MyBatis 将按照下面的顺序来加载属性：
在 properties 元素体内定义的属性首先被读取。 
然后会读取properties 元素中resource或 url 加载的属性，它会覆盖已读取的同名属性。

3、typeAliases（类型别名）

（1）Mybatis支持别名

（2）自定义别名

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 加载db.properties配置文件 --><properties resource="db.properties"></properties><!-- 别名 包以及其子类包下所有类，头字母大小写都行 --><typeAliases><!-- 单个别名定义 --><typeAlias alias="user" type="cn.sh.mybatis.pojo.User" /><!-- 批量别名定义，扫描整个包下的类，别名为类名（大小写不敏感） --><package name="com.sh.mybatis.pojo" /></typeAliases><!-- 和spring整合后 environments配置将废除 --><environments default="development"><environment id="development"><!-- 使用jdbc事务管理 --><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><!-- 加载映射文件 --><mappers><mapper resource="sqlmap/User.xml" /></mappers></configuration>

在mapper.xml配置文件中，就可以使用设置的别名了
别名大小写不敏感

4、mappers（映射器）

Mapper配置的几种方法：
（1）<mapper resource=" " />
使用相对于类路径的资源（现在的使用方式）
如：<mapper resource="sqlmap/User.xml" />

（2）<mapper class=" " />
使用mapper接口类路径
如：<mapper class="cn.itcast.mybatis.mapper.UserMapper"/>

注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

（3）<package name=""/>
注册指定包下的所有mapper接口
如：<package name="cn.itcast.mybatis.mapper"/>
注意：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

源码参考Mybatis_01：https://github.com/AmazeLee/Mybatis.git