MyBatis framework is a complete rewrite of iBatis, it’s a data mapper framework that makes it easier to use a relational database with object-oriented applications. The difference from old iBatis is that now everything can now be written in java, from queries, configuration to mappers.
Some people might ask why MyBatis use a different approach from its ancestor, iBatis? iBatis’ code generator use *DAOs while MyBatis use *Mappers. I think they all the same, but then according to Clinton Begin they are, despite their similarity, are not exact in concepts.
DAOs can collect multiple statements and thus aggregate or cohesive data logic into one method. That said, this isn’t necessarily a good thing. After 10 years of writing DAOs, I can say with enough experience that DAOs are a waste of time. They fragment business logic, they’re extra code and the abstraction goes largely unused for the lifetime of most applications that implement it. DAOs were often implemented incorrectly and code would sneak into them that should not.
Mappers on the other hand, are named function that executes a single SQL statement or procedure. There is no extra code, and it eliminates strings in the execution of mapped statements. Mappers also help define the mapped statement.
In a sense, you can also think of it as:
- DAOs USE mapped statements.
- Mapper methods ARE mapped statements.
The cohesive grouping or aggregation of related statements that work together to form a business process should now exist in your service layer (be it a Spring bean, or an EJB or a POJO service layer).
Okay enough with the chit-chat, let me show you the code, first as always, a simple mysql database named test, and a table named Contoh.
CREATE TABLE contoh
(
nama VARCHAR(30) NOT NULL,
alamat VARCHAR(100),
PRIMARY KEY (nama)
)
and a java bean
package com.edw.mybatis.bean;
public class Contoh {
private String nama;
private String alamat;
// other setter and getter
@Override
public String toString(){
return nama+" : "+alamat;
}
}
This is my Contoh table queries, i named it ContohMapper.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.edw.mybatis.mapper.ContohMapper" >
<resultMap id="ContohMap" type="com.edw.mybatis.bean.Contoh" >
<id column="nama" property="nama" jdbcType="VARCHAR" />
<result column="alamat" property="alamat" jdbcType="VARCHAR" />
</resultMap>
<insert id="save" parameterType="com.edw.mybatis.bean.Contoh" >
insert into contoh (nama, alamat)
values (#{nama,jdbcType=VARCHAR}, #{alamat,jdbcType=VARCHAR})
</insert>
<update id="update" parameterType="com.edw.mybatis.bean.Contoh" >
update contoh
set alamat = #{alamat,jdbcType=VARCHAR}
where nama = #{nama,jdbcType=VARCHAR}
</update>
</mapper>
I register my ContohMapper.xml on Configuration.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>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="UNPOOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost/test"/>
<property name="username" value="root"/>
<property name="password" value="xxx"/>
</dataSource>
</environment>
</environments>
<mappers>
<mapper resource="com/edw/mybatis/xml/ContohMapper.xml"/>
</mappers>
</configuration>
What makes MyBatis different from iBatis, is the ability to put queries on interfaces using annotations. Here is the example.
package com.edw.mybatis.mapper;
import com.edw.mybatis.bean.Contoh;
import java.util.List;
import org.apache.ibatis.annotations.Delete;
import org.apache.ibatis.annotations.Select;
public interface ContohMapper {
int save(Contoh contoh);
@Delete("DELETE FROM contoh WHERE nama = #{nama}")
int delete(String nama);
@Select("SELECT * FROM contoh WHERE nama = #{nama}")
Contoh select(String nama);
@Select("SELECT * FROM contoh")
List<Contoh> selectAll();
}
and a factory class to load my configuration
package com.edw.mybatis.config;
import java.io.Reader;
import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
/**
*
* @author edw
*/
public class MyBatisSqlSessionFactory {
protected static final SqlSessionFactory FACTORY;
static {
try {
Reader reader = Resources.getResourceAsReader("com/edw/mybatis/xml/Configuration.xml");
FACTORY = new SqlSessionFactoryBuilder().build(reader);
} catch (Exception e){
throw new RuntimeException("Fatal Error. Cause: " + e, e);
}
}
public static SqlSessionFactory getSqlSessionFactory() {
return FACTORY;
}
}
And here’s my main class
package com.edw.mybatis.main;
import com.edw.mybatis.bean.Contoh;
import com.edw.mybatis.config.MyBatisSqlSessionFactory;
import com.edw.mybatis.mapper.ContohMapper;
import java.util.List;
import org.apache.ibatis.session.SqlSession;
import org.apache.log4j.Logger;
public class Main {
private Logger logger = Logger.getLogger(Main.class);
public Main() {
}
private void execute() {
SqlSession session = MyBatisSqlSessionFactory.getSqlSessionFactory().openSession();
try {
// select all
ContohMapper mapper = session.getMapper(ContohMapper.class);
List<Contoh> contohs = mapper.selectAll();
for (Contoh contoh1 : contohs) {
logger.debug(contoh1);
}
// delete
int success = mapper.delete("pepe");
if (success == 0) {
logger.debug("failed to delete");
} else {
logger.debug("successfully deleted");
}
// insert
Contoh contohExample = new Contoh();
contohExample.setNama("kacrut");
contohExample.setAlamat("kacrut alamat");
int insertSuccess = session.insert("save", contohExample);
if (insertSuccess == 0) {
logger.debug("failed to insert");
} else {
logger.debug("successfully inserted");
}
// check is it inserted yet
Contoh contoh = (Contoh) mapper.select(contohExample.getNama());
logger.debug(contoh);
// update
Contoh contohExample2 = new Contoh();
contohExample2.setNama("kacrut");
contohExample2.setAlamat("kacrut alamat 22");
int updateSuccess = session.update("com.edw.mybatis.mapper.ContohMapper.update", contohExample2);
if (updateSuccess == 0) {
logger.debug("failed to update");
} else {
logger.debug("successfully updated");
}
session.commit();
} catch (Exception e) {
logger.error(e.getMessage(), e);
} finally {
session.close();
}
}
public static void main(String[] args) {
Main main = new Main();
main.execute();
}
}
this is what happen when i run my project,
run:
2010-11-12 15:40:41,804 - DEBUG java.sql.Connection:27 - ooo Connection Opened
2010-11-12 15:40:42,041 - DEBUG java.sql.PreparedStatement:27 - ==> Executing: SELECT * FROM contoh
2010-11-12 15:40:42,041 - DEBUG java.sql.PreparedStatement:27 - ==> Parameters:
2010-11-12 15:40:42,100 - DEBUG java.sql.ResultSet:27 - <== Columns: nama, alamat
2010-11-12 15:40:42,101 - DEBUG java.sql.ResultSet:27 - <== Row: edwin, singapore
2010-11-12 15:40:42,103 - DEBUG java.sql.ResultSet:27 - <== Row: kamplenk, ciledug
2010-11-12 15:40:42,104 - DEBUG java.sql.ResultSet:27 - <== Row: nugie, pamulang
2010-11-12 15:40:42,105 - DEBUG java.sql.ResultSet:27 - <== Row: samsu, dago
2010-11-12 15:40:42,120 - DEBUG java.sql.ResultSet:27 - <== Row: tebek, jayapura
2010-11-12 15:40:42,122 - DEBUG com.edw.mybatis.main.Main:24 - edwin : singapore
2010-11-12 15:40:42,122 - DEBUG com.edw.mybatis.main.Main:24 - kamplenk : ciledug
2010-11-12 15:40:42,123 - DEBUG com.edw.mybatis.main.Main:24 - nugie : pamulang
2010-11-12 15:40:42,123 - DEBUG com.edw.mybatis.main.Main:24 - samsu : dago
2010-11-12 15:40:42,123 - DEBUG com.edw.mybatis.main.Main:24 - tebek : jayapura
2010-11-12 15:40:42,133 - DEBUG java.sql.PreparedStatement:27 - ==> Executing: DELETE FROM contoh WHERE nama = ?
2010-11-12 15:40:42,134 - DEBUG java.sql.PreparedStatement:27 - ==> Parameters: pepe(String)
2010-11-12 15:40:42,136 - DEBUG com.edw.mybatis.main.Main:30 - failed to delete
2010-11-12 15:40:42,137 - DEBUG java.sql.PreparedStatement:27 - ==> Executing: insert into contoh (nama, alamat) values (?, ?)
2010-11-12 15:40:42,138 - DEBUG java.sql.PreparedStatement:27 - ==> Parameters: kacrut(String), kacrut alamat(String)
2010-11-12 15:40:42,159 - DEBUG com.edw.mybatis.main.Main:43 - successfully inserted
2010-11-12 15:40:42,160 - DEBUG java.sql.PreparedStatement:27 - ==> Executing: SELECT * FROM contoh WHERE nama = ?
2010-11-12 15:40:42,160 - DEBUG java.sql.PreparedStatement:27 - ==> Parameters: kacrut(String)
2010-11-12 15:40:42,163 - DEBUG java.sql.ResultSet:27 - <== Columns: nama, alamat
2010-11-12 15:40:42,163 - DEBUG java.sql.ResultSet:27 - <== Row: kacrut, kacrut alamat
2010-11-12 15:40:42,164 - DEBUG com.edw.mybatis.main.Main:48 - kacrut : kacrut alamat
2010-11-12 15:40:42,166 - DEBUG java.sql.PreparedStatement:27 - ==> Executing: update contoh set alamat = ? where nama = ?
2010-11-12 15:40:42,166 - DEBUG java.sql.PreparedStatement:27 - ==> Parameters: kacrut alamat 22(String), kacrut(String)
2010-11-12 15:40:42,202 - DEBUG com.edw.mybatis.main.Main:58 - successfully updated
2010-11-12 15:40:42,259 - DEBUG java.sql.Connection:27 - xxx Connection Closed
BUILD SUCCESSFUL (total time: 2 seconds)
this is my Netbeans 6.9 project structure
Again, another great framework that i’ll obviously use. Cheers, :-[
ps.
i almost forget, here is my log4j.properties.
# Global logging configuration
log4j.rootLogger=DEBUG,stdout
# Console output...
log4j.appender.stdout=org.apache.log4j.ConsoleAppender
log4j.appender.stdout.layout=org.apache.log4j.PatternLayout
log4j.appender.stdout.layout.ConversionPattern=%d - %-5p %c:%L - %m%n