إرسال البريد الإلكتروني باستخدام Aspose.Email Cloud في تطبيق Heroku Java

تساعدك هذه المقالة على إعداد تطبيق Java على منصة Heroku. وتوضح كيفية استخدام Aspose.Email Cloud لإرسال البريد الإلكتروني باستخدام تطبيق Java في السحابة.

Heroku عبارة عن منصة كخدمة (PaaS) تمكن المطورين من بناء وتشغيل وتشغيل التطبيقات بالكامل في السحابة. وهي تدعم العديد من لغات البرمجة بما في ذلك Java. يسهل Heroku نشر تطبيقات Java وتوسيع نطاقها. سواء كنت تستخدم المكتبات القياسية مع خوادم التطبيقات مثل Tomcat أو Jetty، أو أطر العمل مثل Spring أو Play، فإن Heroku يساعدك في بناء الأشياء بالطريقة التي تريدها باستخدام الأدوات التي تحبها. يرشدك هذا المقال إلى كيفية نشر تطبيق Java على Heroku. تساعدك المقالة على فهم Aspose.Email Cloud، وكيفية استخدامه لإرسال البريد الإلكتروني باستخدام تطبيق Heroku Java. تفترض المقالة أن لديك بالفعل إعداد حساب Heroku مجانيًا وأن Java 8 وMaven 3 مثبتين محليًا. Maven هي أداة قوية لإدارة المشاريع تعتمد على POM (نموذج كائن المشروع) في المقام الأول لمشاريع Java. يمكن أيضًا استخدام Maven لبناء وإدارة المشاريع المكتوبة بلغات C# وRuby وScala ولغات أخرى. يتم استخدامه لبناء المشروع والتبعيات والتوثيق. إنه يبسط عملية البناء مثل ANT. لكنها متقدمة جدًا عن ANT. باختصار، يمكننا القول إن maven هي أداة يمكن استخدامها لبناء وإدارة أي مشروع قائم على Java. يجعل maven العمل اليومي لمطوري Java أسهل ويساعد بشكل عام في فهم أي مشروع قائم على Java. لنبدأ!

إعداد هيروكو

للبدء، تحتاج أولاً إلى تثبيت واجهة سطر أوامر Heroku (CLI).تُستخدم واجهة سطر أوامر Heroku لإدارة وتنفيذ مهام التوسع المختلفة. يمكنك استخدامها لتوفير الوظائف الإضافية وعرض سجلات التطبيق وتشغيل التطبيق محليًا. إذا كنت تستخدم نظام التشغيل macOS، فيمكنك استخدام Homebrew لتثبيته أو يمكنك زيارة موقع Heroku الرسمي.

brew install heroku/brew/heroku

بمجرد الانتهاء من التثبيت، يمكنك تشغيل الأمر التالي للتحقق من صحة Heroku لاستخدامه محليًا.

heroku login
heroku: Press any key to open up the browser to login or q to exit
 ›   Warning: If browser does not open, visit
 ›   https://cli-auth.heroku.com/auth/browser/\*\*\*
heroku: Waiting for login...
Logging in... done
Logged in as me@example.com

يفتح هذا الأمر متصفحك على صفحة تسجيل الدخول إلى Heroku للمصادقة. وهذا مطلوب لكي تعمل أوامر Heroku وgit بشكل صحيح

إعداد Aspose.Email Cloud

Aspose.Email Cloud عبارة عن مجموعة أدوات تطوير سحابية لإرسال واستقبال وإضافة ووضع علامات وتحويل رسائل البريد الإلكتروني السحابية ودعم إنشاء بنية مجلدات لأرشفة البريد الإلكتروني في السحابة. هذه واجهة برمجة تطبيقات سهلة الاستخدام وسريعة، ولا تحتاج إلى تثبيت برامج إضافية. تدعم واجهة برمجة التطبيقات العديد من لغات البرمجة، مثل C# وJava وPHP وPython وRuby وTypescript. لإعداد Aspose.Email Cloud، اتبع التعليمات الموضحة أدناه.

قم بتسجيل الدخول إلى لوحة تحكم Aspose.Cloud وانقر على علامة التبويب “التطبيقات” في الشريط الجانبي الأيسر. الآن قم بالتمرير لأسفل، وانقر على زر “إنشاء تطبيق جديد” كما هو موضح في الصورة أدناه.

إعداد حساب Aspose.Email Cloud لإرسال البريد الإلكتروني

الآن قم بإنشاء تطبيقك الجديد من خلال تحديد التخزين الافتراضي الخاص بك كما هو موضح في الصورة أدناه. يمكنك أيضًا تكوين تخزين تابع لجهة خارجية لتحميل ملفات البيانات الخاصة بك من خلال اتباع الدليل كيفية تكوين تخزين سحابي تابع لجهة خارجية.

إعداد حساب Aspose.Email Cloud لإرسال البريد الإلكتروني

الآن، قم بالتمرير إلى الأسفل نحو قسم بيانات اعتماد العميل لنسخ معرف العميل والسر الخاص بالعميل كما هو موضح في الصورة أدناه.

إعداد حساب Aspose.Email Cloud لإرسال البريد الإلكتروني

