約定俗成
Clinton說:這一點是與我們以前所堅持的原則不相符合的。認識我的人都知道我基本上算是一個完美的人。但是如果我們從最佳實踐的角度去考慮,我們必須在解決復雜問題的時候也使用盡量簡單的解決方案。當然,那些不太喜歡約定俗成式配置的人可以忽略這種配置方式。但是我相信這是非常有用的,特別是對插入、刪除和更新操作來說。使用這種配置方式,一些簡單的查詢也將從中受益。
默認情況下,iBATIS 3.0將使用約定俗成式的配置方式。Java 5的方法語義中已經包含了生成SQL、進行參數和結果映射足夠的信息。例如:
Employee getEmployee (int id);
這些信息對于生成以下SQL已經足夠了:
SELECT id, firstName, lastName FROM Employee WHERE id = ?
結果類型與方法的返回值類型是一致的。因為方法的返回值類型不是集合類型,所以我們知道正在處理“Select One”語義。表的名稱被假定為與結果類型的名稱一致。而查詢參數就被假定為方法對應的參數。在使用其他的配置方式的時候,我們可以更改默認ID參數的配置。SQL語句中的各數據列假定與方法返回類型的同名屬性一一對應,當然這些配置都是可以更改的。
集合類型也是以同樣的方式工作:
List listAllEmployees ();
這個例子將產生以下SQL語句:
SELECT id, firstName, lastName FROM Employee
我們可以將這個例子叫做“Select Many”,因為這個方法返回了一個集合類型。我們知道Where子句為空,因為這個方法沒有任何參數。
如果我們想使用參數式查詢,我們可以這樣來做:
List findEmployeesLike(Employee employee);
假設只有參數的lastName,而其他引用類型都為null值,原始類型都被設置為非法無意義的值(比如-1),我們將得到以下的SQL語句:
SELECT id, firstName, lastName FROM Employee WHERE lastName = 'Begin'
或者可以直接按參數來進行:
List findEmployeeByLastNameAndFirstName (String last, String first);
這將生成以下的SQL語句:
SELECT id, firstName, lastName FROM Employee WHERE lastName = 'Begin' AND firstName = 'Clinton'
因為C#支持參數名稱的反射,所以C#對這種方法提供了更好的支持。形式上也變得相對清晰,當然實質是一樣的:
// C#
IList FindEmployeesLike(string lastName, string firstName);
// And in C# 3.0, we can use anonymous types:
IList FindEmployeesLike(object obj);
//...
IList employees = mapper.FindEmployeesLike(new {LastName="Begin", FirstName="Clinton"});
更新操作也以相同的方式操作:
void insertEmployee (Employee emp);
void updateEmployee (Employee emp);
void deleteEmployee (Employee emp);
也可以自動接受集合參數:
int insertEmployee (List emps); // returns rows inserted
int updateEmployee (List emps); // returns rows updated
int deleteEmployee (List emps); // returns rows deleted
生成器相當的靈活,而且可以為大多數刪除甚至更新操作生成一條SQL語句。