天天看点
返回

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

BIMFACE二次开发

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

C#开发BIMFACE系列23 服务端API之获取模型数据8：获取模型链接信息
　　在Revit等BIM设计工具中可以给模型的某个部位添加链接信息。即类似于在Office Word、Excel 中给一段文字添加本地文件链接或者网址链接等类似功能。例如下面的一个RVT模型种包含了2个链接。
C#开发BIMFACE系列23 服务端API之获取模型数据8：获取模型链接信息
C#开发BIMFACE系列23 服务端API之获取模型数据8：获取模型链接信息

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

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

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

参数：

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

请求 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的控制台中可以看到我们上传的文件列表，模型状态均为转换成功。

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

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

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

查询到了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 }
C#开发BIMFACE系列23 服务端API之获取模型数据8：获取模型链接信息

成在管理，败在经验；嬴在选择，输在不学！  贵在坚持！

欢迎关注作者头条号 张传宁IT讲堂，获取更多IT文章、视频等优质内容。

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

个人作品

1、BIMFace.Community.SDK.NET

     开源地址：https://gitee.com/NAlps/BIMFace.SDK

     系列博客：https://www.cnblogs.com/SavionZhang/p/11424431.html

     系列视频：https://www.cnblogs.com/SavionZhang/p/14258393.html

2、ZCN.NET.Common

     开源地址：https://gitee.com/NAlps/zcn.net.common

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

技术栈

 1、Visual Studio、.C#/.NET、.NET Core、MVC、Web API、RESTful API、gRPC、SignalR、Python

 2、jQuery、Vue.js、Bootstrap

 3、数据库：SQLServer、MySQL、PostgreSQL、Oracle、SQLite、Redis、MongoDB、ElasticSearch、TiDB、达梦DM、人大金仓、 神通、南大通用 GBase、华为 GaussDB 、腾讯 TDSQL 、阿里 PolarDB、蚂蚁金服 OceanBase、东软 OpenBASE、浪潮云溪数据库 ZNBase

 4、ORM：Dapper、Entity Framework、FreeSql、SqlSugar、分库分表、读写分离

 5、架构：领域驱动设计 DDD、ABP

 6、环境：跨平台、Windows、Linux（CentOS、麒麟、统信UOS、深度Linux）、maxOS、IIS、Nginx、Apach

 7、移动App：Android、IOS、HarmonyOS、微信、小程序、快应用、Xamarin、uni-app、MUI、Flutter、Framework7、Cordova、Ionic、React Native、Taro、NutUI、Smobiler

 云原生、微服务、Docker、CI/CD、DevOps、K8S；

 Dapr、RabbitMQ、Kafka、分布式、大数据、高并发、负载均衡、中间件、RPC、ELK；

 .NET + Docker + jenkins + Github + Harbor + K8S；

出处：www.cnblogs.com/SavionZhang

作者：张传宁   微软MCP、系统架构设计师、系统集成项目管理工程师、科技部创新工程师。

          专注于微软.NET技术(.NET Core、Web、MVC、WinForm、WPF)、通用权限管理系统、工作流引擎、自动化项目(代码)生成器、SOA 、DDD、 云原生(Docker、微服务、DevOps、CI/CD）；PDF、CAD、BIM 审图等研究与应用。

          多次参与电子政务、图书教育、生产制造等企业级大型项目研发与管理工作。

          熟悉中小企业软件开发过程：需求分析、架构设计、编码测试、实施部署、项目管理。通过技术与管理帮助中小企业快速化实现互联网技术全流程解决方案。

本文版权归作者和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。

如有问题，可以通过邮件[email protected]联系。共同交流、互相学习。

如果您觉得文章对您有帮助，请点击文章右下角【推荐】。您的鼓励是作者持续创作的最大动力！

BIM BIMFACE BIMFACE二次开发
上一篇: PHP去除数组中的空值
下一篇: 扩展方法

继续阅读