aws sdk java v2

AWS SDK لـ Java 2.0

تعد AWS SDK for Java 2.0 بمثابة إعادة كتابة للإصدار 1.0 مع بعض الميزات الجديدة الرائعة. كما هو الحال مع الإصدار 1.0، فإنه يمكّنك من العمل بسهولة مع Amazon Web Services ولكنه يتضمن أيضًا ميزات مثل عمليات الإدخال والإخراج غير المحظورة وتنفيذ HTTP القابل للتوصيل لمزيد من تخصيص تطبيقاتك. يمكنك البدء خلال دقائق باستخدام Maven أو أي نظام بناء يدعم MavenCentral كمصدر للقطع الأثرية.

• الصفحة الرئيسية لـ SDK
• 1.11 إلى 2.0 سجل التغيير
• أفضل الممارسات
• رمز العينة
• مستندات API
• دليل المطور (المصدر)
• نماذج مافن الأصلية
• مشاكل
• مدونة SDK
• إعطاء ردود الفعل

ابدء

قم بالتسجيل في AWS

قبل أن تبدأ، تحتاج إلى حساب AWS. يرجى مراجعة قسم التسجيل في AWS في دليل المطور للحصول على معلومات حول كيفية إنشاء حساب AWS واسترداد بيانات اعتماد AWS الخاصة بك.

الحد الأدنى من المتطلبات

لتشغيل SDK، ستحتاج إلى Java 1.8+ . لمزيد من المعلومات حول المتطلبات والإعدادات المثالية لـ SDK، يرجى مراجعة قسم تثبيت بيئة تطوير Java في دليل المطور.

باستخدام SDK

الطريقة الموصى بها لاستخدام AWS SDK لـ Java في مشروعك هي استهلاكها من Maven Central.

استيراد BOM

لإدارة إصدارات الوحدات تلقائيًا (تحتوي جميع الوحدات حاليًا على نفس الإصدار، ولكن قد لا يكون هذا هو الحال دائمًا) نوصي باستخدام استيراد قائمة المواد كما يلي:

< dependencyManagement >
  < dependencies >
    < dependency >
      < groupId >software.amazon.awssdk</ groupId >
      < artifactId >bom</ artifactId >
      < version >2.29.31</ version >
      < type >pom</ type >
      < scope >import</ scope >
    </ dependency >
  </ dependencies >
</ dependencyManagement >

بعد ذلك قد تقوم الوحدات الفردية بحذف version من بيان التبعية الخاص بها:

< dependencies >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >ec2</ artifactId >
  </ dependency >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >s3</ artifactId >
  </ dependency >
  < dependency >
    < groupId >software.amazon.awssdk</ groupId >
    < artifactId >dynamodb</ artifactId >
  </ dependency >
</ dependencies >

الخدمات الفردية

وبدلاً من ذلك، يمكنك إضافة تبعيات للخدمات المحددة التي تستخدمها فقط:

< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >ec2</ artifactId >
  < version >2.29.31</ version >
</ dependency >
< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >s3</ artifactId >
  < version >2.29.31</ version >
</ dependency >

SDK بالكامل

يمكنك استيراد حزمة SDK بالكامل إلى مشروعك (بما في ذلك جميع الخدمات). يرجى ملاحظة أنه يوصى باستيراد الوحدات التي تحتاجها فقط.

< dependency >
  < groupId >software.amazon.awssdk</ groupId >
  < artifactId >aws-sdk-java</ artifactId >
  < version >2.29.31</ version >
</ dependency >

راجع قسم إعداد AWS SDK for Java في دليل المطور لمزيد من معلومات الاستخدام.

ميزات جديدة لـ 2.0

• يوفر طريقة لتوصيل تطبيق HTTP الخاص بك.

• يوفر دعمًا من الدرجة الأولى لعمليات الإدخال والإخراج غير المحظورة في عملاء Async.

البناء من المصدر

بمجرد التحقق من الكود من GitHub، يمكنك إنشائه باستخدام الأوامر التالية.

لينكس:

./mvnw clean install

# Skip tests, checkstyles, findbugs, etc for quick build
./mvnw clean install -P quick

# Build a specific service module
./mvnw clean install -pl :s3 -P quick --am

ويندوز:

./mvnw.cmd clean install

رمز العينة

يمكنك العثور على نموذج التعليمات البرمجية للإصدار 2 في الأماكن التالية:

• aws-doc-sdk-examples الريبو.
• اختبارات التكامل في هذا الريبو. وهي موجودة في دليل it ضمن كل وحدة خدمة، على سبيل المثال: اختبارات التكامل s3

الصيانة والدعم للإصدارات الرئيسية من SDK

للحصول على معلومات حول الصيانة والدعم لإصدارات SDK الرئيسية وتبعياتها الأساسية، راجع ما يلي في الدليل المرجعي لأدوات SDK وAWS:

• سياسة صيانة أدوات وحزم تطوير البرمجيات الخاصة بـ AWS
• مصفوفة دعم إصدار AWS SDK والأدوات

الصيانة والدعم لإصدارات جافا

نحافظ على الدعم الكامل لإصدارات الدعم طويل الأمد (LTS): Java 8 وJava 11 وJava 17 وJava 21. لاحظ أنه قد تكون هناك ميزات فردية في الإصدارات الأحدث غير مدعومة، لأن SDK يجب أن تكون متوافقة مع Java 8.

إعطاء ردود الفعل

نحن بحاجة لمساعدتكم في جعل SDK هذا رائعًا. يرجى المشاركة في المجتمع والمساهمة في هذا الجهد من خلال طرح القضايا والمشاركة في منتديات المناقشة وتقديم طلبات السحب من خلال القنوات التالية:

• إرسال المشكلات - هذه هي القناة المفضلة للتفاعل مع فريقنا
• قم بتوضيح طلب الميزة الخاص بك أو قم بالتصويت لصالح الطلبات الحالية على صفحة المشكلات الخاصة بنا

المساهمين

شكرًا لهؤلاء الأشخاص الرائعين (مفتاح الرموز التعبيرية):

سوليس	أوستن بروكس	كونراد "كتوسو" مالاوسكي	أندرو هوبكنز	آدم توماس	ستيفن سور	كاري بورغيس
أنوراج أغراوال	جيفالدر	بوريس	غيوم كوريه	هنري ياندل	ريان شميت	سمية
ستيفن أيرتس	ستيفن وونغ	توماس إليندت	ويل إريكسون	جوليان هوارو	سيوخيونتشوي	adriannistor
شيان صن	أندرياس شيجا	انطون إيجوروف	com.roexber	com.brharrington	كريستوفر راديك	فوافوس
فرانك ويسمان	جيرجيلي فارجا	غييرمو	هنري هيكينن	يوخن شالاندا	جو بارنيت	كازوهيرو سيرا
كريشنا تشيتانيا غانتا	لي باكهام	ماتيو كارارا	مايكل شارب	ميغيل خيمينيز	راسل بولس	راسل شيرر
سكوت	شينيا يوكا	com.sushilamazon	tomliu4uber	فلاديمير أوراني	شينيو هو	يوسف فرتل
دينيس كوناخيفيتش	اليكس ويبل	ريان كاربر	جوناثان م. هنسون	ديبورا ن. إيتو	بريت أمبروز	آنا كارين سالاندر
جون فيجاس	دونجي اجنير	ماثيو ميلر	بنيامين مايزيلز	تشيوان تشو	زوي وانغ	فارون ناندي
أندرو شور	كايل طومسون	سام فينك	جوناثان بوند	ajs139	ديوي نجوين	ديفيد لين
مايكل لي	بينيت لينش	إيكو أشيمين	جيمي ليو	guillepb10	لورينز نيكل	ايرين يانغ
روبرتو تايلي	ألفين سي	رون1	ساي كومار ريدي شاندوباتلا	ديفيد هو	توماس توريل كروفت	ستيفن شان
باري اونيل	آندي كيسلر	مارتن	باولو ليوثير	سيباستيان كروكيسيل	ديفيد نيجريت	ستيفن فلافين
أوليفييه إل أبلين	أدريان كليبوش	تشاد ويلسون	مانيش دايت	دينيس كيسيلهورست	نيلش PS	ستيفن سوارتز
مايكل ديمشوك	نيكيتا سوكولوف	مانويل سوجاوارا	أنيروده	هايدن بيكر	جايكومار جوسار	مايكل غريب
مايكل جروندي	إيكارد موليش	توبياس سولوشينكو	لويس مادريجال	كيريل تشيكين	prateek-vats	بولي1155	توماس فار

يتبع هذا المشروع مواصفات جميع المساهمين. المساهمات من أي نوع موضع ترحيب!