إرسال البريد الإلكتروني باستخدام Aspose.Email Cloud

بافتراض أنك قمت بالفعل بتثبيت Java 8 وMaven 3. فلديك الآن مستودع git عامل يحتوي على تطبيق بسيط. يجب أن يحتوي مستودع Git العامل هذا على تطبيق Java بسيط. يتضمن التطبيق Procfile، وهو ملف نص عادي خاص يستخدمه تطبيقات Heroku. يمكنك الإعلان صراحةً عن العمليات والأوامر المستخدمة لبدء تشغيل تطبيقك في هذا الملف.

يبدو ملف Procfile في كود مصدر التطبيق المثال كما يلي:

web: java -jar target/java-getting-started-1.0.jar

يعلن هذا الملف عن نوع عملية واحد، وهو web، والأمر المطلوب لتشغيله. الاسم web مهم. فهو يعلن أن نوع العملية هذا مرتبط بمكدس توجيه HTTP الخاص بـ Heroku، وقادر على استقبال حركة مرور الويب. يمكن أن تحتوي ملفات Procfiles على أنواع عمليات إضافية. على سبيل المثال، يمكنك إعلان عامل في الخلفية يعالج العناصر من قائمة انتظار. يجب أن يتضمن تطبيق المثال أيضًا ملف pom.xml، والذي يستخدمه مدير التبعيات في Java، Maven. يحدد Heroku تلقائيًا التطبيق باعتباره تطبيق Java إذا كان يحتوي على ملف pom.xml في الدليل الجذر.

يشير ملف آخر، system.properties، إلى إصدار Java الذي يجب استخدامه. يبدو محتوى هذا الملف الاختياري على النحو التالي:

java.runtime.version=1.8

قم أولاً بإضافة المستودع إلى مشروعك

<repository>
    <id>aspose-cloud</id>
    <name>Aspose.Cloud repository</name>
    <url>https://repository.aspose.cloud/repo</url>
</repository>

ثم قم بإضافة التبعية

<dependency>
    <groupId>com.aspose</groupId>
    <artifactId>aspose-email-cloud</artifactId>
</dependency>

أضف الكود التالي إلى مشروعك لإرسال البريد الإلكتروني

import com.aspose.email.cloud.sdk.invoker.ApiException;
import com.aspose.email.cloud.sdk.model.\*;
import com.aspose.email.cloud.sdk.api.\*;

EmailCloud api = new EmailCloud("Your Client secret", "Your Client id");

EmailClientAccountPasswordCredentials credentials =
    new EmailClientAccountPasswordCredentials(
        "example@gmail.com", "password");

// Setup an email account for email sending
EmailClientAccount sendAccountDto = new EmailClientAccount(
    "smtp.gmail.com", 465, "SSLAuto", "SMTP", credentials);
String smtpAccount = "smtp.account";
String smtpLocation = new StorageFileLocation(
    storageName, accountFolder, smtpAccount);
api.client().account().save(new ClientAccountSaveRequest(
    smtpLocation, sendAccountDto));

EmailDto email = new EmailDto()
    .from(new MailAddress().address("example@gmail.com"))
    .addToItem(new MailAddress().address("to@aspose.com"))
    .subject("Some subject")
    .body("Some body");

api.client().message().send(
    new ClientMessageSendRequest(
        smtpLocation, new MailMessageDto(email)));

النشر على Heroku (تطبيق Java)

بمجرد الانتهاء من جميع تغييراتك واستعدادك للنشر على Heroku (تطبيق Java)، يمكنك استخدام الأوامر التالية لدفع تغييراتك إلى Heroku.

$ heroku create
Creating sharp-rain-321... done, stack is heroku-20
https://sharp-rain-221.herokuapp.com/ | https://git.heroku.com/sharp-rain-321.git
Git remote heroku added

سيؤدي هذا إلى إنشاء مستودع git على Heroku وأي شيء تدفعه إلى هذا المستودع سيتم نشره على تطبيق Heroku Java.

$ git push heroku main

الآن يمكنك فتح تطبيقك باستخدام أمر heroku open.

خاتمة

هذه المقالة جزء من سلسلة تشرح منصة Heroku وكيف تمكن المطورين من بناء وتشغيل وتشغيل التطبيقات بالكامل في السحابة. كما تعلمنا كيفية إعداد تطبيق Heroku Java. كما استكشفنا Aspose.Email Cloud، واستخدمناه لإعداد عميل بريد إلكتروني SMTP لإرسال البريد الإلكتروني. Aspose.Email Cloud ليس فقط لإرسال رسائل البريد الإلكتروني. بدلاً من ذلك، فهو عبارة عن مجموعة أدوات تطوير سحابية لإرسال واستقبال وإضافة ووضع علامة وتحويل رسائل البريد الإلكتروني السحابية ودعم إنشاء بنية مجلد لأرشفة البريد الإلكتروني في السحابة. هذه واجهة برمجة تطبيقات سهلة الاستخدام وسريعة، ولا تحتاج إلى تثبيت برامج إضافية. تدعم واجهة برمجة التطبيقات العديد من لغات البرمجة، مثل C# وJava وPHP وPython وRuby وTypescript. آمل أن تكون هذه المقالة قد ساعدتك.

يستكشف