كيف يعمل الصابون

أ الصابون طلب سيشمل انشاء وتأهيل طلب مظروف ، والذي يتضمن جميع المعلومات المطلوبة (على النحو الذي يحدده wsdl الوثيقة) ، ان يحيل الى مظروف API الخادم ، ومناوله الرد.

أ الصابون طلب عامة يتضمن جميع العناصر التالية :

• مظروف الصابون - مع المجرد الادراج.

• الصابون - ربما تحدد الهيءه اضافية namespaces.

• - كيف المرجوة العمل المنشود يتمثل العمل سيتوقف على API في السؤال. وقد يكون بهذه البساطه أ بارامتر ، او إشراك مزيد من namespaces.

• المطور الرئيسية - فريدة معرف يكلفه بها الخادم الى الطالب.

• طلب معالم تفصيل - طلب يجري ادائها.

مع ان المعلومات في الاعتبار ، وهو طلب الصابون يمكن توليدها.

<؟ Xmlversion = "1.0" تشفير = "الرموز العالمية لتحوير الهيءه - 8" مستقل = "لا"؟ >
<الصابون - env : مظروف
Xmlns : الصابون - env = "http://schemas.xmlsoap.org/soap/envelope/"
Xmlns : xsd = "http://www.w3.org/2001/xmlschema"
Xmlns : xsi = "http://www.w3.org/2001/xmlschema-instance">
<الصابون - env : الهيءه>
<Devkey xsi : نوع = "xsd : مداخلة"> 123 </ devkey>
<العمل xsi : نوع = "xsd : الخيط"> بحث </ العمل>
<Xsi النوع : النوع = "xsd : سلسلة"> كتاب </ النوع>
<الكلمات الرئيسية xsi : نوع = "xsd : الخيط"> الاسلوب </ الكلمات الرئيسية>
</ الصابون - env : الهيءه>
</ الصابون - env : مظروف>

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

الصابون استجابة من شأنه ان تبدو كمن هذا :

<؟ Xmlversion = '1.0' تشفير = 'الرموز العالمية لتحوير الهيءه - 8'؟ >
<الصابون - env : مظروف
Xmlns : الصابون - env = "http://schemas.xmlsoap.org/soap/envelope/"
Xmlns : xsi = "http://www.w3.org/1999/xmlschema-instance"
Xmlns : xsd = "http://www.w3.org/1999/xmlschema">
<الصابون - env : الهيءه>
<Librarysearchresponsexmlns = "http://library.example.com/api/ns">
<Requestinfo>
<Devkey xsi : نوع = "xsd : الخيط"> 123 </ devkey>
<العمل xsi : نوع = "xsd : الخيط"> بحث </ العمل>
<Xsi النوع : النوع = "xsd : سلسلة"> كتاب </ النوع>
<الكلمات الرئيسية xsi : نوع = "xsd : الخيط"> الاسلوب </ الكلمات الرئيسية>
</ Requestinfo>
<Responseinfo>
<Resultcount> 2 </ resultcount>
<البند>
<Xsi عنوان : النوع = "xsd : الخيط"> اسلوب الكتاب المجلد 1 </ عنوان>
<مركز xsi : نوع = "xsd : الخيط"> بها </ مركز>
<يحمل xsi : نوع = "xsd : مداخلة"> 3 </ يعقد>
<Copiesonhand xsi : نوع = "xsd : مداخلة"> 2 </ copiesonhand>
<Xsi المؤلف : نوع = "xsd : الخيط"> جون دو </ المؤلف>
</ البند>
<البند>
<Xsi عنوان : النوع = "xsd : الخيط"> اسلوب الكتاب المجلد 2 </ عنوان>
<مركز xsi : نوع = "xsd : الخيط"> </ مركز>
<يحمل xsi : نوع = "xsd : مداخلة"> 0 </ يعقد>
<Copiesonhand xsi : نوع = "xsd : مداخلة"> 1 </ copiesonhand>
<Xsi المؤلف : نوع = "xsd : الخيط"> جون دو </ المؤلف>
</ البند>
</ Responseinfo>
</ Librarysearchresponse>
</ الصابون - env : الهيءه>
</ الصابون - env : مظروف>

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

كما أنك ينبغي أن تكون قادرة على التمييز بين من أظهر استجابة ، ويعلن نفسه الى أن اكس ام ال 1.0 ويستخدم الرموز العالمية لتحوير الهيءه - 8 للتشفير. الصابون - env : مظروف العنصر هو عنصر جذر لهذه الوثيقة ، ولقد threenamespaces ، بما فيها الصابون - env المجرد. الجثه ثم librarysearchresponse تتضمن عنصرا من بين امور اخرى ، والذي يعرف ايضا خاصة بها المجرد.

فأن الوالد requestinfo التالي بعد ، وهذا يتضمن طلب البارامترات التي ولدت الرد التالي على ان من هناك. العودة بارامترات الطلب مع الاستجابة غالبا ما يحدث في الصابون.

واخيرا ، فان الرد هو نفسه عاد. ولاحظ ان عنصر resultcount يجلس كنتيجه مباشرة للresponseinfo الطفل ، والنتيجة هي البنود انفسهم مرة اخرى مخزنة في ظل تكرار عنصر ، البند.