专栏首页.NET企业级解决方案应用与咨询C#开发BIMFACE系列7 服务端API之获取文件信息列表

C#开发BIMFACE系列7 服务端API之获取文件信息列表

系列目录 【已更新最新开发文章,点击查看详细】

本文详细介绍如何获取BIMFACE平台中所有上传过的文件信息列表。

请求地址:GET https://file.bimface.com/files

说明:根据多种查询条件获取文件详细信息列表,支持分页

参数:

请求 path(示例):https://file.bimface.com/files

请求 header(示例):"Authorization: Bearer dc671840-bacc-4dc5-a134-97c1918d664b"

HTTP响应示例(200):

{
  "code" : "success",
  "data" : [ {
    "createTime" : "2017-11-09 13:25:03",
    "etag" : "19349858cjs98ericu989",
    "fileId" : 1216113551663296,
    "length" : 39044,
    "name" : "-1F.rvt",
    "status" : "success",
    "suffix" : "rvt"
  } ],
  "message" : ""
}

注意上面返回的data内容是一个数组。

C#实现方法:

 1 /// <summary>
 2 ///  根据多种查询条件获取文件详细信息列表,支持分页
 3 /// </summary>
 4 /// <param name="accessToken">令牌</param>
 5 /// <param name="startTime">起始日期,格式为 yyyy-MM-dd。默认为空,查询所有</param>
 6 /// <param name="endTime">截止日期,格式为 yyyy-MM-dd。默认为空,查询所有</param>
 7 /// <param name="rows">查询结果数, 默认为100, 最大500。默认100</param>
 8 /// <param name="offset">查询结果偏移,从查询结果的第offset条开始返回数据。默认-1,查询所有</param>
 9 /// <param name="status">文件状态,uploading,success,failure。默认为空,查询所有</param>
10 /// <param name="suffix">文件后缀。默认为空,查询所有</param>
11 /// <returns></returns>
12 public virtual FileInfoListGetResponse GetFileInfoList(string accessToken, string startTime = "", string endTime = "", long rows = 100, long offset = -1, string status = "", string suffix = "")
13 {
14     FileInfoListGetResponse response = new FileInfoListGetResponse();
15    
16     #region 校验
17     if (rows < 0 || rows > 500)
18     {
19         response.Message = "参数[rows]超出范围。要求控制在1到500之间!";
20 
21         return response;
22     }
23 
24     #endregion
25 
26     //GET https://file.bimface.com/files
27     string url = BimfaceConstants.FILE_HOST + "/files";
28     url = url + "?rows=" + rows;
29     if (!string.IsNullOrWhiteSpace(startTime))
30     {
31         url = url + "?rows=" + rows;
32     }
33     if (!string.IsNullOrWhiteSpace(endTime))
34     {
35         url = url + "?endTime=" + endTime;
36     }
37     if (offset >= 0)
38     {
39         url = url + "?offset=" + offset;
40     }
41     if (!string.IsNullOrWhiteSpace(status))
42     {
43         url = url + "?status=" + status;
44     }
45     if (!string.IsNullOrWhiteSpace(suffix))
46     {
47         url = url + "?suffix=" + suffix;
48     }
49 
50     BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
51     headers.AddOAuth2Header(accessToken);
52 
53     try
54     {
55         HttpManager httpManager = new HttpManager(headers);
56         HttpResult httpResult = httpManager.Get(url);
57         if (httpResult.Status == HttpResult.STATUS_SUCCESS)
58         {
59             response = httpResult.Text.DeserializeJsonToObject<FileInfoListGetResponse>();
60         }
61         else
62         {
63             response = new FileInfoListGetResponse
64             {
65                 Message = httpResult.RefText
66             };
67         }
68 
69         return response;
70     }
71     catch (Exception ex)
72     {
73         throw new Exception("[获取文件信息列表]发生异常!", ex);
74     }
75 }
其中引用的 httpManager.Get() 方法,请参考《C#开发BIMFACE系列6 服务端API之获取文件信息》,方法完全一样。

测试

在BIMFACE的控制台中可以看到我们上传的文件列表,共计2个文件。

下面通过调用上述的GetFileInfoList()方法来测试,结果如下,与后台的文件列表一致。

测试程序如下:
// 获取文件信息列表
protected void btnGetFileList_Click(object sender, EventArgs e)
{
    txtFileInfo.Text = string.Empty;

    string token = txtAccessToken.Text;

    FileApi api = new FileApi();
    FileInfoListGetResponse response = api.GetFileInfoList(token);

    List<FileInfoGetEntity> fileInfoList = response.Data;
    StringBuilder sbFiles = new StringBuilder();
    foreach(FileInfoGetEntity fileInfo in fileInfoList)
    {
        sbFiles.AppendLine("名称:" + fileInfo.ToString());
    }

    txtFileInfo.Text = response.Code
                     + Environment.NewLine
                     + response.Message
                     + Environment.NewLine
                     + "共获取 " + fileInfoList.Count + " 个文件。"
                     + Environment.NewLine
                     + sbFiles;
}

系列目录 【已更新最新开发文章,点击查看详细】

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

我来说两句

0 条评论
登录 后参与评论

相关文章

  • C#3.0新增功能09 LINQ 基础01 语言集成查询

    语言集成查询 (LINQ) 是一系列直接将查询功能集成到 C# 语言的技术统称。 数据查询历来都表示为简单的字符串,没有编译时类型检查或 IntelliSens...

    张传宁老师
  • C#3.0新增功能09 LINQ 标准查询运算符 04 运算

    排序操作基于一个或多个属性对序列的元素进行排序。 第一个排序条件对元素执行主要排序。 通过指定第二个排序条件,您可以对每个主要排序组内的元素进行排序。

    张传宁老师
  • C#开发BIMFACE系列10 服务端API之获取文件下载链接

    通过BIMFACE控制台或者调用服务接口上传文件成功后,默认场景下需要下载该源文件,下载文件一般需要知道文件的下载链接即可。BIMACE平台提供了“获取文件下载...

    张传宁老师
  • .net服务器端发起请求封装

    用户1055830
  • 【DB笔试面试612】在Oracle中,查询转换包含哪些类型?

    在Oracle数据库中,用户发给Oracle让其执行的目标SQL和Oracle实际执行的SQL有可能是不同的,这是因为Oracle可能会对执行的目标SQL做等价...

    小麦苗DBA宝典
  • c++面试题中经常被面试官面试的小问题总结(二)(本篇偏向指针知识)

    原文链接:https://www.cnblogs.com/DOMLX/p/10713204.html

    徐飞机
  • C/C++数组与指针详解

    数组大小(元素个数)一般在编译时决定,也有少部分编译器可以运行时动态决定数组大小,比如icpc(Intel C++编译器)。

    Dabelv
  • Python3学习(34)--简单网页内

    基础讲多了也不好,懂的人看了烦躁,半懂的人看多了没耐心,我也不能打消了你们学习Python的积极性了,开始爬虫系列基础篇之前,先上一张图,给大脑充充血:

    py3study
  • JenkinsPipeline插件的十大最佳实践

    Jenkins是卓越的自动化工具之一。Jenkins可通过使用插件进行设计扩展。插件使Jenkins拥有极大的灵活性,可以在各种平台上自动执行各种流程。Jenk...

    泽阳
  • python彩色文字输出

    py3study

扫码关注云+社区

领取腾讯云代金券