# file-uploader **Repository Path**: huafua/file-uploader ## Basic Information - **Project Name**: file-uploader - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-08-25 - **Last Updated**: 2025-08-26 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 説明 ## 1. 背景 1. 現在部分從中央採購帶過來`DMaker`文件上傳功能是將文件保存到中央採購的`nas`平臺上 2. 此後將不再使用`nas`而改爲通過`api`接口上傳到指定的文件服務器 ## 2. 接口介紹 **接口地址:** `http://10.134.180.52:8082/oss/upload/put-file` **請求方式:** `POST` 實例如下圖 ![file-upload](./assets/file-upload.png) ## 3. 幾個類介紹 - `FeedbackData`:用於存儲接口相應的結果,有如下幾個保存文件信息的字段 - `link`:供下載訪問的文件對象服務路徑 - `name`:真實路徑 - `originalName`:上傳之文件原名稱 - `Feedback`:封裝相應的全部資訊 - `code`:結果代碼 - `success`:成功與否 - `data`:即`FeedbackData`類表示的部分 - `msg`:消息 - `FileUploader`:執行上傳的關鍵類,支持如下方法: - `Feedback upload(String filepath)`: 上傳文件,參數為文件路徑 - `Feedback upload(File file)`: 上傳文件,參數為文件的對象 - `boolean upload(String filepath, Connection connection, String tableName, List columns,boolean update)`: 上傳文件,如上傳成功將所需結果保存到數據庫並刪除源文件,參數分別為: - `filepath`:要上傳的文件路徑 - `Connection`:數據庫連接對象 - `tableName`:將上傳結果存儲到哪張表 - `columns`:接收兩個字符串,為所需參數,具體因`update`不同而不同 - `update`:是否為更新操作 - 如為更新操作,則需要 `columns` 中有 4 個值,分別為: - 保存文件原名稱的欄位名稱,如`originalName` - 保存可訪問的服務器路徑欄位名稱,如`link` - 主鍵名稱,如`id` - 主鍵值,如`1` - 否則只需 2 個值,分別為 - 保存文件原名稱的欄位名稱,如`originalName` - 保存可訪問的服務器路徑欄位名稱,如`link` - `boolean uploadInsert(String filepath, Connection connection, String tableName, List columns)`: 上傳文件並插入文件原名稱和服務器路徑到表中 - `boolean uploadModify(String filepath, Connection connection, String tableName, List columns)`: 上傳並更新指定表指定記錄的文件原名稱和服務器路徑 ## 4. 調用 ### 4.1 僅上傳到服務器 ```java public static void upload() { String filepath = "C:\\Users\\F3231918.HQIT\\Desktop\\Update.txt"; FileUploader uploader = new FileUploader("http://localhost:8888/upload"); Feedback feedback = uploader.upload(filepath); if (feedback.getCode() == 200) { System.out.println(JSON.toJSONString(feedback.getData())); } else { System.out.println("Failed to upload file due to code " + feedback.getCode() + ", error message is " + feedback.getMsg()); } } ``` ### 4.2 上傳到服務器並保存返回結果 - 上傳文件並插入新紀錄到表中 ```java public static void uploadSave() { try { String filepath = "C:\\Users\\F3231918.HQIT\\Desktop\\Update.txt"; FileUploader uploader = new FileUploader("http://localhost:8888/upload"); Connection connection = DriverManager .getConnection("jdbc:sqlserver://localhost:3000;DatabaseName=demo;user=sa;password=[密碼]"); boolean v = uploader.uploadInsert(filepath, connection, "FileUpload", Arrays.asList("original_name", "link")); System.out.println(v ? "上傳成功" : "上傳失敗"); } catch (Exception e) { e.printStackTrace(System.out); } } ``` - 上傳文件並修改現有記錄 ```java public static void uploadSave() { try { String filepath = "C:\\Users\\F3231918.HQIT\\Desktop\\Update.txt"; FileUploader uploader = new FileUploader("http://localhost:8888/upload"); Connection connection = DriverManager .getConnection("jdbc:sqlserver://localhost:3000;DatabaseName=demo;user=sa;password=[密碼]"); boolean v = uploader.uploadModify(filepath, connection, "FileUpload", Arrays.asList("original_name", "link","id","3")); System.out.println(v ? "上傳成功" : "上傳失敗"); } catch (Exception e) { e.printStackTrace(System.out); } } ``` 結果如下 ```cmd Upload file to http://localhost:8888/upload 上傳成功 ``` ![上傳成功的記錄](./assets/upload-saved.png)