iBatis開發(fā)詳解（2）---增刪改查

    iBatis是基于SQL的數(shù)據(jù)持久層框架，那就是要書寫SQL語句進(jìn)行數(shù)據(jù)庫操作。對比于Hibernate雖然在對象屬性的擴(kuò)展上修改麻煩但是對SQL的集中管理和主動權(quán)，也還是不錯的。下面我們來探討iBatis中的簡單增刪改查(CRUD)操作，這也是數(shù)據(jù)庫應(yīng)用的基本操作。 

    為了簡化我們SQL輸入?yún)?shù)的配置，我們寫一個類來專門負(fù)責(zé)處理輸入?yún)?shù)，把它們封裝成一個Map類型，代碼如下： 

package ibatis.util;  
import java.util.HashMap;  
public class ParameterMap extends HashMap<Object, Object> {  
    private static final long serialVersionUID = 1L;  
    public ParameterMap(Object... parameters) {  
        for (int i = 0; i < parameters.length - 1; i += 2) {  
            super.put(parameters[i], parameters[i + 1]);  
        }  
    }  
}  

    代碼很簡單，一個擴(kuò)展了HashMap的類，只有一個顯式定義的構(gòu)造方法，并且使用了可變參數(shù)，方法處理是將輸入的參數(shù)按照一定規(guī)則存入HashMap。而這個規(guī)則一看就明白了，是按照參數(shù)列表中的“名”-“值”對來放置的。使用了可變參數(shù)后，那么參數(shù)想放幾對就放幾對，非常方便，為了能在XML中使用這個類型，不要忘了聲明它。 

<typeAlias alias="parameterMap" type="ibatis.util.ParameterMap" />  

   首先是查詢(select)，這個操作面向的是數(shù)據(jù)庫中的記錄，結(jié)果稱之為結(jié)果集(JDBC中的說法)，而iBatis可以對結(jié)果集進(jìn)行指定類型的轉(zhuǎn)換，這也是SqlMap的體現(xiàn)。查詢大體可分為兩種：帶條件的查詢和不帶條件的查詢。 

    不帶條件的查詢非常簡單，在XML中我們配置如下的查詢： 

<select id="getAllUsers" resultClass="java.util.HashMap">  
    select *  
    from users  
</select>  

    這里我們將據(jù)誒過類型設(shè)置為HashMap，那么iBatis就會將返回的一條記錄封裝成Map類型，而我們在取值時使用的是SqlMapClient的queryForList(String sql)方法，那么在返回的List中就是HashMap的集合。我們在程序中可以這樣來遍歷輸出結(jié)果： 

package ibatis;  
import java.io.*;  
import java.sql.SQLException;  
import java.util.*;  
import com.ibatis.common.resources.Resources;  
import com.ibatis.sqlmap.client.*;  
public class IBatisDemo {  
    private static String config = "ibatis/SqlMapConfig.xml";  
    private static Reader reader;  
    private static SqlMapClient sqlMap;  
    static {  
        try {  
            reader = Resources.getResourceAsReader(config);  
        } catch (IOException e) {  
            e.printStackTrace();  
        }  
        sqlMap = SqlMapClientBuilder.buildSqlMapClient(reader);  
    }  
    public static void main(String[] args) throws SQLException {  
        List<HashMap> list = select();  
        for (HashMap user : list) {  
            System.out.println(user);  
        }  
    }  
    public static List<HashMap> select() throws SQLException {  
        return sqlMap.queryForList("getAllUsers");  
    }  
}  

    這樣就可以遍歷出users表中的全部數(shù)據(jù)了，在控制臺打印，可以看出是根據(jù)Map類型的格式來輸出的。下面來看看含有參數(shù)的查詢： 

<select id="getUserByName" parameterClass="java.lang.String"  
        resultClass="java.util.HashMap">  
    select *  
    from users  
    where USERNAME=#VARCHAR#  
</select> 

    和上面相比，多了一個parameterClass，就是參數(shù)類型，就一個參數(shù)USERNAME，我們使用String類型就可以了。方法中這樣寫就可以： 

public static void main(String[] args) throws SQLException {  
    System.out.println(select("sarin"));  
}  
    public static HashMap select(String parameter) throws SQLException {        return (HashMap) sqlMap.queryForObject("getUserByName", parameter);  
}  

   有一個參數(shù)時我們在XML中配置parameterClass寫這種參數(shù)的類型就可以了，但是多個參數(shù)時卻不能在parameterClass中寫一串類型，那么就需要抽象出一種數(shù)據(jù)結(jié)構(gòu)來傳遞參數(shù)，很自然想到了HashMap，這種鍵值對形式的結(jié)構(gòu)非常適合同名參數(shù)的傳遞。因為直接操作HashMap在參數(shù)存儲時很不方便，我們就設(shè)計了前面提到的parameterMap類型。

