Spire.Cloud.SDK for Java提供了PdfAttachmentsApi介面新增附件addAttachment()、下載附件downloadAttachment()、獲取附件資訊getAttachmentsInfo()，本文將通過Java程式碼示例介紹具體實現方法。詳細內容參考以下步驟：

一、匯入jar檔案。（有2種方式）

（推薦）方式1. 建立Maven專案程式，通過maven倉庫下載匯入。以IDEA為例，新建Maven專案，在pom.xml檔案中配置maven倉庫路徑，並指定spire.cloud.sdk的依賴，如下：

<repositories>

    <repository>
 

        <id>com.e-iceblue</id>

        <name>cloud</name>

        <url>http://repo.e-iceblue.cn/repository/maven-public/</url>

    </repository>

</repositories>

<dependencies>

        <dependency>

            <groupId> cloud </groupId>

            <artifactId>spire.cloud.sdk</artifactId>
 

            <version>3.5.0</version>

        </dependency>

        <dependency>

        <groupId> com.google.code.gson</groupId>

        <artifactId>gson</artifactId>

        <version>2.8.1</version>

        </dependency>

        <dependency>
 

            <groupId> com.squareup.okhttp</groupId>

            <artifactId>logging-interceptor</artifactId>

            <version>2.7.5</version>

        </dependency>

        <dependency>

            <groupId> com.squareup.okhttp </groupId>

            <artifactId>okhttp</artifactId>

            <version>2.7.5</version>

        </dependency>

        <dependency>

            <groupId> com.squareup.okio </groupId>

            <artifactId>okio</artifactId>

            <version>1.6.0</version>

        </dependency>

        <dependency>

            <groupId> io.gsonfire</groupId>

            <artifactId>gson-fire</artifactId>

            <version>1.8.0</version>

        </dependency>

        <dependency>

            <groupId>io.swagger</groupId>

            <artifactId>swagger-annotations</artifactId>

            <version>1.5.18</version>

        </dependency>

        <dependency>

            <groupId> org.threeten </groupId>

            <artifactId>threetenbp</artifactId>

            <version>1.3.5</version>

        </dependency>

</dependencies>

完成配置後，點選“Import Changes” 即可匯入所有需要的jar檔案。如果使用的是Eclipse，可參考這裡的匯入方法。

匯入結果：

方式2：手動下載jar包，然後解壓檔案，手動匯入jar，同時還需另行手動匯入其他幾個jar檔案。

二、登入冰藍雲賬號，建立資料夾，上傳檔案。

三、建立應用程式，獲取App ID及App Key。

四、Java程式碼示例

【示例1】新增附件

import spire.cloud.pdf.sdk.ApiException;

import spire.cloud.pdf.sdk.Configuration;

import spire.cloud.pdf.sdk.api.PdfAttachmentsApi;

import java.io.File;

public class AddAttachment {

    static String appId = "App ID";

    static String appKey = "App Key";

    static String baseUrl= "https://api.e-iceblue.cn";

    static Configuration configuration = new Configuration(appId, appKey, baseUrl);

    static PdfAttachmentsApi pdfAttachmentsApi = new PdfAttachmentsApi(configuration);

    public static void main(String[] args) throws ApiException {

        String name = "sample.pdf";//用於測試的PDF原始檔

        String outPath = "output/AddAttachment.pdf";//結果檔案路徑（結果檔案儲存在雲端output資料夾下）

        File file = new File("test.docx");//載入附件檔案

        String attachmentFileName = "AddAttachment.docx";//設定附件檔名稱

        String attachmentDescription = "A Nice File";//附件描述

        String folder = "input";//原始檔所在資料夾

        String storage = null;//冰藍雲提供的2G免費雲端儲存空間

        String password = null;//原始檔密碼

        //呼叫方法新增附件

        pdfAttachmentsApi.addAttachment(name, outPath, file, attachmentFileName, attachmentDescription, folder, storage, password);

    }

}

附件新增結果：

【示例2】下載附件檔案（以上文中生成的PDF檔案為例，讀取新增的Word附件）

import spire.cloud.pdf.sdk.ApiException;

import spire.cloud.pdf.sdk.Configuration;

import spire.cloud.pdf.sdk.api.PdfAttachmentsApi;

import java.io.File;

public class DownloadAttachment {

    //配置賬號資訊

    static String appId = "App ID";

    static String appKey = "App Key";

    static String baseUrl= "https://api.e-iceblue.cn";

    static Configuration configuration = new Configuration(appId, appKey, baseUrl);

    static PdfAttachmentsApi pdfAttachmentsApi = new PdfAttachmentsApi(configuration);

    public static void main(String[] args) throws ApiException {

        String name = "AddAttachment.pdf";//包含附件的PDF原始檔

        Integer orderNumber = 1;

        String folder = "output";//原始檔所在雲端資料夾

        String storage = null;//冰藍雲提供的2G免費雲端儲存空間

        String password = null;//原始檔密碼

        //呼叫方法下載PDF檔案中的附件檔案

        File response = pdfAttachmentsApi.downloadAttachment(name, orderNumber, folder, storage, password);

        System.out.println(response);

    }

}

讀取結果如下，可在路徑中檢視下載的附件檔案：

【示例3】獲取附件資訊

import spire.cloud.pdf.sdk.ApiException;

import spire.cloud.pdf.sdk.Configuration;

import spire.cloud.pdf.sdk.api.PdfAttachmentsApi;

import spire.cloud.pdf.sdk.model.Attachments;

public class GetAttachmentInfo {

    //配置賬號資訊

    static String appId = "App ID";

    static String appKey = "App Key";

    static String baseUrl= "https://api.e-iceblue.cn";

    static Configuration configuration = new Configuration(appId, appKey, baseUrl);

    static PdfAttachmentsApi pdfAttachmentsApi = new PdfAttachmentsApi(configuration);

    public static void main(String[] args) throws ApiException {

        String name = "AddAttachment.pdf";//包含附件的PDF原始檔

        String folder = "output";//原始檔所在資料夾

        String storage = null;//冰藍雲提供的2G雲端儲存空間

        String password = null;//原始檔密碼

        //呼叫方法獲取附件資訊

        Attachments response = pdfAttachmentsApi.getAttachmentsInfo(name, folder, storage, password);

        System.out.println(response);

    }

}

附件資訊讀取結果：

（完）