MyBatis delete 標籤用於定義 delete 語句，執行刪除操作。當 MyBatis 執行完一條更新語句後，會返回一個整數，表示受影響的資料庫記錄的行數。

下面我們通過一個示例演示 delete 標籤的用法。

1. 在 WebsiteMapper.xml 中使用 delete 標籤新增一條 delete 語句，程式碼如下。

<delete id="deleteWebsite" parameterType="string">
delete from website where name = #{name}
</delete>

2.  在 WebsiteMapper 介面中增加一個 deleteWebsite() 方法，程式碼如下。

int deleteWebsite(String name);

引數為 String 型別的字串；返回值為 int 型別，表示執行 sql 語句後，被刪除記錄的行數。

3. 測試程式碼如下。

//刪除 name 為程式設計幫3 的記錄
String name = "程式設計幫3";
int i = websiteMapper.deleteWebsite(name);
System.out.println("共刪除了 " + i + " 條記錄");

4. 執行測試程式碼，控制檯輸出如下。

共刪除了 3 條記錄

1.delete 標籤常用屬性

delete 標籤常用屬性如下表。

注意：delete 標籤中沒有 resultType 屬性，只有查詢操作才需要對返回結果型別進行相應的指定。

2.傳遞多個引數

在上面的示例中，我們在 delete 語句中只使用了一個 String 型別的引數，而在實際的開發過程中，我們的 delete 語句往往需要使用多個引數對記錄進行篩選，Mybatis 為我們提供以下 3 種方式，來實現給對映器傳遞多個引數：

• 使用 Map 傳遞引數
• 使用註解傳遞引數
• 使用 JavaBean 傳遞引數

2.1 使用 Map 傳遞引數

我們可以將引數封裝到一個 Map 物件中，然後傳遞給 MyBatis 的對映器，示例如下。

1. 在 WebsiteMapper 介面中，定義一個 deleteWebsiteByMap() 方法，並使用 Map 傳遞引數，程式碼如下。

int deleteWebsiteByMap(Map<String, Object> params);

2.在 WebsiteMapper.xml 中使用 delete 標籤定義一個 delete 語句，並接收通過 Map 傳遞的引數，配置如下。

<!--通過 Map 傳遞引數，執行刪除操作-->
<delete id="deleteWebsiteByMap" parameterType="map">
delete
from website
where name = #{name}
and url = #{url}
</delete>

3. 測試程式碼如下。

//使用 Map 向 delete 標籤傳遞引數
Map<String, Object> params = new HashMap<>();
params.put("name", "程式設計幫");
params.put("url", "www.biancheng.net");
int i = websiteMapper.deleteWebsiteByMap(params);
System.out.println("通過 Map 傳遞引數，共刪除了 " + i + " 條記錄");

4. 執行測試程式碼，控制檯輸出如下。

通過 Map 傳遞引數，共刪除了 1 條記錄

2.2 使用註解傳遞引數

我們還可以使用 MyBatis 提供的 @Param 註解給註解器傳遞引數，示例如下。

1. 在 WebsiteMapper 介面中，定義一個 deleteWebsiteByParam() 方法，並使用 @Param 註解傳遞引數，方法如下

int deleteWebsiteByParam(@Param("name") String name, @Param("url") String url);

2. 在 WebsiteMapper.xml 中使用 delete 標籤定義一個 delete 語句，並接收通過 @Param 註解傳遞的引數，配置如下。

<!--通過 @Param 註解傳遞引數，執行刪除操作-->
<delete id="deleteWebsiteByParam">
delete
from website
where name = #{name}
and url = #{url}
</delete>

3. 測試程式碼如下。

//使用 @Param 註解傳遞引數
String name = "程式設計幫2";
String url = "www.biancheng.net";
int i = websiteMapper.deleteWebsiteByParam(name, url);
System.out.println("通過 @Param 註解傳遞引數，共刪除了 " + i + " 條記錄");

4. 執行測試程式碼，控制檯輸出如下。

通過 @Param 註解傳遞引數，共刪除了 1 條記錄

2.3 使用 JavaBean 傳遞引數

在引數過多的情況下，我們還可以將引數通過 setter 方法封裝到 JavaBean（實體類）物件中傳遞給對映器。

1. 在 WebsiteMapper 介面中,定義一個 deleteWebsiteByJavaBean() 方法，並使用 JavaBean 傳遞引數，方法如下。

int deleteWebsiteByJavaBean(Website website);

2. 在 WebsiteMapper.xml 中使用 delete 標籤定義一個 delete 語句，並接收通過 JavaBean 傳遞的引數，配置如下。

<!--通過 JavaBean 傳遞引數，執行刪除操作-->
<delete id="deleteWebsiteByJavaBean" parameterType="net.biancheng.www.po.Website">
delete
from website
where name = #{name}
and url = #{url}
</delete>

3. 測試程式碼如下。

//使用 JavaBean 傳遞引數到更新語句中
Website website = new Website();
website.setName("C語言中文網");
website.setUrl("https://www.biancheng.net/");
int i = websiteMapper.deleteWebsiteByJavaBean(website);
System.out.println("通過 JavaBean 傳遞引數，共刪除了 " + i + " 條記錄");

4. 執行測試程式碼，控制檯輸出如下。

通過 JavaBean 傳遞引數，共刪除了 3 條記錄

2.4 區別

以上 3 種方式的區別如下：

• 使用 Map 傳遞引數會導致業務可讀性的喪失，繼而導致後續擴充套件和維護的困難，所以在實際應用中我們應該果斷廢棄該方式。
• 使用 @Param 註解傳遞引數會受到引數個數的影響。當 n≤5 時，它是最佳的傳參方式，因為它更加直觀；當 n>5 時，多個引數將給呼叫帶來困難。
• 當引數個數大於 5 個時，建議使用 JavaBean 方式。