介面1原始碼分析

一曲微茫發表於2024-11-11
原始碼

當然可以，下面是對 addDepartmentPermission 方法的詳細解釋，包括每一行程式碼的功能和作用：

方法簽名

@Override
@Transactional(rollbackFor = Exception.class)
public AddDepartmentPermissionResponse addDepartmentPermission(AddDepartmentPermissionRequest request) {
  • @Override：表示該方法重寫了父類或介面中的方法。
  • @Transactional(rollbackFor = Exception.class)：表示該方法在一個事務中執行。如果方法丟擲 Exception 型別的異常，事務將回滾。

方法體

初始化響應物件

AddDepartmentPermissionResponse response = new AddDepartmentPermissionResponse();
  • 建立一個 AddDepartmentPermissionResponse 物件，用於儲存方法的響應結果。

引數校驗

if (StringUtils.isEmpty(request.getDepartmentId()) || CollectionUtils.isEmpty(request.getDepartmentPermissionDTOList())) {
    log.error("團隊新建索關聯引請求引數為空");
    throw new TitanException("所傳引數為空!");
}
  • 使用 StringUtils.isEmpty 檢查 request.getDepartmentId() 是否為空。
  • 使用 CollectionUtils.isEmpty 檢查 request.getDepartmentPermissionDTOList() 是否為空。
  • 如果任一引數為空，記錄錯誤日誌並丟擲 TitanException 異常，提示引數為空。

獲取部門資訊

Department department = getDepartmentById(request.getDepartmentId());
  • 呼叫 getDepartmentById 方法，根據 request.getDepartmentId() 獲取部門資訊。

處理部門不存在的情況

if (department == null) {
    addDepartment(request.getDepartmentId());
}
  • 如果 department 為 null，表示該部門不存在，則呼叫 addDepartment 方法建立新的部門。

處理全域性查詢許可權的情況

else if (department.getGlobalQuery()) {
    RespUtils.setError(ErrorCodeEnum.DEPARTMENT_ALREADY_GLOBAL_QUERY, response);
    return response;
}
  • 如果 department 存在且已經具有全域性查詢許可權（department.getGlobalQuery() 返回 true），則使用 RespUtils.setError 方法設定響應物件的錯誤資訊，並返回響應物件。

新增許可權

permissionService.addPermissionForDepartment(request.getDepartmentId(), request.getDepartmentPermissionDTOList());
  • 呼叫 permissionService.addPermissionForDepartment 方法，為指定部門新增許可權。

設定成功響應

RespUtils.setSuccess(response);
  • 使用 RespUtils.setSuccess 方法設定響應物件的成功狀態。

返回響應物件

return response;
  • 返回最終的響應物件。

詳細解釋

  1. 初始化響應物件：

    • 建立一個 AddDepartmentPermissionResponse 物件，用於儲存方法的響應結果。

  2. 引數校驗：

    • 檢查請求引數是否為空。如果任一引數為空，記錄錯誤日誌並丟擲異常，防止後續操作出現錯誤。

  3. 獲取部門資訊：

    • 根據提供的部門 ID 獲取部門資訊。這裡假設 getDepartmentById 方法從資料庫或其他資料來源中獲取部門資訊。

  4. 處理部門不存在的情況：

    • 如果部門不存在，呼叫 addDepartment 方法建立新的部門。這裡假設 addDepartment 方法會處理部門的建立邏輯。

  5. 處理全域性查詢許可權的情況：

    • 如果部門已經具有全域性查詢許可權，設定響應物件的錯誤資訊並返回。這裡使用 RespUtils.setError 方法設定錯誤資訊，ErrorCodeEnum.DEPARTMENT_ALREADY_GLOBAL_QUERY 是一個列舉值，表示特定的錯誤碼。

  6. 新增許可權：

    • 呼叫 permissionService.addPermissionForDepartment 方法，為指定部門新增許可權。這裡假設 permissionService 是一個管理許可權的服務類。

  7. 設定成功響應：

    • 使用 RespUtils.setSuccess 方法設定響應物件的成功狀態。這裡假設 RespUtils 是一個工具類，提供了設定響應狀態的方法。

  8. 返回響應物件：

    • 返回最終的響應物件，客戶端可以透過響應物件獲取操作的結果。

透過這些步驟，addDepartmentPermission 方法確保了引數的有效性，處理了不同的業務邏輯，並在最後返回了一個包含操作結果的響應物件。

相關文章