استقبال الرسائل القصيرة في روبي ريلز

يوفر لك الدليل في هذه الصفحة الفرصة لتعلم كيفية استخدام برنامج روبي للحصول على الرسائل القصيرة المستلمة من بوابة الرسائل القصيرة. يمكن القيام بذلك باستخدام طلبات HTTP التي تجمع الرسائل القصيرة المستلمة. يحتوي الدليل على فيديو تعليمي ودليل خطوة بخطوة لمساعدتك في تعلم كيفية استقبال الرسائل القصيرة باستخدام روبي.

ما هي واجهة برمجة تطبيقات الرسائل القصيرة لروبي؟

تتيح لك واجهة برمجة تطبيقات الرسائل القصيرة لروبي ريلز إرسال رسائل قصيرة من برنامج روبي ريلز الخاص بك. تقوم واجهة برمجة تطبيقات الرسائل القصيرة لروبي ببدء طلبات HTTP وإرسالها إلى بوابة الرسائل القصيرة التي تقوم بتسليم الرسالة إلى المستلم.

المتطلبات الأساسية

استقبال الرسائل القصيرة في روبي ريلز

  1. افتح تطبيق المفكرة
  2. انسخ والصق رمز المثال من هذه الصفحة
  3. احفظ الملف باسم ReceiveSMS.rb
  4. افتح بوابة الرسائل القصيرة Ozeki واختر اتصال خادم HTTP
  5. افتح نموذج HTML لاتصال خادم HTTP
  6. أرسل بعض رسائل الاختبار
  7. افتح موجه الأوامر
  8. اكتب 'ruby ReceiveSMS.rb' في موجه الأوامر واضغط Enter
  9. سيقوم روبي ريلز باستقبال رسائل SMS

الفيديو 1 - كيفية استقبال الرسائل القصيرة في روبي ريلز (فيديو تعليمي)

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

require 'net/http'
require 'rexml/document'
include REXML

def DisplayMessages(response)
	xmldoc = Document.new(response)

	xmldoc.elements.each('response/data/message') do |value|
		begin
			sender = value.elements['originator'].text
			text = value.elements['messagedata'].text
			DisplayMessage(sender,text)
		rescue
			puts("The inbox is empty.")
		end
	end
end

def DisplayMessage(sender, text)
	puts("#{sender}: #{text}")
end

username = "john"
password = "Xc3ffs"
httpUrl = "https://127.0.0.1:9508/"
folder = "inbox";
limit = "3";

sendString = "#{httpUrl}api?action=receivemessage&username="\
			 "#{username}&password="\
			 "#{password}&folder=#{folder}&limit="\
			 "#{limit}&afterdownload=delete"

puts("Sending http request #{sendString}")

OpenSSL::SSL.send(:remove_const, :VERIFY_PEER)
OpenSSL::SSL.const_set(:VERIFY_PEER, OpenSSL::SSL::VERIFY_NONE)

url = URI(sendString)
response = Net::HTTP.get(url)
puts("Http response received:")
DisplayMessages(response)

الخطوة 1 - افتح المفكرة

في هذه الخطوة الأولى، تحتاج إلى فتح تطبيق محرر نصوص يمكنه التعامل مع ملفات روبي. لهذا الغرض، يمكنك استخدام تطبيق المفكرة الافتراضي الموجود على جميع أجهزة الكمبيوتر التي تعمل بنظام Windows. كما يوضح الشكل 1، ما عليك سوى فتحه من سطح المكتب الخاص بك.

فتح المفكرة
الشكل 1 - افتح محرر نصوص المفكرة

الخطوة 2 - انسخ كود روبي

بعد ذلك، تحتاج إلى نسخ رمز مثال روبي من هذه الصفحة. للقيام بذلك، ما عليك سوى التمرير لأعلى إلى قسم رمز المثال في هذه الصفحة وتحديد رمز مثال روبي بالكامل. بعد ذلك، كما ترى في الشكل 2، اضغط على Ctrl+C على لوحة المفاتيح لنسخ رمز روبي إلى الحافظة.

نسخ كود روبي
الشكل 2 - نسخ كود مصدر روبي من الموقع

الخطوة 3 - الصق الكود في ملف النص

بعد نسخ كود مصدر روبي من هذه الصفحة، تحتاج إلى وضعه في مستند نصي. للقيام بذلك، انتقل إلى تطبيق المفكرة الذي فتحته سابقًا، وكما ترى في الشكل 3، اضغط على Ctrl+V على لوحة المفاتيح للصق كود مصدر روبي بالكامل في المستند النصي.

لصق الكود في المفكرة
الشكل 3 - لصق كود المصدر في المفكرة

الخطوة 4 - حفظ النص كملف روبي

في هذه المرحلة، لديك ملف نصي يحتوي على الكود المصدري، ولكنه ليس بعد بتنسيق ملف روبي الصحيح. يمكن لبرنامج المفكرة حفظ الملفات بأي تنسيق، لذا يمكنك حل هذه المشكلة بسهولة. لذلك، اختر خيار "حفظ باسم" في المفكرة، واحفظ الملف بامتداد الملف '.rb'. يتم توضيح هذه العملية في الشكل 4.

حفظ ملف روبي
الشكل 4 - حفظ ملف روبي باسم ReceiveSMS.rb

الخطوة 5 - إرسال بعض الرسائل الاختبارية

الآن، كود المثال جاهز للتشغيل، ولكن أولاً، تحتاج إلى وجود بعض الرسائل في مجلد الوارد الخاص بك. لأغراض الاختبار، يمكنك استخدام اتصال خادم HTTP لإرسال بعض الرسائل الاختبارية إلى نفسك واختبار كود PHP المثال. لذا، افتح بوابة الرسائل القصيرة واختر اتصال خادم HTTP. هنا، افتح النموذج HTML للاتصال، وكما في الشكل 5، أرسل بعض الرسائل إلى المستلم 'Ozeki'.

محاكاة رسائل واردة
الشكل 5 - محاكاة بعض الرسائل الواردة

الخطوة 6 - فتح موجه الأوامر

الخطوة الرئيسية في الدليل هي تنفيذ برنامج روبي. للقيام بذلك، تحتاج إلى فتح موجه الأوامر على جهازك. لذا، انتقل أولاً إلى المجلد حيث حفظت ملف روبي باستخدام مستكشف الملفات. هنا، كما ترى في الشكل 6، اكتب 'cmd' في مستكشف الملفات، وإذا ضغطت على Enter، سيتم فتح موجه الأوامر على جهازك.

فتح موجه الأوامر
الشكل 6 - فتح موجه الأوامر

الخطوة 7 - تنفيذ برنامج روبي

في موجه الأوامر، تحتاج فقط إلى تنفيذ سطر واحد من الأوامر لتنفيذ برنامج روبي. لذا، اكتب فقط 'ruby *اسم الملف*.rb' في موجه الأوامر واضغط على Enter. بذلك، سيتم تنفيذ مثال روبي، وستتمكن من رؤية النتائج في نافذة الكونسول (الشكل 7). هنا، يمكنك رؤية طلب HTTP والرد على ذلك الطلب أيضًا والذي يحتوي على جميع الرسائل المستلمة.

تشغيل كود روبي
الشكل 7 - تشغيل كود روبي في موجه الأوامر