专栏首页.NET技术与企业级解决方案C#开发BIMFACE系列23 服务端API之获取模型数据8:获取模型链接信息

C#开发BIMFACE系列23 服务端API之获取模型数据8:获取模型链接信息

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

在Revit等BIM设计工具中可以给模型的某个部位添加链接信息。即类似于在Office Word、Excel 中给一段文字添加本地文件链接或者网址链接等类似功能。例如下面的一个RVT模型种包含了2个链接。

下面详细介绍如何获取单个模型包含的所有链接信息。

请求地址:GET https://api.bimface.com/data/v2/files/{fileId}/links

说明:获取一个模型种包含的所有链接信息

参数:

请求 path(示例):https://api.bimface.com/data/v2/files/1211223382064960/links

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

HTTP响应示例(200):

{
  "code" : "success",
  "data" : [ {
    "guid" : "ffb665b7-067f-4cd6-b080-214e96db0f73-00058185",
    "id" : 0,
    "name" : "file_link.rvt : 12 : loc <not shared>",
    "transform" : ""
  } ],
  "message" : ""
}

返回的结果封装成 SingleModelLink 类

/// <summary>
///  获取单个模型的链接信息返回的结果类
/// </summary>
[Serializable]
public class SingleModelLink : GeneralResponse<List<Link>>
{

}
[Serializable]
public class Link
{
    [JsonProperty("guid")]
    public string Guid { get; set; }

    [JsonProperty("id")]
    public long? Id { get; set; }

    /// <summary>
    ///  样例 : "file_link.rvt : 12 
    /// </summary>
    [JsonProperty("name")]
    public string Name { get; set; }

    [JsonProperty("transform")]
    public string Transform { get; set; }

    /// <summary>返回表示当前对象的字符串。</summary>
    /// <returns>表示当前对象的字符串。</returns>
    public override string ToString()
    {
        return String.Format("[Link guid={0}, id={1}, name={2},transform={3}]",
                             Guid, Id, Name, Transform);
    }
}

C#实现方法:

 1 /// <summary>
 2 ///  获取单个模型的楼层信息
 3 /// </summary>
 4 /// <param name="accessToken">【必填】令牌</param>
 5 /// <param name="fileId">【必填】代表该单模型的文件ID</param>
 6 /// <returns></returns>
 7 public virtual SingleModelLink GetSingleModelLink(string accessToken, long fileId)
 8 {
 9     // GET https://api.bimface.com/data/v2/files/{fileId}/links
10     string url = string.Format(BimfaceConstants.API_HOST + "/data/v2/files/{0}/links", fileId);
11 
12     BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
13     headers.AddOAuth2Header(accessToken);
14 
15     try
16     {
17         SingleModelLink response;
18 
19         HttpManager httpManager = new HttpManager(headers);
20         HttpResult httpResult = httpManager.Get(url);
21         if (httpResult.Status == HttpResult.STATUS_SUCCESS)
22         {
23             response = httpResult.Text.DeserializeJsonToObject<SingleModelLink>();
24         }
25         else
26         {
27             response = new SingleModelLink
28             {
29                 Message = httpResult.RefText
30             };
31         }
32 
33         return response;
34     }
35     catch (Exception ex)
36     {
37         throw new Exception("[获取模型链接信息]发生异常!", ex);
38     }
39 }

其中调用到的 httpManager.Get() 方法,请参考《C# HTTP系列》

测试

在BIMFACE的控制台中可以看到我们上传的文件列表,模型状态均为转换成功。

以模型 “A4.rvt” 为例测试上述的方法

查询到了2条链接信息,与文章开始处的源文件中的链接信息对应。

并不是所有的模型中都包含链接信息,如果不包含,则返回 null

测试代码如下:

 1 // 获取单模型链接信息
 2 protected void btnGetSingleModelLink_Click(object sender, EventArgs e)
 3 {
 4     long fileId = txtFileID.Text.Trim().ToLong();
 5     FileConvertApi api = new FileConvertApi();
 6     SingleModelLink response = api.GetSingleModelLink(txtAccessToken.Text, fileId);
 7 
 8     StringBuilder sb = new StringBuilder();
 9     if (response.Data != null)
10     {
11         List<Link> lstLink = response.Data;
12         foreach (var link in lstLink)
13         {
14             sb.AppendLine(link.ToString());
15         }
16     }
17 
18     txtResult.Text = response.Code.ToString2()
19                    + Environment.NewLine
20                    + response.Message.ToString2()
21                    + Environment.NewLine
22                    + sb;
23 }

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

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

我来说两句

0 条评论
登录 后参与评论

相关文章

  • C# HTTP系列9 GET与POST示例

    学习本篇之前,对 HttpWebRequest 与 HttpWebResponse 不太熟悉的同学,请先学习《C# HTTP系列》。

    张传宁老师
  • C# HTTP系列7 HttpWebRequest.Method属性

    HttpWebRequest.Method属性,获取或设置请求的方法。用于联系 Internet 资源的请求方法。 默认值为 GET。

    张传宁老师
  • C#开发BIMFACE系列13 服务端API之获取转换状态

    在《C#开发BIMFACE系列12 服务端API之文件转换》中详细介绍了7种文件转换的方法。发起源文件/模型转换后,转换过程可能成功也可能失败。那么在这种情况下...

    张传宁老师
  • 再谈Newtonsoft.Json高级用法

      上一篇Newtonsoft.Json高级用法发布以后收到挺多回复的,本篇将分享几点挺有用的知识点和最近项目中用到的一个新点进行说明,做为对上篇文章的补充。 ...

    用户1168362
  • 调用CMD命令的一个.NET工具类(MyWindowsCmd)

    功能大概描述一下如果直接StandardOutput.ReadToEnd()这种方法,有很多限制

    lulianqi
  • WCF技术剖析之十七:消息(Message)详解(上篇)

    消息交换是WCF进行通信的唯一手段,通过方法调用(Method Call)形式体现的服务访问需要转化成具体的消息,并通过相应的编码(Encoding)才能通过传...

    蒋金楠
  • asp.net core封装layui组件示例分享

    用什么封装?这里只是用了TagHelper,是啥?自己瞅[文档](https://docs.microsoft.com/zh-cn/aspnet/core/mv...

    易墨
  • 【C#】工具类-FTP操作封装类FTPHelper

    转载:http://blog.csdn.net/gdjlc/article/details/11968477

    跟着阿笨一起玩NET
  • 用SignalR 2.0开发客服系统[系列2:实现聊天室]

    前言 交流群:195866844 上周发表了 用SignalR 2.0开发客服系统[系列1:实现群发通讯] 这篇文章,得到了很多帮助和鼓励,小弟在此真心的感谢大...

    GuZhenYin
  • .NET Core 使用MediatR CQRS模式

    CQRS(Command Query Responsibility Segregation)命令查询职责分离模式,它主要从我们业务系统中进行分离出我们(Comm...

    HueiFeng

扫码关注云+社区

领取腾讯云代金券