98 lines
4.7 KiB
Markdown
98 lines
4.7 KiB
Markdown
# FileServices
|
||
文件管理，超大文件上传，服务端支持断点续传，客户端h5上传器，支持多文件同时上传，支持断点续传
|
||
|
||
使用方法
|
||
-------
|
||
|
||
1. 注册服务
|
||
```C#
|
||
public void ConfigureServices(IServiceCollection services)
|
||
{
|
||
services.AddHttpContextAccessor();
|
||
services.AddFileServices(opt => {
|
||
opt.DefaultScheme = "documents";//默认是文档处理方案
|
||
opt.AddAuthenticationScheme(CookieAuthenticationDefaults.AuthenticationScheme);//身份认证方案名称
|
||
//文件保存时新文件的命名规则
|
||
opt.RuleOptions = new Ufangx.FileServices.Models.FileNameRuleOptions()
|
||
{
|
||
Rule = Ufangx.FileServices.Models.FileNameRule.Custom,//自定义命名规则，必须提供自定义方法
|
||
Custom = originFileName => string.Format("{0:yyyyMMddHHmmss}_xx_{1}", DateTime.Now, originFileName),
|
||
Format = "xxx_{0:yyyyMMddHHmmss}"//这个配置和Rule=FileNameRule.Date一起使用，默认是：{0:yyyyMMddHHmmss}
|
||
};
|
||
|
||
})
|
||
//照片处理方案
|
||
.AddScheme("pictures", opt => {
|
||
opt.StoreDirectory = "wwwroot/pictures";//图片存储的目录，使用本地文件系统时一般不放这里
|
||
opt.SupportExtensions = new string[] { ".jpg", ".png" };//支持的扩展名
|
||
opt.HandlerType = null;//上传成功后的文件处理类型，该类型必须实现IFileHandler接口
|
||
opt.LimitedSize = 1024 * 1024 * 4;//文件大小的最大限制值，字节为单位
|
||
})
|
||
.AddScheme("documents",opt => opt.StoreDirectory = "wwwroot/documents")//文档处理方案
|
||
.AddScheme<VideoService>(name:"videos",
|
||
storeDirectory:"wwwroot/videos",//视频存储目录，使用本地文件系统时一般不放这里
|
||
supportExtensions: new string[] { ".avi", ".wmv", ".mpg", ".mpeg", ".mov", ".rm", ".swf", ".flv", ".mp4" }
|
||
LimitedSize:1024*1024*500)//视频处理方案
|
||
//.AddLocalServices(o => o.StorageRootDir = hostEnvironment.ContentRootPath)//本地文件系统，文件存在本地
|
||
//七牛存储服务
|
||
.AddQiniuFileService(opt => {
|
||
opt.AccessKey = "";//
|
||
opt.SecretKey = "";
|
||
opt.BasePath = "";
|
||
opt.Bucket = "";
|
||
opt.Domain = "";
|
||
opt.ChunkUnit = Qiniu.Storage.ChunkUnit.U1024K;
|
||
opt.Zone = "ZoneCnEast";
|
||
|
||
});
|
||
//续传信息默认是存储在缓存里面，通过services.AddDistributedRedisCache方法配置Redis缓存实现持久化存储
|
||
//或者AddQiniuFileService<CustomResumableInfoService>或者AddLocalServices<CustomResumableInfoService> 方法指定自定义续传信息服务类型
|
||
}
|
||
|
||
```
|
||
2.使用中间件
|
||
|
||
```C#
|
||
public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
|
||
{
|
||
//。。。。其他代码
|
||
|
||
app.UseFileServices("/FileServices");
|
||
//上传文件的url是：/FileServices/uploader
|
||
//创建续传信息是：
|
||
//GET /FileServices/uploader?fileSize=125829120&blobSize=4194304&blobCount=30&fileName=xxx.zip&fileType=xxxx
|
||
//request headers
|
||
//scheme:documents
|
||
//response
|
||
//{"index":0,"key":"续传信息key"}
|
||
//获取续传信息是：
|
||
//GET /FileServices/uploader?key=续传信息key
|
||
//request headers
|
||
//scheme:documents
|
||
//response
|
||
//{"index":12,"key":"续传信息key"}
|
||
//删除续传信息是：
|
||
//DELETE /FileServices/uploader?key=续传信息key
|
||
//response
|
||
//true
|
||
//上传切片数据块
|
||
//POST /FileServices/uploader
|
||
//Form
|
||
//blobIndex:12 当前切片的索引
|
||
//key:续传信息key
|
||
//Form.Files==1 必须有一个表单文件，表示当前切片数据
|
||
//request headers
|
||
//scheme:documents
|
||
//上传文件
|
||
//POST /FileServices/uploader
|
||
//Form.Files>0 必须包含有一个文件以上
|
||
//request headers
|
||
//scheme:documents
|
||
|
||
//。。。。其他代码
|
||
|
||
}
|
||
|
||
```
|
||
|