C#开发BIMFACE系列9 服务端API之获取应用支持的文件类型

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

　　BIMFACE最核心能力之一是工程文件格式转换。无需安装插件，支持数十种工程文件格式在云端转换，完整保留原始文件信息。开发者将告别原始文件解析烦恼，数据抽取全部自动完成。BIMFACE目前能够解析38种常见工程图纸和模型，具体包括：rvt、rfa、rte、skp、nwd、nwc、ifc、dwg、dxf、3dm、stl、dgn、stp、3ds、obj、dae、ply、fbx、dwf、gmp、gtj、gbq、gcl、ggj、gqi、gdq、gjg、igms、gpb、gpv、gsc、gbg、gsh、gtb、gzb。

下面详细介绍如何获取应用支持的文件类型。

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

说明：获取当前应用支持转换的文件类型，如上传的文件格式不在列表里，BIMFACE不支持对其发起转换。

参数：

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

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

HTTP响应示例(200)：

{
  "code" : "success",
  "data" : {
    "length" : 1073741824,
    "types" : [ "rvt", "rfa", "dwg", "dxf", "skp", "ifc", "dgn", "obj", "stl", "3ds", "dae", "ply", "igms", "zip", "gtj", "bfcatzip" ]
  },
  "message" : ""
}

C#实现方法：

/// <summary>
///  获取应用支持的文件类型
/// </summary>
/// <param name="accessToken">令牌</param>
public virtual FileSupportResponse GetFileSupport(string accessToken)
{
    //GET https://file.bimface.com/support
    string url = BimfaceConstants.FILE_HOST + "/support";
    BimFaceHttpHeaders headers = new BimFaceHttpHeaders();
    headers.AddOAuth2Header(accessToken);

    try
    {
        FileSupportResponse response;

        HttpManager httpManager = new HttpManager(headers);
        HttpResult httpResult = httpManager.Get(url);
        if (httpResult.Status == HttpResult.STATUS_SUCCESS)
        {
            response = httpResult.Text.DeserializeJsonToObject<FileSupportResponse>();
        }
        else
        {
            response = new FileSupportResponse
            {
                Message = httpResult.RefText
            };
        }

        return response;
    }
    catch (Exception ex)
    {
        throw new Exception("[获取应用支持的文件类型]发生异常！", ex);
    }
}

其中引用的 httpManager.Get() 方法，请参考《C#开发BIMFACE系列6 服务端API之获取文件信息》，方法完全一样。

测试

可以看到获取应用支撑的文件类型成功，返回了以下信息：数据长度、支持的类型。

但是此处只返回了以下17种： rvt、rfa、dwg、dxf、skp、ifc、dgn、obj、stl、3ds、dae、ply、imgs、zip、fbx、dwf、nwd 格式。与官网介绍的38种相差很多，原因是我注册的账号只是一个开发者测试账号。所以默认只提供了17种。如果需要其他的格式，需要联系管理员增加其他的格式。

测试程序如下：

// 获取应用支持的文件类型
protected void btnGetFileSupport_Click(object sender, EventArgs e)
{
    txtFileInfo.Text = string.Empty;

    string token = txtAccessToken.Text;

    FileApi api = new FileApi();
    FileSupportResponse response = api.GetFileSupport(token);

    txtFileInfo.Text = response.Code
                     + Environment.NewLine
                     + response.Message
                     + Environment.NewLine
                     + response.Data.ToString();
}

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