feat(portal): 更新Hw资料文件接口路径并新增安全文件地址功能

将Hw资料文件相关接口的URL前缀从`/com.ruoyi.portal`统一调整为`/portal`，同时新增获取安全文件地址的功能，支持通过密钥验证后获取文件访问地址。
该功能包括前端API调用、后端控制器接口及服务层实现，并引入了相应的请求参数封装类。

ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/controller/HwWebDocumentController.java

@@ -3,6 +3,8 @@ package com.ruoyi.portal.controller;
 import java.util.List;
 import java.io.IOException;
 import javax.servlet.http.HttpServletResponse;
+
+import com.ruoyi.portal.domain.SecureDocumentRequest;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -38,7 +40,7 @@ public class HwWebDocumentController extends BaseController
     /**
      * 查询Hw资料文件列表
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:list")
+    @RequiresPermissions("portal:hwWebDocument:list")
     @GetMapping("/list")
     public TableDataInfo list(HwWebDocument hwWebDocument)
     {
@@ -50,7 +52,7 @@ public class HwWebDocumentController extends BaseController
     /**
      * 导出Hw资料文件列表
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:export")
+    @RequiresPermissions("portal:hwWebDocument:export")
     @Log(title = "Hw资料文件", businessType = BusinessType.EXPORT)
     @PostMapping("/export")
     public void export(HttpServletResponse response, HwWebDocument hwWebDocument)
@@ -63,7 +65,7 @@ public class HwWebDocumentController extends BaseController
     /**
      * 获取Hw资料文件详细信息
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:query")
+    @RequiresPermissions("portal:hwWebDocument:query")
     @GetMapping(value = "/{documentId}")
     public AjaxResult getInfo(@PathVariable("documentId") Long documentId)
     {
@@ -73,7 +75,7 @@ public class HwWebDocumentController extends BaseController
     /**
      * 新增Hw资料文件
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:add")
+    @RequiresPermissions("portal:hwWebDocument:add")
     @Log(title = "Hw资料文件", businessType = BusinessType.INSERT)
     @PostMapping
     public AjaxResult add(@RequestBody HwWebDocument hwWebDocument)
@@ -84,7 +86,7 @@ public class HwWebDocumentController extends BaseController
     /**
      * 修改Hw资料文件
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:edit")
+    @RequiresPermissions("portal:hwWebDocument:edit")
     @Log(title = "Hw资料文件", businessType = BusinessType.UPDATE)
     @PutMapping
     public AjaxResult edit(@RequestBody HwWebDocument hwWebDocument)
@@ -95,11 +97,28 @@ public class HwWebDocumentController extends BaseController
     /**
      * 删除Hw资料文件
      */
-    @RequiresPermissions("com.ruoyi.portal:hwWebDocument:remove")
+    @RequiresPermissions("portal:hwWebDocument:remove")
     @Log(title = "Hw资料文件", businessType = BusinessType.DELETE)
 	@DeleteMapping("/{documentIds}")
     public AjaxResult remove(@PathVariable Long[] documentIds)
     {
         return toAjax(hwWebDocumentService.deleteHwWebDocumentByDocumentIds(documentIds));
     }
+
+        /**
+     * 获取安全文件地址
+     */
+    @RequiresPermissions("portal:hwWebDocument:query")
+    @Log(title = "获取安全文件地址", businessType = BusinessType.OTHER)
+    @PostMapping("/getSecureDocumentAddress")
+    public AjaxResult getSecureDocumentAddress(@RequestBody SecureDocumentRequest request)
+    {
+        try {
+            String address = hwWebDocumentService.verifyAndGetDocumentAddress(request.getDocumentId(), request.getProvidedKey());
+            return success(address);
+        } catch (Exception e) {
+            return error(e.getMessage());
+        }
+    }
+
 }

ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/domain/SecureDocumentRequest.java

@@ -0,0 +1,9 @@
+package com.ruoyi.portal.domain;
+
+import lombok.Data;
+
+@Data
+public class SecureDocumentRequest {
+    private Long documentId;
+    private String providedKey;
+}

ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/IHwWebDocumentService.java

@@ -58,4 +58,14 @@ public interface IHwWebDocumentService
      * @return 结果
      */
     public int deleteHwWebDocumentByDocumentId(Long documentId);
+
+        /**
+     * 验证密钥并获取文件地址
+     * @param documentId 文件ID
+     * @param providedKey 提供的密钥
+     * @return 文件地址
+     * @throws Exception 如果密钥不匹配
+     */
+    String verifyAndGetDocumentAddress(Long documentId, String providedKey) throws Exception;
+
 }

ruoyi-modules/hw-portal/src/main/java/com/ruoyi/portal/service/impl/HwWebDocumentServiceImpl.java

@@ -1,6 +1,8 @@
 package com.ruoyi.portal.service.impl;
 
 import java.util.List;
+
+import com.ruoyi.common.core.exception.ServiceException;
 import com.ruoyi.common.core.utils.DateUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.stereotype.Service;
@@ -92,4 +94,20 @@ public class HwWebDocumentServiceImpl implements IHwWebDocumentService
     {
         return hwWebDocumentMapper.deleteHwWebDocumentByDocumentId(documentId);
     }
+
+    @Override
+    public String verifyAndGetDocumentAddress(Long documentId, String providedKey) throws Exception {
+        HwWebDocument document = selectHwWebDocumentByDocumentId(documentId);
+        if (document == null) {
+            throw new ServiceException("文件不存在");
+        }
+        String secretKey = document.getSecretKey();
+        if (secretKey == null || secretKey.equals(providedKey)) {
+            return document.getDocumentAddress();
+        } else {
+            throw new ServiceException("密钥错误");
+        }
+    }
+
+
 }

ruoyi-ui/src/api/portal/hwWebDocument.js

@@ -3,7 +3,7 @@ import request from '@/utils/request'
 // 查询Hw资料文件列表
 export function listHwWebDocument(query) {
   return request({
-    url: '/com.ruoyi.portal/hwWebDocument/list',
+    url: '/portal/hwWebDocument/list',
     method: 'get',
     params: query
   })
@@ -12,7 +12,7 @@ export function listHwWebDocument(query) {
 // 查询Hw资料文件详细
 export function getHwWebDocument(documentId) {
   return request({
-    url: '/com.ruoyi.portal/hwWebDocument/' + documentId,
+    url: '/portal/hwWebDocument/' + documentId,
     method: 'get'
   })
 }
@@ -20,7 +20,7 @@ export function getHwWebDocument(documentId) {
 // 新增Hw资料文件
 export function addHwWebDocument(data) {
   return request({
-    url: '/com.ruoyi.portal/hwWebDocument',
+    url: '/portal/hwWebDocument',
     method: 'post',
     data: data
   })
@@ -29,7 +29,7 @@ export function addHwWebDocument(data) {
 // 修改Hw资料文件
 export function updateHwWebDocument(data) {
   return request({
-    url: '/com.ruoyi.portal/hwWebDocument',
+    url: '/portal/hwWebDocument',
     method: 'put',
     data: data
   })
@@ -38,7 +38,16 @@ export function updateHwWebDocument(data) {
 // 删除Hw资料文件
 export function delHwWebDocument(documentId) {
   return request({
-    url: '/com.ruoyi.portal/hwWebDocument/' + documentId,
+    url: '/portal/hwWebDocument/' + documentId,
     method: 'delete'
   })
 }
+
+// 获取安全文件地址
+export function getSecureDocumentAddress(data) {
+  return request({
+    url: '/portal/hwWebDocument/getSecureDocumentAddress',
+    method: 'post',
+    data: data
+  })
+}