<select id="getUserByRealNameAndMobile" parameterClass="parameterMap"  
        resultClass="java.util.HashMap">  
    select *  
    from users  
    where REALNAME=#realName:VARCHAR# and MOBILE=#mobile:VARCHAR#  
</select>  

    為了區(qū)別，數(shù)據(jù)庫字段名全部大寫，而傳遞的變量名采用小寫方式，這樣可以很清楚地辨別對應(yīng)關(guān)系。那么程序中，這樣進(jìn)行就可以了。 

public static void main(String[] args) throws SQLException {  
        ParameterMap parameterMap = new ParameterMap("realName", "sarin","mobile", "15940990000");  
        System.out.println(select(parameterMap));  
}  
    public static HashMap select(Map parameterMap) throws SQLException {return (HashMap) sqlMap.queryForObject("getUserByRealNameAndMobile",  
                parameterMap);  
}  

    數(shù)據(jù)操作中查詢是難度最大的，但是在iBatis中只涉及到了參數(shù)傳遞和結(jié)果的獲取，SQL的書寫那就是具體問題具體分析了。簡單查詢知道這么多就夠用了，下面我們來說插入(insert)操作。 

<insert id="addUser" parameterClass="parameterMap">  
    insert into users(USERNAME,PASSWORD,REALNAME,MOBILE,EMAIL)  
    values(#userName:VARCHAR#,#password:VARCHAR#,#realName:VARCHAR#,#mobile:VARCHAR#,#email:VARCHAR#)  
</insert>  

   我都知道的，JDBC的更新操作返回的是影響的結(jié)果條數(shù)，那么插入操作就沒有特定的結(jié)果類型了，我們使用SqlMapClient操作時返回的就是int類型的一個數(shù)值。當(dāng)插入成功返回1，插入失敗會報出具體的異常。代碼如下： 

public static void main(String[] args) throws SQLException {  
        ParameterMap parameterMap = new ParameterMap("userName", "sarin",  
                "password", "123", "realName", "sarin", "mobile", "1","email","@");  
        System.out.println(insert(parameterMap));  
}  
public static int insert(Map parameterMap) throws SQLException {  
        return sqlMap.update("addUser", parameterMap);  
}  

   現(xiàn)在我們已經(jīng)很直接的看出定義一個ParameterMap的好處了，就是為了更加簡便的使用iBatis。下面來看看更新(update)操作：

<update id="updateUser">  
        update users   
        set PASSWORD='123456'  
</update>  

   這個操作沒有傳遞任何參數(shù)，就不用寫parameterClass屬性了，然后在程序中調(diào)用就可以執(zhí)行這個操作了，也很簡單。 

public static void main(String[] args) throws SQLException {  
    System.out.println(update());  
}  
public static int update() throws SQLException {  
    return sqlMap.update("updateUser");  
}  

   當(dāng)執(zhí)行更新操作后，結(jié)果返回的是影響數(shù)據(jù)表中的行數(shù)。最后一個就是刪除(delete)操作了，看了前面那么多示例，這不難猜出刪除操作的XML標(biāo)記了。 

<delete id="deleteUser" parameterClass="java.lang.Integer">  
    delete from users  
    where ID=#INT#  
</delete>  

    數(shù)據(jù)庫中設(shè)計主鍵類型為INT，那么這里在參數(shù)上也設(shè)置為#INT#，則parameterClass屬性就要設(shè)置為java.lang.Integer了，很容易理解，基本類型使用其包裝類對象。程序中的寫法和上面也大同小異了，只是在執(zhí)行刪除時SqlMapClient對象提供delete()方法，當(dāng)然也可以繼續(xù)使用update()方法，代碼如下： 

public static void main(String[] args) throws SQLException {  
    System.out.println(delete(4));  
}  
public static int delete(int userId) throws SQLException {  
    return sqlMap.delete("deleteUser", userId);  
}  

    這樣就把ID為4的記錄給刪除了。 

    至此iBatis簡單的增刪改查操作就介紹完了，很簡單。流程就是在配置文件中寫相應(yīng)的標(biāo)簽，在標(biāo)簽體中寫SQL語句，然后在程序中使用SqlMapClient對象中的方法來調(diào)用。執(zhí)行方法的第一個參數(shù)都是XML配置標(biāo)簽的id屬性值，后面跟的是參數(shù)或其他可選參數(shù)。這樣一個流程就執(zhí)行完了。 

    相比于Hibernate的全自動SQL生成，iBatis需要手寫SQL，但是SQL的管理要方便，因為它們都集中在XML文件中。