# 服务端 Java SDK

适用于 Java8 及以上版本。

# 使用方式

可以通过两种方式引入BIMFACE的SDK:

# 1. 把bimface-java-sdk和第三方依赖包全部引入到Java工程

bimface-java-sdk-3.2.6-all.jar(请右击另存为) (opens new window)

第三方依赖包:

gson-2.8.2.jar(请右击另存为) (opens new window)

fastjson-1.2.58.jar(请右击另存为) (opens new window)

logging-interceptor-3.10.0.jar(请右击另存为) (opens new window)

okhttp-3.10.0.jar(请右击另存为) (opens new window)

okio-1.14.0.jar(请右击另存为) (opens new window)

converter-gson-2.4.0.jar(请右击另存为) (opens new window)

retrofit-2.4.0.jar(请右击另存为) (opens new window)

commons-lang3-3.5.jar(请右击另存为) (opens new window)

aspectjrt-1.9.2.jar(请右击另存为) (opens new window)

aspectjweaver-1.9.2.jar(请右击另存为) (opens new window)

annotations-16.0.2.jar(请右击另存为) (opens new window)

slf4j-api-1.7.25.jar(请右击另存为) (opens new window)

# 2. 使用Maven配置工具进行管理

请百度搜索Maven的使用方式。

<dependency>
    <groupId>com.bimface</groupId>
    <artifactId>bimface-java-sdk</artifactId>
    <version>3.2.5</version>
    <classifier>all</classifier>
</dependency>

说明:若构造Maven时报错:"Could not find artifact com.glodon.paas.foundation:restclient:pom:0.0.9-SNAPSHOT",可尝试以下构造方式:

<dependency>
    <groupId>com.bimface</groupId>
    <artifactId>bimface-java-sdk</artifactId>
    <version>3.2.5</version>
    <classifier>all</classifier>
    <exclusions>
        <exclusion>
            <groupId>com.glodon.paas.foundation</groupId>
            <artifactId>restclient</artifactId>
        </exclusion>
    </exclusions>
</dependency>

# 示例程序

BIMFACE在Github上编写了简单的入门程序,请点击链接:Java示例程序 (opens new window)

# 初始化BIMFACE

String appKey = "<your appKey>";
String appSecret = "<your appSecret>";
BimfaceClient bimfaceClient = new BimfaceClient(appKey, appSecret);

# 上传文件

// PUSH方式
FileBean fileBean = bimfaceClient.upload(name, contentLength, inputStream);

// PULL方式
FileBean fileBean = bimfaceClient.upload(name, url);

# 发起文件转换

FileTranslateBean fileTranslateBean = bimfaceClient.translate(fileId, callback);

# 获取转换状态

FileTranslateBean fileTranslateBean = bimfaceClient.getTranslate(fileId);

# 回调,验证签名

待BIMFACE回调应用时,为验证callback的合法性,请通过以下方式校验。

Boolean legal = bimfaceClient.validateSignature(signature, fileId, status, nonce);

# 获取viewToken

String viewToken = bimfaceClient.getViewTokenByFileId(fileId);