.net5 core webapi項目實戰之十七：F8用戶上傳自己的照片

本篇對之前的設計做一下擴展，實現F8功能(見紅色部分)，客戶端可以通過調用此接口API上傳一張（或多張）自己的照片。

功能序號	HTTP謂詞（HTTP verbs）	API	描述
F1	GET	/api/users	管理員獲取用戶列表
F2	POST	/api/users	管理員添加用戶
F3	PATCH	/api/users/{id}/role	管理員修改用戶角色
F4	PATCH	/api/users/{id}/state	管理員鎖定/解鎖用戶
F5	GET	/api/users/{id}	用戶獲取自己的信息
F6	PUT	/api/users/{id}	用戶更新自己的信息
F7	PATCH	/api/users/{id}/password	用戶修改密碼
F8	POST	/api/users/{id}/photo	用戶上傳自己的圖片

 

一、准備工作：

1. 在項目的根目錄下新增 Images 的文件夾用來存放上傳的圖片，如下：

2. 添加如下3個引用

using Microsoft.AspNetCore.Hosting;
using Microsoft.AspNetCore.Http;
using System.IO;

3. 在UsersController.cs的構造函數中注入環境實例以便獲取應用程序目錄，代碼如下（紅色部分）：

        private IWebHostEnvironment _env;
        private ILogger<UsersController> _logger;
        private IUserDao _userDao;
        public UsersController(IWebHostEnvironment env, ILogger<UsersController> logger, IUserDao userDao)
        {
            _env = env;
            _logger = logger;
            _userDao = userDao;
        }

 

二、終結點編碼

新增終結點 UploadPhoto( )，路由屬性為 [Route("{id}/photo")] ，代碼如下：

        [Route("{id}/photo")]
        [HttpPost]
        public ContentResult UploadPhoto(int id)
        {
            //圖片保存路徑
            string filePath = _env.ContentRootPath + "\\Images\\";

            string fullName = string.Empty;

            //Request.Form.Files獲取客戶端POST過來的所有文件
            IFormFileCollection files = Request.Form.Files;
            foreach (FormFile file in files) //遍歷處理每一個文件
            { 
                //Path.GetExtension()獲取文件擴展名
                string exten = Path.GetExtension(file.FileName).ToLower();

                //擴展名不符合要求就不處理
                if (exten != ".jpg" && exten != ".png") continue;

                //Guid.NewGuid().ToString()生成一個GUID風格的文件名避免重名
                string fileName = Guid.NewGuid().ToString();

                fullName = filePath + fileName + exten;

                //用using語句釋放文件資源
                using (FileStream stream = new FileStream(fullName, FileMode.Create, FileAccess.Write))
                {
                    file.CopyTo(stream);
                    stream.Flush();
                }

            }
            return Content("{'result':'ok'}");
        }

 

三、測試

 打開POSTMAN運行網址 http://localhost:52384/api/users/1/photo，添加兩個圖片文件后發送請求，如下：

可以看到在解決方案資源管理器中已經生成了2個圖片文件，如下：

===================================================================

補充：

實際項目中需要在終結點 UploadPhoto( ) 中增加 try{ } catch{ }語句處理異常並寫入日志，

之前的篇章有詳細介紹，可以參考。