如何基于Springboot完成新增員工功能并設(shè)置全局異常處理器
1. 新增員工
1.1 需求分析
后臺系統(tǒng)中可以管理員工信息,通過新增員工來添加后臺系統(tǒng)用戶。點(diǎn)擊[添加員工]按鈕跳轉(zhuǎn)到新增頁面,如下
當(dāng)填寫完表單信息, 點(diǎn)擊"保存"按鈕后, 會提交該表單的數(shù)據(jù)到服務(wù)端, 在服務(wù)端中需要接受數(shù)據(jù), 然后將數(shù)據(jù)保存至數(shù)據(jù)庫中。
1.2 數(shù)據(jù)模型
新增員工,其實(shí)就是將我們新增頁面錄入的員工數(shù)據(jù)插入到employee表。employee表中的status字段已經(jīng)設(shè)置了默認(rèn)值1,表示狀態(tài)正常。
需要注意,employee表中對username字段加入了唯一約束,因?yàn)閡sername是員工的登錄賬號,必須是唯一的。
1.3 程序執(zhí)行流程
A. 點(diǎn)擊"保存"按鈕, 頁面發(fā)送ajax請求,將新增員工頁面中輸入的數(shù)據(jù)以json的形式提交到服務(wù)端, 請求方式POST, 請求路徑 /employee
B. 服務(wù)端Controller接收頁面提交的數(shù)據(jù)并調(diào)用Service將數(shù)據(jù)進(jìn)行保存
C. Service調(diào)用Mapper操作數(shù)據(jù)庫,保存數(shù)據(jù)
1.4 代碼實(shí)現(xiàn)
package com.itheima.reggie.controller; import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper; import com.itheima.reggie.common.R; import com.itheima.reggie.entity.Employee; import com.itheima.reggie.service.EmployeeService; import lombok.extern.slf4j.Slf4j; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.util.DigestUtils; import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestBody; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletRequest; import java.time.LocalDateTime; @Slf4j @RestController @RequestMapping("/employee") public class EmployeeController { @Autowired private EmployeeService employeeService; @PostMapping("/login") public R<Employee> login(HttpServletRequest request, @RequestBody Employee employee){ /**@Description: 員工登陸 * @param @RequestBody 傳入的是json 故需要將其轉(zhuǎn)化為實(shí)體類,json中的類名與實(shí)體類名對應(yīng)才可以封裝 * A. 由于需求分析時, 我們看到前端發(fā)起的請求為post請求, 所以服務(wù)端需要使用注解 @PostMapping * B. 由于前端傳遞的請求參數(shù)為json格式的數(shù)據(jù), 這里使用Employee對象接收, 但是將json格式數(shù)據(jù)封裝到實(shí)體類中, 在形參前需要加注解@RequestBody * @return com.itheima.reggie.common.R<com.itheima.reggie.entity.Employee> * @version v1.0 * @author LiBiGo * @date 2022/8/12 11:32 */ // ①. 將頁面提交的密碼password進(jìn)行md5加密處理, 得到加密后的字符串 String password = employee.getPassword(); password = DigestUtils.md5DigestAsHex(password.getBytes()); // ②. 根據(jù)頁面提交的用戶名username查詢數(shù)據(jù)庫中員工數(shù)據(jù)信息 LambdaQueryWrapper<Employee> queryWrapper = new LambdaQueryWrapper<>(); queryWrapper.eq(Employee::getUsername,employee.getUsername()); Employee emp = employeeService.getOne(queryWrapper); //在數(shù)據(jù)庫中用戶名是唯一的,所以可以用getone() // ③. 如果沒有查詢到, 則返回登錄失敗結(jié)果 if (emp == null){ return R.error("用戶名不存在"); } // ④. 密碼比對,如果不一致, 則返回登錄失敗結(jié)果 if(!emp.getPassword().equals(password)){ return R.error("密碼失敗"); } // ⑤. 查看員工狀態(tài),如果為已禁用狀態(tài),則返回員工已禁用結(jié)果 if(emp.getStatus() == 0){ return R.error("賬戶已禁用"); } // ⑥. 登錄成功,將員工id存入Session, 并返回登錄成功結(jié)果 request.getSession().setAttribute("employee",emp.getId()); return R.success(emp); } @PostMapping("/logout") public R<String> logout(HttpServletRequest request){ /**@Description: /employee/logout 員工退出 * @author LiBiGo * @date 2022/8/12 12:09 */ // 清理Session中保存的當(dāng)前登錄員工的id request.getSession().removeAttribute("employee"); // 返回結(jié)果 return R.success("退出成功"); } @PostMapping public R<String> save(HttpServletRequest request,@RequestBody Employee employee){ /**@Description: 用于保存用戶員工信息。 * * B. 在組裝員工信息時, 還需要封裝創(chuàng)建時間、修改時間,創(chuàng)建人、修改人信息(從session中獲取當(dāng)前登錄用戶)。 * @author LiBiGo * @date 2022/8/12 17:25 */ log.info("新增員工,員工信息:{}",employee.toString()); // A. 在新增員工時,設(shè)置初始密碼,需要進(jìn)行MD5加密處理 employee.setPassword(DigestUtils.md5DigestAsHex("123456".getBytes())); // B. 在組裝員工信息時, 需封裝創(chuàng)建時間、修改時間,創(chuàng)建人、修改人信息(從session中獲取當(dāng)前登錄用戶)。 employee.setCreateTime(LocalDateTime.now()); employee.setUpdateTime(LocalDateTime.now()); //獲得當(dāng)前登錄員工用戶的id Long empId = (Long) request.getSession().getAttribute("employee"); employee.setCreateUser(empId); // 創(chuàng)建員工信息的人 employee.setUpdateUser(empId); // 最后一次更新信息的人 employeeService.save(employee); // 因?yàn)閑mployeeService繼承了,所以不用寫,直接用 log.info("新增員工成功"); return R.success("新增員工成功"); } }
2 全局異常處理
2.1 新增員工存在的問題
當(dāng)我們在測試中,添加用戶時, 輸入了一個已存在的用戶名時,前端界面出現(xiàn)錯誤提示信息:
?而此時,服務(wù)端已經(jīng)報錯了, 報錯信息如下:
?出現(xiàn)上述的錯誤, 主要就是因?yàn)樵?employee 表結(jié)構(gòu)中,我們針對于username字段,建立了唯一索引,添加重復(fù)的username數(shù)據(jù)時,違背該約束,就會報錯。但是此時前端提示的信息并不具體,用戶并不知道是因?yàn)槭裁丛蛟斐傻脑摦惓?,我們需要給用戶提示詳細(xì)的錯誤信息 。
2.2 全局異常處理思路
我們需要對程序中可能出現(xiàn)的異常進(jìn)行捕獲,通常有兩種處理方式:
A. 在Controller方法中加入 try...catch 進(jìn)行異常捕獲
形式如下:
如果采用這種方式,雖然可以解決,但是存在弊端,需要我們在保存其他業(yè)務(wù)數(shù)據(jù)時,也需要在Controller方法中加上try...catch進(jìn)行處理,代碼冗余,不通用。
B. 使用異常處理器進(jìn)行全局異常捕獲
采用這種方式來實(shí)現(xiàn),只需要在項(xiàng)目中定義一個通用的全局異常處理器,就可以解決項(xiàng)目的所有異常。
2.3 全局異常處理器
在項(xiàng)目中自定義一個全局異常處理器,在異常處理器上加上注解 @ControllerAdvice,可以通過屬性annotations指定攔截哪一類的Controller方法。 并在異常處理器的方法上加上注解 @ExceptionHandler 來指定攔截的是那一類型的異常。
異常處理方法邏輯:
- 指定捕獲的異常類型為 SQLIntegrityConstraintViolationException
- 解析異常的提示信息, 獲取出是那個值違背了唯一約束
- 組裝錯誤信息并返回
2.4 全局異常處理器代碼實(shí)現(xiàn)
package com.itheima.reggie.common; import lombok.extern.slf4j.Slf4j; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.ControllerAdvice; import org.springframework.web.bind.annotation.ExceptionHandler; import org.springframework.web.bind.annotation.ResponseBody; import org.springframework.web.bind.annotation.RestController; import java.sql.SQLIntegrityConstraintViolationException; /** * Description: 全局異常處理器 */ @ControllerAdvice(annotations = {RestController.class, Controller.class})// 處理@RestController、@Controller的函數(shù)異常 //指定攔截那些類型的控制器; @ResponseBody //將方法的返回值 R 對象轉(zhuǎn)換為json格式的數(shù)據(jù), 響應(yīng)給頁面; @Slf4j public class GlobalExceptionHandler { /**@Description: 異常處理方法 * @author LiBiGo * @date 2022/8/12 17:46 */ @ExceptionHandler(SQLIntegrityConstraintViolationException.class) // 處理指定異常類 public R<String> exceptionHandler(SQLIntegrityConstraintViolationException ex){ log.error(ex.getMessage()); //Duplicate entry '299067' for key 'idx_username' if(ex.getMessage().contains("Duplicate entry")){ String[] split = ex.getMessage().split(" "); //提取重復(fù)字段,即哪個用戶名重復(fù) 從0開始第2個即為用戶名 String msg = split[2] + "已存在"; return R.error(msg); } return R.error("未知錯誤"); } }
2.5 測試
全局異常處理器編寫完畢后將項(xiàng)目重啟, 完畢之后直接訪問管理系統(tǒng)首頁, 點(diǎn)擊 "員工管理" 頁面中的 "添加員工" 按鈕。當(dāng)添加用戶時, 輸入了一個已存在的用戶名時,前端界面出現(xiàn)如下錯誤提示信息:
總結(jié)
到此這篇關(guān)于如何基于Springboot完成新增員工功能并設(shè)置全局異常處理器的文章就介紹到這了,更多相關(guān)Springboot新增員工并設(shè)置全局異常內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
IDEA創(chuàng)建parent項(xiàng)目(聚合項(xiàng)目)
這篇文章主要介紹了IDEA創(chuàng)建parent項(xiàng)目(聚合項(xiàng)目),文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2019-08-08為zookeeper配置相應(yīng)的acl權(quán)限
這篇文章主要介紹了為zookeeper配置相應(yīng)的acl權(quán)限的相關(guān)實(shí)例,具有一定參考價值,需要的朋友可以了解下。2017-09-09解決Java中由于數(shù)據(jù)太大自動轉(zhuǎn)換成科學(xué)計數(shù)法的問題
今天小編就為大家分享一篇解決Java中由于數(shù)據(jù)太大自動轉(zhuǎn)換成科學(xué)計數(shù)法的問題,具有很好的參考價值,希望對大家有所幫助。一起跟隨小編過來看看吧2018-07-07一篇文章帶你入門java算術(shù)運(yùn)算符(加減乘除余,字符連接)
這篇文章主要介紹了Java基本數(shù)據(jù)類型和運(yùn)算符,結(jié)合實(shí)例形式詳細(xì)分析了java基本數(shù)據(jù)類型、數(shù)據(jù)類型轉(zhuǎn)換、算術(shù)運(yùn)算符、邏輯運(yùn)算符等相關(guān)原理與操作技巧,需要的朋友可以參考下2021-08-08Spring Cloud Ribbon客戶端詳細(xì)介紹
Spring Cloud Ribbon 是一套基于 Netflix Ribbon 實(shí)現(xiàn)的客戶端負(fù)載均衡和服務(wù)調(diào)用工具。通過Spring Cloud的封裝,可以讓我們輕松地將面向服務(wù)的REST模版請求自動轉(zhuǎn)換成客戶端負(fù)載均衡的服務(wù)調(diào)用2022-09-09Java IO學(xué)習(xí)之緩沖輸入流(BufferedInputStream)
這篇文章主要介紹了Java IO學(xué)習(xí)之緩沖輸入流(BufferedInputStream)的相關(guān)資料,需要的朋友可以參考下2017-02-02淺析Android系統(tǒng)中HTTPS通信的實(shí)現(xiàn)
這篇文章主要介紹了淺析Android系統(tǒng)中HTTPS通信的實(shí)現(xiàn),實(shí)現(xiàn)握手的源碼為Java語言編寫,需要的朋友可以參考下2015-07-07