الترقية إلى v0.3.0

يستهدف هذا الدليل Agent Java SDK v0.3.0 وJava 8+.

قرر ما الذي يحتاج إلى الترقية

التكامل القائم	فعل
وظائف الإنتاج الحالية مع البيئة المحذوفة	تظل أشكال الاستجابة الحالية متوافقة؛ الاستعلامات الجديدة لا تفرض الترقية.
توجد مصادقة تضمين عامة لتداول الثواني	إعادة استخدام المصادقة والتجديد؛ حدد صفحة المنتج المطلوبة.
أرصدة التمويل والتحويلات والاسترداد	استخدم النماذج التي تحتوي على `withFunding`، `walletTransfer` و `queryWalletTransfer`.
أموال محاكاة صريحة	استخدم نماذج الطلب/الاستجابة التي تدعم `environment`.
ستة استعلامات البيانات الدائمة	استخدم Java SDK `v0.3.0` العامة، بما في ذلك الطرق الستة ودعم توقيع المصفوفة.

احتفظ بارتباطات المستخدم الحالية 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

يجب أن يتطابق معرفا الالتزام. أعلن التبعية في المشروع الشريك:

<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، فتحقق من مصدرها وطرقها؛ لا تقم بالكتابة بصمت فوق قطعة أثرية مشتركة.

تغييرات التكامل المطلوبة

تحديث نماذج الطلب والاستجابة الصريحة environment. قد ترفض نماذج الاستجابة القديمة الصارمة الحقل الإضافي.
استخدم withFunding() قبل قراءة funding. أرصدة العقود ليست أرصدة تداول ثانية.
استخدم /v1/agent/wallet-transfer و/v1/agent/wallet-transfer-status للتمويل. لا يمكن لـ queryOrder القديم استرداد عملية التمويل.
تستخدم الاستعلامات الستة platformUserIds كمصفوفة سلسلة. قم بتوقيع المصفوفات على أنها مضغوطة JSON؛ Java List.toString() غير متوافق.
قم بتخزين أوامر النقل وأوامر التداول العادية والأوامر المشروطة والتنفيذات ككيانات متميزة. قم بتحليل orderStatus أو status وفقًا للعملية.
تحقق من النص الأصلي webhook قبل التحليل. تتضمن الإشعارات المحاكاة الصريحة environment؛ قارنه بالأمر المحفوظ.
إدارة إصدارات Java والأدوات بشكل مستقل. لا تؤدي ترقية الواجهة الخلفية إلى تغيير الصفحة الأمامية أو وضع التداول، ولا يتطلب تداول الثواني نوع رمز مميز جديد.

التحقق من الترقية

قم بتشغيل بناء المشروع الشريك وتفقد شجرة التبعية الخاصة به. ربط الاختبار، وتدفق الإنتاج الأصلي، والأرصدة المحاكاة الصريحة، واسترداد نتائج التمويل، وجميع الاستعلامات الستة، وترقيم الصفحات ذات النافذة الثابتة، ومعالجة الأخطاء وعمليات الاسترجاعات غير الفعالة.

بالنسبة لعميل HTTP المخصص، اتبع الطلب الموسوم وعقد التوقيع بدلاً من افتراض أن النماذج القديمة تغطي الحقول الجديدة. يرى قواعد توقيع الوكيل, نظرة عامة على الاستعلام و دليل البيئة.