升級到v0.3.0

本指南的目標用戶為 Agent Java SDK v0.3.0 和 Java 8+。

確定需要升級的內容

保留您當前的 baseUrl、agentCode、apiSecret、用戶綁定和原始業務訂單。

安裝穩定的公共標籤

GitHub 託管源代碼。發佈 GitHub 標籤不會將 Maven 座標發佈到 Maven Central。在本地安裝標記的源或將其經過驗證的 JAR/POM 發佈到組織的工件存儲庫。

git clone --branch v0.3.0 --single-branch https://github.com/6mm-com/agent-java-sdk.git agent-java-sdk-v0.3.0
cd agent-java-sdk-v0.3.0
git rev-parse HEAD
git rev-parse 'v0.3.0^{commit}'
mvn install

兩個提交 ID 必須匹配。在合作伙伴項目中聲明依賴：

<dependency>
    <groupId>com.sixmm.exchange.sdk</groupId>
    <artifactId>agent</artifactId>
    <version>0.3.0</version>
</dependency>

驗證已解決的依賴關係：

mvn dependency:tree -Dincludes=com.sixmm.exchange.sdk:agent

本地安裝僅使工件在該計算機上可用。 CI 和其他開發人員需要相同的標記安裝或經過驗證的工件存儲庫。如果您已經有一個名為 0.3.0 的私有工件，請驗證其來源和方法；不要默默地覆蓋共享工件。

所需的集成更改

1. 更新顯式 environment 的請求和響應模型。嚴格的舊響應模型可能會拒絕附加字段。
2. 在讀取 funding 之前使用 withFunding()。合約餘額不是秒交易餘額。
3. 使用 /v1/agent/wallet-transfer 和 /v1/agent/wallet-transfer-status 進行資助。舊的 queryOrder 無法恢復資金操作。
4. 這六個查詢使用 platformUserIds 作為字符串數組。將數組標記為緊湊的 JSON； Java List.toString() 不兼容。
5. 將轉移訂單、普通交易訂單、條件訂單和成交訂單存儲為不同的實體。根據運算解析orderStatus或status。
6. 在解析之前驗證原始的 webhook 正文。顯式模擬通知包括environment；將其與保存的訂單進行比較。
7. 獨立管理 Java 和 Widget 版本。後端升級不會改變前端頁面或交易模式，秒交易不需要新的幣種。

驗證升級

運行合作伙伴項目的構建並檢查其依賴關係樹。測試綁定、原始生產流程、顯式模擬餘額、資金結果恢復、所有六個查詢、固定窗口分頁、錯誤處理和冪等回調。

對於自定義 HTTP 客戶端，請遵循標記的請求和簽名合同，而不是假設舊模型覆蓋新字段。看 代理簽約規則, 查詢概覽 和 環境指南.

來源及相關指南

• 官方v0.3.0源碼
• 查詢概覽和分頁
• 資金錢包